Chapter 14. Extending Satellite Server Functionality
Red Hat Satellite Server can be extended by installing plugins. For example, you can extend hosts orchestration with the Foreman Hooks plug-in. For more information about Foreman Hooks, see the Using Foreman Hooks in Satellite Server article on the Red Hat Customer Portal. The plugins are available as RPM packages in the Red Hat repositories and the Foreman repositories.
Plugins for Satellite typically include the word
foreman in the RPM package name and the plugins for Capsule include the word
smart_proxy in the name.
The plugins provided by Red Hat can be searched and installed using the
yum command from the Satellite
The upstream Satellite plugins are available in the Foreman repositories. Each release of Foreman has a separate repository containing plugins for that release. For more information about configuring the Foreman repository, see Section 14.3, “Configuring the Foreman Repository”.
Red Hat supports the Foreman API but not the plugins installed from the Foreman repository.
14.1. Searching for Plugins
Search available plugins using the Satellite
To search upstream plugins as well, configure the Foreman repository as described in Section 14.3, “Configuring the Foreman Repository”
As root user, search for packages with "-foreman" in the package name using
Example - Searching rubygem plugin for Satellite:
# yum search rubygem-foreman Loaded plugins: product-id, search-disabled-repos, subscription-manager =================== N/S matched: rubygem-foreman ============================== tfm-rubygem-foreman-redhat_access.noarch : Foreman engine to access Red Hat knowledge base and manage support cases. tfm-rubygem-foreman-tasks.noarch : Tasks support for Foreman with Dynflow integration tfm-rubygem-foreman_abrt.noarch : Display reports from Automatic Bug Reporting Tool in Foreman tfm-rubygem-foreman_bootdisk.noarch : Create boot disks to provision hosts with Foreman output truncated
14.2. Installing Plugins
Install plugins using the Satellite CLI. Ensure you install plugins compatible with the version of Foreman on your system. You can view an RPM package description to confirm the identity of a plugin using the
yum info or
rpm -qi command.
To install upstream plugins, configure the Foreman repository as described in Section 14.3, “Configuring the Foreman Repository”.
Install the required plugin using
Example: Installing the tfm-rubygem-foreman_templates plugin:
# yum install tfm-rubygem-foreman_templates
# satellite-maintain service restart
To verify the install, use
yum to list installed plugins:
Example: Verifying rubygem-foreman plugin is installed:
# yum list installed | grep rubygem-foreman | grep foreman
You can also list Capsule plugins using
# yum list installed | grep proxy
14.3. Configuring the Foreman Repository
Configure the Foreman repository using the Satellite CLI to install the upstream plugins. After you configure the repository, you can search and install the plugins using the
yum command from Satellite CLI. The Foreman packages are not currently GPG signed.
Determine the Foreman release with
$ rpm -q foreman foreman-22.214.171.124-1.el7sat.noarch
Create an rpm configuration file.
Add the following content to the file:
[foreman-plugins] name=Foreman plugins baseurl=http://yum.theforeman.org/plugins/1.20/el7/x86_64/ enabled=1 gpgcheck=0
Replace the version number in the URL to the required Foreman release number.