CLI Guide

create peer-connection
Description Creates a peer connection between two storage systems.
The peer connection is defined by the ports that connect the two peer systems, and the name
of the peer connection. The local system uses the remote address to internally run the query peer-
connection command. The results of the query are used to configure the peer connection.
The prerequisites to create a peer connection are:
● Both systems must have iSCSI or FC host ports. Ports at both ends of the connection must use
the same protocol.
● Both systems must be connected to the same fabric or network. For FC, at least one FC switch is
required between systems (no direct attach).
● All host port addresses in both systems must be unique, even for ports not in use.
● Each system must have a virtual pool.
● If iSCSI CHAP is configured for the peer connection, the authentication must be valid.
● The username and password of a user with the manage role on the remote system must be
specified.
You can create a maximum of four peer connections per storage system. However, only one peer
connection is allowed to a particular remote system. Attempting to create a second peer connection
to the same system fails.
Host port evaluation is done at the start or resumption of each replication operation.
● At most, two ports are used.
● Ports with optimized paths are used first. If no optimized path exists, ports with unoptimized
paths are used . If only one port has an optimized path, then only that port is used.
● The replication does not use another available port until all used ports become unavailable.
If a single host port loses connectivity, event 112 is logged. Because a peer connection is likely to be
associated with multiple host ports, the loss of a single host port may degrade performance. The loss
of a single port but does not usually cause the peer connection to be inaccessible.
Minimum role
manage
Syntax
create peer-connection
[remote-password password]
remote-port-address remote-port-address
remote-username username name
Parameters
remote-password password
Optional in console format; required for API format. The password of the user is specified by the
remote-username parameter. If this parameter is omitted, the command prompts you to enter and
reenter a value, which is displayed obscured for security reasons.
remote-port-address remote-port-address
Specifies the FC WWN or iSCSI IP address of the remote system with which to create a peer
connection
remote-username username
The name of a user in the remote system. The username must be a user with the manage role to
remotely configure or provision that system.
name
Specifies a name for the peer connection. Input rules:
● The value is case-sensitive.
● The value can have a maximum of 32 bytes.
● The value can include spaces and printable UTF-8 characters except: " , < \
● A value that includes a space must be enclosed in double quotes.
Examples On a storage system that will replicate using iSCSI to a second system, create peer connection
Peer1 to remote port address 192.168.200.22, using the credentials of remote user John.
Alphabetical list of commands 49