Modifying Metro Mirror and Global Mirror partnerships using the CLI

You can use the command-line interface (CLI) to modify Metro Mirror and Global Mirror partnerships.

The partnership bandwidth, which is also known as background copy, controls the rate at which data is sent from the local system to the remote system. The partnership bandwidth can be changed to help manage the use of intersystem links. It is measured in megabytes per second (MBps).

Complete the following steps to modify Metro Mirror and Global Mirror partnerships:

To modify Metro Mirror and Global Mirror partnerships, run the chpartnership command.
For example, enter:
```
chpartnership -type ip_address_type 
              -clusterip remote_cluster_ip_address 
              -chapsecret chap_secret 
              -nochapsecret -linkbandwidthmbits bandwidth_in_mbps 
              -backgroundcopyrate percentage_of_available_bandwidthremote_cluster_id
```
where ip_address_type specifies the IP address type ("ipv4" or "ipv6") that is used by the background copy process between the clusters (only used for IP connections), remote_cluster_ip_address specifies the IP address of the remote cluster (only used for IP connections), chap_secret specifies the CHAP secret of the remote cluster (only used for IP connections), bandwidth_in_mbps specifies the bandwidth (in megabytes per second) that is used by the background copy process between the clusters (this is optional), percentage_of_available_bandwidth specifies the maximum percentage of aggregate link bandwidth that can be used for background copy operations (this is optional), and remote_cluster_id is the ID or name of the remote system.
Run the chpartnership command from the remote system.
For example, enter:
```
chpartnership -type ip_address_type 
              -clusterip local_cluster_ip_address 
              -chapsecret chap_secret -nochapsecret 
              -linkbandwidthmbits bandwidth_in_mbps 
              -backgroundcopyrate percentage_of_available_bandwidthlocal_cluster_id
```
where ip_address_type specifies the IP address type ("ipv4" or "ipv6") that is used by the background copy process between the clusters (only used for IP connections), local_cluster_ip_address specifies the IP address of the local cluster (only used for IP connections), chap_secret specifies the CHAP secret of the local cluster (only used for IP connections), bandwidth_in_mbps specifies the bandwidth (in megabytes per second) that is used by the background copy process between the clusters (this is optional), percentage_of_available_bandwidth specifies the maximum percentage of aggregate link bandwidth that can be used for background copy operations (this is optional), and local_cluster_id is the ID or name of the local system.