Red Hat Training

A Red Hat training course is available for Red Hat Ceph Storage

Chapter 1. Prerequisites

To use Ceph Block Device commands on your client node, you will have to meet some prerequisites.

1.1. Execute pre-installation requirements

For streamlined installation and deployment, you should execute the pre-installation procedures mentioned in Pre-Installation Requirements on your Ceph client node. Specifically, you should disable requiretty, set SELinux to Permissive and set up a Ceph Deploy user with password-less sudo.

1.2. Install Ceph Common Package

The ceph-common package provides the rbd command. To install ceph-common package you will have to enable RH-Common repository. Execute the following steps on client node:

  1. Enable RH-Common repository.

    For RHEL 6, execute:

    sudo subscription-manager repos --enable=rhel-6-server-rh-common-rpms
    sudo yum update

    For RHEL 7, execute:

    sudo subscription-manager repos --enable=rhel-7-server-rh-common-rpms
    sudo yum update
  2. Install Ceph Common package.

    Execute:

    sudo yum install ceph-common

1.3. Enable access to the Ceph cluster

The client node where you will add a block device, also needs to have access to the Ceph Storage Cluster. To be able to access the cluster, the client node will need the cluster configuration file.

Execute from the admin node of the cluster:

ceph-deploy --overwrite-conf config push <client-node>