vserver peer create
Suggest changes
PDFs
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