CLI Guide

set peer-connection
Description
Modifies a peer connection between two systems.
You can use this command to change the name of a current peer connection or to change the port address
of the remote system without changing the peer connection configurations. For example, you could configure
a peer connection and then move one of the peers to a different network.
You can run this command on either the local system or the remote system. You must specify the username
and password of a user with the manage role on the remote system.
Changing the peer connection name will not affect the network connection so any running replications will
not be interrupted.
Changing the remote port address will modify the network connection, which is permitted only if there are no
active replications using the connection. Abort all replications before modifying the peer connection.
Additionally, either suspend the replication set to prevent any scheduled replications from running during the
operation, or make sure the network connection is offline. After you have modified the peer connection, you
can resume the replication set.
Minimum role manage
Syntax
set peer-connection
[name new-name]
[remote-password password]
[remote-port-address remote-port-address]
remote-username username
peer-connection-ID
Parameters
[name new-name]
Optional. A new name for the peer connection. If you specify this parameter you may not specify the remote-
port-address parameter. 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.
[remote-password password]
Optional in console format; required for API format. The password of the user specified by the remote-
username parameter. If this parameter is omitted, the command prompts you to enter and re-enter a value,
which is displayed obscured for security reasons.
[remote-port-address remote-port-address]
Optional. Specifies a new FC WWN or iSCSI IP address for the remote system. IPv4 and IPv6 formats are
supported. If you specify this parameter you may not specify the name parameter.
remote-username username
The name of a user in the remote system. This must be a user with the manage role to remotely configure or
provision that system.
peer-connection-ID
Specifies the name or serial number of the peer connection to modify.
Examples Connect the current peer connection Peer1 to the remote system’s new IP address, 192.168.202.22,
using the credentials of remote user John.
# set peer-connection remote-port-address 192.168.202.22 remote-username
John remote-password John1234 Peer1
Rename Peer1 to PeerCon1.
Alphabetical list of commands 137