Este contenido no está disponible en el idioma seleccionado.

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 CLI.

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”.

Important

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 CLI.

Note

To search upstream plugins as well, configure the Foreman repository as described in Section 14.3, “Configuring the Foreman Repository”

Procedure

  • As root user, search for packages with "-foreman" in the package name using yum search.

    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
    Copy to Clipboard Toggle word wrap

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.

Note

To install upstream plugins, configure the Foreman repository as described in Section 14.3, “Configuring the Foreman Repository”.

Procedure

  1. Install the required plugin using yum install.

    Example: Installing the tfm-rubygem-foreman_templates plugin:

    # yum install tfm-rubygem-foreman_templates
    Copy to Clipboard Toggle word wrap
  2. Restart satellite-maintain service.

    # satellite-maintain service restart
    Copy to Clipboard Toggle word wrap

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
    Copy to Clipboard Toggle word wrap
  • You can also list Capsule plugins using yum:

    # yum list installed | grep proxy
    Copy to Clipboard Toggle word wrap

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.

For additional information on foreman plugins, see the Popular Plugins and List of Plugins sections on the Foreman website.

Procedure

  1. Determine the Foreman release with rpm command.

    $ rpm -q foreman
    foreman-1.20.1.10-1.el7sat.noarch
    Copy to Clipboard Toggle word wrap
  2. Create an rpm configuration file.

    touch /etc/yum.repos.d/foreman-plugins.repo
    Copy to Clipboard Toggle word wrap
  3. 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
    Copy to Clipboard Toggle word wrap

    Replace the version number in the URL to the required Foreman release number.

Volver arriba
Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2025 Red Hat