Skip to main content

snapmirror list-destinations

Contributors
Suggest changes
PDFs

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:

  • Source path

  • Relationship Type

  • Destination Path

  • Relationship Status

  • Transfer Progress

  • Progress Last Updated

  • Relationship ID

Note the following limitations on the information displayed by the snapmirror list-destinations command:

  • The "Relationship Status" field is not valid after the node hosting the source volume joins the cluster quorum, until at least one transfer is performed on the SnapMirror relationship.

  • "Transfer Progress" and "Progress Last Updated" fields are only valid if a snapshot transfer is in progress.

  • The "Relationship ID" field is not valid for Vserver SnapMirror relationships.

  • The "Relationship Status" , "Transfer Progress" , and "Progress Last Updated" fields are not valid for FlexGroup relationships, but they are valid for FlexGroup constituent relationships.

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-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.

{ [-S, -source-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[app-cgname]>}] - 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>|<[vserver:]/cg/[app-cgname]>}] - 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|vserverflexgroup|vserverconsistencygroup}] - 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|strict-sync-mirror|sync-mirror|automated-failover|automated-failover-duplex|continuous}] - SnapMirror Policy Type

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

  • async-mirror

  • vault

  • mirror-vault

[-cg-item-mappings {<source volume>:@<destination volume>|<source item path>:@<destination item path>}] - Consistency Group Item Mappings

Selects SnapMirror relationships that have a matching list of Consistency Group (CG) item mappings. This parameter is applicable to CG level relationships only.

[-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 and Application Consistency Group SnapMirror relationships, but it is supported for FlexGroup and Application Consistency Group 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 and Application Consistency Group SnapMirror relationships, but it is supported for FlexGroup and Application Consistency Group 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 and Application Consistency Group SnapMirror relationships, but it is supported for FlexGroup and Application Consistency Group 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.

To display information about Application Consistency Group SnapMirror relationships type the following command:

cluster-1::> snapmirror list-destinations
                                                  Progress
Source             Destination         Transfer   Last         Relationship
Path         Type  Path         Status Progress   Updated      Id
----------- ----- ------------ ------- --------- ------------ ---------------
vs0:/cg/cgA XDP   vs1:/cg/cg_dst_async Idle -    -            8cb8bc1a-c193-11ed-9f4c-005056a7c7a2