Use the chpartnership command to modify
the bandwidth of the partnership between the local clustered system
(system) and the remote system that is specified in the command. This
affects the bandwidth that is available for background copy in a system
partnership by either Metro Mirror or Global Mirror operations. Additionally,
use this command to disable and re-enable the partnership, which
allows the local system to be disconnected
and then reconnected to the remote system.
Syntax
chpartnership { -start | -stop } { remote_cluster_id | remote_cluster_name }
chpartnership [ -linkbandwidthmbitslink_bandwidth_in_mbps ] { remote_cluster_id | remote_cluster_name }
chpartnership [ -type { ipv4 | ipv6 } ] [ -clusterip { newipv4addr | newipv6addr } ] [ -chapsecretnewCHAPsecret ] [ -nochapsecret ] [ -backgroundcopyratepercentage ] [ -linkbandwidthmbitslink_bandwidth_in_mbps ] { remote_cluster_id | remote_cluster_name }
Parameters
- -start | -stop
- (Optional) Starts or stops a Metro Mirror or Global Mirror partnership.
To start or stop a partnership, run the chpartnership command
from either system.
- -typeipv4 | ipv6
- (Optional) Specifies the Internet Protocol (IP) address format
for the partnership using either of these case-sensitive strings:
- ipv4 for Internet Protocol Version 4 (IPv4)
- ipv6 for Internet Protocol Version 6 (IPv6)
This migrates a partnership from ipv4 to ipv6 or
vice versa.
- -clusteripnewipv4addr | newipv6addr
- (Optional) Specifies the new partner system IP address, either ipv4 or ipv6.
Systems connected over IP links are not displayed by lspartnershipcandidate before
executing mkippartnership. This does not apply
to FC-based or FCoE-based connections.
Specify this parameter when
creating partnerships with systems connected over native IP links.
To change the partner system IP address, first specify chapartnership
-stop to stop the partnership.
- -chapsecretnewCHAPsecret
- (Optional) Specifies the new Challenge-Handshake Authentication
Protocol (CHAP) secret of the partner system. The maximum size of
the CHAP secret is eighty alphanumeric characters.
- -nochapsecret
- (Optional) Resets the CHAP secret used to authenticate with the
partner system. Specify chpartnership -stop to
stop the partnership. Reset the CHAP secret of the partner system
when authentication of discovery requests is turned off on the partner
system (by specifying chsystem -rcauthmethod).
- -backgroundcopyratepercentage
- (Optional) Specifies the maximum percentage of aggregate link bandwidth that can be used for
background copy operations. This parameter can be specified without stopping the partnership. The
percentage is a numeric value from 0 to 100, and the default value
is 50, which means that a maximum of 50% of the aggregate link bandwidth can be
used for background copy operations. This
command is mutually-exclusive with all parameters other than
-linkbandwidthmbits.
Note: If the specified value is non-zero, the combination of both the
-backgroundcopyrate and the -linkbandwidthmbits values
must result in a background copy bandwidth of at least 8 Mbps.
- -linkbandwidthmbitslink_bandwidth_in_mbps
- (Optional) Specifies the aggregate bandwidth of the RC link between two clustered
systems (systems) in megabits per second (Mbps). It is a numeric value from 1 to
100000, specified in megabits per second (mbps). This parameter can be specified
without stopping the partnership. This
command is mutually-exclusive with all parameters other than
-backgroundcopyrate.
Note: If the specified value is non-zero, the combination of both the
-backgroundcopyrate and the -linkbandwidthmbits values
must result in a background copy bandwidth of at least 8 Mbps.
- remote_cluster_ID | remote_cluster_name
- (Required) Specifies the remote system ID or name of a partnership.
The specified value must match one of the system IDs or names returned
after issuing lspartnershipcandidate. The specified
value must match one of the system IDs or names listed by lspartnership.
Remember: Specifying a remote system ID or
name with chpartnership does not affect the remote
system. To change the system name, specify chsystem.
To
configure the maximum bandwidth available for intrasystem relationships,
specify:
- A local system ID or name
- The -linkbandwidthmbps and -backgroundcopyrate parameters
Description
This command modifies the bandwidth of the partnership
between the local system and the remote system specified in the command.
This affects the bandwidth available for a background copy in Metro
Mirror or Global Mirror relationships (from the local to the remote
system) . To modify the background copy bandwidth from remote system
to local system, issue chpartnership a second time
for the remote system.
Change
the CHAP secret or system IP for partnerships created using IP links.
Before changing the partner CHAP secret or system IP, stop the partnership.
If a stop partnership is issued, the state is
not_present briefly
before it changes to
fully_configured_stopped.
Important: - If you start with a fully configured remote copy partnership,
the state (as reported by lspartnership) is fully_configured.
- If a stop partnership is issued, the state is not_present (typically
for ten seconds or less) before it becomes fully_configured_stopped.
After making the
necessary changes, start the partnership.
The system partnership
must be in either the partially_configured_stopped or fully_configured_stopped states
to be started.
Note: The local
and remote systems in an IP partnership must use the same IP address
types, IPv4 or IPv6.
An invocation example
chpartnership -stop cluster1
The
resulting output:
No feedback
An invocation example to change the allocated
background copy rate
chpartnership -backgroundcopyrate 20 remote-system-2
The
resulting output:
No feedback
An invocation example
to change the link bandwidth
chpartnership -linkbandwidthmbits 1024 remote-system-2
The
resulting output:
No feedback
An invocation example to migrate existing partnership
from IPv4 to IPv6 type
chpartnership -stop remote-sys-2
chpartnership -type ipv6 –clusterip fe80::200:f8ff:fe21:67cf remote-sys-2
The
resulting output:
No feedback
An invocation example
to configure a new CHAP secret for a partner
chpartnership –stop remote-system-2
chpartnership –chapsecret newpassword remote-system-2
chpartnership –start remote-system-2
The resulting output:
No feedback
An invocation example
to configure a new system IP
chpartnership -stop remote-system-2
chpartnership –clusterip 202.49.86.2 –chapsecret newpassword remote-system-2
chpartnership –start remote-system-2
The resulting output:
No feedback
An
invocation example
chpartnership -linkbandwidthmbits 2048 -backgroundcopyrate 100 localCluster
The
resulting output:
No feedback