Skip to main content

storage pool show

Display details of storage pools

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The storage pool show command displays information about SSD storage pools in the cluster. By default, the command displays information about all storage pools in the cluster. You can specify parameters to limit the output to a specific set of storage pools.

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-storage-pool <storage pool name>] - Storage Pool Name
Selects the storage pools that match this parameter value.
[-storage-pool-uuid <UUID>] - UUID of Storage Pool
Selects the storage pools that match this parameter value.
[-nodes {<nodename>|local}, ...] - Nodes Sharing the Storage Pool
Selects the storage pools that match this parameter value.

In an HA pair, either node name may be specified.

[-disk-count <integer>] - Number of Disks in Storage Pool
Selects the storage pools that match this parameter value.
[-allocation-unit-size {<integer>[KB|MB|GB|TB|PB]}] - Allocation Unit Size
Selects the storage pools that match this parameter value.

Allocation units represent the unit of storage allocated to aggregates from this storage pool.

[-allocation-unit-data-size-raid4 {<integer>[KB|MB|GB|TB|PB]}] - Allocation Unit Data Size for RAID4 and RAID-EP
This parameter shows the amount of additional data capacity provided if an allocation unit from this storage pool was added to an aggregate with -raidtype as raid4 or raid_ep.
[-allocation-unit-data-size-raid-dp {<integer>[KB|MB|GB|TB|PB]}] - Allocation Unit Data Size for RAID-DP
This parameter shows the amount of additional data capacity provided if an allocation unit from this storage pool was added to an aggregate with -raidtype as raid_dp.
[-allocation-unit-data-size-raid-tec {<integer>[KB|MB|GB|TB|PB]}] - Allocation Unit Data Size for RAID-TEC
This parameter shows the amount of additional data capacity provided if an allocation unit from this storage pool was added to an aggregate with -raidtype as raid_tec.
[-storage-type <SSD>] - Storage Type
Selects the storage pools that match this parameter value.

Only the SSD type is supported for this version of Data ONTAP.

[-pool-usable-size {<integer>[KB|MB|GB|TB|PB]}] - Storage Pool Usable Size
Selects the storage pools that match this parameter value.

The pool-usable-size is the sum of the capacities of the allocation units that are assigned to nodes but not yet provisioned. The amount of pool-usable-size that is contributed to the cache or usable capacity of an aggregate depends upon the RAID type used when provisioning the allocation units.

[-pool-total-size {<integer>[KB|MB|GB|TB|PB]}] - Storage Pool Total Size
Selects the storage pools that match this parameter value.

The pool-total-size is the sum of the capacities of allocation units belonging to this storage pool.

[-is-healthy {true|false}] - Is Pool Healthy?
Selects the storage pools that match this parameter value.

For storage pools with is-healthy false, the unhealthy-reason parameter provides more information.

is-healthy must be true to provision allocation units from a storage pool into an aggregate.

[-pool-state <State of the Storage Pool>] - State of the Storage Pool
Selects the storage pools that match this parameter value. Possible states are:
  • normal - the storage pool is operating normally.
  • degraded - the storage pool has one or more failed disks.
  • creating - the storage pool is being created.
  • deleting - the storage pool is being deleted.
  • reassigning - allocation units are being reassigned from one node to another.
  • growing - allocation units in the storage pool are expanding due to the addition of new capacity into the storage pool.
[-unhealthy-reason <text>] - Reason for Storage Pool Being Unhealthy
Selects the storage pools that match this parameter value.

The message provided gives additional details about why the storage pool is unhealthy.

[-current-operation-job-id <integer>] - Job ID of the Currently Running Operation
Selects the storage pools that match this parameter value.

Long-running operations associated with storage pools will be managed via jobs. For example, if you provision allocation units from a storage pool into an aggregate and the disks associated with the storage pool need to be zeroed, the operation will be completed via a job.

Examples

Display the storage pools in the cluster.

cluster1::> storage pool show
Storage Pool Type #Disks Nodes Total Size
------------------- ----- ------ ---------------- ----------
LargeSP SSD 10 noda-a,node-b 7.27TB
SmallSP SSD 2 noda-a,node-b 1.45TB
2 entries were displayed.

The following example displays the details of a storage pool named SmallSP. Only one of its four allocation unit has been provisioned, so 75% of its size is available (usable).
cluster1::> storage pool show -storage-pool SmallSP

Storage Pool Name: SmallSP
UUID of Storage Pool: 60f2f1b9-e60f-11e3-a5e7-00a0981899a2
Nodes Sharing the Storage Pool: node-a, node-b
Number of Disks in Storage Pool: 2
Allocation Unit Size: 372.5GB
Storage Type: SSD
Storage Pool Usable Size: 1.09TB
Storage Pool Total Size: 1.45TB
Is Pool Healthy?: true
State of the Storage Pool: normal
Reason for storage pool being unhealthy: -
Job ID of the Currently Running Operation: -

              Is  Allocation Unit Broken?: false