Katello nightly Documentation

Content Hosts

What is a Host?

A Host is a Foreman concept that represents a server/host/system/computer (whatever you want to call it). In addition to holding facts about the system, it:

  • Stores which operating system the system should be running
  • Stores which puppet classes should be assigned
  • Stores which parameters apply to which puppet classes
  • Allows you to re-provision the machine

What are Content Hosts?

Content Hosts are the part of a host that manages Content and Subscription related tasks. As time goes on more and more of this functionality will be moved to the Host object. A Host’s Content Host:

  • Stores which Products are assigned (i.e. which Repositories will the system pull content from)
  • Initiates package install/upgrade/removal
  • Determines which errata apply to a system
  • Initiates errata installation
  • Stores details about System Purpose

How is a Content Host registered?

Subscription Manager is the client for Katello that handles registration.

Installing Subscription Manager

Depending on your Operating System, for:

  • RHEL, subscription-manager is installed by default
  • Fedora, subscription-manager is available from the Everything repo for its release: yum install subscription-manager
  • CentOS 7, subscription-manager is available in the ‘os’ repo for its release: yum install subscription-manager
  • CentOS 5/6, enable the upstream subscription-manager repo and then install subscription-manager (be sure to change ‘6’ to ‘5’ if you’re on EL5, as the version from 6 will not work):
wget -O /etc/yum.repos.d/subscription-manager.repo http://copr.fedoraproject.org/coprs/dgoodwin/subscription-manager/repo/epel-6/dgoodwin-subscription-manager-epel-6.repo

yum install subscription-manager -y

Registering with Subscription Manager

First install the bootstrap rpm from your Katello server:

rpm -Uvh http://$KATELLO_HOSTNAME/pub/katello-ca-consumer-latest.noarch.rpm

Then register:

subscription-manager register --org=Default_Organization --environment=Library

Subscription manager will prompt for your username and password. You can also specify --username $USER --password $PASS on the command line.

Registering to a Content View

To register to Content View “MyView” in a “Devel” Lifecycle Environment:

subscription-manager register --org=Default_Organization --environment=Devel/MyView

Registering without using a username and password

Activation Keys allow you to register and consume content without using a username and password. To create an Activation Key see the Activation Key Guide

Once you have created an activation key, register with:

subscription-manager register --org=Default_Organization --activationkey=$KEY_NAME

Actions with registered Content Hosts

To see the list of your Content Hosts, navigate to Hosts > Content Hosts

Content Host List

Changing the Lifecycle Environment and Content View of a Content Host:

Navigate to the Content Host Details page, Host > Content Hosts > Click the name of the desired Content Host

Content Host Details

Look in the upper right corner for the “Content Host Content”:

Content Host Content

Then select the new Lifecycle Environment you desire, select the new Content View you desire, and click save.

Assigning a Content Host to a Product

In order for a Content Host to receive package updates and access Repositories hosted on Katello, it needs to be subscribed to a product.

Navigate to Hosts > Content Hosts > Select Content Host > Subscriptions > Click the “Add” tab


Check the checkbox under the Products you want to add and select “Add Selected” in the upper right.

Note: This process is not necessary for organizations with Simple Content Access enabled.

To see existing attached Products, click the “List/Remove” tab. To remove a Product, select the checkbox under the desired Product in this list and click “Remove Selected”.

Package Management

To perform package actions on a single Content Host, navigate to: Hosts > Content Hosts > Select Content Host > Packages

Package Management

From here you can:

  • See a list of installed packages
  • Perform a yum install/update/remove of a Package or Package Group
  • Update all packages (equivalent of running ‘yum update’)

View and Install Applicable Errata

If your synced Repositories contain Errata, you can use Katello’s Errata management to track and install Errata.

Navigate to: Hosts > Content Hosts > Select Content Host > Errata

Package Management

To apply errata, search for the errata you want and select the checkbox beside each errata. Then click “Apply Selected” at the top right.

The “Show From” filters what applicable errata to show:

  • Current Environment - Shows only Applicable Errata available in the Host’s Content View & Lifecycle Environment.
  • Previous Environment - Shows Applicable Errata that are available from the Host’s Content View but in the previous Lifecycle Environment. Promoting the Content View Version from that previous Lifecycle Environment to the current Lifecycle Environment for this Host would cause all Applicable Errata shown to then be available.
  • Library Synced Content - Shows Applicable Errata which have been synced to the Library. This shows you what is applicable even when the Errata have not been published into a Content View. All applicable Errata are shown regardless of availability to the Content Host.

Change Host Collection Asssignments

To change Host Collection assignments for a Content Host, navigate to: Hosts > Content Hosts > Select Content Host > Host Collections

Host Collections

Set System Purpose attributes

To set System Purpose attributes for a host, Navigate to the Content Host Details page, Host > Content Hosts > Click the name of the desired Content Host. You can edit Service Level, Role, Usage Type, and Add-ons from the System Purpose section.

System Purpose

Bulk Actions

Katello provides the ability to perform actions on many Content Hosts at once such as:

  • Package installation/upgrade/removal
  • Listing and applying applicable errata
  • Assigning Host Collections
  • Changing Lifecycle Environment and Content View assignments

In order to use the bulk actions, perform whatever search you desire and select which Content Hosts you want to modify. If you want to select all Content Hosts from a search result, click the ‘checkbox’ above the table:

Host Collections

This will select all Content Hosts on that page (only the ones that are visible). To select all that correspond to that search query, notice a bar has now appeared:

Host Collections

Next select the ‘Bulk Actions’ button in the top right.

From here you can select the tab corresponding to any action you wish to perform.

Setting System Purpose attributes via Bulk Actions

Select the Content Hosts that you wish to change the System Purpose attributes on.

Next select the ‘Bulk Actions’ button in the top right, and choose ‘Manage System Purpose’

In the following screen, a banner at the top displays how many Content Hosts will be affected by the change. Select the dropdown next to the attributes you want to change, select the desired value and when satisfied with the options, click the ‘Assign’ button.

Bulk System Purpose


  • If “No change” is selected, the value will remain what it was.

  • If “None (Clear)” is selected, any existing values will be erased.

After clicking ‘Assign’ this will transition you to the task details.

Foreman 3.11.1 has been released! Follow the quick start to install it.

Foreman 3.10.0 has been released! Follow the quick start to install it.