Skip to main content
A newer release of this product is available.

volume rebalance modify

Contributors
Suggest changes
PDFs

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. 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.

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 2KB.

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