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

snapmirror show-history

Contributors
Suggest changes

Displays history of SnapMirror operations.

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

Description

The snapmirror show-history command displays the history of SnapMirror operations. This command is not supported for relationships with non-Data ONTAP endpoints.

By default, the command displays the following information:

  • Destination Path

  • Source Path

  • Operation

  • Start Time

  • End Time

  • Result

The snapmirror show-history command displays - in reverse chronological order - the history of completed SnapMirror operations whose destination endpoints are in the current Vserver for Vserver administrators, or the current cluster for cluster administrators. This command does not return information on the following operations and relationships:

  • Operations that happened prior to installing Data ONTAP 8.3.

  • Relationships with the "Relationship Capability" field, as shown in the output of the SnapMirror show command, set to "Pre 8.2" .

  • Operations on FlexGroup relationships that happened prior to installing Data ONTAP 9.5.

  • Operations on FlexGroup constituent relationships.

The -instance parameter displays the following detailed information:

             Destination Path: Path of the destination endpoint.
                  Source Path: Path of the source endpoint.
              Relationship ID: The unique identifier of the relationship.
                               This parameter is not supported for
                               Vserver SnapMirror relationships.
      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.
                    Operation: Type of the operation.
                               Can be one of the following:
                               - create
                               - modify
                               - quiesce
                               - resume
                               - delete
                               - initialize
                               - manual update
                               - scheduled update
                               - break
                               - resync
                               - abort
                               - restore
                 Operation ID: The unique identifier of the operation.
                   Start Time: Timestamp of the start of the operation.
                     End Time: Timestamp of the end of the operation.
                       Result: Result of the SnapMirror operation.
                               Can be one of the following:
                               - success
                               - failure
                Transfer Size: Total amount of data transferred during the
                               SnapMirror operation.
       Additional Information: A message describing the cause of the
                               failure or additional information about a
                               successful operation, such as if a checkpoint
                               was cleared as part of an abort operation.

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.

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

Select SnapMirror operations that have a matching destination path name.

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

Select SnapMirror operations that have a matching destination Vserver name.

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

Select SnapMirror operations that have a matching destination volume name.

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

Select SnapMirror operations that have a matching operation ID.

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

Select SnapMirror operations that have a matching source path name.

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

Select SnapMirror operations that have a matching source Vserver name.

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

Select SnapMirror operations that have a matching source volume name.

[-operation-type {create|modify|quiesce|resume|delete|initialize|manual-update|scheduled-update|break|resync|abort|restore}] - Operation Type

Select SnapMirror operations that have a matching operation type. Possible values are:

  • create

  • modify

  • quiesce

  • resume

  • delete

  • initialize

  • manual-update

  • scheduled-update

  • break

  • resync

  • abort

  • restore

[-start-time <MM/DD/YYYY HH:MM:SS>] - Start Time

Select SnapMirror operations that have a matching start time.

[-end-time <MM/DD/YYYY HH:MM:SS>] - End Time

Select SnapMirror operations that have a matching end time.

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

Select SnapMirror operations that have a matching relationship ID.

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

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

  • none

  • vserver

  • flexgroup

[-result {success|failure}] - Result of the Operation

Select SnapMirror operations that have a matching result. Possible values are:

  • success

  • failure

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

Select SnapMirror operations that have a matching transfer size.

[-additional-info <text>] - Additional Information

Select SnapMirror operations that have matching additional information.

[-max-rows-per-relationship <integer>] - Maximum Number of Rows per Relationship

Select a matching number of SnapMirror operations per relationship.

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

Select SnapMirror operations on relationships that are constituents and non-constituents of a group.

Examples

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

cluster2::> snapmirror show-history
Destination Source                Start       End
Path        Path        Operation Time        Time        Result
----------- ----------- --------- ----------- ----------- -------
dvs2:       vs2:        create    8/15/2013 08:22:23
                                              8/15/2013 08:22:25
                                                          success
vs1:vol1    vs1:aggr1   manual-update
                                  8/15/2013 08:22:44
                                              8/15/2013 08:22:44
                                                          failure
vs1:vol1    vs1:aggr1   initialize
                                  8/15/2013 08:22:25
                                              8/15/2013 08:22:26
                                                          success
vs1:vol1    vs1:aggr1   create    8/15/2013 08:22:15
                                              8/15/2013 08:22:16
                                                          success
vs1:vol2    vs1:aggr1   initialize
                                  8/15/2013 08:23:23
                                              8/15/2013 08:23:23
                                                          failure
vs1:vol2    vs1:aggr1   create    8/15/2013 08:23:10
                                              8/15/2013 08:23:10
                                                          success
6 entries were displayed.

The example below displays detailed information for the SnapMirror operation with operation ID dc158715-0583-11e3-89bd-123478563412

cluster2::> snapmirror show-history -operation-id dc158715-0583-11e3-89bd-123478563412
Destination Path: vs1:vol1
                Source Path: vs1:aggr1
            Relationship ID: cb3d30a0-0583-11e3-89bd-123478563412
    Relationship Group Type: none
                  Operation: manual-update
               Operation ID: dc158715-0583-11e3-89bd-123478563412
                 Start Time: 8/15/2013 08:22:44
                   End Time: 8/15/2013 08:22:44
                     Result: failure
              Transfer Size: -
     Additional Information: Volume vs1:vol1 is restricted. Use the command "volume online" to bring the volume online.

The example below displays detailed information for all SnapMirror operations on relationships with the Result of "success" and whose destination endpoints are in the current cluster.

cluster2::> snapmirror show-history -result success -instance
           Destination Path: vs1:vol1
                Source Path: vs1:aggr1
            Relationship ID: cb3d30a0-0583-11e3-89bd-123478563412
    Relationship Group Type: none
                  Operation: initialize
               Operation ID: d03ce1db-0583-11e3-89bd-123478563412
                 Start Time: 8/15/2013 08:22:25
                   End Time: 8/15/2013 08:22:26
                     Result: success
              Transfer Size: 1.09MB
     Additional Information: -
Destination Path: vs1:vol1
                Source Path: vs1:aggr1
            Relationship ID: cb3d30a0-0583-11e3-89bd-123478563412
    Relationship Group Type: none
                  Operation: create
               Operation ID: cb3d305d-0583-11e3-89bd-123478563412
                 Start Time: 8/15/2013 08:22:15
                   End Time: 8/15/2013 08:22:16
                     Result: success
              Transfer Size: -
     Additional Information: -
Destination Path: vs1:vol2
                Source Path: vs1:aggr1
            Relationship ID: eb92c549-0583-11e3-89bd-123478563412
    Relationship Group Type: none
                  Operation: create
               Operation ID: eb92c506-0583-11e3-89bd-123478563412
                 Start Time: 8/15/2013 08:23:10
                   End Time: 8/15/2013 08:23:10
                     Result: success
              Transfer Size: -
     Additional Information: -

3 entries were displayed.

The example below displays summary information for all SnapMirror operations on relationships with max-rows-per-relationship of 1 and whose destination endpoints are in the current cluster.

cluster2::> snapmirror show-history -max-rows-per-relationship 1

Destination Source                Start       End
Path        Path        Operation Time        Time        Result
----------- ----------- --------- ----------- ----------- -------
vs1:vol1    vs1:aggr1   manual-update
                                  8/15/2013 08:22:44
                                              8/15/2013 08:22:44
                                                          failure
vs1:vol2    vs1:aggr1   initialize
                                  8/15/2013 08:23:23
                                              8/15/2013 08:23:23
                                                          failure
2 entries were displayed.