Skip to main content

Dell PowerVault ME4 Series Storage System CLI Guide

PDF

volumes

This basetype is used by show volumes and show volume-groups.

Table 1. volumes properties
Name	Type	Description
durable-id	string	Volume ID in the format V `#` , where `#` starts at 1 and increments for each new volume to uniquely identify it. The value is generated from available data in the current CLI session and may change after a Management Controller restart.
url	string	Volume URL.
virtual-disk-name	string	The name of the disk group or pool that contains the volume.
storage-pool-name	string	The name of the disk group or pool that contains the volume.
storage-pools-url	string	Pool URL.
volume-name	string	Volume name.
size	string	Volume capacity, formatted to use the current base, precision, and units.
size-numeric	uint64	Unformatted size value in blocks.
total-size	string	The total size of the volume.
total-size-numeric	uint64	Unformatted total-size value in blocks.
allocated-size	string	The amount of space currently allocated to a virtual volume, or the total size of a linear volume.
allocated-size-numeric	uint64	Unformatted allocated-size value in blocks.
storage-type	string	Linear: The volume is in a linear pool. Virtual: The volume is in a virtual pool.
storage-type-numeric	uint32	Numeric equivalents for storage-type values. 0: Linear 1: Virtual
preferred-owner	string	Controller that owns the volume during normal operation. A: Controller A. B: Controller B.
preferred-owner-numeric	uint32	Numeric equivalents for preferred-owner values. 0: B 1: A
owner	string	Either the preferred owner during normal operation or the partner controller when the preferred owner is offline. A: Controller A. B: Controller B.
owner-numeric	uint32	Numeric equivalents for owner values. 0: B 1: A
serial-number	string	Volume serial number.
write-policy	string	write-back: Write-back caching does not wait for data to be completely written to disk before signaling the host that the write is complete. This is the preferred setting for a fault-tolerant environment because it improves the performance of write operations and throughput. write-through: Write-through caching significantly impacts performance by waiting for data to be completely written to disk before signaling the host that the write is complete. Use this setting only when operating in an environment with low or no fault tolerance.
write-policy- numeric	uint32	Numeric equivalents for write-policy values. 0: write-through 1: write-back
cache-optimization	string	standard: This controller cache mode of operation is optimized for sequential and random I/O and is the optimization of choice for most workloads. In this mode, the cache is kept coherent with the partner controller. This mode gives you high performance and high redundancy. no-mirror: In this mode of operation, the controller cache performs the same as the standard mode with the exception that the cache metadata is not mirrored to the partner. While this improves the response time of write I/O, it comes at the cost of redundancy. If this option is used, the user can expect higher write performance but is exposed to data loss if a controller fails.
cache-optimization-numeric	uint32	Numeric equivalents for cache-optimization values. 0: standard 2: no-mirror
read-ahead-size	string	The read-ahead cache setting of the volume. Disabled: Read-ahead is disabled. Adaptive: Adaptive read-ahead is enabled, which allows the controller to dynamically calculate the optimum read-ahead size for the current workload. Stripe: Read-ahead is set to one stripe. The controllers treat NRAID and RAID-1 disk groups internally as if they have a stripe size of 512 KB, even though they are not striped. 512 KB , 1 MB , 2 MB , 4 MB , 8 MB , 16 MB , or 32 MB: Size selected by a user.
read-ahead-size-numeric	uint32	Numeric equivalents for read-ahead-size values. -2: Stripe -1: Adaptive 0: Disabled 524288: 512 KB 1048576: 1 MB 2097152: 2 MB 4194304: 4 MB 8388608: 8 MB 16777216: 16 MB 33554432: 32 MB 2147483648: Maximum
volume-type	string	base: Base volume standard: Standard volume. snapshot: Snapshot volume.
volume-type-numeric	uint32	Numeric equivalents for volume-type values. 0: standard 3: snapshot 15: base
volume-class	string	• standard: Standard volume.
volume-class-numeric	uint32	Numeric equivalents for volume-class values. 0: standard
tier-affinity	string	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 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
tier-affinity-numeric	uint32	Numeric equivalents for tier-affinity values. 0: No Affinity 1: Archive 2: Performance
snapshot	string	Shows whether the volume is a snapshot.
snapshot-retention-priority	string	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. low: Snapshots may be deleted. Snapshots that are mapped or are not leaves of a volume's snapshot tree are not eligible for automatic deletion.
snapshot-retention-priority-numeric	uint32	Numeric equivalents for retention-priority values. 0: never-delete 1: high 2: medium 3: low
volume-qualifier	string	N/A: Not applicable.
raidtype	string	The RAID level of the disk group. NRAID RAID0 RAID1 RAID3 RAID5 RAID6 RAID10 RAID50 ADAPT
raidtype-numeric	uint32	Numeric equivalents for raidtype values. 0: RAID0 1: RAID1 2: ADAPT 3: RAID3 5: RAID5 6: NRAID 8: RAID50 10: RAID10 11: RAID6
cs-replication-role	string	Copy Source: The volume is the source for a volume copy operation. Copy Destination : The volume is the destination for a volume copy operation. Primary: The volume is the primary volume in a replication set. Secondary: The volume is the secondary volume in a replication set. (blank): Not applicable.
cs-copy-dest	string	Off: Not applicable. On: The volume is the destination for a volume copy operation.
cs-copy-dest-numeric	uint32	Numeric equivalents for cs-copy-dest values. 0: Off 1: On
cs-copy-src	string	Off: Not applicable. On: The volume is the source for a volume copy operation.
cs-copy-src-numeric	uint32	Numeric equivalents for cs-copy-src values. 0: Off 1: On
cs-primary	string	Off: Not applicable. On: The volume is the primary volume in a replication set.
cs-primary-numeric	uint32	Numeric equivalents for cs-primary values. 0: Off 1: On
cs-secondary	string	Off: Not applicable. On: The volume is the secondary volume in a replication set.
cs-secondary-numeric	uint32	Numeric equivalents for cs-secondary values. 0: Off 1: On
health	string	Numeric equivalents for health values. OK Degraded Fault Unknown N/A
health-numeric	uint32	Numeric equivalents for health values. 0: OK 1: Degraded 2: Fault 3: Unknown 4: N/A
health-reason	string	If Health is not OK, the reason for the health state.
health-recommendation	string	If Health is not OK, the recommended actions to take to resolve the health issue.
volume-group	string	If the volume is in a volume group, the name of the group. Otherwise, UNGROUPEDVOLUMES .
group-key	string	If the volume is in a volume group, the durable ID of the volume group. Otherwise, VGU .