6.34 List Pool

list pool <pool_name>

Print detailed information about a specified NSS pool.

nlvm [nlvm_options] list pool  <pool_name>

Command Option

pool_name

Mandatory. Specify the name of the NSS pool.

Example

MYPOOL1

Command Example

nlvm list pool MYPOOL1

Print detailed information about the pool MYPOOL1.

Response Parameters

The command returns the following information about the specified pool:

Label

Description

Name

Name of the pool

State

State of the pool (Active, Deactive, Maintenance, Unknown, Not Mounted (for snapshot pool))

Size

Size of the pool in MB, GB, or TB

Shared

Yes or No; whether the pool’s device is marked as Shareable for Clustering

IsSnap

Yes or No; whether the pool is a snapshot

Used

Used space in the pool in KB, MB, GB, or TB

Free

Free space in the pool in KB, MB, GB, or TB

Segs

Number of segments in the pool

Volumes

Number of volumes in the pool

Snapshots

Number of snapshots, or No

Move

Name of the pool move (if applicable), or No

Status

Status of the pool move (if applicable)

Complete

Percent complete for the pool move (if applicable)

SnapshotNames

Names of the pool snapshots (if applicable)

Created

If the pool is mounted, the date and time the pool was created

The command returns the following information about the pool’s segments:

Label

Description

Index

Index number of the segment

Start

Starting offset in the pool

Next

Next offset in the pool

Size

Size of the segment in MB, GB, or TB

Partition

Partition name for this segment

The command returns the following information about each of the pool’s volumes if the pool is active and it has volumes:

Label

Description

Volume

Volume name

State

Volume state (Active, Deactive)

Mounted

Yes or No; whether the volume is mounted for user access

Quota

Volume quota in MB, GB, or TB, or None (if the volume can grow to the size of the pool)

Used

Used size of the volume in KB, MB, GB, or TB

Free

Free size of the volume in KB, MB, GB, or TB

Sample Command Responses
Sample 1: Pool with 3 Volumes and 1 Snapshot
nlvm list pool POOL1

Name=POOL1
  State=Active Size=99.00MB Shared=No IsSnap=No 
  Used=11.75MB Free=87.24MB Segs=1 Volumes=3 Snapshots=1 Move=No SnapNames=SNAP1
  Created=Wed May 22 16:03:26 2013
  Pool segments:
   Index     Start         Next      Size  Partition
     1           0       204768   99.98MB  sdc7.1
  Volumes on this pool:
   Volume    State Mounted   Quota    Used       Free
   NSS1     Active   Yes      None  1.28MB    87.27MB
   TESTVOL  Active   Yes      None   564KB    87.27MB
   VOL1     Active   Yes      None   600KB    87.27MB
Sample 2: Snapshot Pool for POOL1, Active with 2 of 3 Snap Volumes Mounted
nlvm list pool SNAP1

Name=SNAP1
  State=Active Size=99.00MB Shared=No IsSnap=Yes
  Used=10.96MB Free=88.03MB Segs=1 Volumes=2 Snapshots=0 Move=No
  Created=Wed Jun  5 16:57:21 2013
  Pool segments:
   Index     Start         Next      Size  Partition
     1           0       202752   99.00MB  sdi6.1
  Volumes on this pool:
   Volume    State Mounted   Quota    Used       Free
   NSS1_SV  Active   Yes      None   572MB    88.05MB
   VOL1_SV  Active   Yes      None   600KB    88.05MB
Sample 3: Pool with a No Volumes and 1 Snapshot
nlvm list pool POOL2

Name=POOL2
  State=Active Size=99.00MB Shared=No IsSnap=No
  Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=1 Move=No
  SnapNames=SNAPSHOT1
  Created=Wed May 22 16:03:27 2013
  Pool segments:
   Index     Start         Next      Size  Partition
     1           0       204768   99.98MB  sdb1.3
Sample 4: Snapshot Pool for POOL2, Not Mounted
nlvm list pool SNAPSHOT1

Name=SNAPSHOT1
  State=NotMounted Size=99.00MB Shared=No IsSnap=Yes
  Used=NA Free=NA Segs=1 Volumes=NA Snapshots=0 Move=No
  Pool segments:
   Index     Start         Next      Size  Partition
     1           0       204768   99.98MB  sde1.1
Sample 5: Pool with a Pool Move at 100% Complete but before a Complete Move
nlvm list pool TEST

Name=TEST
  State=Active Size=99.00MB Shared=No IsSnap=No 
  Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=0 
  Move=TEST_move Status=Active:Active Complete=100%
  Created=Tue Jun 11 17:18:08 2013
  Pool segments:
   Index     Start         Next      Size  Partition
     1           0       204768   99.98MB  sdb1.1
  Volumes on this pool:
   Volume    State Mounted   Quota    Used       Free
   VOL2     Active   Yes      None   572MB    88.05MB
   VOL3     Active   Yes      None   600KB    88.05MB
 
Sample 6: Pool Is Deactive
nlvm list pool TEST2

NAME=TEST2
  State=Deactive Size=1019.00MB Shared=No IsSnap=No
  Used=NA Free=NA Segs=2 Volumes=NA Snapshots=O Move=No
  Created: Mon Sep 23 16:33:20 2013
  Pool segments:
   Index     Start         Next      Size  Partition
     1           0      1044416  509.96MB  sdf1.1
     2     1044416      2088832  509.96MB  sde1.1