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. (See also: Content Management Guide).

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 (see also Content Views and Lifecycle Environments).

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. (See also Activation Keys and/or Host Groups).

The content hosts page takes on a similarly central role for orcharhino’s content management, as the all hosts page (see also All Hosts) does 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. (See Performing Bulk Actions below).
  • 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. (See Viewing a Content Host below).
  • 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. (See Viewing a Content Host below).

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 check box 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. (See also: Activation Keys).
  • 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 (see also Host Collections):

Bulk action: Host collections
  • Select any host collections you want the selected content hosts added to (or removed from) via the check boxes 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 (see also RPM Packages and/or Deb Packages):

Note

Package (and by extension errata) actions can generally be performed in one of two ways: Via the Katello agent, or using the remote execution plugin (see also Remote Execution Guide). To facilitate this choice, buttons that perform such actions will include a drop down menu. (If the button is clicked directly it will use the remote execution plugin by default).

Bulk action: Manage 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. (See also: 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 (see also Errata):

Note

Package (and by extension errata) actions can generally be performed in one of two ways: Via the Katello agent, or using the remote execution plugin (see also Remote Execution Guide). To facilitate this choice, buttons that perform such actions will include a drop down menu. (If the button is clicked directly it will use the remote execution plugin by default).

Bulk action: Manage errata
  • Select any errata you want to install via the check boxes (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 (see also Lifecycle Environments):

Bulk action: Change lifecycle environment
  • First choose the desired lifecycle environment by selecting the relevant check box from the lifecycle environment path (1) displayed. Next choose a content view (see also Content Views) 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 Sucscriptions from the Select Action menu, the content host bulk subscriptions window will open (see also Subscriptions and/or Products):

Note

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

Bulk action: Manage subscription
  • The Auto-Attach button (1) will add subscriptions to any products that lack subscriptions (provided there are subscriptions available).
  • Alternatively you can select just 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). (See also: Red Hat Repositories).

Viewing a Content Host

The content host overview page (for a given content host) 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 (for a given content host) 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, see also All Hosts), 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:

Show details about a content host
  • Most fields can be edited using the edit buttons (edit_button) provided.
  • The Subscriptions area (2) lists details on subscriptions. (See also: Subscriptions).
  • The Installed Prodcuts area (4) will list any products installed on the content host. (See also: Products).
  • The Installable Errata area (5) will show you if (and how many) errata are installable. (See also: Errata).
  • The Content Host Content area (6) will show what content view and lifecycle environment the content host is in. (See also: Content Views and Lifecycle Environments).
  • The Content Host Status area (7) will show you what activation key(s) are in use and when the content host last checked in with orcharhino. (See also: Activation Keys).

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

Viewing provisioning details of a content host
  • In particular this tab includes a link to the host overview page (1) for the host (see also Viewing a Host, and note that this 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 (see also Host Groups).

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

Note

Advanced subscription management is generally only important for Red Hat content. For most other content, content hosts will simply use one of an unlimited number of subscriptions for each product. (See also: Red Hat Repositories and/or Subscriptions).

Viewing subscriptons 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 check boxes 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) (see also Subscriptions) lists any subscription related events:

Viewing subscription events of a content host

The Host Collections tab (see also Host Collections) 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 check boxes 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 (see also Tasks) will list any tasks related to the content host being viewed:

Viewing tasks of a content host

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

Note

Package (and by extension errata) actions can generally be performed in one of two ways: Via the Katello agent, or using the remote execution plugin (see also Remote Execution Guide). To facilitate this choice, buttons that perform such actions will include a drop down menu. (If the button is clicked directly it will use 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.

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 check boxes (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 check boxes 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.

The Deb Packages tab (with Apt Actions selected from the drop down menu) (see also Deb Packages) allows for installation, update, or removal of packages on hosts with Debian based distributions. The facilities on this tab are used in the same way as on the corresponding tab for RPM Packages.

Package actions with Deb

Note

Package actions for Debian based distributions are always performed via remote execution. (See also Remote Execution Guide).

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 (see also Errata) lists any installable errata (that is errata that apply to the content host, and are present in it’s lifecycle environment + content view):

Note

Package (and by extension errata) actions can generally be performed in one of two ways: Via the Katello agent, or using the remote execution plugin (see also Remote Execution Guide). To facilitate this choice, buttons that perform such actions will include a drop down menu. (If the button is clicked directly it will use the remote execution plugin by default).

Errata management for a content host
  • Select a different lifecycle environment (see also: Lifecycle Environments) 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 check boxes 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 check boxes (1), then use the Restart Selected button (2) to restart them via remote execution. (See also: Remote Execution Guide).

The Repository Sets tab lists any repositories that the content host being viewed is registered for (see also: Activation Keys).

Managing repositories of a content host
  • Selecting the Show All check box (1) will cause all of orcharhino’s repositories to be displayed in the list (not just those the content host being viewed is subscribed to).
  • Selecting the Limit to Environment check box (2) will filter 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 check boxes provided (3) and choosing the desired action form the Select Action drop down menu (4).