Chapter 9. Block devices

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click the Block:

   

3. Select Images from the drop-down:

   

4. In the Images tab, Click the Create button:

   

5. In the CreateRBD window, enter the parameters:

   

6. Optional: Click Advanced and set the parameters:

   
   

7. Click the CreateRBD button:

   

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

   

Procedure

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

3. Click Images:

   

   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:

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. To edit the image, in the Images tab, click its row:

   

5. Select Edit In the Edit drop-down:

   

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

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. To copy the image, in the Images tab, click its row:

   

5. Select Copy In the Edit drop-down:

   

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

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. To move the image to Trash, in the Images tab, 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 the Move Image button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. In the Trash tab, click the Purge Trash button:

   

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

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

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 name of the image , and then click the Restore Image button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. To edit the image, in the Images tab, click its row:

   

5. Select Delete In the Edit drop-down:

   

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

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

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 CreateRBD Snapshot dialog, enter the parameters and click the CreateRBD Snapshot button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

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 RenameRBD Snapshot dialog, enter the parameters and click the RenameRBD Snapshot button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

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. A notification towards the top right corner of the page indicates the snapshot of the image was updated successfully.

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. To clone 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 CloneRBD dialog, enter the parameters and click the CloneRBD button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. To copy 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:

   

6. In the CopyRBD dialog, enter the parameters and click the CopyRBD button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

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 window, click the Rollback button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

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. A notification towards the top right corner of the page indicates the snapshot of the image was updated successfully.

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Select Images from the drop-down:

   

4. To delete 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:

   

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

   

Procedure

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

3. Click Mirroring:

   

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

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Click Mirroring from the drop-down:

   

4. In the Pools tab, click the row:

   

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 the Update button:

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block:

   

3. Click Mirroring from the drop-down:

   

4. In the Pools tab, click the row

   

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

   

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

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block.

   

3. Click Mirroring from the drop-down:

   

4. In the Pools tab, click the row

   

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

   

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

   

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

   

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block.

   

3. Click Mirroring from the drop-down:

   

4. In the Pools tab, click the row:

   

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:

   

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

   

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

Procedure

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

3. Click iSCSI:

   

Procedure

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

3. Click iSCSI:

   

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

   

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

   

6. Optional: Modify the Target IQN.

   

7. Optional: Set advanced settings for the target.

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

      

   2. Set advanced settings in the Advanced Settings dialog window.

      
   3. Click Confirm to save the settings.

8. Click the Add portal button and select the first of at least two gateways:

   

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

   

   Repeat this step for any additional gateways.

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

    

    Repeat this step for any additional images.

11. Optional: Modify the Images.

    1. Click the gear to the right of the image

       

    2. Modify image settings in the Configure dialog window:

       
    3. Click Confirm to save the settings.

12. Click the ACL authentication box and then click the Add initiator button:

    

13. Enter the IQN from your client in the first text box:

    

    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:

    

15. Click Add image and select an image:

    

    Repeat this step for any additional images.

16. Finish the procedure by clicking the 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.

Procedure

1. Log in to the Dashboard.

2. On the navigation bar, click Block and then click iSCSI:

   

3. Towards the upper left corner of the page, click the Targets tab:

   

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

   

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

   

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

   

   Note: Only some objects display detailed information when clicked.

Procedure

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

3. Click iSCSI:

   

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

   

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

   

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

   

7. Edit the parameters and click the Edit Target button.

   

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.

Procedure

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

3. Click iSCSI:

   

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

   

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

   
6. Towards the upper left corner of the page, click the Edit drop down.

7. From the drop-down, select Delete:

   

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

   

Procedure

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

3. Click iSCSI:

   

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

   

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

   

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

   

Procedure

1. Log in to the dashboard.

2. On the navigation bar, click Block and then click Images:

   

3. Click the row of an image to select it for editing:

   

4. Click the Edit button:

   

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

   

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

   

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

   

8. Enter or edit values for the QoS settings you want to change:

   

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.

   

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

   

10. Click the Edit button to save the changes.

    

Procedure

1. Log in to the dashboard.

2. On the navigation bar, click Pools.

   

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

   

4. Click the Edit button:

   

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

   

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

   

7. Enter or edit values for the QoS settings you want to change:

   

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

   

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

   

9. Click the Edit button to save the changes.

   

Procedure

1. Log in to the dashboard.

2. On the navigation bar, click Block and then click Images:

   

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

   

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

   

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

   

7. Enter or edit values for the QoS settings you want to change:

   

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

   

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

   

9. Click the Create RBD button:

   

Procedure

1. Log in to the dashboard.

2. On the navigation bar, click Pools.

   

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

   

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.

   

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

   

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

   

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

   

8. Enter or edit values for the QoS settings you want to change:

   

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

   

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

   

10. Click the Create Pool button: