Menu Close

Chapter 9. Block devices

9.1. Block devices introduction

The block device functions of the dashboard allow you to manage and monitor block device images. The functionality is divided between generic image functions, mirroring functions, iSCSI functions, and Quality of Service configuration. 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.

9.2. Images functions

The dashboard provides several functions related to managing and monitoring images.

9.2.1. Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.

9.2.2. Creating images

The dashboard allows you to create images.

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 bar, click the Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. In the Images tab, Click the Create button:

    Create image
  5. In the CreateRBD window, enter the parameters:

    Create image window
  6. Optional: Click Advanced and set the parameters:

    Create image Advanced settings
    Create image Advanced settings parameters
  7. Click the CreateRBD button:

    Click Create RBD
  8. Notifications towards the top right corner of the page indicate the image was created successfully.

    Image create notification

Additional Resources

9.2.3. Viewing images

The dashboard allows you to view images.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • An image is in the cluster.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block.
  3. Click Images:

    Images view

    In the above example, you can see a 10 GiB image named disk_1.

  4. To view details, select the image by clicking the row for disk_1:

    Images view details

Additional Resources

9.2.4. Editing images

The dashboard allows you to edit images

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:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To edit the image, in the Images tab, click its row:

    Click Image row
  5. Select Edit In the Edit drop-down:

    Click Edit
  6. In the EditRBD dialog, edit the required parameters and click the EditRBD button:

    Edit Image dialog
  7. A notification towards the top right corner of the page indicates the image was updated successfully.

    Image edit notification

Additional Resources

  • See the Creating Images section in the Red Hat Ceph Storage Dashboard Guide for more information.

9.2.5. Copying images

The dashboard allows you to copy images.

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:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To copy the image, in the Images tab, click its row:

    Click Image row
  5. Select Copy In the Edit drop-down:

    Click Copy
  6. In the CopyRBD window, edit the required parameters and click the CopyRBD button:

    Copy Image window
  7. A notification towards the top right corner of the page indicates the image was updated successfully.

    Copy image notification

Additional Resources

  • See the Creating Images section in the Red Hat Ceph Storage Dashboard Guide for more information.

9.2.6. Moving images to trash

The dashboard allows you to move images 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.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To move the image to Trash, in the Images tab, click its row:

    Click Image row
  5. Select Move to Trash In the Edit drop-down:

    Click Move to Trash
  6. In the Moving an image to trash window, edit the date till which the image needs protection, and then click the Move Image button:

    Move image to Trash window
  7. A notification towards the top right corner of the page indicates the image was moved to trash successfully.

    Move image to trash notification

9.2.7. Purging trash

The dashboard allows you to purge trash of images.

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:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. In the Trash tab, click the Purge Trash button:

    Click Purge Trash
  5. In the Purge Trash window, select the pool, and then click the Purge Trash button:

    Purge Trash window
  6. A notification towards the top right corner of the page indicates the images were purged from the selected pools successfully.

    Purge from trash notification

Additional resources

9.2.8. Restoring images from trash

The dashboard allows you to restore images from trash.

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:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To restore the image from Trash, in the Trash tab, click its row:

    Click Image row in Trash tab
  5. Select Restore in the Restore drop-down:

    Click Restore
  6. In the Restore Image window, enter the name of the image , and then click the Restore Image button:

    Restore from Trash window
  7. Notification towards the top right corner of the page indicate the image was restored from trash successfully.

    Restore from trash notification

Additional resources

  • See the Creating images section in the Red Hat Ceph Storage Dashboard Guide for more details on creating images in an RBD pool.

9.2.9. Deleting images

The dashboard allows you to delete images.

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:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To edit the image, in the Images tab, click its row:

    Click Image row
  5. Select Delete In the Edit drop-down:

    Click Delete
  6. In the Delete RBD dialog window, Click the Yes, I am sure box and then Click Delete RBD to save the settings:

    Delete image window
  7. A notification towards the top right corner of the page indicates the image was moved to trash successfully.

    Delete image notification

9.2.10. Creating snapshots of images

The dashboard allows you to take snapshots of Ceph block device images.

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:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To take the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select Create in the Create drop-down:

    Create snapshot of the image
  6. In the CreateRBD Snapshot dialog, enter the parameters and click the CreateRBD Snapshot button:

    Create snapshot of the image dialog
  7. A notification towards the top right corner of the page indicates the snapshot of the image was created successfully.

    Creation of snapshot of the image notification

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 section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
  • See the Creating images section in the Red Hat Ceph Storage Dashboard Guide for more details.

9.2.11. Renaming snapshots of images

The dashboard allows you to rename snapshots of Ceph block device images.

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 bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To rename the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select Rename in the the Rename drop-down:

    Rename snapshot of the image
  6. In the RenameRBD Snapshot dialog, enter the parameters and click the RenameRBD Snapshot button:

    Rename snapshot of the image dialog
  7. A notification towards the top right corner of the page indicates the snapshot of the image was updated successfully.

    Snapshot update of the image notification

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 section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
  • See the Creating images section in the Red Hat Ceph Storage Dashboard Guide for more details on creating images in an RBD pool.

9.2.12. Protecting snapshots of images

The dashboard allows you to protect snapshots of Ceph block device images. 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 bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To protect the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select Protect in the the Rename drop-down:

    Protect snapshot of the image
  6. A notification towards the top right corner of the page indicates the snapshot of the image was updated successfully.

    Snapshot update of the image notification

Additional Resources

  • See the Protecting a block device snapshot section in the Red Hat Ceph Storage Block Device Guide] for more information.
  • See the Creating pools section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
  • See the Creating images section in the Red Hat Ceph Storage Dashboard Guide for more details on creating images in an RBD pool.

9.2.13. Cloning snapshots of images

The dashboard allows you to clone snapshots of Ceph block device images.

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.
  • A snapshot of the image is protected.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To clone the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select Clone in the the Rename drop-down:

    Rename snapshot of the image
  6. In the CloneRBD dialog, enter the parameters and click the CloneRBD button:

    Clone snapshot of the image dialog
  7. A notification towards the top right corner of the page indicates the snapshot of the image was cloned successfully.

    Clone of snapshot of the image notification

Additional Resources

9.2.14. Copying snapshots of images

The dashboard allows you to copy snapshots of Ceph block device images.

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 bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To copy the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select Copy in the the Rename drop-down:

    Copy snapshot of the image
  6. In the CopyRBD dialog, enter the parameters and click the CopyRBD button:

    Rename snapshot of the image dialog
  7. A notification towards the top right corner of the page indicates the snapshot of the image was updated successfully.

    Copy Snapshot of the image notification

Additional Resources

  • See the Creating pools section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
  • See the Creating images section in the Red Hat Ceph Storage Dashboard Guide for more details on creating images in an RBD pool.

9.2.15. Rolling back snapshots of images

The dashboard allows you to rollback snapshots of Ceph block device images.

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 bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To rollback the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select Rollback in the the Rename drop-down:

    Rollback snapshot of the image
  6. In the RBD snapshot rollback window, click the Rollback button:

    Rollback snapshot of the image window
  7. A notification towards the top right corner of the page indicates the snapshot of the image was rolled back successfully.

    Rollback Snapshot of the image notification

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 section in the Red Hat Ceph Storage Dashboard Guide for more details.
  • See the Creating images section in the Red Hat Ceph Storage Dashboard Guide for more details.

9.2.16. Unprotecting snapshots of images

The dashboard allows you to unprotect snapshots of Ceph block device images. 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.
  • A snapshot of the image is protected.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To unprotect the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select UnProtect in the the Rename drop-down:

    Unprotect snapshot of the image
  6. A notification towards the top right corner of the page indicates the snapshot of the image was updated successfully.

    Snapshot update of the image notification

Additional Resources

  • See the Unprotecting a block device snapshot section in the Red Hat Ceph Storage Block Device Guide for more information.
  • See the Creating pools section in the Red Hat Ceph Storage Dashboard Guide for more details on creating RBD pools.
  • See the Creating images section in the Red Hat Ceph Storage Dashboard Guide for more details on creating images in an RBD pool.
  • See the Protecting snapshots of Images section in the Red Hat Ceph Storage Dashboard Guide for more details.

9.2.17. Deleting snapshots of images

The dashboard allows you to delete snapshots of Ceph block device images.

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.
  • A snapshot of the image is unprotected.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block:

    Click Block
  3. Select Images from the drop-down:

    Select Images from drop-down
  4. To delete the snapshot of the image, in the Images tab, click its row, and then click the Snapshots tab:

    Click Snapshots tab
  5. Select Delete in the the Rename drop-down:

    Delete snapshot of the image
  6. A notification towards the top right corner of the page indicates the snapshot of the image was updated successfully.

    Snapshot deletion of the image notification

Additional Resources

9.3. Mirroring functions

The dashboard allows you to manage and monitor mirroring functions.

9.3.1. Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.

9.3.2. Mirroring view

The dashboard allows you to view the overall state of mirroring functions.

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 bar, click Block.
  3. Click Mirroring:

    Images view

    In the above example, you can see mirroring information categorized into tables labeled Daemons, Pools, and Images.

Additional Resources

9.3.3. Editing mode

The dashboard allows you to edit mode of the overall state of mirroring functions, which includes pools and images.

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 bar, click Block:

    Click Block
  3. Click Mirroring from the drop-down:

    Click Mirroring
  4. In the Pools tab, click the row:

    Click row
  5. In the Edit Mode drop-down, select Edit Mode:

    Click Edit Mode
  6. In the Edit Pool mirror mode window, select the mode from the drop-down, and then click the Update button:

    Edit Mode Window
  7. A notification towards the top right corner of the page indicates the mirror mode was updated successfully.

    Mirror mode edit notification

Additional Resources

9.3.4. Adding peer in mirroring

The dashboard allows you to add storage cluster peer for the`rbd-daemon` mirror to discover its peer storage cluster.

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 bar, click Block:

    Click Block
  3. Click Mirroring from the drop-down:

    Click Mirroring
  4. In the Pools tab, click the row

    Click row
  5. In the Edit Mode drop-down, select Add peer:

    Click Add peer
  6. In the Add pool mirror peer window, enter the parameters, and then click the Submit button:

    Add peer Window
  7. A notification towards the top right corner of the page indicates the mirror peer was created successfully.

    Add peer notification

Additional Resources

9.3.5. Editing peer in mirroring

The dashboard allows you to edit storage cluster peer for the`rbd-daemon` mirror to discover its peer storage cluster.

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 bar, click Block.

    Click Block
  3. Click Mirroring from the drop-down:

    Click Mirroring
  4. In the Pools tab, click the row

    Click row
  5. In the Edit Mode drop-down, select Edit peer:

    Click Edit peer
  6. In the Edit pool mirror peer window, edit the parameters, and then click the Submit button:

    Edit peer Window
  7. A notification towards the top right corner of the page indicates the mirror peer was updated successfully.

    Edit peer notification

Additional Resources

9.3.6. Deleting peer in mirroring

The dashboard allows you to edit storage cluster peer for the`rbd-daemon` mirror to discover its peer storage cluster.

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 bar, click Block.

    Click Block
  3. Click Mirroring from the drop-down:

    Click Mirroring
  4. In the Pools tab, click the row:

    Click row
  5. In the Edit Mode drop-down, select Delete peer:

    Click 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:

    Delete image window
  7. A notification towards the top right corner of the page indicates the image was moved to trash successfully.

    Delete peer notification

Additional Resources

9.4. iSCSI functions (Limited Availability)

The dashboard allows you to manage and monitor iSCSI images and targets. Before you can use the dashboard to manage and monitor iSCSI images and targets, you must add gateways to it and enable the dashboard iSCSI feature.

Note

This technology is Limited Availability. See the Deprecated functionality chapter for additional information.

9.4.1. Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • iSCSI gateways are added to the dashboard.

9.4.2. Manually adding iSCSI gateways to the dashboard

The Red Hat Ceph Storage Dashboard can manage iSCSI targets using the REST API provided by the rbd-target-api service of the Ceph iSCSI Gateway. You must add the API address to the dashboard before the dashboard can access it.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • The Ceph iSCSI Gateway is installed.
Important

The Ceph iSCSI gateway requires at lest two gateways to provide high availability.

Procedure

  1. Log in to a Monitor node.
  2. Optional: If the REST API for the iSCSI gateway is configured in HTTPS mode using a self-signed certificate, you must configure the dashboard to avoid SSL certificate verification when accessing the API. Run the following command to disable SSL verification.

    # ceph dashboard set-iscsi-api-ssl-verification false

    Example:

    [root@mon ~]# ceph dashboard set-iscsi-api-ssl-verification false
    Option ISCSI_API_SSL_VERIFICATION updated
  3. Create two files for the gateways:

    # echo "SCHEME :// USERNAME : PASSWORD @ HOST [: PORT ]" > FILE_CONTAINING_GATEWAY_URL

    Example:

    [root@mon ~]# echo "http://admin:admin@192.168.122.157:5000" > /tmp/first_gateway
    [root@mon ~]# echo "http://admin:admin@192.168.122.193:5000" > /tmp/second_gateway
    Note

    The USERNAME and PASSWORD were set when you configured the iSCSI target. The credentials can be retrieved from the iscsi-gateway.cfg file on the iSCSI Gateway node.

  4. Add the two gateways to the dashboard:

    # ceph dashboard iscsi-gateway-add -i FILE_CONTAINING_GATEWAY_URL

    Example:

    [root@mon ~]# ceph dashboard iscsi-gateway-add -i /tmp/first_gateway
    Success
    [root@mon ~]# ceph dashboard iscsi-gateway-add -i /tmp/second_gateway
    Success
  5. Verify the gateways were added correctly:

    # ceph dashboard iscsi-gateway-list

    Example:

    [root@mon ~]# ceph dashboard iscsi-gateway-list
    {"gateways": {"ceph4": {"service_url": "http://admin:admin@192.168.122.193:5000"}, "ceph4": {"service_url": "http://admin:admin@192.168.122.193:5000"}}}
  6. Optional: If you make a mistake adding a gateway you can remove it by specifying its hostname as mentioned in the command iscsi-gateway-list:

    # ceph dashboard iscsi-gateway-rm GATEWAY_NAME

    Example:

    [root@mon ~]# ceph dashboard iscsi-gateway-rm ceph4
    Success

Additional Resources

9.4.3. iSCSI overview

The dashboard provides an overview that displays iSCSI gateway hosts and images exported over iSCSI.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • The Ceph iSCSI gateway is installed.
  • iSCSI gateways are added to the dashboard.
  • The dashboard iSCSI feature is enabled.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block.
  3. Click iSCSI:

    iSCSI overview

Additional Resources

9.4.4. Creating iSCSI targets

The dashboard allows you to create iSCSI targets.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • The Ceph iSCSI gateway is installed with at least two gateways.
  • iSCSI gateways are added to the dashboard.
  • The dashboard iSCSI feature is enabled.
  • A replicated pool with the RBD application enabled.
  • An erasure coded pool with the RBD application enabled.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block.
  3. Click iSCSI:

    iSCSI overview
  4. Towards the upper left corner of the page, click the Targets tab:

    iSCSI Targets
  5. Towards the upper left corner of the page, click the Add button:

    Create target initial view
  6. Optional: Modify the Target IQN.

    Modify Target IQN
  7. Optional: Set advanced settings for the target.

    1. Click the gear to set advanced settings for the target.

      Gear for Advanced Settings for Target IQN
    2. Set advanced settings in the Advanced Settings dialog window.

      Advanced Settings for Target IQN
    3. Click Confirm to save the settings.
  8. Click the Add portal button and select the first of at least two gateways:

    Add portal one
  9. Click the Add portal button and select the second of at least two gateways:

    Add additional gateways

    Repeat this step for any additional gateways.

  10. Click the Add image button and select an image to be exported by the target:

    Add an image

    Repeat this step for any additional images.

  11. Optional: Modify the Images.

    1. Click the gear to the right of the image

      Gear to Configure Images
    2. Modify image settings in the Configure dialog window:

      Configure Image
    3. Click Confirm to save the settings.
  12. Click the ACL authentication box and then click the Add initiator button:

    ACL authentication and Add initiator
  13. Enter the IQN from your client in the first text box:

    Client IQN

    Retrieve the client IQN from the system where the initiator software runs. See Configuring the iSCSI initiator in the Block Device Guide for more information.

  14. Enter a user name and password details for the target:

    Add initiator user name and password
  15. Click Add image and select an image:

    Add an image

    Repeat this step for any additional images.

  16. Finish the procedure by clicking the Create Target button:

    Create Target button
  17. Verify the target was added by looking for it on the Targets page.

    To locate the Targets page, follow the procedure Viewing iSCSI targets in the Dashboard guide.

Additional Resources

9.4.5. Viewing iSCSI targets

The dashboard allows you to view iSCSI targets.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • The Ceph iSCSI gateway is installed.
  • An iSCSI target is created.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block and then click iSCSI:

    Click Block and then click iSCSI
  3. Towards the upper left corner of the page, click the Targets tab:

    Click Targets
  4. To view details about a target, click on its row:

    Click the target row
  5. You can see the iSCSI topology, including whether an initiator is logged in:

    iSCSI topology
  6. Click an object to view detailed information about it:

    Target IQN details

    Note: Only some objects display detailed information when clicked.

Additional Resources

9.4.6. Editing iSCSI targets

The dashboard allows you to edit iSCSI targets.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • The Ceph iSCSI gateway is installed with at least two gateways.
  • iSCSI gateways are added to the dashboard.
  • The dashboard iSCSI feature is enabled.
  • A replicated pool with the RBD application enabled.
  • An erasure coded pool with the RBD application enabled.
  • An iSCSI target is created.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block.
  3. Click iSCSI:

    iSCSI overview
  4. Towards the upper left corner of the page, click the Targets tab:

    Click Targets
  5. To edit a target, click on its row:

    Click the target row
  6. Towards the upper left corner of the page, click the Edit button.

    Edit target initial view
  7. Edit the parameters and click the Edit Target button.

    Edit target window
  8. Verify the target was edited by looking for it on the Targets page.

    To locate the Targets page, follow the procedure Viewing iSCSI targets in the Dashboard guide.

Additional Resources

9.4.7. Deleting iSCSI targets

The dashboard allows you to delete iSCSI targets.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • The Ceph iSCSI gateway is installed with at least two gateways.
  • iSCSI gateways are added to the dashboard.
  • The dashboard iSCSI feature is enabled.
  • An iSCSI target is created.
  • Disconnect all iSCSI Initiators. See Disconnecting iSCSI initiators.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block.
  3. Click iSCSI:

    iSCSI overview
  4. Towards the upper left corner of the page, click the Targets tab:

    Click Targets
  5. To delete a target, click on its row:

    Click the target row
  6. Towards the upper left corner of the page, click the Edit drop down.
  7. From the drop-down, select Delete:

    Delete target initial view
  8. Click the Yes, I am sure box and then Click Delete iSCSI to save the settings.

    Delete iSCSI window

Additional Resources

9.4.8. Setting Discovery Authentication

The dashboard allows Discovery Authentication by using CHAP/CHAP_MUTUAL.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • The Ceph iSCSI gateway is installed with at least two gateways.
  • iSCSI gateways are added to the dashboard.
  • The dashboard iSCSI feature is enabled.
  • A replicated pool with the RBD application enabled.
  • An erasure coded pool with the RBD application enabled.

Procedure

  1. Log in to the Dashboard.
  2. On the navigation bar, click Block.
  3. Click iSCSI:

    iSCSI overview
  4. Towards the upper left corner of the page, click the Targets tab.

    iSCSI Targets
  5. Towards the upper left corner of the page, click the Discovery authentication button.

    Discovery authentication
  6. in Discovery Authentication window, provide the details and then Click the Submit button.

    Discovery Authentication window

9.5. Quality of Service configuration

As a storage administrator, you can use Quality of Service (QoS) limits to prioritize or deprioritize the performance of pools or images so all images get the resources they need to meet specific business needs.

9.5.1. Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.

9.5.2. Configuring Quality of Service on an existing image

As a storage administrator, you can use Quality of Service (QoS) limits to priortize or deprioritize the performance of an existing image.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • A replicated pool with the RBD application enabled.
  • An erasure coded pool with the RBD application enabled.
  • An existing image.

Procedure

  1. Log in to the dashboard.
  2. On the navigation bar, click Block and then click Images:

    Click Block and then click Images.
  3. Click the row of an image to select it for editing:

    Select an image.
  4. Click the Edit button:

    Click the Edit button.
  5. Click Advanced towards the bottom right corner of the dialog:

    Click Advanced…​
  6. Click the plus symbol next to Quality of Service to open the QoS settings:

    Open the QoS settings.
  7. Optional: Click the question mark symbol next to an individual setting to find out more about it.

    Click the question mark symbol.
  8. Enter or edit values for the QoS settings you want to change:

    Enter values for QoS settings.
  9. Optional: Click the eraser symbol for any setting to remove the local value and inherit the value from the parent pool or global configuration.

    Click the eraser symbol to remove local values.

    The field for the setting is disabled to indicate it is inheriting the value from the parent.

    The field is disabled.
  10. Click the Edit button to save the changes.

    Save the changes.

9.5.3. Configuring Quality of Service on an existing pool

As a storage administrator, you can configure Quality of Service (QoS) on an existing pool.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • A replicated pool with the RBD application enabled.
  • An erasure coded pool with the RBD application enabled.

Procedure

  1. Log in to the dashboard.
  2. On the navigation bar, click Pools.

    Click Pools.

  3. Click the row of a replicated pool with the RBD application to select it for editing:

    Select a pool.
  4. Click the Edit button:

    Click the Edit button.
  5. Click the plus symbol next to Quality of Service to open the QoS settings:

    Open the QoS settings.
  6. Optional: Click the question mark symbol next to an individual setting to find out more about it.

    Click the question mark symbol.
  7. Enter or edit values for the QoS settings you want to change:

    Enter values for QoS settings.
  8. Optional: Click the eraser symbol for any setting to remove the local value and inherit the value from the parent global configuration.

    Click the eraser symbol to remove local values.

    The field for the setting is disabled to indicate it is inheriting the value from the parent.

    The field is disabled.
  9. Click the Edit button to save the changes.

    Save the changes.

9.5.4. Configuring Quality of Service when creating an image

As a storage administrator, you can configure Quality of Service (QoS) limits when creating an image.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • A replicated pool with the RBD application enabled.
  • An erasure coded pool with the RBD application enabled.

Procedure

  1. Log in to the dashboard.
  2. On the navigation bar, click Block and then click Images:

    Click Block and then click Images.
  3. Click the Create button:

    Click the Create button.
  4. At 1, set the name, at 2, set the pool, at 3, set the size, and at 4, click Advanced.

    Set basic image settings
  5. Click the plus symbol next to Quality of Service to open the QoS settings:

    Open the QoS settings.
  6. Optional: Click the question mark symbol next to an individual setting to find out more about it.

    Click the question mark symbol.
  7. Enter or edit values for the QoS settings you want to change:

    Enter values for QoS settings.
  8. Optional: Click the eraser symbol for any setting to remove the local value and inherit the value from the parent pool configuration.

    Click the eraser symbol to remove local values.

    The field for the setting is disabled to indicate it is inheriting the value from the parent.

    The field is disabled.
  9. Click the Create RBD button:

    Create the image.

9.5.5. Configuring Quality of Service when creating a pool

As a storage administrator, you can configure Quality of Service (QoS) when creating a pool.

Prerequisites

  • A running Red Hat Ceph Storage cluster.
  • Dashboard is installed.
  • A replicated pool with the RBD application enabled.
  • An erasure coded pool with the RBD application enabled.

Procedure

  1. Log in to the dashboard.
  2. On the navigation bar, click Pools.

    Click Pools.
  3. Click the Create button towards the top left corner of the page:

    Click the Create button.
  4. In the dialog box, at 1, set the pool name, at 2, set the pool type to erasure, at 3, set the number of placement groups, at 4, enable EC Overwrites, at 5, set the rbd application, finally, at 6, click Create Pool.

    Create an EC RBD pool.
  5. Create another pool but this time set its type to replicated:

    create a replicated pool
  6. Click the plus symbol next to Quality of Service to open the QoS settings:

    Open the QoS settings.
  7. Optional: Click the question mark symbol next to an individual setting to find out more about it.

    Click the question mark symbol.
  8. Enter or edit values for the QoS settings you want to change:

    Enter values for QoS settings.
  9. Optional: Click the eraser symbol for any setting to remove the local value and inherit the value from the parent global configuration.

    Click the eraser symbol to remove local values.

    The field for the setting is disabled to indicate it is inheriting the value from the parent.

    The field is disabled.
  10. Click the Create Pool button:

    Create the pool.

9.5.6. Additional Resources