Oracle Cloud Infrastructure Documentation

Activating a Block Volume Replica

To create a new volume from a volume replica, you need to activate the replica. The activation process creates a new volume by cloning the replica.

Note

For volumes in a volume group configured for replication, activate the volume group replica instead of individual volume replicas to ensure that all replicas are activated from the same coordinated synchronization point.

See Limitations and Considerations and Activating a Volume Group Replica.

    1. On the Block Volume Replicas list page, find the block volume replica you want to work with. If you need help finding the list page or the boot volume, see Listing Block Volume Replicas.
    2. From the Actions menu (three dots), select Activate and then Confirm.
    3. In the Activate Replica panel, enter the following information:
      • Name: Replica name.
      • Create in compartment: Compartment to create the replica in.
      • Cluster Placement Group: (Optional) Select a cluster placement group for the replica.
        Note

        This option is visible when cluster placement groups are enabled for the tenancy, and you've created and activated a cluster placement group with the capability added for volume resources. See Cluster Placement Groups for Block Volume.
      • Volume size and performance: Select default or custom.
      • Enable cross ad/region replication: (Optional) Turn on to enable cross-region replication.
        1. Select the target region for the replica.
        2. Select the availability domain for the replica.
        3. Enter a name for the replica.
        4. Select Confirm.
      • Volume Encryption: (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. Select the vault compartment and vault that contain the master encryption key you want to use.
        3. Select the master encryption key compartment and master encryption key.
          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.
      • Tagging: (Optional) Select Show tagging options to add tags to the volume. If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.
    4. Select Activate.

    The new volume appears in the list, in the provisioning state.

  • Use the oci bv volume create command and specify the source-volume-replica-id, --compartment-id, and availability-domain parameters to activate a block volume replica:

    oci bv volume create --source-volume-replica-id  <volume_ID> --compartment-id <compartment_ID> --availability-domain <availability_domain>

    For example:

    oci bv volume create --source-volume-replica-id ocid1.blockvolumereplica.oc1.phx.<unique_ID> --compartment-id ocid1.compartment.oc1.phx.<unique_ID> --availability-domain ABbv:PHX-AD-1

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

  • Run the CreateVolume operation and specify blockVolumeReplica for the type attribute in the VolumeSourceDetails resource to activate a block volume replica.