Global Replication Services (GRS)

Additional information

If you need a more detailed information on Global Replication Services, see Global Replication Services Solution by using IBM Power Virtual Server

Pricing for GRS

The charges for GRS depend on the location where you create a replication-enabled volume.

Replication-enabled volumes incur the following charges:

• A base charge for the replication capability is based on the size of the replication-enabled volume under the part number "GLOBAL_REPLICATION_STORAGE_GIGABYTE_HOURS".

• The replication-enabled volumes charges are two times the size of the volume against the storage part numbers. This is based on the tier of the volume against the primary volume.

  Auxiliary volumes are not charged separately and are part of the primary volume charges.

Upon a site failure due to a catastrophe, metering becomes unavailable from the failed site. The charges for replication-enabled volumes are charged from the remote site. The charges are two times the size of the volume against the storage part numbers based on the tier of the volume. During this time, the base charge for the replication capability for the replication-enabled volumes is not charged.

Setting up GRS

GRS involves two sites where storage replication is enabled. These two sites are fixed and mapped into one-to-one relationship mode in both directions. These two sites are fixed and are in replication partnership in both directions.

You can create a replication-enabled volume from any site, the site from where the request is initiated contains the primary volume. The remote site is auxiliary and contains an auxiliary volume.

While you are creating a storage volume from the user interface, you can enable the volume for replication by completing the following steps:

1. In the Global Replication Service section, set the Volume replication to on. The name of the primary data center is displayed.
2. From the Secondary data center list, select the displayed secondary site name.

The GRS details of the volume are displayed when you click the storage volume.

A storage volume can have one of the following replication status:

• Not eligible: The storage volume is not in a GRS-enabled storage pool so GRS cannot be enabled on the storage volume. To move the storage volume to a GRS-enabled storage pool, submit a support ticket.
• Not supported: The site where the storage volume is created is not a GRS-supported location. So, you cannot enable replication of the storage volume.
• Not configured: The storage volume is in a GRS-enabled location. You can configure the storage volume for GRS.
• Initializing: The GRS enablement of the storage volume is in progress.
• Configured: The storage volume is a GRS-enabled storage volume.

For more information, see Creating a storage volume.

The following table explains how to determine the primary and secondary site based on replication-enabled volume creation:

Power Virtual Server regions that support GRS

You can use the GRS location APIs to determine the locations that support storage replication and their mapped location. For more information, see all disaster recovery locations that are supported by Power Virtual Server in API documentation.

The following table shows the location pairs that support replication:

Preparation for disaster recovery

Consider that you have the virtual server instances with data volumes that are running workloads. If a failure occurs and if the data volumes are replicated, you can recover the data volumes from the remote site. To enable the volume replication service, complete the actions on the primary site and the actions on the secondary site.

Onboarding auxiliary volumes

The onboard auxiliary volume is needed to manage the replicated volume on a remote site and perform volume recovery.

You must have the editor access on the source and target Power Virtual Server workspaces to onboard the auxiliary volume. The source and target workspace must be owned by the same account ID.

Collect the following information from the primary site to request for onboarding the auxiliary volumes on the secondary site:

1. Fetch the Cloud Resource Name (CRN) of the Power Virtual Server workspace instance where the primary volumes are located (primary site).
2. Fetch the auxiliary volume names from auxVolumeName field of primary volumes from primary site for onboarding.

To perform the onboarding process, use the onboard auxiliary volume API and provide the CRN and auxVolumeName values of the primary volumes that you want to onboard.

The onboarding operation creates a volume ID for each onboarded auxiliary volume. When the primary volume (in the primary site) is a part of a volume group, the onboarding operation creates a volume group ID for the existing volume group on the storage host. It adds the new auxiliary volume IDs to the new group ID.

Volume IDs and group ID for primary-aux volume pairs are different on primary and secondary sites. However, you can check other fields such as materVolumeName, auxVolumeName, and consistencyGroupName to identify a mater-aux volume pair.

The onboarding operation is an asynchronous operation that can take some time that depends upon the number of volumes. Use the Get the information of volume onboarding operation request to check the status of the onboarding operation.

Performing a failover and failback operation

To access the auxiliary volumes from the secondary site upon a primary site failure, stop the volume group by using Perform an action on a volume group API with access flag set to True.

To switch back to the volume group on the primary site, you must perform the volume group stop and start operations from the primary site. You can use the volume group stop command and wait until ReplicationStatus status changes to disabled value. Then, use the volume group start command with the --source master option to start the volume group. For more information about commands, see Perform an action on a volume group API.

Impacts on other Power Virtual Server operations

The impacts of GRS on other Power Virtual Server operations are as follows:

• No changes in image interfaces and no replication support for images.

• No changes in the operation interface and storage pool affinity rules for virtual server instances. The replication and non-replication-enabled volumes support volume attachment and detachment.

• Snapshot and capture operations are allowed for a virtual server instance with replication and non-replication-enabled volumes when the volumes are from the same storage pool. The snapshot and capture operations are performed by using the non-replication-enabled volumes internally even though the volumes of a virtual server instance are replication-enabled.

• By default, when you clone a replication-enabled volume, the cloned volume is replication-enabled. During cloning, you can optionally specify whether the cloned volume must be replication-enabled or not. If you want the cloned volume to be replication-enabled, specify the policy for the clone volume. You can use the following methods to clone a volume:

  • Clone a volume by using API.
  • Clone a volume by using CLI.
  • Clone a volume by using Terraform.

Disabling GRS

If you disable the replication service on a volume, it results in the deletion of the volume on the secondary site.

To disable the replication service between the primary volume and auxiliary volume and to retain the primary volume data, complete the following procedure:

Failure to complete this procedure in the specified order might result in loss of source volume data.

1. Remove the volumes from the volume group on the primary site: On the primary site, if a volume is associated with a volume group, remove the volume from its associated volume group. Use the ibmcloud pi volume-group update CLI command to remove the volumes from the volume group.

   For example, ibmcloud pi vgu 5bbe734a-7ec6-4f0a-a34e-8bd45fc189ca --remove-member-volume-ids afd07003-a61a-45ca-97d1-4f910272306d

2. Disable the volume replication service: Disable the volume replication service by setting the replication-enabled flag to False. Use the ibmcloud pi volume action CLI command to disable the volume replication.

   For example, ibmcloud pi vola afd07003-a61a-45ca-97d1-4f910272306d –replication_enabled=False

   Disabling the volume replication service is an asynchronous process. Retrieve the volume details to confirm that the volume replication service is disabled.

   After the volume replication service is disabled, the following changes occur:

   • The replication relationship between the primary volume and auxiliary volume is removed.
   • The auxiliary volume from the storage backend is deleted.

3. Remove the volumes from the volume group on the secondary site: Update the volume group of the secondary site to remove the volumes from it.

   This step is required if the volume is on-boarded into a workspace on the secondary site.

   Use the ibmcloud pi volume-group update CLI command to remove the volumes from the volume group.

   For example, ibmcloud pi vgu 96e037e3-9efd-4d6d-90cf-d1f6cc76d6c3 --remove-member-volume-ids ba147c20-578a-4ae1-8a94-252b6bbcd9cb

   When you disable the replication service on the primary volume or delete a primary volume, the replication relationship between the primary volume and the secondary volume is deleted in the storage backend. If the auxiliary volume on the secondary site is associated with a volume group, remove the auxiliary volume from the volume group. Delete the auxiliary volume manually. If the auxiliary volume is not deleted from the secondary site, an out-of-band periodic check (occurring every 24 hours) sets the auxiliary volume to an error state.

Updating a primary volume

You can resize the primary volume or switch the bootable or shareable options of the volume as True or False.

Use the ibmcloud pi volume-update CLI command with the following options to update the primary volume:

• Resize --size NEW_SIZE option: On DAL10 and WDC07 location pair, when you resize a replication-enabled primary volume from the primary site, the system resizes the associated auxiliary volume on its corresponding remote site within 24 hours. For all other location pairs, before you resize a replication-enabled volume, remove the volume from the volume group. After the volume resize is completed, add the volume back to the volume group.

  It is recommended not to resize a primary volume by disabling replication as it results in errors that are related to the auxiliary volume on the remote site.

• Bootable bootable=true option: To set a primary volume as a boot volume, update the bootable attribute to True.

• Sharable shareable=true option: To set a primary volume as a shareable volume, update the sharable attribute to True.

  If you are setting the bootable and shareable options to True on the primary volume, you must explicitly set the bootable and shareable options to True on the auxiliary volume.

Deleting a primary volume

To delete a volume or a replication-enabled primary volume, the status of the storage volume must indicate one of the following states: available, error, error_restoring, error_extending, or error_managing. Also, the storage volume cannot be deleted if it is in the state of migrating, attached, belongs to a group, has snapshots, or is disassociated from its snapshots after a transfer.

Once you initiate the action to delete the volume, the action cannot be undone.

To delete a primary volume, complete the following steps:

1. Remove the primary volume from the volume group, if the primary volume is associated with a volume group.
2. Delete the primary volume from the primary site. You can use the CLI command ibmcloud pi volume-delete to delete the volume.
3. Remove the auxiliary volume from the volume group, if the auxiliary volume is associated with a volume group.
4. Delete the auxiliary volume from the secondary site.

When you disable the replication service on the primary volume or delete a primary volume, the replication relationship between the primary volume and the secondary volume is deleted in the storage backend. If the auxiliary volume on the secondary site is associated with a volume group, remove the auxiliary volume from the volume group. Delete the auxiliary volume manually. If the auxiliary volume is not deleted from the secondary site, an out-of-band periodic check (occurring every 24 hours) sets the auxiliary volume to an error state.

When you delete a primary volume, the billing for primary volume stops.

In the following example, afd07003-a61a-45ca-97d1-4f910272306d is a primary volume that is associated with the volume group 5bbe734a-7ec6-4f0a-a34e-8bd45fc189ca:

1. Remove the volume from volume group on the primary site. You can use the following CLI command:

    ibmcloud pi volume group update 5bbe734a-7ec6-4f0a-a34e-8bd45fc189ca --remove-member-volume-idsmafd07003-a61a-45ca-97d1-4f910272306d
   

2. Delete the primary volume from primary site. You can use the following CLI commands:

    ibmcloud pi vol delete afd07003-a61a-45ca-97d1-4f910272306d
   

3. Remove the auxiliary volume from volume group on the secondary site. You can use the following CLI command:

    ibmcloud pi volume group update 96e037e3-9efd-4d6d-90cf-d1f6cc76d6c3 --remove-member-volume-ids ba147c20-578a-4ae1-8a94-252b6bbcd9cb
   

4. Delete the auxiliary volume from the secondary site. You can use the following CLI commands:

    ibmcloud pi vol delete ba147c20-578a-4ae1-8a94-252b6bbcd9cb
   

Deleting an auxiliary volume

If you delete an auxiliary volume, the associated primary volume is also deleted.

When you disable the replication service on the primary volume or delete a primary volume, the replication relationship between the primary volume and the secondary volume is deleted in the storage backend. If the auxiliary volume on the secondary site is associated with a volume group, remove the auxiliary volume from the volume group. Delete the auxiliary volume manually. If the auxiliary volume is not deleted from the secondary site, an out-of-band periodic check (occurring every 24 hours) sets the auxiliary volume to an error state.

Use the ibmcloud pi volume delete CLI command to delete the auxiliary volume.

For example, ibmcloud pi vold afd07003-a61a-45ca-97d1-4f910272306d

Creating a volume group

When you create a volume group and add the replication-enabled volumes to the volume group, the remote replication consistency group is created at both primary and remote storage backend. The consistency group stores the consistent copy for the volumes. When the volume group is created, the primary role attribute is set as master.

You can add only replication-enabled volumes to a volume group. If you try to add a non-replication-enabled volume to a volume group, the action fails.

To create a volume group, you can use the CLI command, ibmcloud pi volume-group-create.

Limitations of GRS

The limitations of GRS are as follows:

• After you performed a failback operation, the replication role of the volume group (VG) and the volume fail to change from auxiliary to primary. The issue is a recurring issue that impacts your GRS environments.

• You cannot perform a snapshot-restore operation on auxiliary volumes.

• The volume group update operation can fail upon a mismatch in the volume group and volume replication states. If the volume group is in an error state, use the volume group action API to reset the volume group status.

• When you disable the replication service on the primary volume or delete a primary volume from the primary site, the following changes occur:

  • The replication relationship between the primary volume and the auxiliary volume is deleted at the storage backend.
  • If the auxiliary volume is not deleted from the secondary site manually, an out-of-band periodic check (occurring every 24 hours) sets the auxiliary volume to an error state.

• You cannot remove the replication-enabled volume when it is a part of a volume group.

• On DAL10 and WDC07 location pair, when you resize a replication-enabled primary volume from the primary site, the system resizes the associated auxiliary volume on its corresponding remote site within 24 hours. For all other location pairs, before you resize a replication-enabled volume, remove the volume from the volume group. After the volume resize is completed, add the volume back to the volume group. For more information, see Updating a primary volume.

• If you resize a primary volume by disabling replication service on the primary site, it results in errors that are related to the auxiliary volume on the remote site.

• Any operation that is performed on a deleted volume fails.

Best practices for GRS

• Set the Shareable and Bootable flag explicitly on onboarded volumes, if required.
• Start the onboarding of auxiliary volumes only when the primary volumes and volume group are in a consistent copying state. You can get the volume details by using the get volume API to determine the state of the primary volumes and volume group in the mirroring state on the primary site. Verify that the volume group is created successfully and it is in a consistent copying state by using get storage details of the volume group API.

• Get volume details by using the following methods:
  • Power Cloud API.
  • Terraform.
• Get volume groups storage details by using the following methods:
  • Power Cloud API.
  • Power Virtual Server CLI
  • Terraform.

• When you add or remove a primary or an auxiliary volume from a volume group from one site, perform the same operation from the other site to keep the data in sync.
• Delete the volumes from primary and secondary site. Volumes are charged when you delete an auxiliary volume but fail to delete the primary volume.
• Use primary site for all the volume operations and perform operations on auxiliary volume on the secondary site only during failover.