Aborting a SnapMirror transfer

What aborting a transfer does

You can use the snapmirror abort command to abort a volume or qtree copy operation before the source finishes transferring data to the destination. The transfer can be the result of a scheduled update, a manual update, or an initialization. If you abort a copy operation, data transfer stops and SnapMirror is put in a restartable mode. If you abort a transfer that has been aborted before, you cannot restart that transfer again.

If you use the -h option (hard abort) with the snapmirror abort command, you cannot restart the transfer.

How to tell whether you can restart an aborted transfer

To find out whether you can restart an aborted copy operation, check the output of the snapmirror status command. If the status message is "Idle with restart checkpoint (n XB done)," the transfer can be restarted.

Example



Source         Destination       State          Lag        Status

filerA:vol0    filerA:vol1       Broken-off     29:09:58   Idle 
with restart checkpoint (135 MB done)

Note
You can abort only transfers that are displayed by the snapmirror status command.

Aborting a transfer

To abort a SnapMirror data transfer, complete the following step.

Step	Action
1	From either the source or the destination filer, enter the following command: *snapmirror abort [-h] {[dest_filer:]dest_volume* \| [dest_filer:]/vol/volume_name/qtree_name ...}** `-h` specifies a hard abort; the transfer cannot be restarted. SnapMirror stops the transfer and clears the restartable transfer log. This option applies only to the SnapMirror destination. dest_filer is the name of the destination filer. dest_volume is the destination volume. /`vol`/volume_name/qtree_name is the path name of a destination qtree. If no destination filer is specified, the local host's name is used for the filer name. You can enter more than one destination volume. You can obtain the destination filer and volume from the `snapmirror status` output. If no destination volume or qtree is specified, the command returns an error message; it does not abort all transfers. To abort all transfers, use the `snapmirror off` command. If you enter an invalid SnapMirror destination (one that is not shown in the output of the `snapmirror status` command), the command fails and displays an error message.

Step

Action

From either the source or the destination filer, enter the following command:

snapmirror abort [-h] {[dest_filer:]dest_volume | 
[dest_filer:]/vol/volume_name/qtree_name ...}

-h specifies a hard abort; the transfer cannot be restarted. SnapMirror stops the transfer and clears the restartable transfer log. This option applies only to the SnapMirror destination.

dest_filer is the name of the destination filer.

dest_volume is the destination volume.

/vol/volume_name/qtree_name is the path name of a destination qtree.

If no destination filer is specified, the local host's name is used for the filer name. You can enter more than one destination volume.

You can obtain the destination filer and volume from the snapmirror status output.

If no destination volume or qtree is specified, the command returns an error message; it does not abort all transfers. To abort all transfers, use the snapmirror off command.

If you enter an invalid SnapMirror destination (one that is not shown in the output of the snapmirror status command), the command fails and displays an error message.

Example

filerA> snapmirror abort vol1 filerB:vol2 
filerC:/vol3/qtree3

snapmirror abort: Aborting transfer to vol1 filerB:vol2 
filerC:/vol3/qtree3

Result

SnapMirror aborts the transfer to vol1 on filerA, where the command was entered, and aborts the transfer to vol2 on filerB and the transfer to qtree 3 in vol3 on filerC.