Skip to main content

volume clone split estimate

Contributors
Suggest changes

Estimates the space required by the containing-aggregate to split the FlexClone volume

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

Description

The volume clone split estimate command displays an estimate of the free disk space required in the aggregate to split the indicated clone volume from its underlying parent volume. The value reported might differ from the space actually required to perform the split, especially if the clone volume is changing when the split is being performed. This command is only supported for flexible volumes.

Parameters

[-vserver <vserver name>] - Vserver Name

This specifies the estimates for free disk space required for splitting FlexClone volumes residing on this Vserver. If the -flexclone option is also specified, then the command displays the free disk space estimate only for the specified FlexClone volume residing on the specified Vserver.

[-flexclone <volume name>] - FlexClone Volume

This specifies the free disk space estimate for splitting this FlexClone volume.

[-type {RW|DP}] - FlexClone Type

This parameter specifies the type of FlexClone volume. A read-only FlexClone volume is created if you specify the type as DP; otherwise a read-write FlexClone volume is created.

[-parent-vserver <vserver name>] - FlexClone Parent Vserver

This specifies the free disk space estimates for splitting the FlexClone volumes that are clones in the specified parent Vserver.

[-b, -parent-volume <volume name>] - FlexClone Parent Volume

This specifies the free disk space estimates for splitting the FlexClone volumes cloned off this parent volume.

[-parent-snapshot <snapshot name>] - FlexClone Parent Snapshot

This specifies the free disk space estimates for splitting the FlexClone volumes cloned off this parent snapshot.

[-state {online|restricted|offline|force-online|force-offline|mixed}] - FlexClone Volume State

This specifies the free disk space estimates for splitting the FlexClone volumes with the specified state.

[-junction-path <junction path>] - Junction Path

This specifies the free disk space estimates for splitting the FlexClone volumes mounted at this junction path.

[-junction-active {true|false}] - Junction Active

If this specified, the command displays the free disk space estimate for splitting the FlexClone volumes with the specified junction path status.

[-s, -space-guarantee {none|volume}] - Space Guarantee Style

This specifies the free disk space estimates for splitting the FlexClone volumes with the specified type of space guarantee.

[-space-guarantee-enabled {true|false}] - Space Guarantee In Effect

This specifies the free disk space estimates for splitting the FlexClone volumes with the specified state of space guarantee.

[-aggregate <aggregate name>] - FlexClone Aggregate

This specifies the free disk space estimates for splitting the FlexClone volumes residing on the specified aggregate.

[-dsid <integer>] - FlexClone Data Set ID

This specifies the free disk space estimates for splitting the FlexClone volume with the specified DSID (data set ID).

[-msid <integer>] - FlexClone Master Data Set ID

This specifies the free disk space estimates for splitting the FlexClone volumes with the specified MSID (master data set ID).

[-size {<integer>[KB|MB|GB|TB|PB]}] - FlexClone Size

This specifies the free disk space estimates for splitting FlexClone volumes with the specified size.

[-used {<integer>[KB|MB|GB|TB|PB]}] - Used Size

This specifies the free disk space estimates for splitting the FlexClone volumes with the specified amount of used disk space.

[-split-estimate {<integer>[KB|MB|GB|TB|PB]}] - Split Estimate

This specifies the free disk space estimates for splitting the FlexClone volumes which match with the specified free disk space estimate for splitting.

[-blocks-scanned <integer>] - Blocks Scanned

This specifies the free disk space estimates for splitting the FlexClone volumes for which the specified number of blocks have been scanned.

[-blocks-updated <integer>] - Blocks Updated

This specifies the free disk space estimates for splitting the FlexClone volumes for which the specified number of blocks have been updated.

[-comment <text>] - Comment

This specifies the free disk space estimates for splitting the FlexClone volumes that have the specified value for the comment field.

[-qos-policy-group <text>] - QoS Policy Group Name

This parameter optionally specifies which QoS policy group to apply to the FlexClone volume. The policy group defines measurable service level objectives (SLOs) that apply to the storage objects with which the policy group is associated. If you do not assign a policy group to the FlexClone volume, the system does not monitor and control the traffic to the volume.

[-qos-adaptive-policy-group <text>] - QoS Adaptive Policy Group Name

This optionally specifies which QoS adaptive policy group to apply to the volume. This policy group defines measurable service level objectives (SLOs) and Service Level greeements (SLAs) that adjust based on the volume allocated space or used space. This parameter is not supported on FlexGroups.

[-caching-policy <text>] - Caching Policy Name

This specifies the free disk space estimates for splitting the FlexClone volumes that are clones with the specified caching policy.

[-parent-vol-type <volAccessType>] - Parent volume type (privilege: advanced)

This specifies the free disk space estimates for splitting the FlexClone volumes that are clones of the parent volumes with the specified type.

[-flexclone-used-percent <percent>] - FlexClone Used Percentage

This specifies the free disk space estimates for splitting the FlexClone volumes that are clones with the specified percentage of used space.

[-vserver-dr-protection {protected|unprotected}] - Vserver DR Protection

This specifies the free disk space estimates for splitting the FlexClone volumes that are clones with the specified Vserver SnapMirror protection.

[-block-percentage-complete <integer>] - Percentage Complete

This specifies the free disk space estimates for splitting the FlexClone volumes for which the specified percentage of Block processing has been completed.

[-uid <integer>] - Volume-Level UID

This specifies the free disk space estimates for splitting the FlexClone volumes that are clones with the specified volume-level UID.

[-gid <integer>] - Volume-Level GID

This specifies the free disk space estimates for splitting the FlexClone volumes that are clones with the specified volume-level GID.

[-flexgroup-uuid <UUID>] - UUID of the FlexGroup

If this parameter is specified, the command displays information only about the FlexGroup volume or FlexGroup volume constituents that have the specified FlexGroup volume UUID. This parameter applies to FlexGroup volumes and FlexGroup volume constituents only.

[-flexgroup-msid <integer>] - FlexGroup Master Data Set ID

If this parameter is specified, the command displays information only about the FlexGroup volume or FlexGroup volume constituents that have the specified FlexGroup volume master data-set ID. This parameter applies to FlexGroup volumes and FlexGroup volume constituents only.

[-flexgroup-index <integer>] - FlexGroup Index

If this parameter is specified, the command displays information only about the FlexGroup volume constituents that have the specified FlexGroup volume index. This parameter applies to FlexGroup volume constituents only.

[-max-constituent-size {<integer>[KB|MB|GB|TB|PB]}] - Maximum size of a FlexGroup Constituent

If this parameter is specified, the command displays information only about the FlexGroup volume or FlexGroup volumes that have the specified maximum constituent size. This parameter applies to FlexGroup volumes only.

[-constituent-role <Constituent Roles>] - Constituent Volume Role

If this parameter is specified, the command displays information only about the constituent volume or volumes that are of the specified role. This parameter applies to FlexGroup volumes only.

[-is-flexgroup-constituent-active {true|false}] - Is Active FlexGroup Constituent

If this parameter is specified, the command displays information only about the volume or volumes that are either active constituent of the FlexGroup or not, depending on the value provided.

[-is-constituent {true|false}] - Is Constituent Volume

If this parameter is specified, the command displays information only about volumes that either are or are not constituents of a FlexGroup, depending on the value provided.

[-is-flexgroup {true|false}] - Is Volume a FlexGroup

If this parameter is specified, the command displays information only about the volume or volumes that are either FlexGroups or not, depending on the value provided.

[-volume-style-extended {flexvol|flexgroup|flexgroup-constituent}] - Extended Volume Style

If this parameter is specified, the command displays information only about the volumes that are configured with the specified extended style. Possible values are flexvol for FlexVol volumes, flexgroup for FlexGroups and flexgroup-constituent for FlexGroup constituents.

[-snaplock-type {non-snaplock|compliance|enterprise}] - SnapLock Type

If this parameter is specified, the command displays information only about the volumes that are configured with the specified SnapLock type. Possible values are compliance for SnapLock Compliance volumes, enterprise for SnapLock Enterprise volumes and non-snaplock for non-SnapLock volumes.

Examples

The following example displays the FlexClone split free disk space estimates for the FlexClone volumes residing on Vserver vs0 .

cluster1::> volume clone split estimate -vserver vs0
  (volume clone split estimate)
                             Split
Vserver   FlexClone       Estimate
--------- ------------- ----------
vs0       fc_vol_1         851.5MB
          fc_vol_3           0.00B
          flex_clone1      350.3MB
          fv_2             47.00MB
          tv9                0.00B
5 entries were displayed.