ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • volume rebalance file-move modify

    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

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

    -volume <volume name> - Volume Name

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

    -path <text> - Path

    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

    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

    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

    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

    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
    Top of Page