Skip to main content
ONTAP commands

snapmirror break

Suggest changes
PDFs

Make SnapMirror destination writable

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

Description

The snapmirror break command breaks a SnapMirror relationship between a source and destination endpoint of a data protection mirror. The destination endpoint can be a Vserver, volume, Application Consistency Group or SolidFire endpoint. When ONTAP breaks the relationship, if the endpoint is a volume, Application Consistency Group or SolidFire endpoint, the destination is made read/write and can diverge from the source volume, client redirection is turned off on the destination, the restart checkpoint is cleared, and the clients can see the latest snapshot. If the endpoint is a Vserver, the subtype of the destination Vserver is changed to default , volumes in the destination Vserver are made read/write and the clients can now access the Vserver namespace for modifications. For SolidFire destination endpoints, the snapmirror break command is only supported if the endpoint is in a SnapMirror relationship. For an Application Consistency Group the item volumes are changed to read/write volumes and can diverge from the corresponding items on the source.

Subsequent manual or scheduled SnapMirror updates to the broken relationship will fail until the SnapMirror relationship is reestablished using the snapmirror resync command.

This command applies to data protection mirrors. For vault relationships, this command is only intended for use when preparing for a ONTAP revert operation (see the -delete-snapshots parameter in advanced privilege level). This command is not intended for use with load-sharing mirrors.

For relationships with a policy of type strict-sync-mirror or sync-mirror , the relationship must be Quiesced before running the snapmirror break command.

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.

The snapmirror break command must be used from the destination Vserver or cluster.

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.

[-f, -force <true>] - Force

If this parameter is specified, the command proceeds without prompting for confirmation.

[-w, -foreground <true>] - Foreground Process

This specifies whether the operation runs as a foreground process. If this parameter is specified, the default setting is true (the operation runs in the foreground). When set to true , the command will not return until the process completes. This parameter is only applicable to relationships with "Relationship Capability" of "Pre 8.2" .

[-delete-snapshots <true>] - Delete Snapshots for Revert (privilege: advanced)

Using this parameter causes break to delete snapshots on a vault destination so that the system can be reverted. Note that the only snapshots that will be deleted are those that were created with the current version of ONTAP. Any snapshots that might be present created with a different version will not be deleted. This parameter is not supported for SnapLock Compliance destinations.

[-s, -restore-destination-to-snapshot <text>] - Restore Destination to Snapshot Copy

This optional parameter specifies the snapshot to which the destination volume is restored after a successful break operation. If the parameter is not specified, the destination is restored to the latest snapshot. This parameter is not supported for Vserver, Application Consistency Group or FlexGroup relationships or SnapLock Compliance destinations.

[-recover <true>] - Recover (privilege: advanced)

When a SnapMirror break operation fails on a FlexGroup or Application Consistency Group relationship, a subset of the destination FlexGroup or Application Consistency Group constituents could have been made writable and subsequently user data could have been written to these constituents. To recover from this failure, you can execute the snapmirror break command again specifying the -recover parameter. All constituents will be restored to the latest snapshot, and any writes to the read-write constituents will be lost. This parameter is applicable only for SnapMirror relationships with FlexGroup and or Application Consistency Group endpoints.

Examples

To stop SnapMirror replication to the destination Application Consistency Group app_cg_dst in Vserver vs2.example.com , type the following command:

vs2.example.com::> snapmirror break -destination-path
       vs2.example.com:/cg/app_cg_dst