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.
                              - consistencygroup: Consistency Group
                                                  relationship.
Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
         Relationship Status: Status of the SnapMirror relationship.
                              Can be one of the following:
                              - Idle: No transfer operation is in
                                      progress and future transfers are
                                      not disabled.
                              - Queued: A transfer operation has been
                                      accepted and queued in the system,
                                      and future transfers are not
                                      disabled.
                              - Transferring: A transfer operation is in
                                      progress and future transfers are
                                      not disabled.
                              - Preparing: Pre-transfer phase for
                                      Vault incremental transfers.
                                      For Vault relationships only.
                              - Finalizing: Post-transfer phase for
                                      Vault incremental transfers.
                                      Network traffic will be low as
                                      processing is primarily on the
                                      destination volume.
                                      For Vault relationships only.
                              - Aborting: A transfer abort operation
                                      that might include the removal of
                                      the checkpoint is underway. Future
                                      transfers are not disabled. Only
                                      for relationships with
                                       "Relationship Capability"
                                      of  "8.2 and above" .
                              - Quiesced: No transfer operation is in
                                      progress and future transfers are
                                      disabled.
                              - Quiescing: A transfer operation is in
                                      progress and future transfers
                                      are disabled.
                              - Checking: Destination volume is
                                      undergoing a diagnostic check,
                                      no transfer is in progress, and
                                      future transfers are not disabled.
                                      Only for relationships with
                                       "Relationship Capability"
                                      of  "Pre 8.2" .
                              - Breaking: The SnapMirror relationship is
                                      being broken off and no transfer is
                                      in progress.
The following values are only applicable to
                              relationships with a policy of type
                              sync-mirror, strict-sync-mirror, or
                              automated-failover:
                              - OutOfSync: The SnapMirror relationship is
                                      not InSync and no async transfer
                                      operation is in progress.
                              - Transitioning: The SnapMirror relationship
                                      is transitioning to InSync.
                              - InSync: The SnapMirror relationship is
                                      InSync.
Mirror State: State of the destination volume. Can be one
                              of the following:
                              - Uninitialized: Destination volume has not
                                              been initialized.
                              - Snapmirrored: Destination volume has been
                                              initialized and is ready to
                                              receive SnapMirror updates.
                              - Broken-off: Destination volume is RW
                                            and snapshots are present.
                     Healthy: Condition of the relationship. Can be one of
                              the following:
                              - true: The SnapMirror relationship is
                                      healthy. It has not missed a
                                      scheduled transfer, or experienced
                                      a manual update failure.
                              - false: The SnapMirror relationship is not
                                     healthy. It has missed a scheduled
                                     transfer, or has experienced a manual
                                     update failure.
            Unhealthy Reason: Reason the SnapMirror relationship is not
                              healthy. Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above"
             Newest Snapshot: Name of the newest Snapshot copy on the
                              destination volume.
   Newest Snapshot Timestamp: Timestamp of the newest Snapshot copy.
           Exported Snapshot: Name of the exported Snapshot copy on the
                              destination volume.
 Exported Snapshot Timestamp: Timestamp of the exported Snapshot copy.
                    Lag Time: Time since the exported Snapshot copy
                              was created. It is displayed in the
                              format: hours:minutes:seconds.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
               Transfer Type: Type of the current transfer operation.
                              Can be one of the following:
                              - initialize
                              - update
                              - resync
                              - restore
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
           Transfer Snapshot: Name of the Snapshot copy being transferred.
           Snapshot Progress: Amount of data transferred for the transfer
                              snapshot. This parameter is not supported
                              for SnapMirror FlexGroup relationships, but
                              it is supported for FlexGroup constituent
                              relationships.
              Total Progress: Total amount of data transferred for the
                              current transfer operation. This parameter
                              is not supported for SnapMirror FlexGroup
                              relationships, but it is supported for
                              FlexGroup constituent relationships.
   Percent Complete for Current Status: Percent complete for the current value
                              of status. This field is only valid when the
             "Relationship Status"  is
             "Finalizing" .
   Network Compression Ratio: The compression ratio achieved for the data
                              sent over the wire as a part of the current
                              transfer operation. The ratio is not
                              maintained across checkpoint restarts. If
                              network compression is disabled for the
                              transfer, the ratio will be set to 1:1.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              or FlexGroup SnapMirror relationships, but
                              it is supported for FlexGroup constituent
                              relationships.
         Snapshot Checkpoint: The amount of data transferred as recorded in
                              the restart checkpoint of the current or most
                              recent transfer snapshot. If a restart
                              checkpoint is present the next transfer will
                              continue from the checkpoint. This parameter
                              is not supported for SnapMirror FlexGroup
                              relationships, but it is supported for
                              FlexGroup constituent relationships.
              Transfer Error: Possible transient error condition if any,
                              encountered by the current transfer
                              operation.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above".
            Current Throttle: The maximum transfer rate in Kilobytes
                              per second, used for the current transfer
                              between clusters.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
   Current Transfer Priority: Priority assigned to the current transfer.
                              Possible values are:
                              - low
                              - normal
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
          Last Transfer Type: Type of the previous transfer operation:
                              - initialize
                              - update
                              - resync
                              - restore
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
          Last Transfer Size: Total amount of data transferred during the
                              previous transfer operation if it was
                              successful.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for
                              SnapMirror FlexGroup relationships, but it
                              is supported for FlexGroup constituent
                              relationships.
Last Transfer Network Compression Ratio: The compression ratio achieved
                              for the data sent over the wire as a part of
                              the previous transfer operation. If network
                              compression was disabled for the transfer,
                              the ratio will be set to 1:1.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              or FlexGroup SnapMirror relationships, but it
                              is supported for FlexGroup constituent
                              relationships.
      Last Transfer Duration: Duration of the previous transfer
                              operation if it was successful.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
          Last Transfer From: Source endpoint of the previous transfer
                              operation.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
 Last Transfer End Timestamp: Timestamp of the end of the previous
                              transfer operation.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
         Last Transfer Error: Cause of the failure of the previous
                              transfer operation.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
     Relationship Capability: Management and control compatibility:
                              - "Pre 8.2": Management and control of
                                the relationship is compatible with
                                clustered Data ONTAP 8.1.
                              - "8.2 and above": Full support of clustered
                                Data ONTAP 8.2 or later SnapMirror
                                relationship management and control.
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
             Relationship ID: The unique identifier of the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
        Current Operation ID: Operation unique identifier of the currently
                              executing SnapMirror operation.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
           Throttle (KB/sec): Configured maximum transfer rate for
                              cross-cluster transfers.
      SnapMirror Policy Type: Type of the SnapMirror policy associated
                              with the relationship. Can be one of the
                              following:
                              - async-mirror
                              - vault
                              - mirror-vault
Refer to the man page for the
                              link:snapmirror-policy-create.html[snapmirror policy create] command
                              for a description of what these types mean.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
           SnapMirror Policy: Name of the SnapMirror policy associated
                              with the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
         SnapMirror Schedule: Name of the schedule (empty if there is
                              no schedule) associated with the
                              relationship.
                 Tries Limit: Maximum number of times a transfer will be
                              tried.
                              Only for relationships with
                               "Relationship Capability"
                              of  "Pre 8.2" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
     Destination Volume Node: Node which owns the destination volume
                              of the relationship. For FlexGroup
                              relationships it is the node which owns
                              the root constituent destination volume.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
Identity Preserve Vserver DR: Whether or not the identity of the source
                              Vserver is replicated to the destination
                              Vserver. Can be:
                              - true:  Source Vserver's configuration will
                                       additionally be replicated to the
                                       destination, along with the
                                       Vserver's volumes and RBAC
                                       configuration.
                              - false: Only volumes and RBAC configuration
                                       of the source Vserver is replicated
                                       to the destination.
                              This parameter is supported only for Vserver
                              SnapMirror relationships.
      Volume MSIDs Preserved: Whether or not the MSIDs of the source
                              volumes are retained while creating
                              destination volumes.
                              Can be:
                               - true: MSIDs of source Vserver volumes and
                                       destination Vserver volumes match.
                               - false: MSIDs of source Vserver volumes and
                                        destination Vserver volumes do not
                                        match.
                              This parameter is supported only for Vserver
                              SnapMirror relationships.
      Is Auto Expand Enabled: Whether or not the auto expand is enabled.
            Can be:
            - true: Auto Expand is enabled.
            - false: Auto Expand is disabled.
            This parameter is supported only for FlexGroup
            SnapMirror relationships.
         Is Adaptive Enabled: Whether or not adaptive is enabled.
            Can be:
            - true: Adaptive is enabled.
            - false: Adaptive is disabled.
            This parameter is supported only for FlexVol
            SnapMirror relationships between Data ONTAP
            endpoints.
Number of Successful Updates: The number of successful SnapMirror update
                              operations for the relationship since the
            last reboot, aggregate relocation, takeover/
            giveback, or metrocluster switchover/switchback
            involving the node that hosts the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
    Number of Failed Updates: The number of failed SnapMirror update
                              operations for the relationship since the
            last reboot, aggregate relocation, takeover/
            giveback, or metrocluster switchover/switchback
            involving the node that hosts the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
Number of Successful Resyncs: The number of successful SnapMirror resync
                              operations for the relationship since the
            last reboot, aggregate relocation, takeover/
            giveback, or metrocluster switchover/switchback
            involving the node that hosts the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
    Number of Failed Resyncs: The number of failed SnapMirror resync
                              operations for the relationship since the
            last reboot, aggregate relocation, takeover/
            giveback, or metrocluster switchover/switchback
            involving the node that hosts the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
 Number of Successful Breaks: The number of successful SnapMirror break
                              operations for the relationship since the
            last reboot, aggregate relocation, takeover/
            giveback, or metrocluster switchover/switchback
            involving the node that hosts the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
     Number of Failed Breaks: The number of failed SnapMirror break
                              operations for the relationship since the
            last reboot, aggregate relocation, takeover/
            giveback, or metrocluster switchover/switchback
            involving the node that hosts the relationship.
                              Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.
        Total Transfer Bytes: Cumulative bytes transferred for the
                              relationship since the last reboot,
            aggregate relocation, takeover/giveback,
            or metrocluster switchover/switchback
            involving the node that hosts the relationship.
            Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
            This parameter is not supported for Vserver
            or FlexGroup volume SnapMirror relationships,
            but it is supported for FlexGroup volume
            constituent relationships.
         Total Transfer Time: Cumulative total transfer time in seconds for
            the relationship since the last reboot, aggregate
            relocation, takeover/giveback, or metrocluster
            switchover/switchback involving the node that
            hosts the relationship. Only for relationships with
                               "Relationship Capability"
                              of  "8.2 and above" .
                              This parameter is not supported for Vserver
                              SnapMirror relationships.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

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

{ [-S, -source-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[cgname]>}] - Source Path

Select SnapMirror relationships that have a matching source path name.

| [-source-cluster <Cluster name>] - Source Cluster

Select SnapMirror relationships that have a matching source cluster name. This parameter is not supported for relationships with non-Data ONTAP source endpoints.

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

Select SnapMirror relationships that have a matching source Vserver name. This parameter is not supported for relationships with non-Data ONTAP source endpoints.

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

Select SnapMirror relationships that have a matching source volume name. This parameter is not supported for relationships with non-Data ONTAP source endpoints.

{ [-destination-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[cgname]>}] - Destination Path

Select SnapMirror relationships that have a matching destination path name.

Note Using wildcards with this parameter:
  • To match all Vserver Snapmirror relationships, use: `-destination-path`*:

  • To match all the Snapmirror relationships except Vserver Snapmirror relationships in the cluster, use: `-destination-path`*

| [-destination-cluster <Cluster name>] - Destination Cluster

Select SnapMirror relationships that have a matching destination cluster name. This parameter is not supported for relationships with non-Data ONTAP destination endpoints.

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

Select SnapMirror relationships that have a matching destination Vserver name. This parameter is not supported for relationships with non-Data ONTAP destination endpoints.

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

Select SnapMirror relationships that have a matching destination volume name. This parameter is not supported for relationships with non-Data ONTAP destination endpoints.

[-type <snapmirrorType>] - Relationship Type

Select SnapMirror relationships that have a matching relationship type. Vservers support only DP SnapMirror relationships. Possible values are:

  • DP

  • LS

  • XDP

  • TDP

  • RST

[-relationship-group-type {none|vserver|consistencygroup|flexgroup|vserverflexgroup}] - Relationship Group Type

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

  • none

  • vserver

  • flexgroup

  • consistencygroup

[-vserver <vserver name>] - Managing Vserver

Select SnapMirror relationships that have a matching managing Vserver name. The -vserver option is currently a reserved option.

[-schedule <text>] - SnapMirror Schedule

Select SnapMirror relationships that have a matching schedule.

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

  • automated-failover

  • sync-mirror

  • strict-sync-mirror

[-policy <sm_policy>] - SnapMirror Policy

Select SnapMirror relationships that have a matching SnapMirror policy.

[-tries <unsigned32_or_unlimited>] - Tries Limit

Select SnapMirror relationships that have a matching tries limit.

[-k, -throttle <throttleType>] - Throttle (KB/sec)

Select SnapMirror relationships that have a matching throttle.

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

Select SnapMirror relationships that have a matching cg-item-mappings.

[-current-throttle <throttleType>] - Current Transfer Throttle (KB/sec)

Select SnapMirror relationships that have a matching current throttle.

[-state <mirror state>] - Mirror State

Select SnapMirror relationships that have a matching mirror state. Possible values are:

  • Uninitialized

  • Snapmirrored

  • Broken-off

[-status <mirror status>] - Relationship Status

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

  • Idle

  • Queued

  • Transferring

  • Preparing

  • Finalizing

  • Aborting

  • Quiesced

  • Quiescing

  • Checking

Status values Finalizing, Checking, Waiting and Preparing are not supported for Vserver SnapMirror relationships.

[-file-restore-file-count <integer>] - File Restore File Count

The number of files being restored by file restore.

[-file-restore-file-list <text>,…​] - File Restore File List

List of the destination file names of the files being restored by file restore.

[-transfer-snapshot <text>] - Transfer Snapshot

Select SnapMirror relationships that have a matching transfer Snapshot copy.

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

Select SnapMirror relationships that have a matching Snapshot progress.

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

Select SnapMirror relationships that have a matching total progress.

[-network-compression-ratio <text>] - Network Compression Ratio

Select SnapMirror relationships that have a matching network compression ratio. This parameter is not supported for Vserver SnapMirror relationships.

[-snapshot-checkpoint {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Checkpoint

Select SnapMirror relationships that have a matching Snapshot copy checkpoint. This parameter is not supported for Vserver SnapMirror relationships.

[-newest-snapshot <text>] - Newest Snapshot

Select SnapMirror relationships that have a matching newest Snapshot copy.

[-newest-snapshot-timestamp <MM/DD HH:MM:SS>] - Newest Snapshot Timestamp

Select SnapMirror relationships that have a matching newest Snapshot copy timestamp.

[-exported-snapshot <text>] - Exported Snapshot

Select SnapMirror relationships that have a matching exported Snapshot copy name. For load-sharing mirror relationships, if the exported-snapshot field for a relationship has a dash (-), the load-sharing mirror is lagging behind the up-to-date mirrors in the set.

[-exported-snapshot-timestamp <MM/DD HH:MM:SS>] - Exported Snapshot Timestamp

Select SnapMirror relationships that have a matching exported Snapshot copy timestamp.

[-healthy {true|false}] - Healthy

Select SnapMirror relationships that have a matching healthy condition.

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

Select SnapMirror relationships that have a matching relationship ID. This parameter is not supported for Vserver SnapMirror relationships.

[-current-operation-id <UUID>] - Current Operation ID

Select SnapMirror relationships that have a matching operation unique identifier of the currently executing SnapMirror operation.

[-current-transfer-type {initialize|update|resync|restore|check|file_restore|cggrs_initialize|cggrs_resync|cg_update|cg_initialize|cg_resync|cg_restore|catalog_metadata|cg_file_restore|failover|aufo|failover_incapable|cg_migrate}] - Transfer Type

Select SnapMirror relationships that have a matching current transfer type.

[-current-transfer-error <text>] - Transfer Error

Select SnapMirror relationships that have a matching current transfer error.

[-last-transfer-type {initialize|update|resync|restore|check|file_restore|cggrs_initialize|cggrs_resync|cg_update|cg_initialize|cg_resync|cg_restore|catalog_metadata|cg_file_restore|failover|aufo|failover_incapable|cg_migrate}] - Last Transfer Type

Select SnapMirror relationships that have a matching last transfer type.

[-last-transfer-error <text>] - Last Transfer Error

Select SnapMirror relationships that have a matching last transfer error.

[-last-transfer-size {<integer>[KB|MB|GB|TB|PB]}] - Last Transfer Size

Select SnapMirror relationships that have a matching last transfer size.

[-last-transfer-network-compression-ratio <text>] - Last Transfer Network Compression Ratio

Select SnapMirror relationships that have a matching last transfer network compression ratio. This parameter is not supported for Vserver SnapMirror relationships.

[-last-transfer-duration <[[<hours>:]<minutes>:]<seconds>>] - Last Transfer Duration

Select SnapMirror relationships that have a matching last transfer duration.

[-last-transfer-from <text>] - Last Transfer From

Select SnapMirror relationships that have a matching last transfer source.

[-last-transfer-end-timestamp <MM/DD HH:MM:SS>] - Last Transfer End Timestamp

Select SnapMirror relationships that have a matching last transfer end timestamp.

[-unhealthy-reason <text>] - Unhealthy Reason

Select SnapMirror relationships that have a matching unhealthy reason.

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

Select SnapMirror relationships that have a matching progress last updated.

[-relationship-capability <text>] - Relationship Capability

Select SnapMirror relationships that have a matching relationship capability. This parameter is not supported for Vserver SnapMirror relationships.

[-lag-time <[[<hours>:]<minutes>:]<seconds>>] - Lag Time

Select SnapMirror relationships that have a matching lag time.

[-current-transfer-priority {low|normal}] - Current Transfer Priority

Select SnapMirror relationships that have a matching current transfer priority.

[-is-smtape-op {true|false}] - SMTape Operation

Select SnapMirror relationships that have a matching smtape operation.

[-destination-volume-node <nodename>] - Destination Volume Node Name

Select SnapMirror relationships that have a matching destination volume node name. This parameter is not supported for Vserver SnapMirror relationships.

[-identity-preserve {true|false}] - Identity Preserve Vserver DR

Select SnapMirror relationships that have a matching value for identity-preserve. This parameter is valid only for Vserver SnapMirror relationships.

[-expand <true>] - Show Constituents of the Group

Specifies whether to display constituent relationships of Vserver, FlexGroup and Consistency Group SnapMirror relationships. By default, the constituents are not displayed.

[-update-successful-count <integer>] - Number of Successful Updates

Select SnapMirror relationships that have a matching number of successful updates. This parameter is not supported for Vserver SnapMirror relationships.

[-update-failed-count <integer>] - Number of Failed Updates

Select SnapMirror relationships that have a matching number of failed updates. This parameter is not supported for Vserver SnapMirror relationships.

[-resync-successful-count <integer>] - Number of Successful Resyncs

Select SnapMirror relationships that have a matching number of successful resyncs. This parameter is not supported for Vserver SnapMirror relationships.

[-resync-failed-count <integer>] - Number of Failed Resyncs

Select SnapMirror relationships that have a matching number of failed resyncs. This parameter is not supported for Vserver SnapMirror relationships.

[-break-successful-count <integer>] - Number of Successful Breaks

Select SnapMirror relationships that have a matching number of successful breaks. This parameter is not supported for Vserver SnapMirror relationships.

[-break-failed-count <integer>] - Number of Failed Breaks

Select SnapMirror relationships that have a matching number of failed breaks. This parameter is not supported for Vserver SnapMirror relationships.

[-total-transfer-bytes <integer>] - Total Transfer Bytes

Select SnapMirror relationships that have a matching total transfer bytes. This parameter is not supported for Vserver SnapMirror relationships.

[-total-transfer-time-secs <integer>] - Total Transfer Time in Seconds

Select SnapMirror relationships that have a matching total transfer time in seconds. This parameter is not supported for Vserver SnapMirror relationships.

[-msid-preserve {true|false}] - Source Volume MSIDs Preserved

This parameter specifies whether the volume MSIDs are preserved at the destination. This parameter is applicable only for Vserver SnapMirror relationships.

[-is-auto-expand-enabled {true|false}] - Is Auto Expand Enabled

Select SnapMirror relationships that have a matching value for auto expand. This parameter is supported only for FlexGroup SnapMirror relationships. Possible values are:

  • true

  • false

[-percent-complete-cur-status <integer>] - Percent Complete for Current Status

Select SnapMirror relationships that have a matching percent complete for the current status.

Examples

The example below displays summary information for all SnapMirror relationships with destination endpoints in the current cluster:

cluster2::> snapmirror show
Source            Destination  Mirror  Relationship  Total             Last
Path        Type  Path         State   Status        Progress  Healthy Updated
----------- ---- ------------ ------- -------------- --------- ------- --------
cluster1-vs2.example1.com:
            DP   cluster2-dvs2.example2.com:
                              Snapmirrored
                                      Idle           -         true    -
cluster2-vs1.example.com:dp_src1
            DP   cluster2-vs2.example.com:dp_dst1
                              Snapmirrored
                                      Idle           -         true    -
cluster2-vs1.example.com:xdp_src1
            XDP  cluster2-vs2.example.com:xdp_dst1
                              Snapmirrored
                                      Idle           -         true    -
cluster2://cluster2-vs1.example.com/ls_src1
            LS   cluster2://cluster2-vs1.example.com/ls_mr1
                              Snapmirrored
                                      Idle           -         true    -
                 cluster2://cluster2-vs1.example.com/ls_mr2
                              Snapmirrored
                                      Idle           -         true    -
5 entries were displayed.

The example below displays detailed information for the SnapMirror relationship with the destination endpoint cluster2-vs2.example.com:dp_dst1 .

cluster2::> snapmirror show -destination-path cluster2-vs2.example.com:dp_dst1
Source Path: cluster2-vs1.example.com:dp_src1
                       Destination Path: cluster2-vs2.example.com:dp_dst1
                      Relationship Type: DP
                Relationship Group Type: none
                    SnapMirror Schedule: -
                 SnapMirror Policy Type: async-mirror
                      SnapMirror Policy: DPDefault
                            Tries Limit: -
                      Throttle (KB/sec): unlimited
                           Mirror State: Snapmirrored
                    Relationship Status: Idle
                      Transfer Snapshot: -
                      Snapshot Progress: -
                         Total Progress: -
    Percent Complete for Current Status: -
              Network Compression Ratio: -
                    Snapshot Checkpoint: -
                        Newest Snapshot: snapmirror.3d19af37-8f5e-11e1-8c83-123478563412_2147484676.2012-04-27_025137
              Newest Snapshot Timestamp: 04/27 02:51:42
                      Exported Snapshot: snapmirror.3d19af37-8f5e-11e1-8c83-123478563412_2147484676.2012-04-27_025137
            Exported Snapshot Timestamp: 04/27 02:51:42
                                Healthy: true
                       Unhealthy Reason: -
                Destination Volume Node: cluster2-node1
                        Relationship ID: cdc70a81-8f5f-11e1-8392-123478563412
                   Current Operation ID: -
                          Transfer Type: -
                         Transfer Error: -
                       Current Throttle: -
              Current Transfer Priority: -
                     Last Transfer Type: update
                    Last Transfer Error: -
                     Last Transfer Size: 530.2MB
Last Transfer Network Compression Ratio: 111.7:1
                 Last Transfer Duration: 0:2:53
                     Last Transfer From: cluster2-vs1.example.com:dp_src1
            Last Transfer End Timestamp: 04/27 02:51:45
                  Progress Last Updated: -
                Relationship Capability: 8.2 and above
                               Lag Time: 133:50:40
           Identity Preserve Vserver DR: -
                 Volume MSIDs Preserved: -
           Is Auto Expand Enabled: -
                Is Adaptive: -
           Number of Successful Updates: 1
               Number of Failed Updates: 0
           Number of Successful Resyncs: 0
               Number of Failed Resyncs: 0
            Number of Successful Breaks: 0
                Number of Failed Breaks: 0
                   Total Transfer Bytes: 663552
         Total Transfer Time in Seconds: 3

The example below displays detailed information for SnapMirror relationships with the Relationship Capability of "Pre 8.2" source or destination endpoints in the current cluster.

cluster2::> snapmirror show -relationship-capability "Pre 8.2" -instance
Source Path: cluster2://cluster2-vs1.example.com/ls_src1
                       Destination Path: cluster2://cluster2-vs1.example.com/ls_mr1
                      Relationship Type: LS
                Relationship Group Type: -
                    SnapMirror Schedule: -
                 SnapMirror Policy Type: -
                      SnapMirror Policy: -
                            Tries Limit: 8
                      Throttle (KB/sec): unlimited
                           Mirror State: Snapmirrored
                    Relationship Status: Idle
                      Transfer Snapshot: -
                      Snapshot Progress: -
                         Total Progress: -
    Percent Complete for Current Status: -
              Network Compression Ratio: -
                    Snapshot Checkpoint: -
                        Newest Snapshot: snapmirror.3d4e52c5-8f5c-11e1-8392-123478563412_3_2147484684.2012-05-02_163506
              Newest Snapshot Timestamp: 05/02 16:35:06
                      Exported Snapshot: snapmirror.3d4e52c5-8f5c-11e1-8392-123478563412_3_2147484684.2012-05-02_163506
            Exported Snapshot Timestamp: 05/02 16:35:06
                                Healthy: true
                       Unhealthy Reason: -
                Destination Volume Node: -
                        Relationship ID: -
                   Current Operation ID: -
                          Transfer Type: -
                         Transfer Error: -
                     Last Transfer Type: -
                    Last Transfer Error: -
                     Last Transfer Size: -
Last Transfer Network Compression Ratio: -
                 Last Transfer Duration: -
                     Last Transfer From: -
            Last Transfer End Timestamp: -
                  Progress Last Updated: -
                Relationship Capability: Pre 8.2
                               Lag Time: -
                      SnapMirror Policy: -
           Identity Preserve Vserver DR: -
                 Volume MSIDs Preserved: -
           Is Auto Expand Enabled: -
                Is Adaptive: -
           Number of Successful Updates: -
               Number of Failed Updates: -
           Number of Successful Resyncs: -
               Number of Failed Resyncs: -
            Number of Successful Breaks: -
                Number of Failed Breaks: -
                   Total Transfer Bytes: -
         Total Transfer Time in Seconds: -
Source Path: cluster2://cluster2-vs1.example.com/ls_src1
                       Destination Path: cluster2://cluster2-vs1.example.com/ls_mr2
                      Relationship Type: LS
                Relationship Group Type: -
                    SnapMirror Schedule: -
                 SnapMirror Policy Type: -
                      SnapMirror Policy: -
                            Tries Limit: 8
                      Throttle (KB/sec): unlimited
                           Mirror State: Snapmirrored
                    Relationship Status: Idle
                      Transfer Snapshot: -
                      Snapshot Progress: -
                         Total Progress: -
    Percent Complete for Current Status: -
              Network Compression Ratio: -
                    Snapshot Checkpoint: -
                        Newest Snapshot: snapmirror.3d4e52c5-8f5c-11e1-8392-123478563412_3_2147484684.2012-05-02_163506
              Newest Snapshot Timestamp: 05/02 16:35:06
                      Exported Snapshot: snapmirror.3d4e52c5-8f5c-11e1-8392-123478563412_3_2147484684.2012-05-02_163506
            Exported Snapshot Timestamp: 05/02 16:35:06
                                Healthy: true
                       Unhealthy Reason: -
                Destination Volume Node: -
                        Relationship ID: -
                   Current Operation ID: -
                          Transfer Type: -
                         Transfer Error: -
                     Last Transfer Type: -
                    Last Transfer Error: -
                     Last Transfer Size: -
Last Transfer Network Compression Ratio: -
                 Last Transfer Duration: -
                     Last Transfer From: -
            Last Transfer End Timestamp: -
                  Progress Last Updated: -
                Relationship Capability: Pre 8.2
                               Lag Time: -
                      SnapMirror Policy: -
           Identity Preserve Vserver DR: -
                 Volume MSIDs Preserved: -
           Is Auto Expand Enabled: -
                Is Adaptive: -
           Number of Successful Updates: -
               Number of Failed Updates: -
           Number of Successful Resyncs: -
               Number of Failed Resyncs: -
            Number of Successful Breaks: -
                Number of Failed Breaks: -
                   Total Transfer Bytes: -
         Total Transfer Time in Seconds: -

2 entries were displayed.

The example below displays detailed information for the Vserver SnapMirror relationship with the destination endpoint cluster2-dvs2.example2.com: .

cluster2::> snapmirror show -destination-path cluster2-dvs2.example2.com:
Source Path: cluster1-vs2.example1.com:
                       Destination Path: cluster2-dvs2.example2.com:
                      Relationship Type: DP
                Relationship Group Type: -
                    SnapMirror Schedule: -
                 SnapMirror Policy Type: async-mirror
                      SnapMirror Policy: DPDefault
                            Tries Limit: -
                      Throttle (KB/sec): unlimited
                           Mirror State: Snapmirrored
                    Relationship Status: Idle
                File Restore File Count: -
                 File Restore File List: -
                      Transfer Snapshot: -
                      Snapshot Progress: -
                         Total Progress: -
    Percent Complete for Current Status: -
              Network Compression Ratio: -
                    Snapshot Checkpoint: -
                        Newest Snapshot: vserverdr.1d519e9c-7838-11e3-91fb-123478563412.2014-01-13_110707
              Newest Snapshot Timestamp: 01/13 11:07:07
                      Exported Snapshot: vserverdr.1d519e9c-7838-11e3-91fb-123478563412.2014-01-13_110707
            Exported Snapshot Timestamp: 01/13 11:07:07
                                Healthy: true
                       Unhealthy Reason: -
                Destination Volume Node: -
                        Relationship ID: -
                           Operation ID: -
                          Transfer Type: -
                         Transfer Error: -
                       Current Throttle: -
              Current Transfer Priority: -
                     Last Transfer Type: resync
                    Last Transfer Error: -
                     Last Transfer Size: -
Last Transfer Network Compression Ratio: -
                 Last Transfer Duration: -
                     Last Transfer From: cluster1-vs2.example1.com:
            Last Transfer End Timestamp: -
                  Progress Last Updated: -
                Relationship Capability: -
                               Lag Time: 18:47:9
           Identity Preserve Vserver DR: false
                 Volume MSIDs Preserved: true
           Is Auto Expand Enabled: -
                Is Adaptive: -
           Number of Successful Updates: -
               Number of Failed Updates: -
           Number of Successful Resyncs: -
               Number of Failed Resyncs: -
            Number of Successful Breaks: -
                Number of Failed Breaks: -
                   Total Transfer Bytes: -
         Total Transfer Time in Seconds: -

The following example displays detailed information for the SnapMirror relationship with the AltaVault destination endpoint 10.0.0.11:/share/share1 :

cluster2::> snapmirror show -destination-path 10.0.0.11:/share/share1
Source Path: cluster2-vs1.example.com:data_ontap_vol
           Destination Path: 10.0.0.11:/share/share1
          Relationship Type: XDP
    Relationship Group Type: none
        SnapMirror Schedule: -
     SnapMirror Policy Type: vault
          SnapMirror Policy: XDPDefault
          Tries Limit: -
          Throttle (KB/sec): unlimited
         Mirror State: Snapmirrored
        Relationship Status: Idle
          Transfer Snapshot: -
          Snapshot Progress: -
       Total Progress: -
    Percent Complete for Current Status: -
        Network Compression Ratio: -
        Snapshot Checkpoint: -
      Newest Snapshot: snapmirror.3d19af37-8f5e-11e1-8c83-123478563412_2147484676.2012-04-27_025137
        Newest Snapshot Timestamp: 04/27 02:51:42
          Exported Snapshot: snapmirror.3d19af37-8f5e-11e1-8c83-123478563412_2147484676.2012-04-27_025137
      Exported Snapshot Timestamp: 04/27 02:51:42
        Healthy: true
           Unhealthy Reason: -
    Destination Volume Node: -
      Relationship ID: cdc70a81-8f5f-11e1-8392-123478563463
       Current Operation ID: -
        Transfer Type: -
       Transfer Error: -
           Current Throttle: -
        Current Transfer Priority: -
         Last Transfer Type: update
        Last Transfer Error: -
         Last Transfer Size: 530.2MB
  Last Transfer Network Compression Ratio: 1:1
     Last Transfer Duration: 0:2:53
         Last Transfer From: cluster2-vs1.example.com:data_ontap_vol
      Last Transfer End Timestamp: 04/27 02:51:45
      Progress Last Updated: -
    Relationship Capability: 8.2 and above
             Lag Time: 133:50:40
     Identity Preserve Vserver DR: -
     Volume MSIDs Preserved: -
           Is Auto Expand Enabled: -
                Is Adaptive: -
     Number of Successful Updates: 1
         Number of Failed Updates: 0
     Number of Successful Resyncs: 0
         Number of Failed Resyncs: 0
      Number of Successful Breaks: 0
    Number of Failed Breaks: 0
       Total Transfer Bytes: 663552
   Total Transfer Time in Seconds: 3

The example shows the usage of the -expand parameter to additionally display the constituents of Vserver SnapMirror relationships with destination endpoints in the current cluster. Note that in the following example, since there is no volume level relationship for the root volume of a Vserver, it is not shown in the output:

cluster2::> snapmirror show -expand
                                                                       Progress
Source            Destination  Mirror  Relationship  Total             Last
Path        Type  Path         State   Status        Progress  Healthy Updated
----------- ---- ------------ ------- -------------- --------- ------- --------
cluster1-vs1.example1.com:
            DP   cluster2-dvs1.example2.com:
                              Snapmirrored
                                      Idle           -         true    -
cluster1-vs1.example1.com:vol1
            DP   cluster2-dvs1.example2.com:vol1
                              Snapmirrored
                                      Idle           -         true    -
cluster1-vs2.example1.com:
            DP   cluster2-dvs2.example2.com:
                              Snapmirrored
                                      Idle           -         true    -
cluster1-vs2.example1.com:vol1
            DP   cluster2-dvs2.example2.com:vol1
                              Snapmirrored
                                      Idle           -         true    -
4 entries were displayed.