Skip to main content

Dell PowerVault ME4 Series Storage System CLI Guide

PDF

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. # set peer-connection name PeerCon1 remote-username John remote-password John1234 Peer1
See also	create peer-connection delete peer-connection query peer-connection show peer-connection