Bookmark this page

Configure Organizations and Content Manifests

Objectives

  • Describe and configure organizations in Red Hat Satellite, and create and install content manifests for organizations.

Manage Systems by Organization and Location

Red Hat Satellite 5 supported the creation and management of multiple organizations within one Satellite installation. You could divide systems, content, and subscriptions across organizations or groups. Satellite 6 provides yet another context to manage systems by introducing locations.

Within a single Satellite installation, administrators can define multiple organizations and locations. Organizations can represent departments, such as Finance, Marketing, and Sales. Locations are physical places of system installation. Administrators can create high-level locations, such as countries. In addition, administrators can create even more specific locations, such as cities, and nest these specific locations within high-level locations to create a hierarchical location tree.

As mentioned previously, you can extend the Satellite infrastructure by adding either local or remote Capsule Servers. You can assign Capsule Servers either by organization or by location. In the following diagram, a single Satellite Server instance manages four organizations across five locations, thereby creating nine contexts to manage the systems.

Figure 1.9: Satellite 6 organizations and locations topology

This Satellite infrastructure also includes four Capsule Servers, each of which is assigned to a different geographic location. The management function resides only on the Satellite Server; content and configuration is synchronized between the Satellite Server and the Capsule Servers that are assigned to the various locations. Satellite Server manages the managed systems in each location, and fetches content and configuration from the Capsule Server of each location.

Manage Organizations

Within Satellite Server, content-related functions, such as the management of products, repositories, and content views, are specific to organizations. Therefore, administrators must complete the management of organizations early in the implementation of their Satellite infrastructure. The Satellite Server installation, by default, includes an organization called Default Organization. In Red Hat Satellite 6, you can create and manage multiple organizations and then divide and assign your Red Hat subscriptions to each organization.

Navigate to AdministerOrganizations and click New Organization to create an organization. Create a name for the organization and a unique identifier as the organization's label. Use a label to create and map certain assets, such as directories for content storage. When creating a label, use letters, numbers, underscores, and dashes, but no spaces. Additionally, you have the option to enter a description for the organization.

You can edit existing values or assign infrastructure resources that you want to add to an organization, such as networking, installation media, and kickstart templates.

To edit an organization, navigate to AdministerOrganizations and click the organization's name to edit. Alternatively, you can click Edit in the Actions column in the same row as the organization to edit. Choose the category to edit from the left side of the Organizations page. For example, click Primary to edit values such as the organization's name, label, or description.

To delete an organization, navigate to AdministerOrganizations and select Delete from the Edit list to the right of the organization's name to delete.

Manage Locations

Organizations divide Red Hat Satellite 6 resources into logical groups that are based on ownership, purpose, content, security level, or other divisions. Locations divide organizations into logical groups based on geographical location.

Navigate to AdministerLocations and click New Location. If the location is a sublocation of another location, then select that other location in the Parent field. Nested locations are convenient for creating management groups that are based on regional asset authority in your organization. Create a meaningful name for the location.

You can edit existing values or assign infrastructure resources to add to a location, such as networking, installation media, and kickstart templates.

To edit a location, navigate to AdministerLocations and click the location name to edit. Alternatively, you can click Edit in the Actions column in the same row as the location to edit. Choose the category to edit from the left side of the Locations page. For example, click Primary to edit the location's parent, name, or description.

You can delete a location if the location is not associated with any lifecycle environments or host groups. If any lifecycle environments or host groups are associated with the location to delete, then remove them before deleting the location.

Important

Do not delete the default location that was created during installation, because the default location is a placeholder for unassociated hosts in the Satellite environment. At least one location must exist in the environment at all times.

To delete a location, navigate to AdministerLocations and select Delete from the Edit list to the right of the location name to delete.

Manage Subscriptions and Content

Subscription management gives organizations a method to manage their Red Hat subscription information. Content management gives organizations a method to manage the installed software on systems.

A major role of Satellite Server is to synchronize content from the Red Hat Content Delivery Network (CDN) to provide a local software repository of Red Hat content to subscribed hosts. Content includes packages, errata updates, kickstart trees, and installation ISO images. Satellite Server access to content from the Red Hat Content Delivery Network is governed by a subscription manifest, which you can obtain through the Red Hat Customer Portal.

Create a Subscription Manifest

To create a subscription manifest, access the Red Hat Customer Portal and log in to the Red Hat account that you used to register the system to Red Hat Subscription Management. Navigate to Subscriptions in the upper-left corner of the Customer Portal. Click Subscription Allocations and then click Create New subscription allocation. Create a name for your manifest, and select a type and version of the subscription management application that you are using, such as Satellite 6.11.

As a Red Hat Satellite administrator, you can enable Simple Content Access (SCA). SCA is a new, optional feature of Red Hat Satellite 6 and Red Hat Subscription Management. This feature simplifies entitlement tasks, so that it is easier to consume the content from your Red Hat subscriptions. You enable Simple Content Access separately for each organization, allowing you to maintain some organizations with the SCA behavior and others without the behavior.

To add subscriptions to your manifest, navigate to Subscription Allocations on the Customer Portal and click the manifest name to add subscriptions to. Click Subscriptions and then click Add Subscriptions.

You see a list of your Red Hat product subscriptions. In the Entitlement Quantity field, enter the required number of entitlements for each product in the manifest.

Export a Subscription Manifest from the Customer Portal

While viewing a subscription allocation with at least one subscription, you can export a manifest from one of these places:

On the Customer Portal, navigate to Subscription Allocations and click the subscription manifest name to export. To download the subscription manifest to your local system, on either the Subscriptions or the Details tab, click Export Manifest.

When you export a subscription manifest, the Customer Portal encodes the selected subscription certificates and creates a compressed file that you can upload to the Satellite Server.

Import a Subscription Manifest to Satellite Server

After you install a subscription manifest, a Satellite Server with access to Red Hat Content Delivery Network synchronizes Red Hat content. You must assign a subscription manifest to an organization within the Satellite Server.

In the Satellite web UI, set the context to the organization to associate with the imported subscription manifest. To import the subscription manifest, navigate to ContentSubscriptions and click Manage Manifest to display the manifest dialogue for the organization.

Select the CDN Configuration tab to set the correct location for the URL in the Red Hat CDN section. The default location is https://cdn.redhat.com. For a disconnected Satellite infrastructure, set the location to the URL for your locally hosted content ISO. Our classroom is an example of a disconnected infrastructure and uses http://cdn.lab.example.com to reach the locally hosted content ISO.

Select the Manifest tab and click Browse to locate and select the manifest you downloaded from the Red Hat Customer Portal.

References

For more information, refer to the Importing a Subscription Manifest into Satellite Server section in Red Hat Satellite 6.11 Installing Satellite Server in a Disconnected Network Environment at https://access.redhat.com/documentation/en-us/red_hat_satellite/6.11/html-single/installing_satellite_server_in_a_disconnected_network_environment/index#Importing_a_Red_Hat_Subscription_Manifest_into_Server_satellite

Revision: rh403-6.11-3ad886e