| Index | Top - Up | Data ONTAP 8.3 |
Display a list of SnapMirror relationships
Availability: This command is available to cluster and Vserver administrators at the admin privilege level.
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. 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. May 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.
- infinitevol: Infinite Volume relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Relationship Status: Status of the SnapMirror relationship.
May 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 may 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.
Mirror State: State of the destination volume. May 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. May 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.
May 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.
Total Progress: Total amount of data transferred for the
current transfer operation.
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".
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.
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".
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".
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.
Relationship ID: The unique identifier of the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
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. May be one of the
following:
- async-mirror
- vault
- mirror-vault
Refer to the man page for the 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".
Constituent Relationship: Whether or not the SnapMirror relationship
is between Infinite Volume constituent
volumes. May be:
- true: The relationship is between
constituent volumes.
- false: The relationship is not between
constituent volumes.
Destination Volume Node: Node which owns the destination volume
of the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Number of Successful Updates: The number of successful SnapMirror update
operations for the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Number of Failed Updates: The number of failed SnapMirror update
operations for the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Number of Successful Resyncs: The number of successful SnapMirror resync
operations for the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Number of Failed Resyncs: The number of failed SnapMirror resync
operations for the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Number of Successful Breaks: The number of successful SnapMirror break
operations for the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Number of Failed Breaks: The number of failed SnapMirror break
operations for the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Total Transfer Bytes: Cumulative bytes transferred for the
relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
Total Transfer Time: Cumulative total transfer time in seconds
for the relationship.
Only for relationships with
"Relationship Capability"
of "8.2 and above".
{ [-fields <fieldname>, ...]
| [-instance ] }
{ [-source-path | -S {<[vserver:]volume>|<[[cluster:]//vserver/]volume>}] - Source Path
| [-source-cluster <Cluster name>] - Source Cluster
[-source-vserver <vserver name>] - Source Vserver
[-source-volume <volume name>] } - Source Volume
{ [-destination-path {<[vserver:]volume>|<[[cluster:]//vserver/]volume>}] - Destination Path
| [-destination-cluster <Cluster name>] - Destination Cluster
[-destination-vserver <vserver name>] - Destination Vserver
[-destination-volume <volume name>] } - Destination Volume
[-type <snapmirrorType>] - Relationship Type
[-relationship-group-type {none|infinitevol}] - Relationship Group Type
[-vserver <vserver name>] - Managing Vserver
[-schedule <text>] - SnapMirror Schedule
[-policy-type {vault|async-mirror|mirror-vault}] - SnapMirror Policy Type
[-policy <sm_policy>] - SnapMirror Policy
[-tries <unsigned32_or_unlimited>] - Tries Limit
[-throttle | -k <throttleType>] - Throttle (KB/sec)
[-current-throttle <throttleType>] - Current Transfer Throttle (KB/sec)
[-state <mirror state>] - Mirror State
[-status <mirror status>] - Relationship Status
[-file-restore-file-count <integer>] - File Restore File Count
[-file-restore-file-list <text>, ...] - File Restore File List
[-transfer-snapshot <text>] - Transfer Snapshot
[-snapshot-progress {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Progress
[-total-progress {<integer>[KB|MB|GB|TB|PB]}] - Total Progress
[-network-compression-ratio <text>] - Network Compression Ratio
[-snapshot-checkpoint {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Checkpoint
[-newest-snapshot <text>] - Newest Snapshot
[-newest-snapshot-timestamp <MM/DD HH:MM:SS>] - Newest Snapshot Timestamp
[-exported-snapshot <text>] - Exported Snapshot
[-exported-snapshot-timestamp <MM/DD HH:MM:SS>] - Exported Snapshot Timestamp
[-healthy {true|false}] - Healthy
[-relationship-id <UUID>] - Relationship ID
[-current-operation-id <UUID>] - Current Operation ID
[-current-transfer-type {initialize|update|resync|restore|check|file_restore}] - Transfer Type
[-current-transfer-error <text>] - Transfer Error
[-last-transfer-type {initialize|update|resync|restore|check|file_restore}] - Last Transfer Type
[-last-transfer-error <text>] - Last Transfer Error
[-last-transfer-size {<integer>[KB|MB|GB|TB|PB]}] - Last Transfer Size
[-last-transfer-network-compression-ratio <text>] - Last Transfer Network Compression Ratio
[-last-transfer-duration <[[<hours>:]<minutes>:]<seconds>>] - Last Transfer Duration
[-last-transfer-from <text>] - Last Transfer From
[-last-transfer-end-timestamp <MM/DD HH:MM:SS>] - Last Transfer End Timestamp
[-unhealthy-reason <text>] - Unhealthy Reason
[-progress-last-updated <MM/DD HH:MM:SS>] - Progress Last Updated
[-relationship-capability <text>] - Relationship Capability
[-lag-time <[[<hours>:]<minutes>:]<seconds>>] - Lag Time
[-current-transfer-priority {low|normal}] - Current Transfer Priority
[-is-smtape-op {true|false}] - SMTape Operation
[-is-constituent {true|false}] - Constituent Relationship
[-destination-volume-node <nodename>] - Destination Volume Node Name
[-update-successful-count <integer>] - Number of Successful Updates
[-update-failed-count <integer>] - Number of Failed Updates
[-resync-successful-count <integer>] - Number of Successful Resyncs
[-resync-failed-count <integer>] - Number of Failed Resyncs
[-break-successful-count <integer>] - Number of Successful Breaks
[-break-failed-count <integer>] - Number of Failed Breaks
[-total-transfer-bytes <integer>] - Total Transfer Bytes
[-total-transfer-time-secs <integer>] - Total Transfer Time in Seconds
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
----------- ---- ------------ ------- -------------- --------- ------- --------
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 -
4 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: -
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: -
Constituent Relationship: false
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
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: -
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: -
Constituent Relationship: false
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: -
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: -
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: -
Constituent Relationship: false
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: -
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 snapmirror show command will display values only for the following fields for relationships with "Relationship Capability" of "Pre 8.2", when run on the source cluster of a cross-cluster relationship: source-path, source-cluster, source-vserver, source-volume, destination-path, destination-cluster, destination-vserver, destination-volume, type, status, state, is-constituent, relationship-capability. You must issue the snapmirror show command on the destination cluster to have complete information about SnapMirror relationships.
For SnapMirror relationships between Infinite Volumes, the Total Progress, Snapshot Progress, Destination Volume Node, and Snapshot Checkpoint fields will not display values in the snapmirror show output.
If the SnapMirror relationship is between Infinite Volumes, and the Source Path field's value is SRC_VOLUME_UNRESOLVED, or the Destination Path field's value is DST_VOLUME_UNRESOLVED, check the intercluster connectivity for that relationship.
| Index | Top - Up | Data ONTAP 8.3 |
Copyright © 1994-2015 NetApp, Inc. Legal Information
