Description

System management with Foreman

This project is unmaintained, as my frustrations with Foreman reached a critical level!

This project contains all the packages scattered around for managing CentOS and Fedora clients in Foreman. This is due to the fact that the components here are dispersed among different repositories, are not on par with each other regarding versions across distributions and are all not available for the supported client distributions in Foreman.

Required packages

The clients enrolled in Foreman require various packages. The table listed below shows the minimum source packages that need to be built for a client to succesfully enroll in Foreman and where do they come from. A - symbol means it's either not required or already available in the main repositories of the distribution.

CentOS Stream variations are the same as the basic version.

The yum/dnf-plugin-proxy is to use repositories from Foreman/Katello or Satellite along with:

• External repositories that are only reachable by proxy
• Specific settings for the no_proxy addresses (not supported by normal yum/dnf proxy configuration
• Blacklisted repositories that have been mirrored in-house (such as those installed with centos-linux-release)

| Source package              | CentOS 6        | CentOS 7              | CentOS 8        | Fedora         |
|-----------------------------|-----------------|-----------------------|-----------------|----------------|
| katello-host-tools          | Foreman Client  | Custom                | Custom          | Custom         |
| rubygem-foreman_scap_client | Foreman Client  | Foreman Client        | Foreman Client  | Foreman Client |
| gofer                       | Satellite tools | Satellite tools       | Satellite tools | -              |
| tracer                      | -               | Foreman Client / EPEL | Foreman Client  | -              |
| subscription-manager        | RHEL            | -                     | -               | -              |
| pulp                        | Satellite tools | -                     | -               | -              |
| pulp-rpm                    | Satellite tools | -                     | -               | -              |
| python-isodate              | Satellite tools | -                     | -               | -              |
| dnf-plugin-proxy            | -               | -                     | Custom          | Custom         |
| yum-plugin-proxy            | -               | Custom                | -               | -              |

These are the source repositories listed above:

• RHEL 6
• RHEL 6 - Satellite Tools
• RHEL 7 - Satellite Tools
• RHEL 8 - Satellite Tools
• RHEL 6 - Foreman Client
• RHEL 7/8 & Fedora - Custom katello-host-tools
• RHEL 7 & Fedora - Custom yum-plugin-proxy
• RHEL 8 & Fedora - Custom dnf-plugin-proxy

Summing up, the source packages that are being built as part of this (depending on the distribution the version might be different) are:

• subscription-manager - el6
• pulp - el6
• pulp-rpm - el6
• python-isodate - el6
• gofer - el6, el7, el8
• katello-host-tools - el6, el7, el8, fc32, fc33
• rubygem-foreman_scap_client - el6, el7, el8, fc32, fc33
• tracer - el7 (so you don't need EPEL), el8
• dnf-plugin-proxy - el8, fc32, fc33
• yum-plugin-proxy - el7

The katello-host-tools is custom as it is without the agent and a simpler SPEC file on anything CentOS 7 and up.

Supported distributions

These are the supported distributions:

• RHEL 6 and derivatives
• RHEL 7 and derivatives
• RHEL 8 and derivatives
• CentOS Stream 8
• Fedora 32
• Fedora 33
• Fedora 34

Note on RHEL 6 and derivatives: no new packages will be built from now on as the distribution is End of Life.

Installation Instructions

Instructions as in the Foreman manual:

1. Inside a Product in Foreman, create a repository that is syncing from this COPR repository.
2. When registering the client, install subscription-manager, subscription-manager-rhsm and subscription-manager-rhsm-certificates.
3. Register the system as per instruction, with subscription-manager register or an activation key.
4. Now you have two options for the client part:

• With agent: install katello-agent and start the service goferd.
• Agentless: install katello-host-tools in CentOS/RHEL 6 or katello-host-tools-tracer in CentOS/RHEL 7+ and Fedora.

Active Releases

The following unofficial repositories are provided as-is by owner of this project. Contact the owner directly for bugs or issues (IE: not bugzilla).

Release	Architectures	Repo Download
Centos-stream 8	aarch64 (39)*, x86_64 (67)*	Centos-stream 8 (80 downloads)
EPEL 6	i386 (95)*, x86_64 (93)*	EPEL 6 (103 downloads)
EPEL 7	x86_64 (184)*	EPEL 7 (125 downloads)
EPEL 8	aarch64 (64)*, x86_64 (189)*	EPEL 8 (135 downloads)

* Total number of downloaded packages.