Oracle Cloud Infrastructure Documentation

Enabling Cross-Region Replication When Updating an Existing Volume Group

Use the steps described in this procedure to enable replication on an existing volume group. You can also enable replication when you create a volume.

For more information, see Creating a Volume Group.

    1. On the Volume Groups list page, select the volume group you want to work with. If you need help finding the list page or the volume group, see Listing Volume Groups.
    2. On the details page, select Edit.
    3. Select Next twice to display the Cross region replication section.
    4. In the Cross region replication section, move the Enable cross region replication slider to the right to enable cross-region replication.
    5. Select Confirm to acknowledge the cost warning.
    6. (Optional) Encrypt the data in this volume group by using your own encryption key. For more information, see Customer-Managed Encryption Keys for Cross-Region Operations.
      1. Select Encrypt using customer-managed keys.
      2. Enter the encryption key OCID for the destination region.
        Note

        The service doesn't support encrypting volumes with keys that are encrypted using the Rivest-Shamir-Adleman (RSA) algorithm. When you use your own keys, you must use keys that are encrypted using the Advanced Encryption Standard (AES) algorithm. This restriction applies to block volumes and boot volumes.
    7. Select Next twice to display the Summary section.

    8. Select Save changes.

  • Use the oci bv volume-group update command and specify the --volume-group-id, --volume-group-replicas '[{"displayName", "availabilityDomain" and "xrrKmsKeyId" parameters to enable cross-region replication for an existing volume group:

    oci bv volume-group update --volume-group-id <volume-group_ID> --volume-group-replicas '[{"displayName":"<display_name>","availabilityDomain":"<availability-domain_ID>","xrrKmsKeyId" : "<kms_key_ID>"}]'

    For example:

    oci bv volume-group update --volume-group-id ocid1.volumegroup.oc1.phx.<unique_ID> --volume-group-replicas '[{"displayName":"Sample_Replica","availabilityDomain":"pjBI:US-ASHBURN-AD-1","xrrKmsKeyId" : "ocid1.key.oc1.iad-ad-1.<unique_ID>"}]'

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the UpdateVolumeGroup operation and specify the volumeGroupReplicas attribute in the UpdateVolumeGroupDetails resource to enable cross-region replication in an existing volume group.