Content Hosts

The content hosts page can be accessed via the hosts menu:

Hosts > Content Hosts

The content hosts page forms a part of orcharhino’s content management.

The content hosts page lists all content hosts, that is, those hosts that are registered with orcharhino’s content management (or at least intended for this registration). Content hosts are always associated with exactly one content view and exactly one lifecycle environment.

Content hosts can be created by registering an existing (plain) host (using an activation key), or by creating new hosts belonging to a host group associated with an activation key.

The content hosts page takes on a similarly central role for orcharhino’s content management, as does the all hosts page for host deployment. That is, it forms the central hub from which to manage content hosts.


The content hosts page includes a Register Content Host button, a Select Action menu, and a list of content hosts currently managed by orcharhino:

List of content hosts
  • The Register Content Host button (1) displays instructions on how to register an existing host with orcharhino’s content management.

  • The Select Action drop-down menu (2) allows you to perform various bulk actions.

  • Clicking on the name of a content host in the Name column (4) of the list of content hosts (3) will take you to the content host overview page for that content host.

  • The various links from the Installable Updates column (5) of the list of content hosts (3) will take you to the content host overview page for that content host with the Errata tab selected.

Performing Bulk Actions

It is possible to perform actions on several content hosts at once, by selecting the desired content hosts from the first column of the list of content hosts, and using the Select Action drop down menu to select the desired action, as follows:

List available bulk actions
  • The checkbox in the top left corner (1) of the list of content hosts can be used to select (or deselect) all content hosts at once.

  • Clicking on the desired action will open a window with further options for that action. (See below for a detailed description of each action).

  • The Manage Repository Sets option allows you to enable/disable any repositories that the selected content hosts are registered for.

  • The Remove Hosts action will completely delete the host both as a content host, as well as from the hosts page and the underlying compute resource. You will be asked to confirm this action.


When selecting Change Host Collections from the Select Action menu, the host collection membership management window will open:

Host collections
  • Select any host collections you want the selected content hosts added to (or removed from) via the checkboxes provided (1), then use the Add To button (2) (or the Remove From button (3)) to perform the corresponding action. You will be asked to confirm the action, and a pop up message will inform you whether it was successful.

  • The Done button (4) will close the window (without performing any actions).


When selecting Manage Packages from the Select Action menu, the update packages window will open: Refer to the RPM packages and Deb packages pages for more information.

Package and by extension errata actions can generally be performed in one of two ways: via the Katello agent or by using the remote execution plugin. Buttons that perform such actions include a drop down menu to facilitate this choice. If the button is clicked directly, it uses the remote execution plugin by default.

Managing packages
  • The Update All Packages action (1), does exactly what it says (and currently only works via the Katello agent).

  • The Install (2), Update (3), and Remove (4) actions require you to enter a list of package names in the provided input field first.

  • Selecting the Package Group checkbox (5) will allow you to perform actions on package groups rather than individual packages. Note that the "package group" concept only exists for RPM packages.

  • The Done button (6) will close the window (without performing any actions).


When selecting Manage Errata from the Select Action menu, the content host errata management window will open:

Package and by extension errata actions can generally be performed in one of two ways: via the Katello agent or by using the remote execution plugin. Buttons that perform such actions include a drop down menu to facilitate this choice. If the button is clicked directly, it uses the remote execution plugin by default.

Managing errata
  • Select any errata you want to install via the checkboxes (1) provided, then use the Install Selected button (2) to schedule the action.

  • The Done button (3) will close the window (without performing any actions).


When selecting Change Lifecycle Environment from the Select Action menu, the content host bulk content window will open:

Changing lifecycle environment
  • First, choose the desired lifecycle environment by selecting the relevant checkbox from the lifecycle environment path (1) displayed. Next, choose a content view from the drop down list (2). (It will only include content views with a version published to the selected lifecycle environment). Finally, use the Assign button (3) to make your changes.

  • The Done button (4) will close the window (without performing any actions).


When selecting Manage Subscriptions from the Select Action menu, the content host bulk subscriptions window will open:

Advanced subscriptions management is generally only needed for Red Hat and SUSE products. Other products generally have an unlimited number of subscriptions available and each subscribed content host will automatically be given one.

Managing subscriptions
  • The Auto-Attach button (1) will add subscriptions to any products that lack subscriptions (provided there are subscriptions available).

  • Alternatively you can select solely those subscriptions you want (2) and use the Add Selected button (3) (or the Remove Selected button (4)).

  • The Done button (5) will close the window (without performing any actions).

Viewing a Content Host

The content host overview page can be accessed via the list of content hosts:

Hosts > Content Hosts >> list of content hosts > Name column > name of a content host

The content host overview page is organized into tabs and drop down menus as follows:

Viewing a content host
  • The Content Hosts link (1) will take you back to the content hosts page.

  • The drop down link (2) will allow you to select a different content host from a list.

  • The Unregister Host button (3) will offer a choice to either remove the content host being viewed from orcharhino’s content management (but preserve it on the hosts page, or to completely remove it (both from orcharhino’s content management, as well as the hosts page and the underlying compute resource).

  • The various tabs (4) are discussed below.


The Details tab lists general content management related information on the content host:

Details of a content host
  • Most fields can be edited using the edit buttons provided.

  • The Subscriptions area (2) lists details on subscriptions.

  • The Installed Products area (4) will list any products installed on the content host.

  • The Installable Errata area (5) will show you if (and how many) errata are installable.

  • The Content Host Content area (6) will show what content view and lifecycle environment the content host is in.

  • The Content Host Status area (7) will show you what activation keys are in use and when the content host last checked in with orcharhino.


The Provisioning Details tab lists information on host provisioning of the content host itself (as opposed to the provisioning of content on that host):

Viewing provisioning details of a content host
  • This tab includes a link to the host overview page (1) for the host, which is a different page than the content host overview page you are on, as well as the host group (2) that the host is in.


The Subscriptions tab (with Subscriptions selected from the drop down menu) lists any subscriptions available to the content host:

Advanced subscriptions management is generally only needed for Red Hat and SUSE products. Other products generally have an unlimited number of subscriptions available and each subscribed content host will automatically be given one.

Viewing subscriptions of a content host
  • The Run Auto-Attach link (1) will seek to give the content host subscriptions for any products lacking them (as long as there are subscriptions available).

  • Switch between the List/Remove and Add tabs (2) depending on what you want to do.

  • Select any subscriptions you want to perform an action on via the checkboxes provided (3), then use the Remove Selected button (4) (or Add Selected depending on what tab you are on) to perform the corresponding action.

The Subscriptions tab (with Events selected from the drop down menu) lists any subscription related events:

Viewing subscription events of a content host

The Host Collections tab will let you change what host collections the content host is in:

Managing host collection mememberships of a content host
  • Switch between the List/Remove and Add tabs (1) depending on what you want to do.

  • Select any host collections you want to perform an action on using the checkboxes provided (2), then use the Remove Selected button (3) (or Add Selected depending on what tab you are on) to perform the corresponding action.


The Tasks tab will list any tasks related to the content host being viewed:

Viewing tasks of a content host

RPM Package Actions

The Packages tab (with Yum Actions selected from the drop down menu) allows you to install, update, or remove RPM packages from the content host:

Package and by extension errata actions can generally be performed in one of two ways: via the Katello agent or by using the remote execution plugin. Buttons that perform such actions include a drop down menu to facilitate this choice. If the button is clicked directly, it uses the remote execution plugin by default.

Packages actions with Yum
  • Select the action you want to perform from the Package Actions drop down menu (1). (Note that the package group concept is only meaningful for RPM packages). Also, enter the name of the package you want the action performed for in the input field (2). Finally, click the Perform button (3) to perform the action.

  • The Update All Packages button (4) will update all packages installed on the content host to the newest available version.

RPM Package List

The Packages tab (with Installed selected from the drop down menu) lists all installed packages, and allows for targeted removal:

Installed packages (RPM)
  • Select any packages you want removed via the checkboxes (1), then use the Remove Selected button (2) to start the relevant task.

The Packages tab (with Applicable selected from the drop down menu) lists all available upgrades for packages installed on the content host:

List available upgrades of a content host
  • Select any packages you want to upgrade using the checkboxes provided (1), then use the Apply Selected button (2) to start the upgrade.

  • The Update All Packages button (3) will update all the packages from the list.

Debian Package Actions

The Deb Packages tab (with Apt Actions selected from the drop down menu) allows for installation, update, or removal of deb packages on hosts with Debian based distributions. This tab offers the same functionality as the corresponding tab for RPM packages.

Package actions with Deb

Package actions for Debian based distributions are always performed via remote execution.

Debian Package List

The Installed view of the Deb Packages tab lists packages that are installed on the content host. They can be selected and deinstalled.

Installed packages (Deb)

The Errata tab lists any installable errata (that is errata that apply to the content host, and are present in its lifecycle environment and content view):

Package and by extension errata actions can generally be performed in one of two ways: via the Katello agent or by using the remote execution plugin. Buttons that perform such actions include a drop down menu to facilitate this choice. If the button is clicked directly, it uses the remote execution plugin by default.

Errata management for a content host
  • Select a different lifecycle environment from the drop down menu (1) to see errata that apply to the host (even if they are not yet installable).

  • Select any errata you want to apply using the checkboxes provided (2), then use the Apply Selected button (3) to schedule the relevant task.

  • The Recalculate button (4) will launch a Task to recalculate what errata are applicable to the content host being viewed.


The Traces tab lists any services (on the content host being viewed) that need to be restarted as a result of any package actions performed by orcharhino:

Service management of a content host
  • Select any (generally all) services from the list using the checkboxes (1), then use the Restart Selected button (2) to restart them via remote execution.


The Repository Sets tab lists any repositories that the content host being viewed is registered for.

Managing repositories of a content host
  • Selecting the Show All checkbox (1) displays all repositories in the list as opposed to only the ones the content host is being subscribed to.

  • Selecting the Limit to Environment checkbox (2) filters the repositories in the list using the lifecycle environment and content view of the content host being viewed.

  • You can also enable/disable any repositories by selecting the desired repositories via the checkboxes provided (3) and choosing the desired action form the Select Action drop down menu (4).