6.42 List Pool

list pool <pool_name>

Print detailed information about a specified NSS pool including its pool type (NSS64 or NSS32).

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))
Type	Type of the pool (NSS64 or NSS32-bit 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 Type=NSS32 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
nl   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 Type=NSS32 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 Type=NSS32 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 Type=NSS32 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 Type=NSS32 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 Type=NSS32 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