mkippartnership

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