Skip to main content

volume rebalance file-move abort

Contributors
Suggest changes

Abort a file-move operation that is in progress

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

Description

The volume rebalance file-move abort command aborts a file-move operation that has been started and is in progress.

A file-move operation goes through different stages as part of the move operation. During the cutover stage of the file-move operation, the actual file is created at the destination FlexGroup constituent, after which the data blocks are transferred. Once the file is created at the destination FlexGroup constituent, the file is visible in the namespace of the FlexGroup volume. If the file-move operation has entered the cutover stage, it cannot be aborted.

The volume rebalance file-move abort command is only supported on FlexGroup volumes. For a given FlexGroup volume, there can be many file-move operations that are currently in progress for different sets of constituents. The parameters for this command provide a way to identify a particular file-move operation within a FlexGroup volume.

Parameters

-vserver <vserver name> - Vserver Name (privilege: advanced)

Identifies the Vserver that contains the FlexGroup volume involved in the file-move operation.

-volume <volume name> - Volume Name (privilege: advanced)

Identifies the FlexGroup volume that is hosting the file being moved in the file-move operation.

-path <text> - Path (privilege: advanced)

Identifies the path to the file being moved within the FlexGroup volume.

-destination-constituent <volume name> - Destination Constituent Volume (privilege: advanced)

Identifies the destination constituent name of the FlexGroup volume where the file is being moved.

[-operation-uuid <UUID>] - Operation UUID (privilege: advanced)

If specified, this parameter identifies the UUID of the file-move operation. Use the volume rebalance file-move show command to obtain the UUID for a file-move operation.

Examples

The following example aborts a file-move operation for the file "/system/build/image.tgz" within the FlexGroup volume "bld_volume":

cluster1::*> volume rebalance file-move abort -vserver vs0 -volume bld_volume -path /system/build/image.tgz -destination-constituent bld_volume__0005

File-move operation cancelled.

The following example aborts the file-move operation in progress for the file "/system/build/image.tgz" within the FlexGroup "bld_volume". The UUID of the file-move operation is also provided:

cluster1::*> volume rebalance file-move abort -vserver vs0 -volume bld_volume -path /system/build/image.tgz -destination-constituent bld_volume__0005 -operation-uuid f8d780b4-32fc-4053-be5e-2f6edc0a652b

File-move operation cancelled.

The following example attempts to abort the file-move operation for the file "/system/build/image.tgz" within the FlexGroup volume "bld_volume". However, the file-move operation could not be aborted as it is past the cutover stage of the operation. A file-move operation can only be aborted if it has not entered the cutover stage:

cluster1::*> volume rebalance file-move abort -vserver vs0 -volume bld_volume -path /system/build/image.tgz -destination-constituent bld_volume__0005

Error: command failed: The file move abort operation failed. Reason: Cannot
       destroy file operation. File move operation has completed the cutover
       phase.