Changing configuration settings in the IBM Spectrum Virtualize 3-Site Orchestrator

Edit online

You can modify the IP addresses, the SSH key file, or other configuration values in the IBM Spectrum Virtualize 3-Site Orchestrator.

Note: The ch3siteconfig command generates a tar file at location /opt/ibm/SpectrumVirtualize/rc3site/config.tar. You must update this file to standby orchestrator to complete the configuration. For more information, see Updating configuration on standby orchestrator.

The same 3-Site Orchestrator command, ch3siteconfig, can be used to change configuration settings. When you change these settings, ensure that these changes are also completed on each system in the configuration, if necessary.

Notes:

Modifying attributes of objects in a 3-site configuration might cause unexpected behavior and is not supported. For example, if you change the name of a consistency group or relationship. Or, if you change a storage pool type or other attribute.
If consistency groups are not in a stopped state, the ch3siteconfig command fails (except for -updatesystemname).
The management GUI supports viewing configuration settings for the 3-site configuration only. You must use the ch3siteconfig command to update any configuration settings. To view configurations settings in the management GUI, select Copy Services > Remote Copy > 3-Site Partnership > Actions > Properties.

You can use the ch3siteconfig to update the following configuration settings:

To change the IP address that is specified for a site, enter the ch3siteconfig -ip1 x.xxx.xxx.xx -site Master command, where x.xxx.xxx.xx is the new IP address.
To verify the changed IP address, enter the ls3siteconfig command to verify the change in the resulting output. For example:
```
master_ip1 x.xxx.xxx.xx 
```
To change the SSH key file, enter the ch3siteconfig -keyfile /root/.ssh/id_rsa command. Make sure that all sites are configured with the new passwordless SSH key file.
Enter the ls3siteconfig command to verify the change in the resulting output. For example:
```
keyfile /root/.ssh/id_rsa
```

To change ports, enter the ch3siteconfig -port 3000 Only one port is required as a parameter, the command automatically assigns the remaining ports in sequence.

To verify the port updates, enter the ls3siteconfig command to view the resulting output.

Results for Metro Mirror configurations

[root@ORCH-HOST cli]# ls3siteconfig
master_name Master
master_ip1 x.xxx.xxx.x
master_ip1_status reachable
master_ip2  
master_ip2_status not_configured
master_port 3000
auxnear_name AuxNear
auxnear_ip1 x.xxx.xxx.xx
auxnear_ip1_status reachable
auxnear_ip2  
auxnear_ip2_status not_configured
auxnear_port 3001
auxfar_name AuxFar
auxfar_ip1 x.xxx.xxx.xx
auxfar_ip1_status reachable
auxfar_ip2  
auxfar_ip2_status not_configured
auxfar_port 3002
username tsuser
keyfile /root/.ssh/id_rsa

Results for HyperSwap configurations

master_name Master
master_site_name site1
master_site_status online
master_ip1 x.xxx.xxx.xx
master_ip1_status reachable
master_ip2
master_ip2_status not_configured
master_port 9000
auxnear_name Master
auxnear_site_name site2
auxnear_site_status online
auxnear_ip1 x.xxx.xxx.xx
auxnear_ip1_status reachable
auxnear_ip2
auxnear_ip2_status not_configured
auxnear_port 9000
auxfar_name AuxFar
auxfar_site_status online
auxfar_ip1 x.xxx.xxx.xx
auxfar_ip1_status reachable
auxfar_ip2
auxfar_ip2_status not_configured
auxfar_port 9001
username tsuser
keyfile /root/.ssh/id_rsa
topology hyperswap

To change site aliases, enter the ch3siteconfig command to update the site aliases in the 3-site configuration.

Example for Metro Mirror configurations

[root@ORCH-HOST cli]# ch3siteconfig -sitealias MASTER -site Master 
[root@ORCH-HOST cli]# ch3siteconfig -sitealias AUXNEAR -site AuxNear 
[root@ORCH-HOST cli]# ch3siteconfig -sitealias AUxFAR -site AuxFar

Example for HyperSwap configuration

[root@ORCH-HOST cli]# ch3siteconfig -sitealias MASTER -site Master 
[root@ORCH-HOST cli]# ch3siteconfig -sitealias AUXFAR -site AuxFar

The system names and aliases must be unique in a 3-site configuration. Enter the ls3siteconfig command to view the resulting output.

Results for Metro Mirror configurations

[root@ORCH-HOST cli]# ls3siteconfig
master_name MASTER
master_ip1 x.xxx.xxx.xx
master_ip1_status reachable
master_ip2  
master_ip2_status not_configured
master_port 3000
auxnear_name AUXNEAR
auxnear_ip1 x.xxx.xxx.xx
auxnear_ip1_status reachable
auxnear_ip2  
auxnear_ip2_status not_configured
auxnear_port 3001
auxfar_name AUXFAR
auxfar_ip1 x.xxx.xxx.xx
auxfar_ip1_status reachable
auxfar_ip2  
auxfar_ip2_status not_configured
auxfar_port 3002
username tsuser
keyfile /root/.ssh/id_rsa

Results for HyperSwap configuration

master_name MASTER
master_site_name Master
master_site_status online
master_ip1 x.xxx.xxx.xx
master_ip1_status reachable
master_ip2
master_ip2_status not_configured
master_port 9000
auxnear_name MASTER
auxnear_site_name site2
auxnear_site_status online
auxnear_ip1 x.xxx.xxx.xx
auxnear_ip1_status reachable
auxnear_ip2
auxnear_ip2_status not_configured
auxnear_port 9000
auxfar_name AUXFAR
auxfar_site_status online
auxfar_ip1 x.xxx.xxx.xx
auxfar_ip1_status reachable
auxfar_ip2
auxfar_ip2_status not_configured
auxfar_port 9001
username tsuser
keyfile /root/.ssh/id_rsa
topology hyperswap

To change the username of the 3-Site Administrator, enter the ch3siteconfig -username tsuser1 command to update the username. Make sure that all sites are configured with the new username. Also, make sure that the passwordless SSH key file enables connection to all sites from 3-Site Orchestrator by using the new username.
Enter the ls3siteconfig command to view the resulting output.
```
username tsuser1
```