Oracle Cloud Infrastructure Documentation

Enabling Cross-Region Replication When Updating An Existing Boot Volume

Learn how to enable cross-region replication for an existing boot volume.

  • Use the steps described in this procedure to enable replication on an existing boot volume.

    1. On the Boot Volumes list page, select the boot volume you want to work with. If you need help finding the list page or the boot volume, see Listing Boot Volumes.
    2. On the details page, select Edit.
    3. In the Cross/ad region replication section, move the Enable cross ad/region replication slider to the right to enable cross-region replication.
    4. Select the target region for the replica.
    5. Select the availability domain for the replica.
    6. Enter a name for the replica.
    7. Select Confirm to acknowledge the cost warning.
    8. (Optional) Encrypt the data in this volume 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.

    9. Select Save changes.

  • Use the oci bv boot-volume update command and specify the --boot-volume-id, --boot-volume-replicas, "displayName", "availabilityDomain" and "xrrKmsKeyId"parameters to enable cross-region replication when updating an existing boot volume:

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

    For example:

    oci bv boot-volume update --boot-volume-id ocid1.bootvolume.oc1.phx.<unique_ID> --boot-volume-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 UpdateVolume operation and specify the bootVolumeReplicas attribute in the UpdateVolumeDetails resource to enable cross-region replication for an existing boot volume.