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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, click Create.
  3. Complete the Create Images form.
  4. Optional: Click Advanced to set advanced parameters, such as Striping and Quality of Service.

    Figure 14.1. Create a Block Device image

    Create a Block Device image
  5. Click Create Image.

    A notification displays 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. From the dashboard navigation, go to Block→Images.
  2. From the Namespaces tab, click Create.
  3. In the Create Namespace dialog, select the pool and enter a name for the namespace.
  4. Click Create.

    A notification displays that the namespace was created successfully.

    Figure 14.2. Create namespace

    Create namespace

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. From the dashboard navigation, go to Block→Images.
  2. Go to Edit from the menu of the image that needs to be edited.
  3. 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

    Edit Block device image

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

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

  1. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, click Copy from the menu on the image that you want to copy.
  3. 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

    Copy Block Device image

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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, select the image to move to trash, and click Move to Trash from the image menu.
  3. 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

    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

  1. From the dashboard navigation, go to Block→Images.
  2. From the Trash tab, click Purge Trash.

    Important

    To be able to restore an image, be sure that you set an expiry date before moving to trash.

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

    Purge Trash

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. From the dashboard navigation, go to Block→Images.
  2. From the Trash tab, select the row of the image to restore.
  3. Click Restore from the protected image menu.

    Figure 14.7. Restore images from the trash

    Restoring protected images from the trash
  4. In the Restore Image dialog, review the image name and click Restore.

    A notification displays 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. From the dashboard navigation, go to Block→Images.
  2. Select the row to be deleted and click Delete from the action drop-down.
  3. 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

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. From the dashboard navigation, go to Block→Images.
  2. From the Namespaces tab, select the namespace and click Delete from the action drop-down.
  3. 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

  1. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row.
  3. In the Snapshots tab, click Create.
  4. In the Create RBD Snapshot dialog, enter the snapshot name and click Create RBD Snapshot.

    Figure 14.8. Creating snapshot of images

    Creating snapshot of images

    A notification displays 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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row.
  3. In the Snapshots tab, click Rename.
  4. In the Rename RBD Snapshot dialog, enter the new name and click Rename RBD Snapshot.

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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row and click on the Snapshots tab.
  3. 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

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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row.
  3. In the Snapshots tab, select the snapshot to clone and click Clone from the action drop-down.
  4. 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

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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row.
  3. In the Snapshots tab, select the snapshot to clone and click Copy from the action drop-down.
  4. 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

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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row and click on the Snapshots tab.
  3. 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

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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row and click on the Snapshots tab.
  3. Select the snapshot to rollback, and click Rollback from the snapshot menu.
  4. In the RBD snapshot rollback dialog, click Rollback.

    Figure 14.9. 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. From the dashboard navigation, go to Block→Images.
  2. From the Images tab, expand an image row.
  3. In the Snapshots tab, select the snapshot to delete and click Delete from the action drop-down.
  4. 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

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

    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

  • From the dashboard navigation, go to Block→Mirroring.

    1. In the Pools table, select the pool to edit and click Edit Mode.
    2. 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

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. From the dashboard navigation, go to Block Mirroring and click Create Bootstrap Token.
  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.11. Create bootstrap token

    Create bootstrap token
    1. For the provided site name, select the pools to be mirrored.
    2. For the selected pools, generate a new bootstrap token by clicking Generate.
    3. Click Copy to Clipboard.
    4. Click Close.
  4. Enable the pool mirror mode.

    1. Select the pool.
    2. Click Edit Mode.
    3. In the Edit pool mirror mode dialog, select Image from the Mode list.
    4. Click Update.

      A notification displays that the pool was updated successfully.

Site B

  1. From the dashboard navigation, go to Block Mirroring and click Import Bootstrap Token from the action drop-down.

    Note

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

  2. In the Import Bootstrap Token dialog, select the direction, and paste the token copied earlier, from site A.

    Figure 14.12. Import bootstrap token

    Create bootstrap token
  3. Click Submit.

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

  4. On the Block Mirroring page, in the Pool table, verify the health of the pool is in the OK state.

Site A

  1. Create an image with Mirroring enabled.

    1. From the dashboard navigation, go to Block Images.
    2. On the Images tab, click Create.
    3. In the Create Image form, fill in the Name and Size.
    4. Select Mirroring.

      Note

      Select mirroring with either Journal or Snapshot.

    5. Click Create Image.

      Figure 14.13. Create mirroring image

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

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

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.

    1. From the Pools table, click Edit Peer from the pool menu.

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

        Editing peer in mirroring

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. From the dashboard navigation, go to Block→Mirroring.
  2. From the Pools table, select the pool to edit and click Delete Peer from the action drop-down.
  3. 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

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.