Use the mkippartnership command to define a new partnership created
over Internet Protocol (IP) links.
Syntax
mkippartnership -type { ipv4 | ipv6 } [ -clusteripipadr ] [ -chapsecretCHAPsecret ] -linkbandwidthmbitslink_bandwidth_in_mbps [ -backgroundcopyratepercentage ] [ -compressed { yes | no } ]
Parameters
- -typeipv4 | ipv6
- (Required) Specifies the Internet Protocol (IP) address format for the partnership using
either of the following case-sensitive strings:
- ipv4 for Internet Protocol Version 4 (IPv4)
- ipv6 for Internet Protocol Version 6 (IPv6)
All Transmission Control Protocol (TCP) Remote Copy (RC) connections between the primary
and remote clustered systems (systems) are created using specific IP addresses. Note: Remote copy includes Metro Mirror, Global Mirror, and HyperSwap
Partnership
creation fails if the Internet Protocol (IP) address types specified for either primary or
remote systems are not the same.
- -clusteripipadr
- (Required) Specifies the 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.
- -chapsecretCHAPsecret
- (Optional) Specifies the Challenge-Handshake Authentication Protocol (CHAP) secret of the
partner system. The maximum size of the CHAP secret is eighty alphanumeric characters.
- -linkbandwidthmbitslink_bandwidth_in_mbps
- (Required) 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.
Important: For partnerships over IP links with
compression, this parameter specifies the aggregate bandwidth after the compression had been
applied to the data. Do not set this parameter higher than the physical link bandwidth
multiplied by the (carefully rounded down) compression factor.
This parameter can be specified without stopping the partnership.
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.
- -backgroundcopyratepercentage
- (Optional) Specifies the maximum percentage of aggregate link bandwidth that can be used
for background copy operations. It 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.
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.
- -compressedyes | no
- (Optional) Specifies whether compression is enabled for this partnership. The default value
is no.
Description
This command defines a new partnership created over Internet Protocol (IP) links. A remote
system IP must be specified so its IP ports are enabled for data replication. RC sessions can
then be created between the two partners.
In FC-based or FCoE-based partnerships, the partner system must first be a partnership
candidate (displayed by lspartnership). Then it can become part of a
partnership, created specifying mkfcpartnership with the remote system ID or
name.
The lspartnershipcandidate command displays partnership candidates.
For IP partnerships, specifying mkippartnership with the cluster IP address
and CHAP secret of the partner creates the partnership.
All TCP connections are established using either IPv4 or IPv6, and it cannot be a mix of the
two IP address types.
Both systems in a partnership must have at least one IP address from
an identical replication group to establish RC partnerships. Replication groups are numeric
values that specify the pools of local IP addresses that establish Remote Copy partnerships with
pools of IP addresses configured on the partner system.
An invocation
example
mkippartnership –type ipv4 –clusterip 192.168.32.19
–chapsecret mychapsecret –linkbandwidthmbits 100 –backgroundcopyrate 50
The
resulting output:
No feedback
An invocation
example
mkippartnership –type ipv6 –clusterip fe80::200:f8ff:fe21:67cf
–chapsecret mychapsecret –linkbandwidthmbits 1024 –backgroundcopyrate 25
The
resulting output:
No feedback
An invocation example creating a compressed IP replication link
mkippartnership –type ipv4 –clusterip 192.168.32.19 –chapsecret mychapsecret –linkbandwidthmbits 100 –backgroundcopyrate 50 -compressed yes
The resulting output:
No feedback