Skip to main content
SANtricity commands

Set thin volume attributes

Contributors netapp-driley

The set volume command defines the properties for a thin volume.

Supported Arrays

This command applies to any individual storage array, including the E4000, E2700, E5600, E2800, E5700, EF600 and EF300 arrays, as long as all SMcli packages are installed.

Roles

To execute this command on an E4000, E2800, E5700, EF600, or EF300 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 [volumeName] |
volumes [volumeName1 ... volumeNameN] | volume <"wwID">)
[newCapacity=capacityValue]
[repositoryMaxCapacity=capacityValue]
[repositoryExpansionPolicy=(automatic|manual)]
[warningThresholdPercent=warningThresholdPercentValue]
[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:

  • Enclose all of the names in square brackets ([ ]).

  • Separate each of the names with a space.

If the volume names have special characters or consist only of numbers, enter the names using these rules:

  • Enclose all of the names in square brackets ([ ]).

  • Enclose each of the names in double quotation marks (" ").

  • Separate each of the names with a space.

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

repositoryMaxCapacity*

This parameter sets the maximum capacity of the repository volume. The value must not be smaller than 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 repositoryMaxCapacity works with repositoryExpansionPolicy=automatic.

repositoryExpansionPolic*

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 addRepositoryCapacity works with repositoryExpansionPolicy=manual.

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

256 TB

Minimum physical capacity

4 GB

Maximum physical capacity

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

Minimum firmware level

7.83