CLI Guide

See also
show vdisks on page 252
set volume
Description Changes parameters for a volume.
CAUTION: Applying new parameters may disrupt access from connected hosts.
For virtual storage, you can set the retention priority for snapshots of the volume. If automatic deletion of
snapshots is enabled, snapshots will be considered for automatic deletion first by priority and then by date, so
the oldest low-priority snapshot will be deleted first. A snapshot is eligible for deletion if all the following are
true:
• The snapshot has a retention priority other than never-delete.
• The snapshot has no child snapshots.
• The snapshot is not mapped to a host.
NOTE: For virtual storage, changing the retention priority for a volume does not change the
retention priority for existing child snapshots.
Minimum role manage
Syntax
set volume
[identifying-information description]
[large-virtual-extents enabled|disabled|on|off]
[name new-name]
[snapshot-retention-priority never-delete|high|medium|low]
[tier-affinity no-affinity|archive|performance]
volume
Parameters
[identifying-information description]
Optional. A description of the volume to help a host-side user identify it. Input rules:
• The value is case sensitive.
• The value can have a maximum of 127 bytes.
• The value can include spaces and printable UTF-8 characters except: < \
• A value that includes a space must be enclosed in double quotes.
[large-virtual-extents enabled|disabled|on|off]
Optional. For a virtual volume, this sets whether the system will try to allocate pages in a sequentially
optimized way to reduce I/O latency and improve performance.
• disabled or off: Optimized page allocation is disabled. This is the default.
• enabled or on: Optimized page allocation is enabled
[name new-name]
Optional. A new name for the volume. Input rules:
• The value is case sensitive.
• The value can have a maximum of 32 bytes.
• The value can include spaces and printable UTF-8 characters except: " , < \
• A value that includes a space must be enclosed in double quotes.
[snapshot-retention-priority never-delete|high|medium|low]
Optional. For virtual storage, this specifies the retention priority for snapshots of the volume.
• never-delete: Snapshots will never be deleted.
• high: Snapshots may be deleted after all eligible medium-priority snapshots have been deleted.
Alphabetical list of commands
157