Dell PowerVault ME4 Series Storage System CLI Guide

PDF

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. medium: Snapshots may be deleted after all eligible low-priority snapshots have been deleted. This is the default. low: Snapshots may be deleted. [tier-affinity no-affinity\|archive\|performance] Optional. For virtual storage, this specifies how to tune the tier-migration algorithm for the volume. The tier-affinity setting affects all members of a snapshot tree. no-affinity: This setting uses the highest available performing tiers first and only uses the Archive tier when space is exhausted in the other tiers. Volume data will swap into higher performing tiers based on frequency of access and tier space availability. This is the default. archive: This setting prioritizes the volume data to the least performing tier available. Volume data can move to higher performing tiers based on frequency of access and available space in the tiers. performance: This setting prioritizes volume data to the higher performing tiers. If no space is available, lower performing tier space is used. Performance affinity volume data will swap into higher tiers based upon frequency of access or when space is made available. `volume` The name or serial number of the volume to change. A name that includes a space must be enclosed in double quotes.
Examples	Rename volume Vol1 to Vol2. # set volume name Vol2 Vol1 Set identifying information for Vol3. # set volume identifying-information "Project X data" Vol3 Set volume OldFiles to have affinity for the Archive tier. # set volume tier-affinity archive OldFiles Change the snapshot retention priority for Vol1 to low. # set volume snapshot-retention-priority low Vol1
See also	show maps show volumes