Chapter 16. Management of buckets of a multi-site object configuration on the Ceph dashboard

Procedure

1. From the dashboard navigation of the secondary site, go to Object→Buckets.

   The Object Gateway buckets from the primary site are displayed.

2. Select the bucket that you want to edit, and click Edit from the action drop-down.

3. In the Edit Bucket form, edit the required prameters, and click Edit Bucket.

   A notification is displayed that the bucket is updated successfully.

   Figure 16.1. Edit buckets in a multi-site

   

   View larger image

   

Procedure

1. From the dashboard navigation of the primary site, go to Object→Buckets.
2. Select the bucket of the secondary site to be deleted, and click Delete from the action drop-down.

3. In the Delete Bucket notification, select Yes, I am sure and click Delete bucket.

   The bucket is deleted from the Buckets table.

Procedure

1. Enable the Ceph Object Gateway module for import/export on both the the primary and secondary sites.

   1. From the dashboard navigation of the secondary site, go to Object→Multi-site.
   2. In the In order to access the import/export feature, the rgw module must be enabled note, click Enable.

2. On the primary site dashboard, create a default realm, zonegroup, and zone.

   1. Click Create Realm.
   2. In the Create Realm form, provide a realm name, and select Default.
   3. Click Create Realm.
   4. Click Create Zone Group from the action drop-down.
   5. In the Create Zone Group form, provide a zone group name, the Ceph Object Gateway endpoints, and select Default.
   6. Click Create Zone Group.
   7. Click Create Zone from the action drop-down.

   8. In the Create Zone form, provide a Zone Name, select Default, and provide the Ceph Object Gateway endpoints of the primary site. For the user, provide the access and secret key of the user with system privileges.

      Note

      While creating a zone, Red Hat recommends to give access key and secret key of the dashboard default user, dashboard.

   9. Click Create Zone.

      A warning is displayed to restart the Ceph Object Gateway service to complete the zone creation.

3. Restart the Ceph Object Gateway service.

   1. From the dashboard navigation of the secondary site, go to Administration→Services.
   2. Select the Ceph Object Gateway service row and expand the row.
   3. From the Daemons tab, select the hostname.
   4. Click Restart from the action drop-down.

4. From the dashboard navigataion, in Object→Overview you get an error that "The Object Gateway Service is not configured". This bug is a known issue. See BZ#2231072.

   1. As a workaround, set the Ceph Object Gateway credentials on the command-line interface.

      Syntax

      ceph dashboard set-rgw-credentials
      RGW credentials configured

      Copy to Clipboard Toggle word wrap

   2. Go to Object→Overview to verify that you are able to access the Ceph Object Gateway on the dashboard.

5. Create a replication user on the primary site. You can use the following two options:

   • Create user using the CLI:

     Example

     [ceph: root@host01 /]# radosgw-admin user create --uid="uid" --display-name="displayname" --system

     Copy to Clipboard Toggle word wrap

   • Create user from the dashboard and modify the user from the CLI:

     Example

     [ceph: root@host01 /]# radosgw-admin user modify --uid="uid" --system

     Copy to Clipboard Toggle word wrap

6. From the dashboard navigation, go to Object→Users.

7. Expand the user row and from Keys, click Show.

   1. Use the Copy to Clipboard to copy the access and secret keys.

      These will be used in a later step.

8. From the primary site dashboard, go to Object→Multi-site.

   1. From the Topology Viewer, select the zone and click the Edit icon.
   2. From the Edit Zone form, paste the access key in the S3 access key field and the secret key in the S3 secret key field. Use the keys that were copied previously.
   3. Click Edit Zone.

9. Click Export.

   1. From the Export Multi-site Realm Token dialog, copy the token.
10. From the secondary site, go to Object→Multi-site.

11. Import the token from the primary zone, by clicking Import.

    1. In the Import Multi-site Token dialog, in the Zone section, paste the token that was copied earlier, and provide a secondary zone name.
    2. In the Service section, select the placement and the port where the new Ceph Object Gateway service is going to be created.

    3. Click Import.

       A warning is displayed to restart the Ceph Object Gateway service.

12. Restart the Ceph Object Gateway service.

    1. From the dashboard navigation of the secondary site, go to Administration→Services.
    2. Select the Ceph Object Gateway service row and expand the row.
    3. From the Daemons tab, select the hostname.

    4. Click Restart from the action drop-down.

       Wait until the users are synced to the secondary site.

13. Verify that the sync is complete using the following commands:

    Syntax

    radosgw-admin sync status
    radosgw-admin user list

    Copy to Clipboard Toggle word wrap

    Example

    [ceph: root@host01 /]# radosgw-admin sync status
    [ceph: root@host01 /]# radosgw-admin user list

    Copy to Clipboard Toggle word wrap

14. In Object→Overview you get an error that "The Object Gateway Service is not configured". This bug is a known issue. See BZ#2231072.

    1. As a workaround, set the Ceph Object Gateway credentials on the command-line interface.

       Syntax

       ceph dashboard set-rgw-credentials
       RGW credentials configured

       Copy to Clipboard Toggle word wrap

    2. Go to Object→Overview to verify that you are able to access the Ceph Object Gateway on the dashboard.

15. On the primary site, Object→Overview, in the Multi-Site Sync Status section, an error is displayed because on the secondary zone you can see that the endpoints and the hostname are not the IP address. This bug is a known issue while configuring multi-site. See BZ#2242994.

    1. As a workaround, from the secondary site dashboard, go to Object→Multi-site.
    2. Select the secondary zone and click the Edit icon.
    3. Edit the endpoints to reflect the IP address.
    4. Click Edit Zone.

16. On the primary site and secondary site dashboards, from Object→Overview, in the Multi-Site Sync Status section, the status displays.

    

    View larger image