Skip to main content
Version: vStor 4.15

Creating Replication Groups

Attention!

Replication groups cannot use deletion protection. You can only use deletion protection on individual replications.

The vStor Group Replication feature allows you to create a replication group between multiple vStor servers. This keeps data synchronized across all the vStor servers in the group by replicating snapshots of the volumes.

Group replication provides a simple way to set up and manage replication for multiple volumes. Instead of creating individual replication relationships between volumes on different vStor servers, you can add volumes to a group and efficiently schedule and replicate them together.

Creating a Replication Group​

Note.

The vStor servers must already have partnerships established before creating a group replication.

To create a new replication group:

  1. Select Replication from the sidebar.
  2. Click Create group in the Replication Relationships section to open the Create Group dialog.
[image expected here]
  1. Specify the following information:
  • Name: Enter a name for the replication group.
  • Partner: Select the IP address of the partner vStor server.
  • Replication Bandwidth Settings: Select the replication priority. This setting is only applicable when Bandwidth limit is set in System Settings (see Replication), and it determines how much of the bandwidth is consumed by each task when they coincide.
  • Remote pool: Select the pool on the partner server where the volumes will be replicated to.
  • (optional) Select volumes: Select volumes from the dropdown list to add to the group. Only compatible volumes will be listed.
    If volumes with already defined relationships are selected, their target replication pool will remain unaffected by the selection in the Create Group window.
[image expected here]
  1. Click Save to create the replication group.
Note.

You can only group volumes connected to the same Partner IP address.

The selected volumes will be replicated as a group according to the configured schedule and settings.

Scheduling Group Replication​

After creating a replication group, you can configure a schedule for replicating the volumes within the group.

To schedule group replication:

  1. In the Replication Relationships section, hover over a replication group and click Schedule.
[image expected here]
  1. Follow the steps as in Scheduling a Replication.
  2. Click Save to save the schedule.

The volumes in the group will now replicate according to the configured schedule.

You can also manually trigger replication for a replication group by hovering over the group and clicking Synchronize.

Additional Group Replication Options​

To use additional options, Hover over a replication group and click More Actions (...). It gives you access to the following options:

  • Edit: Modify the group name or volumes in the group.
  • Ungroup: Remove the group but keep the replication relationships intact.
  • Delete: Delete the group and all replication relationships within it.

vStor CLI for Group Replication​

To create a new replication group using the vStor CLI, use the following command:

vstor relationship group create --name <name> --partner_id <partner_id> --bandwidth_priority <priority> --remote_pool_id <pool_id> --local_vol_ids <vol_ids>

To update an existing replication group using the vStor CLI, use the following command:

vstor relationship group update --id <id> --name <name> --bandwidth_priority <priority> --remote_pool_id <pool_id> --local_vol_ids <vol_ids>
Tip.

For more commands and parameters, use the --help flag at any level, e.g:

vstor relationship group --help
vstor relationship group create --help