Configuring systems and IBM Spectrum Virtualize 3-Site Orchestrator for Metro Mirror configurations

Edit online

To configure 3-site replication with a Metro Mirror configuration requires IBM Spectrum Virtualize 3-Site Orchestrator and all systems within the configuration meet specific requirements and complete all configuration steps. After you complete the setup tasks, you can convert existing Metro Mirror consistency groups or add existing Metro Mirror relationships to the configuration.

The IBM Spectrum Virtualize 3-Site Orchestrator is a separate command-line based application that is hosted on a separate Linux® virtual machine or server. The 3-Site Orchestrator coordinates replication between three systems that are defined in partnerships and responds automatically during outages and connection issues with limited intervention by administrators.

Before you can set up a 3-site configuration, ensure that the following prerequisites are met.

Each system in the configuration has a unique name.
All planning steps are complete. For more information, see Planning for IBM Spectrum Virtualize 3-Site Orchestrator.
Ensure that you install the correct IBM Spectrum Virtualize 3-Site Orchestrator package for your configuration. For more information, see Installing IBM Spectrum Virtualize 3-Site Orchestrator.

If you have existing 3-site partnerships, you can complete the following steps on the IBM Spectrum Virtualize 3-Site Orchestrator host to configure 3-site replication with Metro Mirror.

Remove the existing configuration by running the following command.
```
rm3siteconfig
```
This command removes the configuration objects on the host, but does not remove related objects, such as partnerships and 3-site administrator, from the system.
Note: You cannot use the rm3siteconfig command if the standby orchestrator is configured on 3-site orchestrator.
To ensure that the management GUI can access 3-Site Orchestrator objects, add the public SSH key to the authorized keys by entering the following command on the 3-Site Orchestrator host.
```
ssh-copy-id -i ~/.ssh/<id_rsa.pub> root@<ORCH-HOST> 
```
Enter the following command:
```
[root@ORCH-HOST cli]# mk3siteconfig -ip1 x.xxx.xxx.xx,x.xxx.xxx.xx,x.xxx.xxx.xxx 
-keyfile '/root/.ssh/id_rsa' -username 'tsuser'  -port 6000
```
where x.xxx.xxx.xx represents the management IP addresses of each of systems at the Master, Auxiliary-near and Auxiliary-far sites. The -keyfile value is the file path where the SSH private key is on the Orchestrator host. The -username value specifies the name of the user that has 3-Site Orchestrator administrator role. The value in the -port parameter is the starting address of the three port numbers that are assigned to each site. For example, if 6000 is set as -port, then the master port (master_port) is set at 6000; the auxiliary-near port (auxnear_port) is set at 6001; and the auxiliary-far port (auxfar_port) is set at 6002.
Note: The mk3siteconfig command generates a tar file at location /opt/ibm/SpectrumVirtualize/rc3site/config.tar.
Log in to the management GUI, select Settings > GUI Preferences > Generaland select Refresh under Refresh GUI cache.
After the cache is refreshed, select Copy Services > Remote Copy. Verify that the 3-site partnership displays.

To configure Metro Mirror configurations that span three sites, the management GUI supports setting up IBM Spectrum Virtualize 3-Site Orchestrator and the necessary system objects. The GUI guides you through each necessary task and provides simplified management of 3-site configuration objects with detailed status graphics both for synchronous and asynchronous copy operations.

These instructions assume that you are creating a new 3-site configuration with new partnerships. On the master site system, log in to the management GUI and complete the following steps.

Select Copy Services > Remote Copy.
Under Partnerships, select Create Partnerships > 3-Site Partnerships.
On the Create 3-Site Partnership page, complete each of the following tasks.