Skip to main content

storage pool show

Contributors
Suggest changes
PDFs

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 .

[-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 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: -