Creating and managing manifests for a connected Satellite Server

Subscription Central 2021

Red Hat Customer Content Services

Abstract

This guide describes how to create, export, delete, and modify a manifest for a Red Hat Satellite Server on a connected network. Manifests enable you to find, access, synchronize, and download content from the correct repositories for use in the Satellite organizations that are managed by a Satellite Server.

Providing feedback on Red Hat documentation

We appreciate your feedback on our documentation. To provide feedback, highlight text in a document and add comments.

Prerequisites

  • You are logged in to the Red Hat Customer Portal.
  • In the Red Hat Customer Portal, the document is in the Multi-page HTML viewing format.

Procedure

To provide your feedback, perform the following steps:

  1. Click the Feedback button in the top-right corner of the document to see existing feedback.

    Note

    The feedback feature is enabled only in the Multi-page HTML format.

  2. Highlight the section of the document where you want to provide feedback.
  3. Click the Add Feedback pop-up that appears near the highlighted text.

    A text box appears in the feedback section on the right side of the page.

  4. Enter your feedback in the text box and click Submit.

    A documentation issue is created.

  5. To view the issue, click the issue link in the feedback view.

Part I. Creating and managing manifests for a connected Satellite Server

Red Hat Satellite enables you to use sets of encrypted files containing subscription information, called manifests, to import your subscriptions into Satellite. After the manifest is imported, you can use it to manage RHEL systems and synchronize content. As a Satellite user on a connected network, you can create, export, delete, and modify manifests from Red Hat Hybrid Cloud Console. Alternatively, these actions can be performed from the Customer Portal.

Chapter 1. Creating a manifest for connected Satellite Server

Creating a manifest enables you to import subscriptions to your subscription management application, such as Red Hat Satellite 6 or later. Creating a new manifest is required whenever you create a new Satellite Server or Satellite Organization.

Prerequisites

  • Red Hat Satellite 6 or later
  • The Subscriptions administrator role in the role-based access control (RBAC) system for the Red Hat Hybrid Cloud Console

Procedure

The following procedure guides you through the steps to create a subscription manifest.

  1. Log in to your Red Hat Hybrid Cloud Console Account at cloud.redhat.com.
  2. From the Business Insights menu, click Subscriptions > Manifests.
  3. From the Manifests page, click Create new manifest.
  4. In the Name field, enter a descriptive name that you can locate later.
  5. From the Type list, select the application type and version number that corresponds to your Red Hat Satellite Server.
  6. Click Save.

Chapter 2. Exporting and downloading a manifest for connected Satellite servers

Exporting a manifest enables you to manage the subscriptions that it contains from within your Satellite instance. Exporting and downloading a new copy of the manifest is required whenever you add or remove subscriptions from the manifest.

Prerequisites

  • Red Hat Satellite 6 or later
  • To export a manifest, you can have either the Subscriptions user role or Subscriptions administrator role in the role-based access control (RBAC) system for the Hybrid Cloud Console.

Procedure

The following procedure guides you through the steps to export and download a manifest.

  1. Log in to your Red Hat Hybrid Cloud Console Account at cloud.redhat.com.
  2. From the Business Insights menu, click Subscriptions > Manifests.
  3. From the Manifests page, click the name of the manifest that you want to export.
  4. Click Export manifest.

    Important

    Do not refresh the page while the manifest is exporting. Refreshing the page will disrupt the manifest creation process.

    When the manifest is exported successfully, a notification window opens.

  5. From the notification window, click Download Manifest.

    Note

    The application encodes the selected subscriptions certificates and creates a compressed file in .zip format. This file is the subscription manifest that you can upload into Satellite Server. The file saves to your default downloads folder.

After you download the manifest, you can import it into your Satellite Server. You can then use the Satellite web UI to update the manifest and refresh it to reflect the changes. Alternatively, you can import an updated manifest that contains the changes. For more information, see Importing a Subscription Manifest into Satellite Server in the Red Hat Satellite Content Management Guide.

Chapter 3. Setting the simple content access mode from Red Hat Hybrid Cloud Console

When you create a new manifest, simple content access is enabled by default. Simple content access gives you the ability to consume content on your systems without strict entitlement enforcement. However, if you have an environment where simple content access is not appropriate for all manifests, the Subscriptions administrator can change the simple content access mode for each manifest as needed.

For Red Hat Satellite version 6.5 and later, you can set the simple content access mode for a particular manifest directly from the Manifests page of the Hybrid Cloud Console. You can check whether simple content access is enabled for a manifest from the setting that is displayed in the Simple Content Access column in the Manifests table. For Red Hat Satellite versions older than 6.5, the Simple Content Access column displays N/A because simple content access is not available for those versions of Satellite.

Prerequisites

  • Red Hat Satellite 6 or later
  • The Subscriptions administrator role in the role-based access control (RBAC) system for the Red Hat Hybrid Cloud Console

Procedure

The following procedure guides you through the steps to set the simple content access mode to Enabled or Disabled from Red Hat Hybrid Cloud Console.

  1. Log in to your Red Hat Hybrid Console Account at cloud.redhat.com.
  2. From the Business Insights menu, click Subscriptions > Manifests.
  3. From the Manifests page, locate the name of the manifest that you want to modify in the Manifests table.
  4. In the Simple Content Access column, set the simple content access switch to Enabled or Disabled, depending on the mode you want to use for that manifest.

    Note

    The ability to set the simple content access mode for manifests is only available in Satellite versions 6.5 and later. If simple content access enablement is not available, the Simple Content Access column displays N/A.

Chapter 4. Deleting a subscription manifest for connected Satellite servers

You can remove unused manifests for maintenance purposes. However, deleting an active manifest on a connected Satellite Server is intended for debugging purposes only. Before deleting an active manifest, it is important to note the consequences:

  • All subscriptions attached to running hosts will be deleted.
  • All subscriptions attached to activation keys will be deleted.
  • You will be required to create, export, download, and import a new manifest into your connected Satellite Server and reattach the subscriptions to hosts and activation keys.
  • Red Hat Insights will be disabled due to a lost connection to Red Hat Satellite.

Prerequisites

  • Red Hat Satellite 6 or later
  • The Subscriptions administrator role in the role-based access control (RBAC) system for the Red Hat Hybrid Cloud Console

Procedure

The following procedure guides you through the steps to delete an unused manifest.

  1. Log in to your Red Hat Hybrid Cloud Console account at cloud.redhat.com.
  2. From the Business Insights menu, click Subscriptions > Manifests.
  3. From the Manifests page, click the name of the manifest that you want to delete.

    Important

    Deleting a manifest will delete all subscriptions attached to running hosts and activation keys and disable Red Hat Insights. This operation is permanent and cannot be undone.

  4. From the Details panel, click Delete manifest.

    1. If you are sure that you want to delete the selected manifest, select the confirmation check box and then click YES, DELETE.

Legal Notice

Copyright © 2022 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.