ch3siteconfig

Edit online

Use the ch3siteconfig command to change the current 3-site configuration and maintain standby orchestrator.

Syntax

Read syntax diagramSkip visual syntax diagram ch3siteconfig -keyfilessh_keyfile_path-username3site_username-portlocal_port_offset-sitesite_name-ip1site_ip1-ip2site_ip2-sitealiasnew_site_alias-updatesystemname-startha-standby-config <path of config.tar>-stopha-force-standby-force-update-config <path of config.tar>

Parameters

-keyfile ssh_keyfile_path
(Optional) Specifies the updated path for the private SSH key file for the 3-site user on the host. This parameter is mutually exclusive with -site.
-username 3site_username
(Optional) Specifies the updated 3-site username for all three sites. This parameter is mutually exclusive with -site.
-port local_port_offset
(Optional) Specifies the updated starting address for the three local ports that are used for connection with the three sites over the SSH tunnel.
-site site_name
(Optional) Specifies the site that you want to update the configuration with.
-ip1 site_ip1
(Optional) Specifies the new IPv4 address for IP address 1. This parameter must be used with -site and is mutually exclusive with -ip2.
-ip2 site_ip2
(Optional) Specifies the new IPv4 address for IP address 2. This parameter must be used with -site and is mutually exclusive with -ip1.
-sitealias new_site_alias
(Optional) Specifies the updated site alias name. This parameter must be used with -site.
-updatesystemname
(Optional) Specify this parameter to refresh the system name change of any of the three sites.
-startha
(Optional) Specify this parameter to start standby orchestrator and set the role of orchestrator to active orchestrator.
Note: The -startha parameter can be used with -standby -config <path of config.tar> to configure standby orchestrator.
-standby
(Optional) Specify this parameter to perform operation on standby orchestrator.
Note:
  • The -standby parameter can be used with -startha -config <path of config.tar> to configure standby orchestrator.
  • The -standby parameter can be used with the -force parameter to forcefully switch an active orchestrator to standby.
-stopha
(Optional) Specify this parameter to stop standby orchestrator.
Note: The -stopha parameter should be used with -force parameter.
-force
(Optional) Specify this parameter to perform operation forcefully.
-update
(Optional) Specify this parameter to update 3site configuration file.
Note: The -update parameter should be used with -config parameter.
-config
(Optional) Specify this parameter to update configuration file or configure standby orchestrator.
Note: You must use the -config parameter either with the -update parameter or -startha -standby parameters.

Description

When you run this command, 3-Site Orchestrator immediately changes the configuration, without the need to restart any services. You can change the configuration details for one site at a time.

Note: After the successful execution of the ch3siteconfig command, a tar file is generated at location /opt/ibm/SpectrumVirtualize/rc3site/config.tar. The user must update this file to the standby orchestrator to complete the configuration.
Note: This command fails (except for -updatesystemname) if all consistency groups are not in a stopped state.

An invocation example to change the 3-site configuration of ip1 and site alias for the master_site site.

ch3siteconfig -site master_site -ip1 9.193.231.150 -sitealias master_site0

The resulting output:

No feedback

An invocation example to set up standby orchestrator

ch3siteconfig  -startha -standby -config <path of config.tar>

The resulting output:

No feedback