snapmirror quiesce
Disable future transfers
Availability: This command is available to cluster and Vserver administrators at the admin privilege level.
Description
The snapmirror quiesce
command disables future transfers for a SnapMirror relationship. If there is no transfer in progress, the relationship becomes "Quiesced"
.
If there is a transfer in progress, it is not affected, and the relationship becomes "Quiescing"
until the transfer completes. If the current transfer aborts, it will be treated like a future transfer and will not restart.
If applied to a load-sharing (LS) SnapMirror relationship, all the relationships in the load-sharing set will be quiesced.
If applied to a relationship with a policy of type strict-sync-mirror
or sync-mirror
, any ongoing operation is aborted, and if the relationship is InSync, synchronous replication is stopped. If the replication policy type is "strict-sync-mirror", then the primary client I/O disruption is not enforced. A new common snapshot is created if the relationship is InSync, unless a recent one exists. The relationship becomes "Quiescing"
until these operations complete.
When a SnapMirror relationship is quiesced, it remains quiesced across reboots and fail-overs.
This command is supported for SnapMirror relationships with the field "Relationship Capability"
showing as either "8.2 and above"
or "Pre 8.2"
in the output of the snapmirror show command.
This command is not supported for SnapMirror active sync relationships with policy of type automated-failover
or automated-failover-duplex
.
The snapmirror quiesce
command must be used from the destination Vserver or cluster.
The relationship must exist on the destination Vserver or cluster. When issuing snapmirror quiesce
, you must specify the destination endpoint. The specification of the source endpoint of the relationship is optional.
Parameters
- {
[-S, -source-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[app-cgname]>}]
- Source Path - |
[-source-cluster <Cluster name>]
- Source Cluster -
Specifies the source cluster of the SnapMirror relationship. If this parameter is specified, the
-source-vserver
and-source-volume
parameters must also be specified. This parameter is only applicable for relationships with"Relationship Capability"
of"Pre 8.2"
. This parameter cannot be specified when operating in a Vserver context on relationships with"Relationship Capability"
of"8.2 and above"
. [-source-vserver <vserver name>]
- Source Vserver-
Specifies the source Vserver of the SnapMirror relationship. For relationships with volumes as endpoints, if this parameter is specified, parameters
-source-volume
and for relationships with"Relationship Capability"
of"Pre 8.2"
,-source-cluster
must also be specified. This parameter is not supported for relationships with non-ONTAP source endpoints. [-source-volume <volume name>]
- Source Volume }-
Specifies the source volume of the SnapMirror relationship. If this parameter is specified, parameters
-source-vserver
and for relationships with"Relationship Capability"
of"Pre 8.2"
,-source-cluster
must also be specified. This parameter is not supported for relationships with non-ONTAP source endpoints. - {
-destination-path {<[vserver:][volume]>|<[[cluster:]//vserver/]volume>|<hostip:/lun/name>|<hostip:/share/share-name>|<[vserver:]/cg/[app-cgname]>}
- Destination Path - |
[-destination-cluster <Cluster name>]
- Destination Cluster -
Specifies the destination cluster of the SnapMirror relationship. If this parameter is specified, parameters
-destination-vserver
and-destination-volume
must also be specified. This parameter is only applicable for relationships with"Relationship Capability"
of"Pre 8.2"
. This parameter cannot be specified when operating in a Vserver context on relationships with"Relationship Capability"
of"8.2 and above"
. -destination-vserver <vserver name>
- Destination Vserver-
Specifies the destination Vserver of the SnapMirror relationship. For relationships with volumes as endpoints, if this parameter is specified, parameters
-destination-volume
and for relationships with"Relationship Capability"
of"Pre 8.2"
,-destination-cluster
must also be specified. This parameter is not supported for relationships with non-ONTAP destination endpoints. -destination-volume <volume name>
- Destination Volume }-
Specifies the destination volume of the SnapMirror relationship. If this parameter is specified, parameters
-destination-vserver
and for relationships with"Relationship Capability"
of"Pre 8.2"
,-destination-cluster
must also be specified. This parameter is not supported for relationships with non-ONTAP destination endpoints.
Examples
To quiesce the Application Consistency Group SnapMirror relationship with the destination Application Consistency Group app_cg_dst
in Vserver vs2.example.com
, type the following command:
vs2.example.com::> snapmirror quiesce -destination-path vs2.example.com:/cg/app_cg_dst