Chapter 12. Managing Ceph Object Gateway using the dashboard

Procedure

1. Log in to the Dashboard.
2. On the navigation bar, click Object Gateway.
3. Click Users and then Click Create.

4. In the Create User window, set the following parameters:

   1. Set the user name, full name, and edit the maximum number of buckets if required.
   2. Optional: Set an email address or suspended status.
   3. Optional: Set a custom access key and secret key by unchecking Auto-generate key.
   4. Optional: Set a user quota.
   5. Check Enabled under User quota.
   6. Uncheck Unlimited size or Unlimited objects.
   7. Enter the required values for Max. size or Max. objects.
   8. Optional: Set a bucket quota.
   9. Check Enabled under Bucket quota.
   10. Uncheck Unlimited size or Unlimited objects:
   11. Enter the required values for Max. size or Max. objects:

5. Click Create User.

   Figure 12.3. Create Ceph object gateway user

   
6. You get a notification that the user was created successfully.

Procedure

1. Log in to the Dashboard.
2. On the navigation bar, click Object Gateway.
3. Click Users.
4. Select the user by clicking its row.
5. From Edit drop-down menu, select Edit.
6. In the Edit User window, click +Create Subuser.
7. In the Create Subuser dialog box, enter the user name and select the appropriate permissions.

8. Check the Auto-generate secret box and then click Create Subuser.

   Figure 12.4. Create Ceph object gateway subuser

   
   Note

   By clicking Auto-generate-secret checkbox, the secret key for object gateway is generated automatically.

9. In the Edit User window, click the Edit user button
10. You get a notification that the user was updated successfully.

Procedure

1. Log in to the Dashboard.
2. On the navigation bar, click Object Gateway.
3. Click Users.
4. To edit the user capabilities, click its row.
5. From the Edit drop-down menu, select Edit.
6. In the Edit User window, edit the required parameters.

7. Click Edit User.

   Figure 12.5. Edit Ceph object gateway user

   
8. You get a notification that the user was updated successfully.

Procedure

1. Log in to the Dashboard.
2. On the navigation bar, click Object Gateway.
3. Click Users.
4. To delete the user, click its row.
5. From the Edit drop-down menu, select Delete.
6. In the Edit User window, edit the required parameters.

7. In the Delete user dialog window, Click the Yes, I am sure box and then Click Delete User to save the settings:

   Figure 12.6. Delete Ceph object gateway user

   

Procedure

1. Log in to the Dashboard.
2. On the navigation bar, click Object Gateway.
3. Click Buckets and then click Create.

4. In the Create Bucket window, enter a value for Name and select a user that is not suspended. Select a placement target.

   Figure 12.7. Create Ceph object gateway bucket

   
   Note

   A bucket’s placement target is selected on creation and can not be modified.

5. Optional: Enable Locking for the objects in the bucket. Locking can only be enabled while creating a bucket. Once locking is enabled, you also have to choose the lock mode, Compliance or Governance and the lock retention period in either days or years, not both.

6. Optional: Enable Security to encrypt the objects in the bucket. To enable encryption on a bucket, you need to set the configuration values for SSE-S3.

   1. To set the configuration values, hover the cursor over the question mark and click Click here.

   2. In the Update RGW Encryption Configurations window, select SSE-S3 as the Encryption Type, provide the required details, and click Submit.

      Figure 12.8. Encrypt objects in the bucket

      
      Note

      When using SSE-S3 encryption type, Ceph manages the encryption keys that are stored in the vault by the user.

7. Click Create bucket.
8. You get a notification that the bucket was created successfully.

Procedure

1. Log in to the Dashboard.
2. On the navigation bar, click Object Gateway.
3. Click Buckets.
4. To edit the bucket, click it’s row.
5. From the Edit drop-down select Edit.

6. In the Edit bucket window, edit the Owner by selecting the user from the dropdown.

   Figure 12.9. Edit Ceph object gateway bucket

   

   1. Optional: Enable Versioning if you want to enable versioning state for all the objects in an existing bucket.

      • To enable versioning, you must be the owner of the bucket.
      • If Locking is enabled during bucket creation, you cannot disable the versioning.
      • All objects added to the bucket will receive a unique version ID.
      • If the versioning state has not been set on a bucket, then the bucket will not have a versioning state.

   2. Optional: Check Delete enabled for Multi-Factor Authentication. Multi-Factor Authentication(MFA) ensures that users need to use a one-time password(OTP) when removing objects on certain buckets. Enter a value for Token Serial Number and Token PIN.

      Note

      The buckets must be configured with versioning and MFA enabled which can be done through the S3 API.

7. Click Edit Bucket.
8. You get a notification that the bucket was updated successfully.

Procedure

1. Log in to the Dashboard.
2. On the navigation bar, click Object Gateway.
3. Click Buckets.
4. To delete the bucket, click it’s row.
5. From the Edit drop-down select Delete.

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

   Figure 12.10. Delete Ceph object gateway bucket

   

Procedure

1. On the Dashboard landing page of the secondary site, in the vertical menu bar, click Object Gateway drop-down list.
2. Select Buckets.

3. You can see those object gateway buckets on the secondary landing page that were created for the object gateway users on the primary site.

   Figure 12.12. Monitoring object gateway monitoring

   
4. Click the row of the bucket that you want to edit.
5. From the Edit drop-down menu, select Edit.

6. In the Edit Bucket window, edit the required parameters and click Edit Bucket.

   Figure 12.13. Edit buckets in a multi-site

   

Procedure

1. On the Dashboard landing page of the primary site, in the vertical menu bar, click Object Gateway drop-down list.
2. Select Buckets.
3. You can see those object gateway buckets of the secondary site here.
4. Click the row of the bucket that you want to delete.
5. From the Edit drop-down menu, select Delete.
6. In the Delete Bucket dialog box, select Yes, I am sure checkbox, and click Delete Bucket.