Skip to main content
A newer release of this product is available.

snapmirror show

Contributors
Suggest changes

Display a list of SnapMirror relationships

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

Description

The snapmirror show command displays information associated with SnapMirror relationships. By default, the command displays the following information:

  • Source path

  • Relationship Type

  • Destination Path

  • Mirror State

  • Relationship Status

  • Total Progress

  • Healthy

  • Progress Last Updated

For backward compatibility with clustered Data ONTAP 8.1, and to accommodate load-sharing relationships which are only supported in a Data ONTAP 8.1 compatible way, SnapMirror relationships, which match one of the following conditions are managed as on clustered Data ONTAP 8.1: (1) The relationship is of type load-sharing; (2) The source endpoint of the relationship is on a remote Data ONTAP 8.1 cluster; (3) The local cluster was upgraded from clustered Data ONTAP 8.1, the relationship was created before the upgrade, and the relationship has not yet been converted to one with Data ONTAP 8.2 capabilities. These relationships have the same limitations as on clustered Data ONTAP 8.1. Especially, they support the same set of information fields. The "Relationship Capability" field is set to "Pre 8.2" for these relationships.

The snapmirror show command displays information for SnapMirror relationships whose destination endpoints are in the current Vserver if you are in a Vserver context, or in the current cluster if you are in a cluster context, or on a non-Data ONTAP endpoint that supports SnapMirror (for example, AltaVault). For backward compatibility with clustered Data ONTAP 8.1, the command also displays information for SnapMirror relationships with the "Relationship Capability" of "Pre 8.2" , and whose source endpoints are in the current Vserver or cluster, and destination endpoints are in different Vservers or clusters. You must use the snapmirror list-destinations command to display information for SnapMirror relationships whose source endpoints are in the current Vserver or current cluster.

Some of the SnapMirror relationship information is cached. The snapmirror show command only returns the cached information, therefore there is a delay after the information is changed before it is reflected in the snapmirror show output. Other information, such as progress metrics during a transfer, is only updated periodically and can be very delayed in the snapmirror show output.

The -instance and -fields parameters are mutually exclusive and select the information fields that are displayed. The other parameters to the snapmirror show command select the SnapMirror relationships for which information is displayed. The -instance displays detailed information fields including:

Source Path: Path of the source endpoint.
            Destination Path: Path of the destination endpoint.
           Relationship Type: Type of the SnapMirror relationship. Can be
                              one of the following:
                              - DP: Data protection relationship.
                              - LS: Load-sharing relationship.
                              - XDP: Extended data protection relationship.
                              - RST: Temporary relationship created
                                     during a restore operation, and
                                     deleted if the operation completes
                                     successfully.
                              - TDP: 7-mode to clustered Data ONTAP
                                     transition data protection
                                     relationship.
     Relationship Group Type: For FlexVol relationships, specifies the
                              type of the group relationship that includes
                              this FlexVol. For group relationships,
                              specifies the type of the group
                              relationship. Can be one of the following:
                              - none: No group relationship.
                              - vserver: Vserver relationship.
                              - flexgroup: FlexGroup relationship.
Only for relationships with
                               "Relationship Capability"
                              of  "8.