Registering the IBM Storage Ceph nodes

Register the IBM Storage Ceph nodes on Red Hat Enterprise Linux.

Before you begin

Before registering the IBM Storage Ceph nodes, be sure that you have:
  • At least one running virtual machine (VM) or bare-metal server with an active internet connection.
  • Red Hat Enterprise Linux 9.8 or 10.2 with ansible-core 2.16.18 bundled into AppStream.
  • A valid IBM subscription with the appropriate entitlements.
  • Root-level access to all nodes.
Note: Red Hat now supports only Simple Content Access (SCA). As a result, customers no longer need to attach any subscription to a system. Registering the system and enabling the required repositories is now sufficient for registration use. For more information, see How to register and subscribe a RHEL system to the Red Hat Customer Portal using Red Hat Subscription-Manager? on the Red Hat Customer Portal.

For the latest supported Red Hat Enterprise Linux versions, see Compatibility matrix.

About this task

Note: The following procedure provides syntax and examples for installing with Red Hat Enterprise Linux 9.7. For installing with Red Hat Enterprise Linux 10.1, replace rhel-9 with rhel-10, in each instance.

Procedure

  1. Register the system, and when prompted, enter your Red Hat customer portal credentials. 
    subscription-manager register
    For example, 
    [root@admin ~]# subscription-manager register

Registering to: subscription.rhsm.redhat.com:443/subscription
Username: USERNAME
Password: PASSWORD
The system has been registered with ID: ID
The registered system name is: SYSTEM_NAME
  2. Pull the latest subscription. 
    subscription-manager refresh
    For example, 
    [root@admin ~]# subscription-manager refresh
All local data refreshed
  3. Disable the software repositories. 
    subscription-manager repos --disable=*
    For example, 
    [root@admin ~]# subscription-manager repos --disable=*
  4. Enable the Red Hat Enterprise Linux BaseOS and appstream repositories.. 
    subscription-manager repos --enable=rhel-9-for-x86_64-baseos-rpms
    subscription-manager repos --enable=rhel-9-for-x86_64-appstream-rpms
  5. Update the system to receive the latest packages for Red Hat Enterprise Linux. 
    dnf update
    For example, 
    [root@admin ~]# dnf update
  6. Enable the ceph-tools repository. 
    curl https://public.dhe.ibm.com/ibmdl/export/pub/storage/ceph/ibm-storage-ceph-9-rhel-9.repo | sudo tee /etc/yum.repos.d/ibm-storage-ceph-9-rhel-9.repo
  7. Add the license to install IBM Storage Ceph and click Accept. 
    dnf install ibm-storage-ceph-license
  8. Accept the provisions. 
    touch /usr/share/ibm-storage-ceph-license/accept
    Important: Starting from IBM Storage Ceph 9.9.1, Call Home is enabled by default. When you accept the license, the Call Home feature is automatically enabled.

    For more information about Call Home and disabling after installation, see Call Home.

  9. Repeat steps 1 through 8 on all the nodes of the storage cluster.
  10. Install cephadm-ansible. 
    dnf install cephadm-ansible

What to do next

Use Ceph Orchestrator commands to clear the health warning emitted by Call Home.
  • Clear the health warning and allow the module to remain active. 
    ceph orch accept call-home-enabled
  • Clear the health warning and turn off the Call Home module. 
    ceph orch deny call-home-enabled
Automatic service events are not enabled automatically. To enable service events, see Enabling service events.