Index  |  Top  -  Up Data ONTAP 8.3

snapmirror list-destinations

Display a list of destinations for SnapMirror sources

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

Description

The snapmirror list-destinations command displays information including the destination endpoints, the relationship status, and transfer progress, for SnapMirror relationships whose source endpoints are in the current Vserver if you are in a Vserver context, or the current cluster if you are in a cluster context.

The command might display several relationships that have the same source and destination endpoints, but have different relationship IDs. If this is the case, some of the information is stale. It corresponds to relationships that have been deleted on the destination Vserver or cluster, and have not been released yet on the source Vserver or source cluster.

The relationships and the information displayed are controlled by the parameters that you specify. If no parameters are specified, the command displays the following information associated with each SnapMirror relationship whose source endpoint is in the current Vserver if you are in a Vserver context, or the current cluster if you are in a cluster context: Note the following limitations on the information displayed by the snapmirror list-destinations command:The -instance and -fields parameters are mutually exclusive and select the fields that are displayed. The -instance parameter if specified, displays detailed information about the relationships. The other parameters of the snapmirror list-destinations command, select the SnapMirror relationships for which the information is displayed.

Parameters

{  [-fields <fieldname>, ...]

If you specify the -fields <fieldname>,... parameter, the command only displays the fields that you have specified.

|  [-instance ]  }

If you specify the -instance parameter, the command displays detailed information about all relationships selected.

{  [-source-path | -S {<[vserver:]volume>|<[[cluster:]//vserver/]volume>}] - Source Path

Selects SnapMirror relationships that have a matching source path name.

|  [-source-vserver <vserver name>] - Source Vserver

Selects SnapMirror relationships that have a matching source Vserver name.

   [-source-volume <volume name>]  } - Source Volume

Selects SnapMirror relationships that have a matching source volume name.

{  [-destination-path {<[vserver:]volume>|<[[cluster:]//vserver/]volume>}] - Destination Path

Selects SnapMirror relationships that have a matching destination path name.

|  [-destination-vserver <vserver name>] - Destination Vserver

Selects SnapMirror relationships that have a matching destination Vserver name.

   [-destination-volume <volume name>]  } - Destination Volume

Selects SnapMirror relationships that have a matching destination volume name.

[-relationship-id <UUID>] - Relationship ID

Selects SnapMirror relationships that have a matching relationship identifier.

[-type <snapmirrorType>] - Relationship Type

Selects SnapMirror relationships that have a matching relationship type. Possible values are:

[-relationship-group-type {none|infinitevol}] - Relationship Group Type

Selects SnapMirror relationships that have a matching relationship group type. Possible values are:

[-policy-type {vault|async-mirror|mirror-vault}] - SnapMirror Policy Type

Selects SnapMirror relationships that have a matching SnapMirror policy type. Possible values are:

[-status <mirror status>] - Relationship Status

Selects SnapMirror relationships that have a matching relationship status. Possible values are:

[-transfer-progress {<integer>[KB|MB|GB|TB|PB]}] - Transfer Progress

Selects SnapMirror relationships that have a matching transfer progress. This option is not supported for Infinite Volume SnapMirror relationships.

[-progress-last-updated <MM/DD HH:MM:SS>] - Timestamp of Last Progress Update

Selects SnapMirror relationships that have a matching transfer progress last updated timestamp. This option is not supported for Infinite Volume SnapMirror relationships.

[-is-constituent {true|false}] - Constituent Relationship

Selects SnapMirror relationships that have a matching constituent condition.

[-source-volume-node <nodename>] - Source Volume Node Name

Selects SnapMirror relationships that have a matching source volume node name.

Examples

To display summary information about all relationships whose source endpoints are in the current Vserver, type the following command:

vserver1.example.com::> snapmirror list-destinations

                                                  Progress
Source             Destination          Transfer  Last      Relationship
Path         Type  Path         Status  Progress  Updated   ID
----------- ----- ------------ ------- --------- --------- ----------------
vserver1.example.com:dp_s1
            DP    vserver2.example.com:dp_d1
                               Idle    -         -         06b4327b-954f-11e1-af65-123478563412
vserver1.example.com:xdp_s1
            XDP   vserver2.example.com:xdp_d1
                               Idle    -         -         a9c1db0b-954f-11e1-af65-123478563412
2 entries were displayed.


To display detailed information about SnapMirror relationships whose source endpoints are in the current Vserver, type the following command:

vserver1.example.com::> snapmirror list-destinations -instance

              Source Path: vserver1.example.com:dp_s1
         Destination Path: vserver2.example.com:dp_d1
        Relationship Type: DP
  Relationship Group Type: none
      Relationship Status: Idle
        Transfer Progress: -
    Progress Last Updated: -
       Source Volume Node: node1
          Relationship ID: 06b4327b-954f-11e1-af65-123478563412

              Source Path: vserver1.example.com:xdp_s1
         Destination Path: vserver2.example.com:xdp_d1
        Relationship Type: XDP
  Relationship Group Type: none
      Relationship Status: Idle
        Transfer Progress: -
    Progress Last Updated: -
       Source Volume Node: node2
          Relationship ID: a9c1db0b-954f-11e1-af65-123478563412

2 entries were displayed.

Restrictions/Limitations

The snapmirror list-destinations command does not return information about load-sharing relationships or relationships whose source endpoints were in clustered Data ONTAP 8.1 when they were created. You must run the snapmirror show command to display information about these relationships.

SnapMirror relationship information on the source Vserver or cluster is populated during the first transfer. Therefore, the snapmirror list-destinations command will not return any information about newly created SnapMirror relationships until the baseline transfer has started.

See Also

snapmirror show  
Index  |  Top  -  Up Data ONTAP 8.3

Copyright © 1994-2015 NetApp, Inc. Legal Information