Chapter 3. Setting Up Your Administration Server

Red Hat Ceph Storage uses an administration server for a Red Hat Ceph Storage repository, the Calamari monitoring and administration server, and your cluster’s Ceph configuration and authentication keys.

Visit the Software & Download Center in the Red Hat Customer Service Portal (https://access.redhat.com/downloads) to obtain the Red Hat Ceph Storage installation ISO image files. Use a valid Red Hat Subscription to download the full installation files, obtain a free evaluation installation, or follow the links in this page to purchase a new Red Hat Subscription. To download the Red Hat Ceph Storage installation files using a Red Hat Subscription or a Red Hat Evaluation Subscription:

  1. Visit the Red Hat Customer Service Portal at https://access.redhat.com/login and enter your user name and password to log in.
  2. Click Downloads to visit the Software & Download Center.
  3. In the Red Hat Ceph Storage area, click Download Software to download the latest version of the software.

  4. Using sudo, mount the image: 

    sudo mount -o loop <path_to_iso>/rhceph-1.2.3-rhel-6-x86_64.iso /mnt

    OR 

    sudo mount <path_to_iso>/rhceph-1.2.3-rhel-7-x86_64.iso /mnt

  5. Using sudo, copy each Ceph *.pem product certificates from /mnt to /etc/pki/product. For example: 

    sudo cp /mnt/RHCeph-Calamari-1.2-x86_64-c1e8ca3b6c57-285.pem /etc/pki/product/285.pem
sudo cp /mnt/RHCeph-Installer-1.2-x86_64-8ad6befe003d-281.pem /etc/pki/product/281.pem
sudo cp /mnt/RHCeph-MON-1.2-x86_64-d8afd76a547b-286.pem /etc/pki/product/286.pem
sudo cp /mnt/RHCeph-OSD-1.2-x86_64-25019bf09fe9-288.pem /etc/pki/product/288.pem

  6. Using sudo, install the setup script. 

    sudo yum install /mnt/ice_setup-*.rpm

  7. Create a working directory for your Ceph cluster configuration files and keys. Then, navigate to that directory. For example: 

    mkdir ~/ceph-config
cd ~/ceph-config

  8. Using sudo, run the setup script in the working directory you created at step 7 of Setting Up Your Administration Server. NOTE: You cannot run the setup script in /mnt or a read-only directory or the script will crash. The script will output a cephdeploy.conf file, which ceph-deploy will use to point to the local repository. 

    sudo ice_setup -d /mnt

    The setup script performs the following operations:

    • It moves the RPMs to /opt/ICE and /opt/calamari
    • It creates a .repo file for the ceph-deploy and calamari packages pointing to a local path
    • It installs the Calamari server packages on the admin node
    • It installs the ceph-deploy package on the admin node; and
    • It writes a cephdeploy.conf file to /opt/ICE.

  9. To receive updates to calamari, ceph-deploy and ice_setup on the admin node, using sudo, execute: 

    sudo yum update

  10. Using sudo, run ice_setup with the update all sub-command. This will synchronize new packages (if any) from the Red Hat CDN into the local repository on your Calamari admin node. 

    sudo ice_setup update all

  11. Using sudo, initialize the Calamari monitoring and administration server. 

    sudo calamari-ctl initialize
    Note

    The initialization script implies that you can only execute ceph-deploy when pointing to a remote site. You may also direct ceph-deploy to your Calamari admin node (e.g,. ceph-deploy admin <admin-hostname>). You can also use the Calamari admin node to run a Ceph daemon, although this is not recommended.

At this point, you should be able to access the Calamari web server via a web browser. Proceed to the Storage Cluster Quick Start.