ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • 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:

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

    { [-S, -source-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[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/[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}] - 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|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 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.
    Top of Page