Create a Pool

By default, Ceph block devices use therbd pool. Create a pool forCloudStack NFS Primary Storage. Ensure your Ceph cluster is running, then createthe pool.

cephosdpoolcreatecloudstack

SeeCreate a Pool for details on specifying the number of placement groupsfor your pools, andPlacement Groups for details on the number of placementgroups you should set for your pools.

A newly created pool must be initialized prior to use. Use therbd toolto initialize the pool:

rbdpoolinitcloudstack

Create a Ceph User

To access the Ceph cluster we require a Ceph user which has the correctcredentials to access thecloudstack pool we just created. Although we coulduseclient.admin for this, it’s recommended to create a user with onlyaccess to thecloudstack pool.

cephauthget-or-createclient.cloudstackmon'profile rbd'osd'profile rbd pool=cloudstack'

Use the information returned by the command in the next step when adding thePrimary Storage.

SeeUser Management for additional details.

Add Primary Storage

To add a Ceph block device as Primary Storage, the steps include:

1. Log in to the CloudStack UI.

2. ClickInfrastructure on the left side navigation bar.

3. SelectView All underPrimary Storage.

4. Click theAdd Primary Storage button on the top right hand side.

5. Fill in the following information, according to your infrastructure setup:

   • Scope (i.e. Cluster or Zone-Wide).

   • Zone.

   • Pod.

   • Cluster.

   • Name of Primary Storage.

   • ForProtocol, selectRBD.

   • ForProvider, select the appropriate provider type (i.e. DefaultPrimary, SolidFire, SolidFireShared, or CloudByte). Depending on the provider chosen, fill out the information pertinent to your setup.

6. Add cluster information (cephx is supported).

   • ForRADOS Monitor, provide the IP addresses or DNS names of Ceph monitors. Please note that support for comma-separated list of IP addresses or DNS names is only present in Cloudstack v4.18.0.0 or later.

   • ForRADOS Pool, provide the name of an RBD pool.

   • ForRADOS User, provide a user that has sufficient rights to the RBD pool. Note: Do not include theclient. part of the user.

   • ForRADOS Secret, provide the secret the user’s secret.

   • Storage Tags are optional. Use tags at your own discretion. For more information about storage tags in CloudStack, refer toStorage Tags.

7. ClickOK.

Create a Disk Offering

To create a new disk offering, refer toCreate a New Disk Offering.Create a disk offering so that it matches therbd tag.TheStoragePoolAllocator will choose therbdpool when searching for a suitable storage pool. If the disk offering doesn’tmatch therbd tag, theStoragePoolAllocator may select the pool youcreated (e.g.,cloudstack).

Limitations

• Until v4.17.1.0, CloudStack will only bind to one monitor at a time. You can however use multiple DNS A or AAAA records in a round-robin fashion to spread connections over multiple monitors.