Set thin volume attributes
The set volume command defines the properties for a thin volume.
Supported Arrays
This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.
Roles
To execute this command on an storage array, you must have the Storage Admin role.
Context
You can use the parameters to define properties for one or more thin volumes.
Syntax
set (volume [<var id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1111703" className="keyword varname">volumeName</var>] |
volumes [<var id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1111704" className="keyword varname">volumeName1</var> ... <var id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1111705" className="keyword varname">volumeNameN</var>] | volume <"<var id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1111706" className="keyword varname">wwID</var>">)
[newCapacity=<var id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1570840" className="keyword varname">capacityValue</var>]
[repositoryMaxCapacity=<var id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1570841" className="keyword varname">capacityValue</var>]
[repositoryExpansionPolicy=(<span id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1442088" className="keyword option">automatic</span>|<span id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1442089" className="keyword option">manual</span>)]
[warningThresholdPercent=<var id="GUID-290491EE-1F3C-4C8F-B4A3-AF42BB92C2ED__V1440750" className="keyword varname">warningThresholdPercentValue</var>]
[addRepositoryCapacity=capacity-spec][hostReportingPolicy=(standard | thin)]
Parameters
| Parameter | Description |
|---|---|
| volume | The name of the volume for which you want to define properties. Enclose the volume name in square brackets ([ ]). If the volume name has special characters or numbers, you must enclose the volume name in double quotation marks (" ") inside square brackets. |
| volume | The World Wide Identifier (WWID) of the volume for which you want to define properties. Enclose the WWID in double quotation marks (" ") inside angle brackets (< >). |
| volumes | The names of several volumes for which you want to define properties. All of the volumes will have the same properties. Enter the names of the volumes using these rules:
If the volume names have special characters or consist only of numbers, enter the names using these rules:
|
| newCapacity | This parameter increases the virtual capacity of the thin volume. The virtual capacity is the value that the volume will report to a host that is mapped to the volume. Values smaller or equal to the existing capacity will cause an error. Size is defined in units of bytes, KB, MB, GB, or TB. The minimum virtual capacity is 32 MB. The maximum virtual capacity is 63 TB. |
| repositoryMaxCapacity | This parameter sets the maximum capacity of the repository volume. The value must not be smaller that the physical capacity of the repository volume. If the new value results in a reduction in capacity to a level below the warning threshold, the command will produce an error. Note The command |
| repositoryExpansionPolicy | This parameter sets the expansion policy to automatic or manual.When you change the policy from automatic to manual, the maximum capacity value (quota) changes to the physical capacity of the repository volume. |
| warningThresholdPercent | The percentage of thin volume capacity at which you receive a warning alert that the thin volume is nearing full. Use integer values. For example, a value of 70 means 70 percent. Valid values are from 1 to 100. Setting this parameter to 100 disables warning alerts. |
| addRepositoryCapacity | This parameter allocates capacity from the free extent of the disk pool. If insufficient space is available the command fails. Note The command |
| hostReportingPolicy | This parameter changes the way in which the thin volume is reported to the host. Valid values are standard or thin. |
Notes
When you use this command, you can specify one or more of the optional parameters.
The following table lists the capacity limits for a thin volume.
| Type of Capacity | Size |
|---|---|
| Minimum virtual capacity | 32 MB |
| Maximum virtual capacity | 63 TB |
| Minimum physical capacity | 4 GB |
| Maximum physical capacity | 64 TB |
Thin volumes support all of the operations that standard volumes do with the following exceptions:
- You cannot change the segment size of a thin volume.
- You cannot enable the pre-read redundancy check for a thin volume.
- You cannot use a thin volume as the target volume in a volume copy.
- You cannot use a thin volume in a Synchronous Mirroring operation.
If you want to change a thin volume to a standard volume, use the volume copy operation to create a copy of the thin volume. The target of a volume copy is always a standard volume.