Replicating an object store

In the admin web interface, go to Replication . Click the Start button, and fill in the fields:

Application: Select the application containing the volume you want to replicate.

Volume: Select the volume that you want to replicate.

Target System: Select the target system that you want to replicate to.

Source Floating Ip: Select the replication floating IP entity that you want to use for replication. Most deployments use just one replication floating IP entity per system. In a highly available (HA) deployment, the replication floating IP entity defines two IP addresses: one per controller node. However, this uses a single named configuration entity, so there is only one entry to select in the drop-down menu.

Target Floating Ip: Select the target replication floating IP entity. As with the source floating IP, in most systems, there is only one target floating IP configuration entity to select that encompasses both floating IPs in an HA system.

Synchronous, Semisynchronous, or Asynchronous: Select the replication mode you want to use. For more information on these modes, see Replication overview.

Parameters

In the Parameters section, StorONE recommends leaving the fields empty to allow the replication setup to create a matching application and volume on the target system. If you need to pre-create the application and volume (for example, to modify some of the volume settings between the source and target systems), you can do so, but StorONE recommends against it.

Target Application: If you pre-created an application and volume on the target system, select the application.

Target Volume: If you selected an existing application, the Target Volume field appears, and you can select an existing volume from that application. The volume must be uninitialized, meaning that it cannot have a filesystem, object store, or have been mapped to an initiator host.

After completing all fields, click Submit to start replication. You can view the progress by clicking the List button on the Replication page.

To start replication using the CLI, use the following command:

replication start --application=<name> --volume=<name> --targetSystem=<name>
[(--targetApplication=<name> --targetVolume=<name>)]
  --sourceFloatingIp=<name> --targetFloatingIp=<name>
  --synchronous | --semisynchronous | --asynchronous
 [--force]

--application=<name>

Specify the application containing the volume you want to replicate. You can use the TAB key auto-complete to list available applications.

--volume=<name>

Specify volume you want to replicate. You can use the TAB key auto-complete to see the available volumes.

--targetSystem=<name>

Specify the target system that you want to replicate to. You can use the TAB key auto-complete to see the available systems.

--targetApplication=<name> --targetVolume=<name>

These parameters are optional, but mutually inclusive. If you specify them, you must specify both. StorONE recommends omitting these parameters to allow the replication setup to create a matching application and volume on the target system. If you need to pre-create the application and volume (for example, to modify some of the volume settings between the source and target systems), you can do so, but StorONE recommends against it.

--sourceFloatingIp=<name>

Specify the replication floating IP entity that you want to use for replication. Most deployments use just one replication floating IP entity per system. In a highly available (HA) deployment, the replication floating IP entity defines two IP addresses: one per controller node. However, this uses a single named configuration entity, so there is only one floating IP to specify. You can use the TAB key auto-complete to see the available replication floating IPs.

--targetFloatingIp=<name>

Specify the target replication floating IP entity. As with the source floating IP, in most systems, there is only one target floating IP configuration entity to select that encompasses both replication floating IPs in an HA system. You can use the TAB key auto-complete to see the available target replication floating IPs.

--synchronous | --semisynchronous | --asynchronous

Specify the replication mode you want to use. For more information on these modes, see Replication overview.

--force

Skip the confirmation prompt.

Examples

1. To asynchronously replicate the homedir volume in the users application to a target system named acme-dr, and have the system create a matching application and volume on the target system:

   replication start --application users --volume homedir --targetSystem acme-dr --sourceFloatingIp repl-float --targetFloatingIp repl-float --asynchronous
   

2. To synchronously replicate the ds01 volume in the vm application to an unitialized volume named ds01-repl in the vm-repl application within the us-repl target system:

   replication start --application vm --volume ds01 --targetSystem us-repl --targetApplication vm-repl --targetVolume ds01-repl --sourceFloatingIp replication-ip --targetFloatingIp replication-ip --synchronous
   

To see which floating IP is assigned to the object store, in the admin web interface, go to Applications > Objects > Stores .

If the paired floating IP you want to use is not listed on the object store:

1. Click the Edit button.
2. In the Volume Selection section, select the application and volume.
3. In the Editable Values section, select the paired floating IP that you want to use for the object store from the Floating Ip drop-down menu.
4. Click Submit to save your changes.
5. Repeat on the other system.

Run the following command to see the floating IPs assigned to the object store:

applications objects stores list

If the paired floating IP you want to use is not listed, edit the object store to set it:

applications object stores edit --application=<application_name> --volume=<volume_name>  --floatingIp=<floating_ip>

--application=<application_name> --volume=<volume_name>

Specify the application and volume names. You can use the TAB key auto-complete to list the applications and volumes.

--floatingIps=<floating_ip...>

Specify the floating IPs to associate with the object store. You can use the TAB key auto-complete to list the available floating IPs.

In the admin web interface, go to Replication .

The Sync entry shows the replication status. In the Parameters sections, you can specify an application and volume to see the status of a specific replicated volume. You can also use the Filter Secondary and Filter Primary radio buttons to display only secondary or primary volumes, respectively.

Click Submit to view the results after specifying any custom parameters.

Run the following command to see the replication status in the CLI:

replication list

If you want to see only specific volumes, you can use the following parameters:

replication list [--application=<name> --volume=<name>] [--filterSecondary|--filterPrimary]