volume rebalance start

Contributors

Start a volume capacity rebalancing operation on a FlexGroup volume

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

Description

The volume rebalance start command starts a volume capacity rebalancing operation on a FlexGroup volume in the specified Vserver. Only one volume capacity rebalancing operation is supported per FlexGroup volume at a time. Running capacity rebalancing operations on multiple FlexGroup volumes at the same time is supported.

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

Parameters

-vserver <vserver name> - Vserver Name

Identifies the Vserver that contains the FlexGroup volume whose capacity will be rebalanced.

-volume <volume name> - Volume Name

Identifies the FlexGroup volume whose capacity will be rebalanced.

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

Specifies the maximum time a capacity rebalancing operation will run for. The default value is 6 hours.

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

[-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, a volume capacity rebalancing operation is started for the FlexGroup volume "fg1" in vserver "vs0" with the maximum run time being 72000 seconds or 20 hours.

cluster::volume rebalance rebalance*> start -vserver vs0 -volume fg1 -max-runtime 72000