How to Register Ceph with Satellite 5

Updated

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

How Ceph Works With Satellite 5

When a Red Hat Ceph Storage node is connected to a Red Hat Satellite 5 server, the server hosts package repositories and provides system updates.

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

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

Registering Ceph Nodes with Satellite 5

This article includes the following procedures:

  1. Create a new Satellite certificate on the Customer Portal or update an already created one. Download the certificate to your system. See Creating or Updating the Satellite Certificate.

  2. Activate the Satellite certificate and synchronize your repositories with the newly added Red Hat Ceph Storage channels. See Activating a Satellite Certificate and Synchronizing Channels.

  3. Create an Activation key. See Creating an Activation Key.

  4. Register the Ceph nodes with the Satellite 5 server. See Registering Ceph Nodes to the Satellite 5 server.

  5. Subscribe the Ceph nodes to the Ceph repositories. See Subscribing Ceph Nodes to Repositories.

Creating or Updating the Satellite Certificate

A Satellite certificate defines what repository content is available to you.

Creating a Satellite Certificate

  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 certificate.

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

  5. Click Attach a subscription. A new page with a list of subscriptions available to you 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 Satellite Certificate to save the certificate locally on your system.

Updating a Satellite Certificate

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

  2. Click Subscription Management Applications → Satellite.

  3. Select an already created certificate.

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

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

  5. Click ATTACHED SELECTED.

  6. Click Download Satellite Certificate to save the certificate locally on your system.

Activating a Satellite Certificate and Synchronizing Channels

  1. Log in to the Satellite 5 server:
   $ ssh [user]@[satellite.example.com]

* [user] specifies the user account
* [satellite.example.com] specifies the web URL of the Satellite 5 server
  1. Activate the Satellite certificate:
   $ rhn-satellite-activate --rhn-cert=<path_to_the_certificate.xml>
  1. Verify that the channels providing Red Hat Ceph Storage have been added:
   $ satellite-sync -l | less
  1. Synchronize the newly added channels:
   $ satellite-sync -c [channel_name]

* [channel_name] is the ID of the channel that provides packages for Red Hat Ceph Storage

Creating an Activation Key

Activation keys are used to register, entitle, and subscribe multiple systems in a single operation. Follow the steps below to create an activation key and to add child channels that provide Red Hat Ceph Storage to the activation key.

  1. Log in to your Red Hat Satellite 5 server web UI.

  2. Click Systems → Activation Keys.

  3. Click Create Key.

  4. Fill in the needed fields and select Base Channels → Red Hat Satellite Default.

  5. Click Create Activation Key.

  6. Navigate to the Child Channels tab and select appropriate Ceph channels. Then click Update Key.

Registering Ceph Nodes to the Satellite 5 Server

  1. If a node is registered with the Red Hat Network Classic or Subscription Manager, unregister it. See This content is not included.How to Unregister a System from RHN Classic or a Satellite.

  2. Download and install the SSL certificate package from the /pub/ directory of the Red Hat Satellite 5 server:

   # rpm -Uvh http://[satellite.example.com]/pub/rhn-org-trusted-ssl-cert-1.0-1.noarch.rpm

* [satellite.example.com] is the URL address of your Satellite 5 server
  1. Register the system with the Satellite 5 server:
   # rhnreg_ks --activationkey [key] --serverUrl [https://satellite.example.com/]XMLRPC --sslCACert=/usr/share/rhn/RHN-ORG-TRUSTED-SSL-CERT --force

* [key] specifies the path to the activation key
* [https://satellite.example.com/] is the URL address of your Satellite 5 server

Use the `--force` option to re-register the node.

Subscribing Ceph Nodes to Repositories

  1. Log in to your Red Hat Satellite 5 server web UI.

  2. Click the Systems tab → Systems → All.

  3. Select the node that you want subscribe to repositories.

  4. Click Software → Software Channels and select repositories depending on the type of the node. For example, for a monitor node, select the monitor repository.

  5. Click Change Subscriptions.

  6. From the node, confirm that the repositories have been successfully added: 

   # yum repolist

Next Steps

Once you are done, install Red Hat Ceph Storage. For details, see the This content is not included.Installation Guide for Red Hat Enterprise Linux for Red Hat Ceph Storage 1.3 or the This content is not included.Installation Guide for Red Hat Enterprise Linux for Red Hat Ceph Storage 2.

Additional Resources

Product(s)
Category
Tags
Article Type