Skip to main content

volume rebalance modify

Contributors
Suggest changes

Modify the configuration for volume capacity rebalancing operations.

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

Description

The volume rebalance modify command modifies the configuration for volume capacity rebalancing operations on a FlexGroup volume in the specified Vserver. When a new capacity rebalancing operation is started on a FlexGroup volume, it will use the current configuration values. Once the operation is started, any changes to the configuration will not affect the currently running capacity rebalancing operation. Only future capacity rebalancing operations will use the new configuration values.

The volume rebalance modify command is only supported on FlexGroup volumes.

Parameters

-vserver <vserver name> - Vserver Name

Identifies the Vserver that contains the FlexGroup volume whose capacity rebalancing configuration will be modified.

-volume <volume name> - Volume Name

Identifies the FlexGroup volume whose capacity rebalancing configuration will be modified.

[-max-runtime <time_interval>] - Maximum Runtime

Specifies the maximum time a capacity rebalancing operation will run for.

[-max-threshold <percent>] - Maximum Imbalance Threshold per Constituent

Specifies the maximum imbalance percentage for constituents. When a constituent's imbalance percentage is larger than this value, files will be moved from the constituent. The default value is 20%.

[-min-threshold <percent>] - Minimum Imbalance Threshold per Constituent

Specifies the minimum imbalance percentage for constituents. When a constituent's imbalance percentage is smaller than this value, files will not be moved from the constituent. The default value is 5%.

[-max-file-moves <integer>] - Maximum Concurrent File Moves per Constituent

Specifies the maximum number of concurrent file moves in a volume capacity rebalancing operation on a constituent of the FlexGroup volume. The default value is 25.

[-min-file-size {<integer>[KB|MB|GB|TB|PB]}] - Minimum File Size

Specifies the minimum file size to consider for a volume capacity rebalancing operation. The value must be a multiple of 4KB. The default value is 100MB, and the minimum configurable value is 20MB. Setting the minimum file size to less than the default value leads to more files being moved. Moved files use granular data, which might impact read/write I/O performance.

[-exclude-snapshots {true|false}] - Exclude Files Stuck in Snapshot Copies

Specifies whether files stuck in snapshots should be excluded in a volume capacity rebalancing operation. The default value is true.

[-start-time <Date>] - Scheduled start time

Specifies the scheduled start time of the volume capacity rebalancing operation. The value must be a time later than 'now'.

Examples

In this example, the volume capacity rebalancing configuration is modified for the FlexGroup volume "fg1" in vserver "vs0" with the maximum threshold being 30%, the minimum threshold being 10%, the maximum file moves being 35, and the minimum file size being 200MB.

cluster::volume rebalance*> modify -vserver vs0 -volume fg1 -max-threshold 30 -min-threshold 10 -max-file-moves 35 -min-file-size 200MB

In this example, a previously scheduled volume capacity rebalancing is rescheduled for a different time.

cluster::volume rebalance*> modify -vserver vs0 -volume fg1 -start-time 12/30/2022 22:59:59