Configuring host collections

A host collection is a group of content hosts. This feature enables you to perform the same action on multiple hosts at once. These actions can include the installation, removal, and update of packages and errata, change of assigned lifecycle environment, and change of content view. You can create host collections to suit your requirements, and those of your company. For example, group hosts in host collections by function, department, or business unit.

Creating a host collection

The following procedure shows how to create host collections.

Procedure
  1. In the orcharhino management UI, navigate to Hosts > Host Collections.

  2. Click New Host Collection.

  3. Add the Name of the host collection.

  4. Clear Unlimited Content Hosts, and enter the desired maximum number of hosts in the Limit field.

  5. Add the Description of the host collection.

  6. Click Save.

CLI procedure
  • To create a host collection, enter the following command:

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

Cloning a host collection

The following procedure shows how to clone a host collection.

Procedure
  1. In the orcharhino management 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.

Removing a host collection

Use the following procedure to remove a host collection from orcharhino.

Procedure
  1. In the orcharhino management 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.

Adding a host to a host collection

You can add a host to a host collection in the orcharhino management UI.

Prerequisites

A host must be registered to orcharhino to add it to a Host Collection.

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

Procedure
  1. In the orcharhino management 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.

CLI procedure
  • To add a host to a host collection, enter the following command:

    # hammer host-collection add-host \
    --host-ids My_Host_ID_1 \
    --id My_Host_Collection_ID

Removing a host from a host collection

The following procedure shows how to remove hosts from host collections.

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

Procedure
  1. In the orcharhino management 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.

Adding content to a host collection

These steps show how to add content to host collections in orcharhino.

Adding packages to a host collection

The following procedure shows how to add packages to host collections.

Prerequisites
  • The content to be added should be available in one of the existing repositories or added prior to this procedure.

  • Content should be promoted to the environment where the hosts are assigned.

Procedure
  1. In the orcharhino management UI, navigate to Hosts > Host Collections.

  2. Select the host collection where the package should be added.

  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.

Viewing installed packages

Use the following procedure to view the installed packages of a host.

Procedure
  1. In the orcharhino management 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.

Upgrading a package

Use the following procedure to view the installed packages of a host.

Procedure
  1. In the orcharhino management 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.

Removing a package from a host

Use the following procedure to remove an installed package from a host.

Procedure
  1. In the orcharhino management 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.

Adding errata to a host collection

The following procedure shows how to add errata to host collections.

Prerequisites
  • The errata to be added should be available in one of the existing repositories or added prior to this procedure.

  • Errata should be promoted to the environment where the hosts are assigned.

Procedure
  1. In the orcharhino management UI, navigate to Hosts > Host Collections.

  2. Select the host collection where the errata should be added.

  3. On the Collection Actions tab, click Errata Installation.

  4. Select the errata you want to add to the host 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.

Adding errata to a single host

Use the following procedure to add errata to a host.

Procedure
  1. In the orcharhino management UI, navigate to Hosts > All Hosts.

  2. Select the host you want to add errata to.

  3. Click Content and select the Errata tab.

  4. Select the errata you want to add to the host, or select the checkbox at the top of the list to add all installable errata. Click the checkbox next to any errata you wish to remove from a full list.

  5. Using the vertical ellipsis icon next to the errata you want to add 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.

Applying installable errata

Use the following procedure to view a list of installable errata and select errata to install.

Procedure
  1. In the orcharhino management UI, navigate to Hosts > All Hosts and select the host you require.

  2. If there are errata associated with the host, they are displayed in an Installable Errata card on the new Host page.

  3. On the Content tab, Errata displays installable errata for the chosen host.

  4. Click the checkbox for any errata you wish to install.

  5. Using the vertical ellipsis icon next to the errata you want to add to the host, select Apply via Remote Execution to use Remote Execution. Select Apply via customized remote execution if you want to customize the remote execution.

  6. Click Submit.

Filter errata by type and severity

Use the following procedure to filter errata by type or severity.

Procedure
  1. In the orcharhino management 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.

Removing content from a host collection

The following procedure shows how to remove packages from host collections.

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.

Changing the lifecycle environment or content view of a host collection

The following procedure shows how to change the assigned lifecycle environment or content view of host collections.

Procedure
  1. In the orcharhino management 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.

    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.

The text and illustrations on this page are licensed by ATIX AG under a Creative Commons Attribution–Share Alike 3.0 Unported ("CC-BY-SA") license. This page also contains text from the official Foreman documentation which uses the same license ("CC-BY-SA").