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