Replicating a Volume
The Block Volume service provides you with the capability to perform ongoing automatic asynchronous replication of block volumes, boot volumes, and volume groups to other regions and availability domains.
Block Volume supports two types of replication:
- Cross region, for replication between regions.
- Cross availability domain, for replication between availability domains within the same region.
This feature supports the following scenarios without requiring volume backups and volume group backups:
- Disaster recovery
- Migration
- Business expansion
The replication feature is complementary to the backup feature, not a replacement. Backups give you a point-in-time snapshot of volumes that enables you to return to a previous version of a volume or volume group. Replicas give you the current version of the data.
When you enable replication for a volume or volume group, the process includes an initial sync of the data from the source to the replica. Depending on volume size and amount of data written to volumes, this sync can take hours. After the initial synchronization process is complete, the replication process is continuous, with the typical Recovery Point Object (RPO) target rate being less than thirty minutes for replication across regions, however the RPO can vary. See Limitations and Considerations.
Replication doesn't cause any downtime or impact on source volumes.
Limitations and Considerations
The following applies to both replication to another region and replication to another availability domain within the same region.
- Replication isn't supported for volumes encrypted using customer-managed Vault encryption keys.
- You can't resize a volume with replication enabled. When resizing a volume, you need to disable replication, which deletes the volume replica. After the volume is resized, you can reenable replication for the volume, which starts the replication process from scratch.
- While the typical RPO target rate is significantly less than thirty minutes for replication, the RPO can vary depending on the change rate of data on the source volume. For example, the RPO can be greater than an hour for volumes with a large amount of write I/O operations to the volume.
Cost Considerations for Replication
After you enable replication for a volume or volume group, it will be replicated in the specified availability domain or the specified region and availability domain. Your bill will include storage costs for the volume or volume group replica in the destination. The replica in the destination is billed using the Block Storage Lower Cost option price, regardless of volume type in the source region.
See Oracle Storage Cloud Pricing for information about storage pricing.
For cross region replication, your bill will also include applicable network costs, see Network Costs for Cross Region Replication.
Cross Region Replication
Block Volume replication supports replicating a volume or volume group to another region. For this type of replication, when you enable replication for a volume or volume group, you select a different region than the current source region as the destination region to replicate to. If the destination region supports multiple availaiblity domains, you can also select the availability domain you want to replicate to.
The source region for the volume or volume group determines the target regions available to select as a destination region for replication. Each region has one or more regions available as possible destination regions. The destination regions are selected based on geographical locations. Your tenancy must be subscribed to the destination region for replication. See Destination Regions for more information.
Network Costs for Cross Region Replication
Your bill will also include any applicable network costs for the replication process between regions. Network costs for replication between availability domains within the same region are not billed. As part of the replication process, all data being updated on the source volume or source volume group is transferred to the replica, so volumes with continual updates incur higher network costs.
You can see the amount of data transferred for an individual volume during replication in the Console.
To see the amount of data transferred from the replication process for a volume
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes.
- Click the replica that you want to see the amount of data transferred for. On the Replica Details page, the Total Data Transferred field displays the amount of data, in GBs, that has been transferred during the replication process for the volume. This number includes all data from the point that volume replication was enabled to now.
See Oracle Networking Cloud Pricing for information about network pricing.
Destination Regions
In most regions, you can select almost any subscribed destination region for cross-region replication. For exceptions, see volume-replica-disallowed-regions.json.
If your tenancy isn't subscribed to any of the destination regions for the source region, and the source region only supports one availability domain, no regions are displayed in the region list and an error message is shown. For source regions containing multiple availability domains, the source region is displayed in the region list, and cross availability domain replication is the only replication available. To use cross region replication, you must subscribe to one of the destination regions for the source region. To subscribe to a region, see Managing Regions.
If you don't see a region that you're subscribed to in the destination region list, open a support ticket to request that the region be added as a destination target for the source region for your volume or volume group.
Cross Availability Domain Replication
Block Volume replication supports replicating a volume or volume group to another availability domain within the same region. For this type of replication, when you enable replication for a volume or volume group, if the current region contains more than one availability domain, the regions list will include the current region. Select this region as the source region, and then select the availaiblity domain that you want to replicate to.
Replication across availability domains is only supported in commercial regions with multiple availability domains. To determine which regions contain more than one availability domain, see the Availability Domains field in the table listing the commercial regions in About Regions and Availaibility Domains.
Replication Metrics
The Block Volume service emits metrics to help you track volume replication operations. For more information, see Descriptions: Replication Metrics and Descriptions: Performance Metrics.
Tagging Resources
You can apply tags to your resources to help you organize them according to your business needs. You can update the resource later with the desired tags. For general information about applying tags, see Resource Tags. Any tags applied to the source volume are replicated to the volume replica in the destination region.
Required IAM Policy
To use Oracle Cloud Infrastructure, an administrator must be a member of a group granted security access in a policy by a tenancy administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don't have permission or are unauthorized, verify with the tenancy administrator what type of access you have and which compartment your access works in.
For administrators: The policy in Let volume admins manage block volumes, backups, and volume groups lets the specified group do everything with block volumes, backups, and volume groups.
Block Volume Replicas
Use the procedures in this section to create and manage block volume replicas.
Enabling Cross-Region Replication When Creating a Block Volume
Learn how to enable cross-region replication when you create a new block volume.
See Creating a Volume. Use the
oci bv volume create
command and specify the--compartment-id
,--block-volume-replicas
,"availabilityDomain"
and"xrrKmsKeyId"
parameters to create a block volume with cross-region replication enabled:oci bv volume create --compartment-id <compartment_ID> --block-volume-replicas '[{"displayName":"<display_name>","availabilityDomain":"<availability-domain_ID>","xrrKmsKeyId" : "<kms_key_ID>"}]'
For example:
oci bv volume create --compartment-id ocid1.compartment.oc1.phx.<unique_ID> --block-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
CreateVolume
operation and specify theblockVolumeReplicas
attribute in theCreateVolumeDetails
resource to enable cross-region replication for a new block volume.
Enabling Cross-Region Replication When Updating an Existing Block Volume
Learn how to enable cross-region replication for an existing block volume
Use the steps described in this procedure to enable replication on an existing volume. You can also enable replication when you create a volume, see Creating a Block Volume.
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes.
-
Select the block volume that you want to enable replication for.
-
Select Edit.
-
In the Cross region replication section, select ON.
-
For cross region replication, select the region you want to replicate the volume to, the availability domain to place the volume replica in, and then specify the name for the volume replica.
To replicate to another availability domain in the same region, select the region the volume is located in, the availability domain to place the volume replica in, and then specify the name for the volume replica.
-
Optionally, encrypt the volume replica in the destination region by using your own Vault encryption key. In Cross region replication encryption, select Encrypt using customer-managed keys , and then specify the OCID for a valid encryption key in the region you selected to replicate the volume to. For more information, see Requirements for Customer-Managed Encryption Keys for Cross-Region Operations.
-
Select Confirm to acknowledge the cost warning.
-
Select Save changes.
Use the
oci bv volume update
command and specify the--volume-id
,"displayName"
,"availabilityDomain"
and"xrrKmsKeyId"
parameters to enable cross-region replication when updating an existing block volume:oci bv volume update --volume-id <volume_ID> --block-volume-replicas '[{"displayName":"<display_name>","availabilityDomain":"<availability-domain_ID>","xrrKmsKeyId" : "<kms_key_ID>"}]'
For example:
oci bv volume update --volume-id ocid1.volume.oc1.phx.<unique_ID> --block-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 theblockVolumeReplicas
attribute in theUpdateVolumeDetails
resource to enable cross-region replication for an existing block volume.
Updating the Destination Region or Availability Domain Replication Settings for a Block Volume
Learn how to update replication settings for an existing block volume.
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes.
-
Select the block volume that you want to change the destination region and availability domain for.
-
Select Edit.
- In the Cross region replication section, select OFF.
-
Select Confirm to acknowledge the replica deletion.
- Select Save changes.
-
Select Edit.
- In the Cross region replication section, select ON.
-
Select the region you want to replicate the volume to and the availability domain to create the volume replica in, and then specify the name for the volume replica.
To replicate to another availability domain in the same region, select the region the volume is located in and the availability domain to create the volume replica in, and then specify the name for the volume replica.
-
Optionally, encrypt the volume replica in the destination region by using your own Vault encryption key. In Cross region replication encryption, select Encrypt using customer-managed keys , and then specify the OCID for a valid encryption key in the region you selected to replicate the volume to. For more information, see Requirements for Customer-Managed Encryption Keys for Cross-Region Operations.
-
Select Confirm to acknowledge the cost warning.
-
Select Save changes.
Disable and then re-enable cross-volume replication. When you re-enable cross-region replication, specify the new availability domain you want to replicate to.
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Disableand re-enable cross-region replication. When you re-enable cross-region replication, specify the new availiability domain you want to replicate to.
Disabling Cross-Region Replication for a Block Volume
Learn how to disable cross-region replication for an existing block volume.
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes.
-
Select the block volume that you want to disable replication for.
- Select Edit.
- In the Cross region replication section, select OFF.
- Select Confirm to acknowledge the that volume replica will be deleted.
-
Select Save changes.
Use the
oci bv volume update
command and specify the--volume-id
parameter and'[]'
for the--block-volume-replicas
parameter to disable cross-region replication for a block volume:oci bv volume update --volume-id <volume_ID> --block-volume-replicas '[]'
For example:
oci bv volume update --volume-id ocid1.volume.oc1.phx.<unique_ID> --block-volume-replicas '[]'
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the
UpdateVolume
operation and specify[]
for theblockVolumeReplicas
attribute in theUpdateVolumeDetails
resource to disable cross-region replication for an existing block volume.
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.
For volumes in a volume group configured for replication, activate the volume group replica instead of individual volume replicas if you want to ensure that all replicas are activated from the same coordinated synchronization point.
See Limitations and Considerations and Activating a Volume Group Replica.- Open the navigation menu and select Storage. Under Block Storage, select Block Volume Replicas. Ensure that you are in correct destination region or availability domain that contains the volume replica you want to activate.
-
Select the replica that you want to activate.
- Select Activate and then Confirm.
- In the Activate Volume Replica form, specify the settings for the new volume, including:
- Name
- Compartment
- (Optional) Cluster Placement Group Note
The Cluster Placement Group control only appears in the Console if Cluster Placement Groups are enabled for the tenancy, and if you've created and activated a cluster placement group with the capability added for volume resources. For more information, see Cluster Placement Groups for Block Volume. - Size and performance settings
- Reservations
- Volume replication
- Encryption
- Tags
- Select Activate replica. The new volume appears in the block volumes list, in the provisioning state.
Use the
oci bv volume create
command and specify thesource-volume-replica-id
,--compartment-id
, andavailability-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 specifyblockVolumeReplica
for thetype
attribute in theVolumeSourceDetails
resource to activate a block volume replica.
Listing Block Volume Replicas
Learn how to list the block volume replicas in a specified compartment and availability domain.
Open the navigation menu and select Storage. Under Block Storage, select Block Volume Replicas.
Use the
oci bv block-volume-replica list
command and specify the--availability-domain
, and compartment--compartment-id
parameters to list the block volume replicas in a specified compartment and availability domain:oci bv block-volume-replica list --availability-domain <availability_domain> --compartment-id <compartment_ID>
For example:
oci bv block-volume-replica list --availability-domain ABbv:PHX-AD-1 --compartment-id ocid1.compartment.oc1.phx.<unique_ID>
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the
ListBlockVolumeReplicas
operation and specify theavailabilityDomain
andcompartmentId
attributes to view a list of block volume replicas in the specified compartment and availiability domain.
Getting Details for a Block Volume Replica
Learn how to view details for a specific block volume replica.
-
Open the navigation menu and select Storage. Under Block Storage, select Block Volume Replicas.
-
Select the block volume replica that you want to view details for.
-
Use the
oci bv block-volume-replica get
command and specify the--block-volume-replica-id
parameter to view details for a block volume replica:oci bv block-volume-replica get --block-volume-replica-id <block-volume-replica-ID>
For example:
oci bv block-volume-replica get --block-volume-replica-id ocid1.blockvolumereplica.oc1.phx.<unique_ID>
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the
GetBlockVolumeReplica
operation and specify theblockVolumeReplicaId
attribute to view details for a boot volume replica.
Restoring a Block Volume Replica to Its Source Region
To restore a block volume replica to the source region, you must activate the replica in the destination region, with volume replication enabled, and select the original source region as the target region for replication.
Using the Console
- Open the navigation menu and select Storage. Under Block Storage, select Block Volume Replicas. Ensure that you're in the correct destination region that contains the volume replica you want to activate.
-
Select the replica that you want to activate.
- Select Activate.
- In the Activate replica form, specify the settings for the new volume, including:
- Name
- Compartment
- Size and performance settings
- Volume replication
- Encryption
- Tags
- In Cross region replication, select ON and the original source region, and enter a name for replica.
- Select Confirm.
- Optionally, configure encryption and tags.
- Select Activate replica. The new volume appears in the block volumes list, in the provisioning state. After the initial synchronization finishes, the restoration process is complete, and you can use the volume in the original source region.
Using the CLI
oci bv volume create
command and specify the --availability-domain
, --compartment-id
, --display-name
, --source-details
, blockVolumeReplicaId
, and "displayName"
parameters to restore a block volume replica to its source region:oci bv volume create --availability-domain <availability_domain> --compartment-id <compartment_ID> --display-name <activated_volume_name> --source-details '{"type": "blockVolumeReplicaId", "blockVolumeReplicaId": "<replica_ID>"}' --blockVolumeReplicas '[{"displayName": "<replica_display_name>", "availabilityDomain": "<destination_availability_domain>"}]'
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Using the API
Run the CreateVolume
operation and specify the compartmentId
, blockVolumeReplicas
and sourceDetails
attributes for the CreateVolumeDetails
resource to restore a block volume replica to its source region.
Boot Volume Replicas
Use the procedures in this section to create and manage boot volume replicas.
Enabling Cross-Region Replication When Creating a Boot Volume
Learn how to enable cross-region replication when you create a new boot volume.
This task can't be performed using the Console. Use the
oci bv boot-volume create
command and specify the--source-boot-volume-id
,--compartment-id
,"displayName"
,"availabilityDomain"
and"xrrKmsKeyId"
parameters to create boot volume with cross-region replication enabled:oci bv boot-volume create --source-boot-volume-id <volume_ID> --compartment-id <compartment_ID> --boot-volume-replicas '[{"displayName":"<display_name>","availabilityDomain":"<availability-domain_ID>","xrrKmsKeyId" : "<kms_key_ID>"}]'
For example:
oci bv boot-volume create --source-boot-volume-id ocid1.bootvolume.oc1.phx.<unique_ID> --compartment-id ocid1.compartment.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
.CreateVolume
operation and specify thebootVolumeReplicas
attribute in theCreateVolumeDetails
resource to enable cross-region replication for the new boot volume.
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.
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes. In the Block Storage menu on the sidebar, select Boot Volumes.
-
Select the boot volume that you want to enable replication for.
- Select Edit.
- In the Cross region replication section, select ON.
-
For cross region replication, select the region you want to replicate the boot volume to, the availability domain to place the boot volume replica in, and then specify the name for the boot volume replica.
To replicate to another availability domain in the same region, select the region the boot volume is located in, the availability domain to place the boot volume replica in, and then specify the name for the boot volume replica.
-
Optionally, encrypt the boot volume replica in the destination region by using your own Vault encryption key. Select Encrypt using customer-managed keys for Cross region replication encryption, and then specify the OCID for a valid encryption key in the region you selected to replicate the boot volume to. For more information, see Requirements for Customer-Managed Encryption Keys for Cross-Region Operations.
- Select Confirm to acknowledge the cost warning.
-
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 thebootVolumeReplicas
attribute in theUpdateVolumeDetails
resource to enable cross-region replication for an existing boot volume.
Updating the Destination Region or Availability Domain Replication Settings for a Boot Volume
To change the destination region or availability domain for cross-region replication you need to first turn cross-region replication off for a boot volume. Then specify the new region and availability domain selections when you turn cross-region replication on again.
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes. In the Block Storage menu on the sidebar, select Boot Volumes.
-
Select the boot volume that you want to change the destination region and availability domain for.
-
Select Edit.
- In the Cross region replication section, select OFF.
-
Select Confirm to acknowledge the replica deletion.
- Select Save changes.
-
Select Edit.
- In the Cross region replication section, select ON.
-
Select the region you want to replicate the volume to and the availability domain to create the volume replica in, and then specify the name for the volume replica.
To replicate to another availability domain in the same region, select the region the volume is located in and the availability domain to create the volume replica in, and then specify the name for the volume replica.
-
Optionally, encrypt the volume replica in the destination region by using your own Vault encryption key. In Cross region replication encryption, select Encrypt using customer-managed keys , and then specify the OCID for a valid encryption key in the region you selected to replicate the volume to. For more information, see Requirements for Customer-Managed Encryption Keys for Cross-Region Operations.
-
Select Confirm to acknowledge the cost warning.
-
Select Save changes.
Disable and then re-enable cross-region replication replication. When you re-enable cross-region replication, specify the new availability domain you want to replicate to
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Disable and re-enable cross-region replication for a boot volume to change the destination or availability domain replication settings.
Disabling Cross-Region Replication for a Boot Volume
Learn how to disable cross-region replication for an existing boot volume.
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes. In the Block Storage menu on the sidebar, select Boot Volumes.
-
Select the boot volume that you want to disable replication for.
- Select Edit.
- In the Cross region replication section, select OFF.
- Select Confirm to acknowledge the that boot volume replica will be deleted.
-
Select Save changes.
Use the
oci bv boot-volume update
command and specify theboot-volume-id
parameter and'[]'
for the--boot-volume-replicas
parameter to disable cross-region replication for a boot volume:oci bv boot-volume update --boot-volume-id <volume_ID> --boot-volume-replicas '[]'
For example:
oci bv boot-volume update --boot-volume-id ocid1.bootvolume.oc1.phx.<unique_ID> --boot-volume-replicas '[]'
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the
UpdateVolume
operation and specify[]
for thebootVolumeReplicas
attribute in theUpdateVolumeDetails
resource to disable cross-region replication for an existing block volume.
Activating a Boot 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.
For volumes in a volume group configured for replication, activate the volume group replica instead of individual volume replicas if you want to ensure that all replicas are activated from the same coordinated synchronization point.
See Limitations and Considerations and Activating a Volume Group Replica.- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes. In the Block Storage menu on the sidebar, select Boot Volume Replicas. Ensure that you're in the correct destination region that contains the boot volume replica you want to activate.
-
Select the replica that you want to activate.
-
Select Activate and then Confirm.
-
In the Activate Volume Replica form, specify the settings for the new volume, including:
- Name
- Compartment
- (Optional) Cluster Placement Group Note
The Cluster Placement Group control only appears in the Console if Cluster Placement Groups are enabled for the tenancy, and if you've created and activated a cluster placement group with the capability added for volume resources. For more information, see Cluster Placement Groups for Block Volume. - Size and performance settings
- Reservations
- Volume replication
- Encryption
- Tags
- Select Activate replica. The new volume appears in the boot volumes list, in the provisioning state.
- Note
For volumes in a volume group configured for replication, activate the volume group replica instead of individual volume replicas if you want to ensure that all replicas are activated from the same coordinated synchronization point.
See Limitations and Considerations and Activating a Volume Group Replica.Use the
oci bv boot-volume create
command and specify the--source-volume-replica-id
,--compartment-id
, and--availability-domain
parameters to activate a boot volume replica:oci bv boot-volume create --source-volume-replica-id <volume_ID> --compartment-id <compartment_ID> --availability-domain <availability_domain>
For example:
oci bv boot-volume create --source-volume-replica-id ocid1.bootvolumereplica.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 specifybootVolumeReplica
for the type attribute in theVolumeSourceDetails
resource to activate a boot volume replica.
Listing Boot Volume Replicas
Learn how to list the boot volume replicas in a specified compartment and availability domain.
Open the navigation menu and select Storage. Under Block Storage, select Block Volumes. In the Block Storage menu on the sidebar, select Boot Volume Replicas.
Use the
oci bv boot-volume-replica list
command and specify the--availability-domain
andcompartment-id
parameters to list the boot volume replicas in a specified compartment and availability domain.oci bv boot-volume-replica list --availability-domain <availability_domain> --compartment-id <compartment_ID>
For example:
oci bv boot-volume-replica list --availability-domain ABbv:PHX-AD-1 --compartment-id ocid1.compartment.oc1.phx.<unique_ID>
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the
ListBootVolumeReplicas
operation to and specify theavailabilityDomain
andcompartmentId
attributes to list boot volume replicas.
Getting Details for a Boot Volume Replica
Learn how to view details for a specific boot volume replica.
-
Open the navigation menu and select Storage. Under Block Storage, select Block Volume Replicas.
- In the Block Storage list, select Boot Volume Replicas.
-
Select the boot volume replica that you want to view details for.
-
Use the
oci bv boot-volume-replica get
command and specify the--boot-volume-replica-id
parameter to get details for a boot volume replica:oci bv boot-volume-replica get --boot-volume-replica-id <boot-volume-replica-ID>
For example:
oci bv boot-volume-replica get --boot-volume-replica-id ocid1.bootvolumereplica.oc1.phx.<unique_ID>
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the
GetBootVolumeReplica
operation and specify thebootVolumeId
attribute to get details for a boot volume replica.
Restoring a Boot Volume Replica to Its Source Region
To restore a boot volume replica to the source region, you must activate the replica in the destination region with volume replication enabled, and then select the original source region as the target region for replication.
- Open the navigation menu and select Storage. Under Block Storage, select Block Volumes. In the Block Storage menu on the sidebar, select Boot Volume Replicas. Ensure that you are in the correct destination region that contains the boot volume replica you want to activate.
-
Select the replica that you want to activate.
- Select Activate.
- In the Activate replica form, specify the settings for the new volume, including:
- Name
- Compartment
- Size and performance settings
- Volume replication
- Encryption
- Tags
- In Cross region replication, select ON and the original source region, and enter a name for replica.
- Select Confirm.
- Optionally, configure encryption and tags.
- Select Activate replica. The new volume appears in the boot volumes list, in the provisioning state. After the initial synchronization finishes, the restoration process is complete, and you can use the volume in the original source region.
- Use the
oci bv volume create
command and specify the--availability-domain
,--compartment-id
,--display-name
,--source-details
,bootVolumeReplicaId
, and"displayName"
parameters to restore a boot volume replica to its source region:oci volume create --availability-domain <availability_domain> --compartment-id <compartment_ID> --display-name <activated_volume_name> --source-details '{"type": "bootVolumeReplicaId", "bootVolumeReplicaId": "<replica_ID>"}' --bootVolumeReplicas '[{"displayName": "<replica_display_name>", "availabilityDomain": "<destination_availability_domain>"}]'
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the
CreateVolume
operation and specify thecompartmentId
,bootVolumeReplicas
andsourceDetails
for theCreateVolumeDetails
resource to restore a boot volume replica to its source region.