Skip to main content

volume rebalance file-move modify

Contributors
Suggest changes

Modify a file-move operation

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

Description

The volume rebalance file-move modify command modifies certain attributes of a file-move operation that is currently in progress. Specifically, the maximum throughput allowed on a particular file-move operation can be modified, and the data transfer of a file-move operation can be paused or resumed.

The volume rebalance file-move modify 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. This parameter can be specified with the -destination-constituent parameter to identify a particular file-move operation within a 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. This parameter can be specified with the -path parameter to identify a particular file-move operation within a FlexGroup volume.

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

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. This parameter can be specified in addition to the -path and -destination-constituent parameters to identify a particular file-move operation if there are multiple ongoing operations involving the same path and destination constituent.

[-max-throughput {<integer>[KB|MB|GB|TB|PB]}] - Maximum Scanner Speed (privilege: advanced)

If specified, this parameter will modify the rate limit for the data transfer in bytes per second. A non-zero value less than 1 MB/s will be set to 1 MB/s. A non-zero value greater than 1 MB/s will be truncated to the nearest integral megabyte value. A value of "0" specifies that no range will be set for the data transfer. This value does not represent a throughput the system will guarantee, but a limit that cannot be exceeded.

[-scanner-paused {true|false}] - Scanner Paused (privilege: advanced)

If specified, the data transfer of the file-move operation will be paused or resumed. Using a value of false will pause the data transfer while using a value of true will resume the data transfer.

Examples

The following example modifies the maximum throughput of the ongoing file-move operation for the file "/system/build/image.tgz" within the FlexGroup volume "bld_volume". -path and -destination-constituent are used to identify the particular file-move operation:

cluster1::*> volume rebalance file-move modify -vserver vs0 -volume bld_volume -path /system/build/image.tgz -destination-constituent bld_volume__0005 -max-throughput 2MB

The following example pauses the data transfer of the ongoing file-move operation for the file "/system/build/image.tgz" within the FlexGroup volume "bld_volume". This stops any further data from being transferred from the source volume to the destination volume:

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

The following example resumes the data transfer of a paused file-move operation for the file "/system/build/image.tgz" within the FlexGroup volume "bld_volume". -path and -destination-constituent are used to identify the particular file-move operation:

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