Skip to main content

vserver peer create

Create a new Vserver peer relationship

Availability: This command is available to cluster administrators at the admin privilege level.

Description​

The vserver peer create command creates a Vserver peer relationship between two Vservers residing on the same cluster or across two clusters. For intercluster Vserver peer relationships, the cluster administrator must accept or reject the relationship on the peer cluster.

Parameters​

-vserver <vserver> - Vserver Name
Specifies the name of the local Vserver.
-peer-vserver <vserver> - Peer Vserver Name
Specifies the name of the peer Vserver with which you want to create the Vserver peer relationship.
[-peer-cluster <text>] - Peer Cluster Name
Specifies the name of the peer cluster. If this is not specified, it is assumed that the peer Vserver resides on the same cluster.
-applications {snapmirror|file-copy|lun-copy|flexcache}, ... - Peering Applications
Specifies the applications for which the Vserver peer relationship is created.
[-local-name <vserver>] - Peer Vserver Local Name
Specifies the unique local name to identify the peer Vserver with which you want to create the Vserver peer relationship. The default value is the remote peer Vserver name.

Examples​

The following example illustrates how to create an intercluster Vserver peer relationship between Vserver lvs1.example.com, residing on cluster1, and pvs1.example.com, residing on cluster2. The relationship is created for SnapMirror. 

cluster1::> vserver peer create -vserver lvs1.example.com -peer-vserver pvs1.example.com -peer-cluster cluster2 -applications snapmirror

The following example illustrates how to create an intercluster Vserver peer relationship between Vserver lvs1.example.com, residing on cluster1, and lvs1.example.com, residing on cluster2. The relationship is created for SnapMirror. The -local-name parameter is specified to create a local name used to identify the peer Vserver in cases where the name of the peer Vserver name is not uniquely referenced from local cluster.

cluster1::> vserver peer create -vserver lvs1.example.com -peer-vserver lvs1.example.com -peer-cluster cluster2 -applications snapmirror -local-name cluster2lvs1locallyUniqueName

cluster1::> vserver peer show
            Peer        Peer                           Peering        Remote
Vserver     Vserver     State        Peer Cluster      Applications   Vserver
----------- ----------- ------------ ----------------- -------------- ---------
lvs1.example.com
            cluster2lvs1locallyUniqueName
                        initiated    cluster2          snapmirror     lvs1.example.com


cluster1::> vserver peer show -instance

  Local Vserver Name: lvs1.example.com
   Peer Vserver Name: cluster2lvs1locallyUniqueName
       Peering State: initiated
Peering Applications: snapmirror
 Remote Vserver Name: lvs1.example.com


The following example illustrates how to create an intercluster Vserver peer relationship between Vserver lvs1, residing on cluster1, and Vserver pvs1, residing on cluster2. The relationship is created for SnapMirror. The following Vserver peer permission exists on remote cluster cluster2 for local Vserver pvs1.

cluster2::> vserver peer permission show
Peer Cluster     Vserver         Applications
---------------- --------------- -----------------
cluster1         pvs1            snapmirror
1 entries were displayed.

cluster1::> vserver peer create -vserver lvs1 -peer-vserver pvs1 -peer-cluster cluster2 -applications snapmirror

cluster1::> vserver peer show
            Peer        Peer                           Peering        Remote
Vserver     Vserver     State        Peer Cluster      Applications   Vserver
----------- ----------- ------------ ----------------- -------------- ---------
lvs1        pvs1        peered       cluster2          snapmirror     pvs1

cluster2::> vserver peer show
            Peer        Peer                           Peering        Remote
Vserver     Vserver     State        Peer Cluster      Applications   Vserver
----------- ----------- ------------ ----------------- -------------- ---------
pvs1        lvs1        peered       cluster1          snapmirror     lvs1


Here is an another example which creates an intracluster Vserver peer relationship.
cluster1::> vserver peer create -vserver lvs1.example.com -peer-vserver lvs2.example.com -applications snapmirror

Related reference