Skip to main content

volume rebalance start

Contributors
Suggest changes

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. If granular data is not already enabled on the volume, it will automatically be set to basic when this command is run.

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, 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, e.g. 12/31/2022 23:59:59

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

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 starting at 23:59:59 on 12/31/2022.

cluster::volume rebalance*> start -vserver vs0 -volume fg1 -max-runtime 72000 -start-time 12/31/2022 23:59:59