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.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top