Provide Administering Foreman guide for "foreman-el" and "foreman-deb"

[melcorr]

As part of #396, we and the latest discussion there, we need to stream the admin guide to generate versions for

• Satellite (the status quo but ensure nothing leaks that shouldn't etc)
• Foreman-EL
• Katello
• Debian users
• (I know orcharhino work has already been done, maybe more is needed)

This was inspired by theforeman/theforeman.org#1879 (comment)

I (@melcorr) will work on the foreman-el and katello scenarios.

[melcorr]

@ekohl can you help me formulate a prerequisite for chapter two for Foreman EL and Katello users.

To use this section, you must have foreman-maintain installed (how do they do that?)
And is there an alternative method? I can add that in?
At the moment, i've just added an ifndef for foreman-deb builds for Chapter 2.

[ekohl]

To use this section, you must have foreman-maintain installed (how do they do that?)

For Foreman on EL, you can yum/dnf install it. For Debian you can't. The software doesn't support it and is also not packaged.

Personally I always use systemctl directly.

systemctl stop foreman.service foreman.socket to stop Foreman itself. For something like (re)start it's sufficient to only restart foreman.service. There's also dynflow-sidekiq@* (always recommend to use \* if it's a shell command to prevent globbing files).

You should also be aware that httpd (EL) or apache2 (Debian) is a service that's used on the Foreman server. There's also rh-redis5-redis (EL7) or redis (EL8 / Debian).

If you're using a DB on the same server, there's also postgresql.service.

If I want to manage the Foreman Proxy, it's systemctl $action foreman-proxy.service. $action can be status, stop, start and restart.

[maximiliankolb]

orcharhino is currently using a version of "Administering Foreman" somewhere between foreman-el and satellite. For us, Katello is a non-optional plugin and orcharhino only runs on EL (7) currently.

Please tag me @melcorr whenever there are changes regarding the versions for foreman-el, satellite, and orcharhino.

[melcorr]

There's also dynflow-sidekiq@* (always recommend to use \* if it's a shell command to prevent globbing files).

I don't understand this bit. At the moment, I have created a prerequisite section where I say that before they can use the procedure, they'd have to have foreman-maintain installed, then the command. Then I say, Alternatively, they can use systemctl and the range of options for starting and stopping.

I'm assuming dynflow-sidekiq@* is a service they need to consider? Starting and stopping it? Starting it as part of the restart?

[ekohl]

I've revisited this a bit and opened #979 which is certainly not a solution, but a step in the right direction.