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.

Note

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

  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 14.1. Create Block device image

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

Additional Resources

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

  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, 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 14.2. Create namespace

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

Additional Resources

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

  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 14.3. Edit Block device image

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

Additional Resources

14.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 14.4. Copy Block device image

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

Additional Resources

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

  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 14.5. Moving images to trash

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

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

  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 14.6. Purge trash

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

Additional resources

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

  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 14.7. Restore images from trash

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

Additional resources

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

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block
  3. Select Images.
  4. To delete the image, select the row.
  5. From the Edit drop-down, select Delete.
  6. In the Delete RBD dialog box, click the Yes, I am sure box and then Click Delete RBD to save the settings.

    Figure 14.8. Deleting images

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

Additional resources

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

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block
  3. Select Images.
  4. To delete the namespace, 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 14.9. Deleting namespaces

    Deleting namespaces
  7. You get a notification 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

  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 14.10. Creating snapshot of images

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

Additional Resources

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

  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 14.11. Renaming snapshot of images

    Renaming snapshot of images

Additional Resources

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

  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

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

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

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

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

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

  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

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

  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 14.14. Rolling back snapshot of images

    Rolling back snapshot of images

Additional Resources

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

  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 14.15. Deleting snapshot of images

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

Additional Resources

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

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

    Figure 14.16. View mirroring of Block devices

    View mirroring of Block devices

Additional Resources

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

  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 14.17. Editing mode in mirroring

    Editing mode in mirroring

Additional Resources

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.
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 14.18. Create bootstrap token

    Create bootstrap token
    1. For the provided site name, choose the pool to be mirrored.
    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 14.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 14.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

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

  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 peer.
  6. In the Edit pool mirror peer window, edit the parameters, and then click Submit:

    Figure 14.21. Editing peer in mirroring

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

Additional Resources

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

  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 14.22. Delete peer in mirroring

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

Additional Resources

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.

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.

© 2024 Red Hat, Inc.