Chapter 13. Management of 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, mirroring functions, and iSCSI functions. For example, you can create new images, view the state of images mirrored across clusters, manage or monitor iSCSI targets, and set IOPS limits on an image.

13.1. Management of 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.

Note

The Block Device images table is paginated for use with 10000+ image storage clusters to reduce Block Device information retrieval costs.

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click the Block drop-down menu.
  3. Select Images.
  4. Click Create.
  5. In the Create RBD window, enter the parameters.
  6. Optional: Click Advanced and set the parameters.
  7. Click Create RBD.
  8. Create Block device image.

    Figure 13.1. Create Block device image

    Create Block device image
  9. You get a notification that the image was created successfully.

Additional Resources

13.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.
  • A Block device image is created.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation menu, click the Block drop-down menu.
  3. Select Images.
  4. To create the namespace of the image, in the Namespaces tab, click Create.
  5. In the Create Namespace window, select the pool and enter a name for the namespace.
  6. Click Create.

    Figure 13.2. Create namespace

    Create namespace
  7. You get a notification that the namespace was created successfully.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation bar, click the Block drop-down menu.
  3. Select Images.
  4. To edit the image, click its row.
  5. In the Edit drop-down menu, select Edit.
  6. In the Edit RBD window, edit the required parameters and click Edit RBD.

    Figure 13.3. Edit Block device image

    Edit Block device image
  7. You get a notification that the image was updated successfully.

Additional Resources

13.1.4. Copying images on the Ceph dashboard

You can copy 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

  1. Log in to the Dashboard.
  2. On the navigation bar, click the Block drop-down menu.
  3. Select Images.
  4. To copy the image, click its row.
  5. In the Edit drop-down menu, select Copy.
  6. In the Copy RBD window, set the required parameters and click Copy RBD.

    Figure 13.4. Copy Block device image

    Copy Block device image
  7. You get a notification that the image was copied successfully.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images from the drop-down menu.
  4. To move the image to trash, click its row.
  5. Select Move to Trash in the Edit drop-down.
  6. In the Moving an image to trash window, edit the date till which the image needs protection, and then click Move.

    Figure 13.5. Moving images to trash

    Moving images to trash
  7. You get a notification that the image was moved to trash successfully.

13.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

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block:
  3. Select Images.
  4. In the Trash tab, click Purge Trash.
  5. In the Purge Trash window, select the pool, and then click Purge Trash.

    Figure 13.6. Purge trash

    Purge Trash
  6. You get a notification that the pools in the trash were purged successfully.

Additional resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block:
  3. Select Images.
  4. To restore the image from Trash, in the Trash tab, click its row:
  5. Select Restore in the Restore drop-down.
  6. In the Restore Image window, enter the new name of the image , and then click Restore.

    Figure 13.7. Restore images from trash

    Restore images from trash
  7. You get a notification that the image was restored successfully.

Additional resources

13.1.8. Deleting images on the Ceph dashboard.

You can delete the images only after the images are moved to trash. You can delete the cloned images and the copied images directly without moving them to trash.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • A pool with the rbd application enabled is created.
  • An image is created and is moved to trash.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block
  3. Select Images.
  4. To delete the image, in the Trash tab, click its row.
  5. Select Delete in the Restore drop-down menu.
  6. Optional: To remove the cloned images and copied images, select Delete from the Edit drop-down menu.
  7. In the Delete RBD dialog box, click the Yes, I am sure box and then Click Delete RBD to save the settings:

    Figure 13.8. Deleting images

    Deleting images
  8. You get a notification that the image was deleted successfully.

Additional resources

13.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.
  • An image is created and is moved to trash.
  • A block device image and its namespaces is created

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block
  3. Select Images.
  4. To delete the namespace of the image, in the Namespaces tab, click its row.
  5. Click Delete.
  6. In the Delete Namespace dialog box, click the Yes, I am sure box and then Click Delete Namespace to save the settings:

    Figure 13.9. Deleting namespaces

    Deleting namespaces
  7. You get a notification that the namespace was deleted successfully.

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To take the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select Create in the Create drop-down.
  6. In the Create RBD Snapshot dialog, enter the name and click Create RBD Snapshot:

    Figure 13.10. Creating snapshot of images

    Creating snapshot of images
  7. You get a notification that the snapshot was created successfully.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To rename the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select Rename in the the Rename drop-down.
  6. In the Rename RBD Snapshot dialog box, enter the name and click Rename RBD Snapshot:

    Figure 13.11. Renaming snapshot of images

    Renaming snapshot of images

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To protect the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select Protect in the the Rename drop-down.
  6. The State of the snapshot changes from UNPROTECTED to PROTECTED.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To protect the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select Clone in the the Rename drop-down.
  6. In the Clone RBD window, edit the parameters and click Clone RBD.

    Figure 13.12. Cloning snapshot of images

    Cloning snapshot of images
  7. You get a notification that the snapshot was cloned successfully. You can search for the cloned image in the Images tab.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To protect the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select Copy in the the Rename drop-down menu.
  6. In the Copy RBD window, enter the parameters and click the Copy RBD button:

    Figure 13.13. Copying snapshot of images

    Copying snapshot of images
  7. You get a notification that the snapshot was copied successfully. You can search for the copied image in the Images tab.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To unprotect the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select UnProtect in the the Rename drop-down.
  6. The State of the snapshot changes from PROTECTED to UNPROTECTED.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To rollback the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select Rollback in the the Rename drop-down.
  6. In the RBD snapshot rollback dialog box, click Rollback.

    Figure 13.14. Rolling back snapshot of images

    Rolling back snapshot of images

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Select Images.
  4. To take the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab.
  5. Select Delete in the the Rename drop-down:

    Figure 13.15. Deleting snapshot of images

    Deleting snapshot of images
  6. You get a notification that the snapshot was deleted successfully.

Additional Resources

13.2. Management of 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.

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Click Mirroring.

    Figure 13.16. View mirroring of Block devices

    View mirroring of Block devices

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Click Mirroring.
  4. In the Pools tab, click the peer you want to edit.
  5. In the Edit Mode drop-down, select Edit Mode.
  6. In the Edit pool mirror mode window, select the mode from the drop-down, and then click Update. Pool is updated successfully

    Figure 13.17. Editing mode in mirroring

    Editing mode in mirroring

Additional Resources

13.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.
Note

Ensure that mirroring is enabled for the pool in which images are created.

Procedure

Site A

  1. Log in to the dashboard.
  2. From the Navigation menu, click the Block drop-down menu, and click Mirroring.
  3. Click Create Bootstrap Token and configure the following in the window:

    Figure 13.18. Create bootstrap token

    Create bootstrap token
    1. Choose the pool for mirroring for the provided site name.
    2. For the selected pool, generate a new bootstrap token by clicking Generate.
    3. Click the Copy icon to copy the token to clipboard.
    4. Click Close.
  4. Enable pool mirror mode.

    1. Select the pool.
    2. Click Edit Mode.
    3. From the Edit pool mirror mode window, select Image from the drop-down.
    4. Click Update.

Site B

  1. Log in to the dashboard.
  2. From the Navigation menu, click the Block drop-down menu, and click Mirroring.
  3. From the Create Bootstrap token drop-down, select Import Bootstrap Token.

    Note

    Ensure that mirroring mode is enabled for the specific pool for which you are importing the bootstrap token.

  4. In the Import Bootstrap Token window, choose the direction, and paste the token copied earlier from site A.

    Figure 13.19. Import bootstrap token

    Create bootstrap token
  5. Click Submit.

    The peer is added and the images are mirrored in the cluster at site B.

  6. Verify the health of the pool is in OK state.

    • In the Navigation menu, under Block, select Mirroring. The health of the pool is OK.

Site A

  1. Create an image with Mirroring enabled.

    1. From the Navigation menu, click the Block drop-down menu.
    2. Click Images.
    3. Click Create.
    4. In the Create RBD window, provide the Name, Size and enable Mirroring.

      Note

      You can either choose Journal or Snapshot.

    5. Click Create RBD.

      Figure 13.20. Create mirroring image

      Create mirroring image
  2. Verify the image is available at both the sites.

    • In the Navigation menu, under Block, select Images. The image in site A is primary while the image in site B is secondary.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Click Mirroring.
  4. In the Pools tab, click the peer you want to delete.
  5. In the Edit Mode drop-down, select Edit peer.
  6. In the Edit pool mirror peer window, edit the parameters, and then click Submit:

    Figure 13.21. Editing peer in mirroring

    Editing peer in mirroring
  7. You get a notification that the peer was updated successfully.

Additional Resources

13.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

  1. Log in to the Dashboard.
  2. On the navigation menu, click Block.
  3. Click Mirroring.
  4. In the Pools tab, click the peer you want to delete.
  5. In the Edit Mode drop-down, select Delete peer.
  6. In the Delete mirror peer dialog window, Click the Yes, I am sure box and then Click Delete mirror peer to save the settings:

    Figure 13.22. Delete peer in mirroring

    Delete peer in mirroring
  7. You get a notification that the peer was deleted successfully.

Additional Resources