How to Register Ceph with Satellite 6

Updated

This article describes how to register Red Hat Ceph Storage nodes to a Red Hat Satellite 6 server. It assumes that you have a working Satellite 6 server. Note that the article does not describe how to deploy a Satellite 6 server.

How Ceph Works with Satellite 6

When a Red Hat Ceph Storage node is connected to a Red Hat Satellite 6 server, the server hosts package repositories and provides system updates. In addition, you can use Satellite 6 to manage system entitlements. The provisioning functionality is supported with Red Hat Ceph Storage 2. For additional details, see Provisioning a Red Hat Ceph Storage Cluster on Bare Metal with Satellite 6.

Once you register the Red Hat Ceph Storage nodes with the Satellite 6 server, you can:

  • Deliver updates to the cluster without allowing a direct connection to the Internet.
  • Search and view errata applicable to the cluster nodes.

Registering Ceph Nodes with Satellite 6

This article includes the following procedures:

  1. Create a manifest on the Customer Portal. See Creating a Manifest.

  2. Upload the manifest to the Satellite 6 server. See Uploading a Manifest.

  3. Select repositories and synchronize them with the Content Delivery Network (CDN). See Adding and Synchronizing Repositories.

  4. Create a new content view on the Satellite 6 server and add repositories to it. See Creating Content Views.

  5. Create an activation key and assign the content view to it. See Creating Activation Keys.

  6. Use the activation key to register a node to Satellite 6 and enable repositories. See Registering Nodes.

Creating a Manifest

A manifest defines what repository content is available to you. To create a manifest:

  1. Log in to the Customer Portal and navigate to the SUBSCRIPTION tab.

  2. Click Subscription Management Applications → Satellite.

  3. Click Register a Satellite to create a new manifest.

  4. Fill in the Name field and select the Satellite version. For Satellite 6, specify the latest minor version, for example 6.2. Then click REGISTER.

  5. Click Attach a subscription. A new page with a list of available subscriptions appears. Select the appropriate subscriptions and specify how many of them you need in the Quantity field.

    For a successful registration, the certificate must include a Satellite subscription, one or more Red Hat Enterprise Linux subscriptions, and relevant Red Hat Ceph Storage subscriptions.

  6. Click ATTACHED SELECTED.

  7. Click DOWNLOAD MANIFEST to save the manifest locally on your system.

Uploading a Manifest

  1. Log in to the Satellite 6 server.

  2. Create an organization.

    1. Click Administer → Organizations → New Organization.

    2. Fill in the fields; Name and Label are required, Description is optional.

    3. Click Submit.

  3. Click Any Context and select the newly created organization from Any Organization.

  4. Upload your subscriptions.

    1. Click Content → Red Hat Subscriptions.

    2. Provide a path to the manifest you previously created and click Upload.

Adding and Synchronizing Repositories

  1. Click Content → Red Hat Repositories.

  2. Select the repositories needed for deploying a Ceph cluster. They are located under various repositories sets.

    1. For Red Hat Ceph Storage 1.3 select the following repositories:

      • Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage Tools 1.3 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage Installer 1.3 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage Calamari 1.3 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage MON 1.3 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage OSD 1.3 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server

    2. For Red Hat Ceph Storage 2 select the following repositories:

      • Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage Tools 2 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage MON 2 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Ceph Storage OSD 2 for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Storage Console Installer for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Storage Console Main for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Storage Console Agent for Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server

    3. For Red Hat Ceph Storage 3 select the following repositories:

      • Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Enterprise Linux 7 Server - Extras RPMs x86_64
      • Red Hat Ceph Storage MON 3 for Red Hat Enterprise Linux 7 Server RPMs x86_64
      • Red Hat Ceph Storage OSD 3 for Red Hat Enterprise Linux 7 Server RPMs x86_64
      • Red Hat Ceph Storage Tools 3 for Red Hat Enterprise Linux 7 Server RPMs x86_64

    4. For Red Hat Ceph Storage 4 on RHEL7 select the following repositories:

      • Red Hat Ceph Storage Tools 4 for Red Hat Enterprise Linux 7 Server RPMs x86_64
      • Red Hat Ceph Storage MON 4 for Red Hat Enterprise Linux 7 Server RPMs x86_6
      • Red Hat Ceph Storage OSD 4 for Red Hat Enterprise Linux 7 Server RPMs x86_64
      • Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
      • Red Hat Enterprise Linux 7 Server - Extras RPMs x86_64
      • Red Hat Ansible Engine 2.9 RPMs for Red Hat Enterprise Linux 7 Server x86_64

    5. For Red Hat Ceph Storage 4 on RHEL8 select the following repositories:

      • Red Hat Enterprise Linux 8 for x86_64 - BaseOS RPMs x86_64 8
      • Red Hat Enterprise Linux 8 for x86_64 - AppStream RPMs x86_64 8
      • Red Hat Ceph Storage MON 4 for RHEL 8 x86_64 RPMs
      • Red Hat Ceph Storage OSD 4 for RHEL 8 x86_64 RPMs
      • Red Hat Ceph Storage Tools 4 for RHEL 8 x86_64 RPMs
      • Red Hat Ansible Engine 2.9 for RHEL 8 x86_64 RPMs

    6. For Red Hat Ceph Storage 5 on RHEL8 select the following repositories:

      • Red Hat Enterprise Linux 8 for x86_64 - BaseOS RPMs x86_64
      • Red Hat Enterprise Linux 8 for x86_64 - AppStream RPMs x86_64
      • Red Hat Ceph Storage Tools 5 for RHEL 8 x86_64 RPMs
      • Red Hat Ansible Engine 2.9 for RHEL 8 x86_64 RPMs
      • rhel-8-for-x86_64-highavailability-rpms for 'ceph-resource-agents' users

    7. For Red Hat Ceph Storage 5 on RHEL8.4 EUS select the following repositories:

      • Red Hat Enterprise Linux 8 for x86_64 - BaseOS - Extended Update Support
      • Red Hat Enterprise Linux 8 for x86_64 - AppStream - Extended Update Support
      • Red Hat Ceph Storage Tools 5 for RHEL 8 x86_64 RPMs
      • Red Hat Ansible Engine 2.9 for RHEL 8 x86_64 RPMs
      • rhel-8-for-x86_64-highavailability-rpms for 'ceph-resource-agents' users

  3. Optionally, if you will provision Red Hat Ceph Storage on bare metals, add the required Red Hat Enterprise Linux 7/8 Kickstart in the Kickstarts tab.

  4. Synchronize the repository data with the Content Delivery Network (CDN). Click Content → Sync Status and select the repositories you want to synchronize. Then click Synchronize Now.

Creating Content Views

A content view allows you to create a different collections of repositories. It is also possible to create a specific collection of repositories for a particular Ceph node. For example create a content view for Ceph monitor nodes that includes the Red Hat Ceph Storage MON repository, but not the Red Hat Ceph Storage OSD repository and so on.

  1. Click Content → Content Views.

  2. Click Create New View.

  3. Fill in the fields; Name and Label are required, Description is optional. Then click Save.

  4. Click on the newly created content view. Click → Content → Repositories.

  5. Click Add and select the repositories. Then click Add Repositories.

  6. Once you added the repositories, click Versions → Publish New Version. Add a comment if necessary and click Save.
    NOTE: Synchronize and publish a new version of the content view each time a new asynchronous update is released.

Creating Activation Keys

Activation keys are necessary for Ceph nodes to have an access to the repositories included in a content views. An activation key has rules attached to it, for example what repositories are included, whether the repositories are enabled by default or not and so on.

  1. Click Content → Activation keys.

  2. Click New Activation Key and fill out the fields; Name is required. Then attach the previously created content view and click Save.

  3. Attach your subscriptions. Click Subscriptions → Add.

  4. Disable auto attaching by clearing the Auto-Attach check box. Then click Save.

  5. Select subscriptions you require and then click Add Selected.

  6. The Product Content tab lists all available repositories, that is repositories included in the content view. You can select whether the repositories will be enabled by default after registering a node to Satellite.

Registering Nodes

NOTE:

  • If you previously registered a node to the Content Delivery Network (CDN), you must first unregister the node and clean the Subscription Manager data to be able to register the node again with Satellite. To do so, run the following commands as root:

    # subscription-manager unregister
# subscription-manager clean

To register nodes with Satellite 6:

  1. Log in to a node and install the pre-built bootstrap RPM to configure the node to use the Satellite server by running the following command:
   # rpm -Uvh http://[hostname]/pub/katello-ca-consumer-latest.noarch.rpm

Where [hostname] specifies a host name of the Satellite server.
  1. Register a node with the Subscription Manager by using the following command:
   # subscription-manager register --org="[organization]" --activationkey="[activation_key]"

Where [organization] and [activation_key] specify names of the organization and activation key created in previous steps. You can find the exact form of this command in the Satellite web interface on a page with the activation key. Navigate to `Content`, select `Activation key` and view the activation key information by clicking its name.
  1. Install the katello remote agent:
   # yum install katello-agent
  1. Enable Ceph repositories based on the node type as described in the This content is not included.Enabling Ceph Repositories section of the Red Hat Ceph Storage 1.3 Installation Guide or in the This content is not included.Enabling Ceph Repositories section of the Red Hat Ceph Storage 2 Installation Guide for Red Hat Enterprise Linux 7. In addition, enable the Red Hat Enterprise Linux 7 Server Base repository:
   # subscription-manager repos --enable=rhel-7-server-rpms
  1. Update the node:
   # yum update

Next Steps

Once you are done, install Red Hat Ceph Storage. For details, see the Installation Guides:

Additional Resources

Product(s)
Category
Article Type