Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.

Chapter 18. Configuring host collections


To group hosts and perform the same action on them at once, you can use host collections. Available actions include managing packages, applying errata, or assigning content view environments. Group hosts in a way that suits your workflow, such as by function, department, or business unit.

18.1. Creating a host collection by using Satellite web UI

You can create a host collection from the Satellite web UI to group hosts and perform bulk actions such as package updates or errata installation.

Prerequisites

  • Your user account has a role that grants the create_host_collections permission.

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collections.
  2. Click New Host Collection.
  3. Add the Name of the host collection.
  4. Clear Unlimited Hosts, and enter the desired maximum number of hosts in the Limit field.
  5. Add the Description of the host collection.
  6. Click Save.

18.2. Creating a host collection by using Hammer CLI

You can create a host collection by using Hammer CLI to group hosts and perform bulk actions such as package updates or errata installation.

Procedure

  • Create a host collection:

    $ hammer host-collection create \
    --name "My_Host_Collection" \
    --organization "My_Organization"

18.3. Cloning a host collection

You can clone a host collection to create a new collection with the same settings and membership, then adjust it as needed.

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collections.
  2. On the left hand panel, click the host collection you want to clone.
  3. Click Copy Collection.
  4. Specify a name for the cloned collection.
  5. Click Create.

18.4. Removing a host collection

You can remove a host collection from Satellite when you no longer need that grouping. The hosts in the collection are not deleted.

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collections.
  2. Select the host collection that you want to remove.
  3. Under Select Action, click Remove.
  4. Click Delete to remove the host collection.

18.5. Adding a host to a host collection by using Satellite web UI

You can add a host to a host collection from the Satellite web UI.

Note that if you add a host to a host collection, the Satellite auditing system does not log the change.

Prerequisites

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts.
  2. Click the name of the host you want to modify.
  3. In the Host collections card, click the vertical ellipsis and select Add host to collections.
  4. Select the host collection.
  5. Click Add.

18.6. Adding a host to a host collection by using Hammer CLI

You can add a host to a host collection by using Hammer CLI.

Note that if you add a host to a host collection, the Satellite auditing system does not log the change.

Prerequisites

Procedure

  • Add a host to your host collection:

    $ hammer host-collection add-host \
    --host-ids My_Host_ID \
    --id My_Host_Collection_ID

You can add multiple hosts to a host collection at once from the Satellite web UI.

Note that if you add a host to a host collection, the Satellite auditing system does not log the change.

Prerequisites

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collections.
  2. Select the host collection where the host should be added.
  3. On the Hosts tab, select the Add subtab.
  4. Select the hosts to be added from the table and click Add Selected.

18.8. Adding hosts to a host collection in bulk by using Hammer CLI

You can add multiple hosts to a host collection at once by using Hammer CLI.

Note that if you add a host to a host collection, the Satellite auditing system does not log the change.

Prerequisites

Procedure

  • Add multiple hosts to a host collection:

    $ hammer host-collection add-host \
    --host-ids My_Host_ID_1,My_Host_ID_2 \
    --id My_Host_Collection_ID

18.9. Removing a host from a host collection

Remove hosts from a host collection to update membership without deleting the host from Satellite.

Note that if you remove a host from a host collection, the host collection record in the database is not modified so the Satellite auditing system does not log the change.

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collections.
  2. Choose the desired host collection.
  3. On the Hosts tab, select the List/Remove subtab.
  4. Select the hosts you want to remove from the host collection and click Remove Selected.

18.10. Managing host content with host collections

You can use host collections in Satellite to install packages, apply errata, or manage other content across all hosts in the collection.

18.10.1. Installing packages on hosts in a host collection

You can install packages on all hosts in a host collection in one action.

Prerequisites

  • The packages or package groups you want to install should be available in one of the existing repositories or added before this procedure.
  • Content should be promoted to the environment where the hosts are assigned.

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collections.
  2. Select the host collection on which you want to install the package.
  3. On the Collection Actions tab, click Package Installation, Removal, and Update.
  4. To update all packages, click Update All Packages to use the default method. Alternatively, select the drop-down icon to the right of the button to select a method to use. Selecting the via remote execution – customize first menu entry will take you to the Job invocation page where you can customize the action.
  5. Select the Package or Package Group radio button as required.
  6. In the field provided, specify the package or package group name. Then click:

    • Install – to install a new package using the default method. Alternatively, select the drop-down icon to the right of the button and select a method to use. Selecting the via remote execution – customize first menu entry will take you to the Job invocation page where you can customize the action.
    • Update – to update an existing package in the host collection using the default method. Alternatively, select the drop-down icon to the right of the button and select a method to use. Selecting the via remote execution – customize first menu entry will take you to the Job invocation page where you can customize the action.

18.10.2. Viewing installed packages

You can view the installed packages on a host to see what is present or to plan package or errata actions.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts and select the name of the host.
  2. On the Content tab, Packages displays a list of installed packages.
  3. To see details of a package, select that package.

    • The Details tab displays details of the selected package.
    • The Files tab lists the files contained in the package.
    • The Dependencies tab lists the dependencies of the package.
    • The Repositories tab lists the repositories that contain the selected package.
  4. You can filter these by Library or Default organization.

18.10.3. Upgrading a package

You can upgrade an installed package on a host to a newer version from the Satellite web UI to get bug fixes or new features.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts and select the name of the host that contains the package you want to upgrade.
  2. On the Content tab, select Packages.

    The Status column displays whether the package is upgradable or Up-to date. You cannot update an up-to-date package.

  3. From the list of packages, choose the package you want to upgrade and click the vertical ellipsis icon at the end of the line.
  4. Choose the Apply via Remote Execution to use Remote Execution, or Apply via customized remote execution if you want to customize the remote execution, for example, to set a time when it should be applied.
  5. Click Submit to upgrade the package.

18.10.4. Removing a package from a host

To uninstall software or resolve dependency issues, you can remove a package from a host.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts and select the host containing the package you want to remove.
  2. On the Content tab, select Packages.
  3. Click the vertical ellipsis icon at the end of the line for the package you want to remove, and choose the Remove option.
  4. Click Submit.

18.10.5. Applying errata to hosts in a host collection

You can apply errata to all hosts in a host collection in one action using remote execution.

Prerequisites

  • The errata to be applied should be available in one of the existing repositories, or the repository should be enabled on the host before this procedure.
  • Errata should be promoted to the environment where the hosts are assigned.

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collections.
  2. Select the host collection where the errata should be applied.
  3. On the Collection Actions tab, click Errata Installation.
  4. Select the errata you want to apply to the hosts in the collection and click Install Selected to use the default method. Alternatively, select the drop-down icon to the right of the button to select a method to use. Selecting the via remote execution – customize first menu entry takes you to the Job invocation page where you can customize the action.

18.10.6. Applying errata to a host

To patch security vulnerabilities and bugs, you can apply errata to a host.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts.
  2. Select the host you want to apply errata to.
  3. Click Content and select the Errata tab.
  4. Select the errata you want to apply to the host, or select the checkbox at the top of the list to apply all installable errata. Click the checkbox next to any errata you want to remove from a full list.
  5. Using the vertical ellipsis icon next to the errata you want to apply to the host, select Apply via Remote Execution to use Remote Execution, or select Apply via customized remote execution if you want to customize the remote execution.
  6. Click Submit.

18.10.7. Applying errata to hosts by using Satellite web UI

You can use the Satellite web UI to review and apply errata to hosts so that security and bugfix updates are installed on selected hosts.

Procedure

  1. In the Satellite web UI, navigate to Content > Content Types > Errata.
  2. Click the name of an erratum you want to apply.
  3. On the to Content Hosts tab, select all hosts that you want to apply errata to.
  4. Click Apply to Hosts and click Confirm.

Verification

  1. In the Satellite web UI, navigate to Monitor > Jobs.
  2. Select the most recent Install errata job.
  3. Verify that the remote execution to apply errata to all selected host succeeded.

18.10.8. Filter errata by type and severity

You can filter errata by type or severity to focus on security updates, bug fixes, or enhancements when planning or applying errata.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts and click the name of the host.
  2. On the Contents tab, Errata lists the errata associated with the selected host.
  3. Click Type to filter errata by type.
  4. You can filter to display errata of type Security, Bugfix, or Enhancement
  5. Click Severity to filter by severity.
  6. You can filter to display errata of severity N/A, Low, Moderate, Important, or Critical.
  7. To deselect your choice, return to the list of options and click the selected option again.

    You can also use the Errata card on the host page to pre-filter errata for type before display.

18.10.9. Viewing errata by applicable and installable

You can view errata by applicable or installable status to see which updates affect your hosts and which are ready to install.

Procedure

  1. In the Satellite web UI, navigate to Hosts > All Hosts.
  2. Select the host name.
  3. Click the Overview tab. Under the Errata card, there are two types of Errata.
  4. Click Applicable to view errata that apply to a package installed on your host.
  5. Click Installable to view applicable errata that are available in the content view environments of the host.
  6. Click the link with number of errata under each type to see the list of all available errata of that type.
  7. Click security advisories, bug fixes, or enhancements under each type to view only the respective type of errata.

18.10.10. Generating a report for installable and applicable errata

You can generate a report of installable or applicable errata on hosts to review update status across your environment before applying errata.

Procedure

  1. In the Satellite web UI, navigate to Monitor > Reports > Report Templates.
  2. Click Generate for the Host – Applicable Errata template.
  3. Optional: To schedule a report, click the calendar icon to the right of the Generate at field and choose the date and time you want for the generated report.
  4. Optional: To send a report to an e-mail address, select the Send report via e-mail checkbox, and in the Deliver to e-mail addresses field, enter the required e-mail address.
  5. Optional: Select another Output format for the report file. The default is CSV.
  6. Optional: To limit the report only to hosts found by the search query, click on Hosts filter and search from the available list of hosts. For a report on all available hosts, leave Hosts filter empty.
  7. Optional: To limit the report only to errata found by the search query, click on Errata filter and search from the available list of errata. For a report on all available errata, leave Errata filter empty.
  8. From the Installability list, select one of these options:

    • Applicable to show all applicable errata.
    • Installable to limit the report exclusively to errata that are accessible in the content view environments of your host that may be installed.
  9. Click Generate. Your browser automatically downloads the report file after Satellite creates it. If you have selected the Send report via e-mail option, the report is sent to your e-mail address.

18.10.11. Removing content from hosts in a host collection

Remove packages or package groups from hosts in a host collection to keep collection content in sync with your requirements.

Procedure

  1. Click Hosts > Host Collections.
  2. Click the host collection where the package should be removed.
  3. On the Collection Actions tab, click Package Installation, Removal, and Update.
  4. Select the Package or Package Group radio button as required.
  5. In the field provided, specify the package or package group name.
  6. Click Remove to remove the package or package group using the default method. Alternatively, select the drop-down icon to the right of the button and select a method to use. Selecting the via remote execution - customize first menu entry will take you to the Job invocation page where you can customize the action.

You can change the lifecycle environment or content view assigned to a host collection so that all hosts in the host collection consume content from the new lifecycle environment or content view.

Procedure

  1. In the Satellite web UI, navigate to Hosts > Host Collection.
  2. Selection the host collection where the lifecycle environment or content view should be changed.
  3. On the Collection Actions tab, click Change assigned Lifecycle Environment or Content View.
  4. Select the lifecycle environment to be assigned to the host collection.
  5. Select the required content view from the list.
  6. Click Assign.

    Note

    The changes take effect in approximately 4 hours. To make the changes take effect immediately, on the host, enter the following command:

    # subscription-manager refresh

    You can use remote execution to run this command on multiple hosts at the same time.

Red Hat logoGithubredditYoutubeTwitter

Lernen

Testen, kaufen und verkaufen

Communitys

Über Red Hat

Wir liefern gehärtete Lösungen, die es Unternehmen leichter machen, plattform- und umgebungsübergreifend zu arbeiten, vom zentralen Rechenzentrum bis zum Netzwerkrand.

Mehr Inklusion in Open Source

Red Hat hat sich verpflichtet, problematische Sprache in unserem Code, unserer Dokumentation und unseren Web-Eigenschaften zu ersetzen. Weitere Einzelheiten finden Sie in Red Hat Blog.

Über Red Hat Dokumentation

Legal Notice

Theme

© 2026 Red Hat
Nach oben