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 -fields parameter specifies what fields should be displayed. The other parameters of the snapmirror list-destinations command, select the SnapMirror relationships for which the information is displayed.

This command is not supported for SnapMirror relationships with non-Data ONTAP endpoints.

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>|<hostip:/lun/name>|<hostip:/share/share-name>}] - 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>|<hostip:/lun/name>|<hostip:/share/share-name>}] - 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. This parameter is not supported for Vserver SnapMirror relationships.
[-type <snapmirrorType>] - Relationship Type
Selects SnapMirror relationships that have a matching relationship type. Possible values are:
  • DP
  • XDP
  • RST
[-relationship-group-type {none|vserver|consistencygroup|flexgroup}] - Relationship Group Type
Selects SnapMirror relationships that have a matching relationship group type. Possible values are:
  • none
  • vserver
  • flexgroup
[-policy-type {vault|async-mirror|mirror-vault|full-sync-mirror|relaxed-sync-mirror}] - SnapMirror Policy Type
Selects SnapMirror relationships that have a matching SnapMirror policy type. Possible values are:
  • async-mirror
  • vault
  • mirror-vault
[-status <mirror status>] - Relationship Status
Selects SnapMirror relationships that have a matching relationship status. Possible values are:
  • Idle
  • Transferring
This parameter is not supported for FlexGroup SnapMirror relationships, but it is supported for FlexGroup constituent relationships.
[-transfer-progress {<integer>[KB|MB|GB|TB|PB]}] - Transfer Progress
Selects SnapMirror relationships that have a matching transfer progress. This parameter is not supported for FlexGroup SnapMirror relationships, but it is supported for FlexGroup constituent 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 parameter is not supported for FlexGroup SnapMirror relationships, but it is supported for FlexGroup constituent relationships.
[-source-volume-node <nodename>] - Source Volume Node Name
Selects SnapMirror relationships that have a matching source volume node name. For FlexGroup relationships, it is the node which owns the root constituent source volume. This parameter is not supported for Vserver SnapMirror relationships.
[-expand [true]] - Show Constituents of the Group
Specifies whether to display constituent relationships of Vserver and FlexGroup SnapMirror relationships. By default, the constituents are not displayed.

Examples

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

cluster1::> 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
vserver2.example.com:
            DP    dvserver2.example2.com:
                               Idle    -         -         -
3 entries were displayed.


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.

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

cluster-1::> snapmirror list-destinations -expand
                                                  Progress
Source             Destination         Transfer   Last         Relationship
Path         Type  Path         Status Progress   Updated      Id
----------- ----- ------------ ------- --------- ------------ ---------------
vs1:fg_s1   XDP   vs1:fg_d1    -       -         -            504abc00-70a8-11e6-82be-0050568536d7
vs1:fg_s1__0001
            XDP   vs1:fg_d1__0001
                               -       -         -            5041f2aa-70a8-11e6-82be-0050568536d7
vs1:fg_s1__0002
            XDP   vs1:fg_d1__0002
                               -       -         -            50421733-70a8-11e6-82be-0050568536d7
vs1:fg_s1__0003
            XDP   vs1:fg_d1__0003
                               -       -         -            50421826-70a8-11e6-82be-0050568536d7
vs1:fg_s1__0004
            XDP   vs1:fg_d1__0004
                               -       -         -            504218f0-70a8-11e6-82be-0050568536d7
5 entries were displayed.