Chapter 14. Managing block devices using the Ceph dashboard
As a storage administrator, you can manage and monitor block device images on the Red Hat Ceph Storage dashboard. The functionality is divided between generic image functions and mirroring functions. For example, you can create new images, view the state of images mirrored across clusters, and set IOPS limits on an image.
14.1. Managing block device images on the Ceph dashboard
As a storage administrator, you can create, edit, copy, purge, and delete images using the Red Hat Ceph Storage dashboard.
You can also create, clone, copy, rollback, and delete snapshots of the images using the Ceph dashboard.
The Block Device images table is paginated for use with 10000+ image storage clusters to reduce Block Device information retrieval costs.
14.1.1. Creating images on the Ceph dashboard
You can create block device images on the Red Hat Ceph Storage dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, click Create.
- Complete the Create Images form.
Optional: Click Advanced to set advanced parameters, such as Striping and Quality of Service.
Figure 14.1. Create a Block Device image
Click Create Image.
A notification displays that the image was created successfully.
Additional Resources
- See the Red Hat Ceph Storage Block Device Guide for more information on Images.
- See the Creating pools on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.2. Creating namespaces on the Ceph dashboard
You can create namespaces for the block device images on the Red Hat Ceph Storage dashboard.
Once the namespaces are created, you can give access to the users for those namespaces.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Namespaces tab, click Create.
- In the Create Namespace dialog, select the pool and enter a name for the namespace.
Click Create.
A notification displays that the namespace was created successfully.
Figure 14.2. Create namespace
Additional Resources
- See the Knowledgebase article Segregate Block device images within isolated namespacesfor more details.
14.1.3. Editing images on the Ceph dashboard
You can edit block device images on the Red Hat Ceph Storage dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- Go to Edit from the menu of the image that needs to be edited.
In the Edit Image form, edit the required parameters and click Edit Image.
A notification displays that the image was updated successfully.
Figure 14.3. Edit image
Additional Resources
- See the Red Hat Ceph Storage Block Device Guide for more information on Images.
- See the Creating pools on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.4. Copying images on the Ceph dashboard
You can copy block device images on the Red Hat Ceph Storage dashboard.
Prerequisites
Before you begin, make sure that you have the following prerequisites in place:
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, click Copy from the menu on the image that you want to copy.
In the Copy Image form, set the required parameters and click Copy Image.
A notification displays that the image was copied successfully.
Figure 14.4. Copy block image
Additional Resources
- See the Red Hat Ceph Storage Block Device Guide for more information on Images.
- See the Creating pools on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.5. Moving images to trash on the Ceph dashboard
You can move the block device images to trash before it is deleted on the Red Hat Ceph Storage dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, select the image to move to trash, and click Move to Trash from the image menu.
In the Move an image to trash dialog, change the Protection expires at field and click Move.
A notification displays that the image was moved to trash successfully.
Figure 14.5. Moving images to trash
14.1.6. Purging trash on the Ceph dashboard
You can purge trash using the Red Hat Ceph Storage dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is trashed.
Procedure
- From the dashboard navigation, go to Block→Images.
From the Trash tab, click Purge Trash.
ImportantTo be able to restore an image, be sure that you set an expiry date before moving to trash.
In the Purge Trash dialog, select the pool, and click Purge Trash.
A notification displays that the pools in the trash were purged successfully.
Figure 14.6. Purge trash
Additional resources
- See the Purging the Block Device Snapshots section in the Red Hat Ceph Storage Block Device Guide for more details.
14.1.7. Restoring images from trash on the Ceph dashboard
You can restore the images that were trashed and has an expiry date on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is trashed.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Trash tab, select the row of the image to restore.
Click Restore from the protected image menu.
Figure 14.7. Restore images from the trash
In the Restore Image dialog, review the image name and click Restore.
A notification displays that the image was restored successfully.
Additional resources
- See the Creating images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details on creating images in an RBD pool.
14.1.8. Deleting images on the Ceph Dashboard
You can delete the images from the cluster on the Ceph Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- Select the row to be deleted and click Delete from the action drop-down.
In the Delete RBD notification, select Yes, I am sure and click Delete RBD.
A notification displays that the image was deleted successfully.
Additional resources
- See the Moving images to trash on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details on creating images in an RBD pool.
14.1.9. Deleting namespaces on the Ceph dashboard.
You can delete the namespaces of the images on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- A namespace is created in the pool.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Namespaces tab, select the namespace and click Delete from the action drop-down.
In the Delete Namespace notification, select Yes, I am sure and click Delete Namespace.
A notification displays that the namespace was deleted successfully.
14.1.10. Creating snapshots of images on the Ceph dashboard
You can take snapshots of the Ceph block device images on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row.
- In the Snapshots tab, click Create.
In the Create RBD Snapshot dialog, enter the snapshot name and click Create RBD Snapshot.
Figure 14.8. Creating snapshot of images
A notification displays that the snapshot was created successfully.
Additional Resources
- See the Creating a block device snapshot section in the Red Hat Ceph Storage Block Device Guide for more information on creating snapshots.
- See the Creating pools on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
- See the Creating images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.11. Renaming snapshots of images on the Ceph dashboard
You can rename the snapshots of the Ceph block device images on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- A snapshot of the image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row.
- In the Snapshots tab, click Rename.
- In the Rename RBD Snapshot dialog, enter the new name and click Rename RBD Snapshot.
Additional Resources
- See the Renaming a block device snapshot section in the Red Hat Ceph Storage Block Device Guide] for more information.
- See the Creating pools on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
- See the Creating images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.12. Protecting snapshots of images on the Ceph dashboard
You can protect the snapshots of the Ceph block device images on the Red Hat Ceph Storage Dashboard.
This is required when you need to clone the snapshots.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- A snapshot of the image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row and click on the Snapshots tab.
Select the snapshot to protect, and click Protect from the action drop-down.
The snapshot updates and the State changes from Unprotected to Protected.
Additional Resources
- See the Protecting a block device snapshot section in the Red Hat Ceph Storage Block Device Guide for more information.
14.1.13. Cloning snapshots of images on the Ceph dashboard
You can clone the snapshots of images on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- A snapshot of the image is created and protected.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row.
- In the Snapshots tab, select the snapshot to clone and click Clone from the action drop-down.
In the Clone RBD form, fill in the required details and click Clone RBD.
A notification displays that the snapshots was cloned successfully and the new image displays in the Images table.
Additional Resources
- See the Protecting a Block device Snapshot section in the Red Hat Ceph Storage Block Device Guide for more information.
- See the Protecting snapshots of images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.14. Copying snapshots of images on the Ceph dashboard
You can copy the snapshots of images on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- A snapshot of the image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row.
- In the Snapshots tab, select the snapshot to clone and click Copy from the action drop-down.
In the Copy RBD form, fill in the required details and click Copy RBD.
A notification displays that the snapshots was cloned successfully and the new image displays in the Images table.
Additional Resources
- See the Creating pools on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
- See the Creating images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.15. Unprotecting snapshots of images on the Ceph dashboard
You can unprotect the snapshots of the Ceph block device images on the Red Hat Ceph Storage Dashboard.
This is required when you need to delete the snapshots.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- A snapshot of the image is created and protected.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row and click on the Snapshots tab.
Select the protected snapshot, and click Unprotect from the action drop-down.
The snapshot updates and the State changes from Protected to Unprotected*.
Additional Resources
- See the Unprotecting a block device snapshot section in the Red Hat Ceph Storage Block Device Guide for more information.
- See the Protecting snapshots of images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.16. Rolling back snapshots of images on the Ceph dashboard
You can rollback the snapshots of the Ceph block device images on the Red Hat Ceph Storage Dashboard. Rolling back an image to a snapshot means overwriting the current version of the image with data from a snapshot. The time it takes to execute a rollback increases with the size of the image. It is faster to clone from a snapshot than to rollback an image to a snapshot, and it is the preferred method of returning to a pre-existing state.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- A snapshot of the image is created.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row and click on the Snapshots tab.
- Select the snapshot to rollback, and click Rollback from the snapshot menu.
In the RBD snapshot rollback dialog, click Rollback.
Figure 14.9. Rolling back snapshot of images
Additional Resources
- See the Rolling a block device snapshot section in the Red Hat Ceph Storage Block Device Guide for more information.
- See the Creating pools on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
- See the Creating images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.1.17. Deleting snapshots of images on the Ceph dashboard
You can delete the snapshots of the Ceph block device images on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- A snapshot of the image is created and is unprotected.
Procedure
- From the dashboard navigation, go to Block→Images.
- From the Images tab, expand an image row.
- In the Snapshots tab, select the snapshot to delete and click Delete from the action drop-down.
In the Delete RBD Snapshot dialog, select Yes, I am sure and click Delete RBD Snapshot.
A notification displays that the snapshot was created successfully.
Additional Resources
- See the Deleting a block device snapshot section in the Red Hat Ceph Storage Block Device Guide for more information.
- See the Unprotecting snapshots of images on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more details.
14.2. Managing mirroring functions on the Ceph dashboard
As a storage administrator, you can manage and monitor mirroring functions of the Block devices on the Red Hat Ceph Storage Dashboard.
You can add another layer of redundancy to Ceph block devices by mirroring data images between storage clusters. Understanding and using Ceph block device mirroring can provide you protection against data loss, such as a site failure. There are two configurations for mirroring Ceph block devices, one-way mirroring or two-way mirroring, and you can configure mirroring on pools and individual images.
14.2.1. Mirroring view on the Ceph dashboard
You can view the Block device mirroring on the Red Hat Ceph Storage Dashboard.
You can view the daemons, the site details, the pools, and the images that are configured for block device mirroring.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- Mirroring is configured.
Procedure
From the dashboard navigation, go to Block→Mirroring.
Figure 14.10. View mirroring of Ceph Block Devices
Additional Resources
- For more information on mirroring, see Mirroring Ceph block devices section in the Red Hat Ceph Storage Block Device Guide.
14.2.2. Editing mode of pools on the Ceph dashboard
You can edit mode of the overall state of mirroring functions, which includes pools and images on the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- Mirroring is configured.
Procedure
From the dashboard navigation, go to Block→Mirroring.
- In the Pools table, select the pool to edit and click Edit Mode.
In the Edit Mode dialog, select the mode and click Update.
A notification displays that the mode was updated successfully and the Mode updates in the Pools table.
Additional Resources
- See the Ceph Block Device Mirroring section in the Red Hat Ceph Storage Block Device Guide for more information.
14.2.3. Adding peer in mirroring on the Ceph dashboard
You can add storage cluster peer for the rbd-daemon
mirror to discover its peer storage cluster on the Red Hat Ceph Storage Dashboard.
Prerequisites
- Two healthy running Red Hat Ceph Storage clusters.
- Dashboard is installed on both the clusters.
- Pools created with the same name.
-
rbd
application enabled on both the clusters.
Ensure that mirroring is enabled for the pool in which images are created.
Procedure
Site A
-
From the dashboard navigation, go to Block
Mirroring and click Create Bootstrap Token. - From the Navigation menu, click the Block drop-down menu, and click Mirroring.
Click Create Bootstrap Token and configure the following in the window:
Figure 14.11. Create bootstrap token
- For the provided site name, select the pools to be mirrored.
- For the selected pools, generate a new bootstrap token by clicking Generate.
- Click Copy to Clipboard.
- Click Close.
Enable the pool mirror mode.
- Select the pool.
- Click Edit Mode.
- In the Edit pool mirror mode dialog, select Image from the Mode list.
Click Update.
A notification displays that the pool was updated successfully.
Site B
From the dashboard navigation, go to Block
Mirroring and click Import Bootstrap Token from the action drop-down. NoteEnsure that mirroring mode is enabled for the specific pool for which you are importing the bootstrap token.
In the Import Bootstrap Token dialog, select the direction, and paste the token copied earlier, from site A.
Figure 14.12. Import bootstrap token
Click Submit.
The peer is added and the images are mirrored in the cluster at site B.
-
On the Block
Mirroring page, in the Pool table, verify the health of the pool is in the OK state.
Site A
Create an image with Mirroring enabled.
-
From the dashboard navigation, go to Block
Images. - On the Images tab, click Create.
- In the Create Image form, fill in the Name and Size.
Select Mirroring.
NoteSelect mirroring with either Journal or Snapshot.
Click Create Image.
Figure 14.13. Create mirroring image
-
From the dashboard navigation, go to Block
Verify the image is available at both the sites.
- From the Images table, verify that the image in site A is set to primary and that the image in site B is set to secondary.
Additional Resources
- See the Configuring two-way mirroring using the command-line interface section in the Red Hat Ceph Storage Block Device Guide for more information.
14.2.4. Editing peer in mirroring on the Ceph dashboard
You can edit storage cluster peer for the rbd-daemon
mirror to discover its peer storage cluster in the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- Mirroring is configured.
- A peer is added.
Procedure
From the dashboard navigation, go to Block→Mirroring.
From the Pools table, click Edit Peer from the pool menu.
In the Edit pool mirror peer dialog, edit the parameters, and click Submit.
A notification displays that the peer was updated successfully.
Figure 14.14. Editing peer in mirroring
Additional Resources
- See the Adding peer in mirroring on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more information.
14.2.5. Deleting peer in mirroring on the Ceph dashboard
You can edit storage cluster peer for the`rbd-daemon` mirror to discover its peer storage cluster in the Red Hat Ceph Storage Dashboard.
Prerequisites
- A running Red Hat Ceph Storage cluster.
- Dashboard is installed.
- A pool with the rbd application enabled is created.
- An image is created.
- Mirroring is configured.
- A peer is added.
Procedure
- From the dashboard navigation, go to Block→Mirroring.
- From the Pools table, select the pool to edit and click Delete Peer from the action drop-down.
In the Delete mirror peer dialog, select Yes, I am sure and click Delete mirror peer.
A notification displays that the peer deleted successfully.
Additional Resources
- See the Adding peer in mirroring on the Ceph dashboard section in the Red Hat Ceph Storage Dashboard Guide for more information.