Managing host content settings and system purpose

You can set which content source and repositories a host uses and choose module streams for software versions. You can configure system purpose so subscription usage on the host reflects its role and usage.

Editing the system purpose of a host by using orcharhino management UI

You can edit the system purpose attributes for your Red Hat Enterprise Linux host from the orcharhino management UI. Setting system purpose defines the intended use of the system on your network and improves reporting accuracy in the Subscriptions service of the Red Hat Hybrid Cloud Console.

Prerequisites
  • The host that you want to edit must be registered with the subscription-manager.

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

  2. Click the name of the host you want to modify.

  3. On the Overview tab, click Edit on the System purpose card.

  4. Select the system purpose attributes for your host.

  5. Click Save.

Editing the system purpose of a host by using Hammer CLI

You can edit the system purpose attributes for your Red Hat Enterprise Linux host by using Hammer CLI. Setting system purpose defines the intended use of the system on your network and improves reporting accuracy in the Subscriptions service of the Red Hat Hybrid Cloud Console.

Prerequisites
  • The host that you want to edit must be registered with the subscription-manager.

Procedure
  1. Log in to the host and edit the required system purpose attributes. For example, set the usage type to Production and the role to Red Hat Enterprise Linux Server.

    $ subscription-manager syspurpose set usage 'Production'
    $ subscription-manager syspurpose set role 'Red Hat Enterprise Linux Server'
  2. Verify the system purpose attributes for this host:

    $ subscription-manager syspurpose

Editing the system purpose of multiple hosts

You can edit the system purpose attributes of multiple Red Hat Enterprise Linux hosts at once from the orcharhino management UI. Setting system purpose defines the intended use of the systems on your network and improves reporting accuracy in the Subscriptions service of the Red Hat Hybrid Cloud Console.

Prerequisites
  • The hosts that you want to edit must be registered with the subscription-manager.

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

  2. Select the Red Hat Enterprise Linux hosts that you want to edit.

  3. Click the main menu icon and select Manage content > System purpose.

  4. Select the system purpose attributes that you want to assign to the selected hosts. You can select one of the following values:

    • A specific attribute to set an all selected hosts.

    • No Change to keep the attribute set on the selected hosts.

    • (unset) to clear the attribute on the selected hosts.

  5. Click Save.

Changing a module stream for a host

If you have a host running Red Hat Enterprise Linux 8, you can modify the module stream for the repositories you install. You can enable, disable, install, update, and remove module streams from your host in the orcharhino management UI.

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

  2. Click the name of the host you want to modify.

  3. Click the Content tab, then click the Module streams tab.

  4. Click the vertical ellipsis next to the module and select the action you want to perform. You get a REX job notification once the remote execution job is complete.

Enabling custom repositories on hosts

You can enable custom repositories on a host from the orcharhino management UI. This allows the host to install packages or consume other content from repositories you have added to orcharhino.

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

  2. Select the Content tab, then select Repository sets.

  3. From the dropdown, you can filter the Repository type column to Custom.

  4. Select the desired number of repositories or click the Select All checkbox to select all repositories, then click the vertical ellipsis, and select Override to Enabled.

Changing the content source of a host

You can change the content source of a host so that the host consumes content from a different orcharhino Proxy. This helps you balance load or point the host to a closer or preferred content source.

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

  2. Click the name of the host you want to modify.

  3. Click the vertical ellipsis icon next to the Edit button and select Change content source.

  4. Select Content Source, Lifecycle Content View, and Content Source from the lists.

  5. Click Change content source.

    Some lifecycle environments can be unavailable for selection if they are not synced on the selected content source.

  6. You can complete the content source change by using remote execution or manually.

    To update configuration on host using remote execution, click Run job invocation. For more information about running remote execution jobs, see Configuring and setting up remote jobs in Managing Hosts.

    To update the content source manually, execute the autogenerated commands from Change content source on the host.

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