6.37 List Pools

list pools [exclude] [more|all]

Print a list of all NSS pools.

nlvm [-t] list pools [exclude] [more|all]

Command Options

exclude=<nss|shared|nonshared|snap|snapnomount>

Specify types of pools to exclude from the list. The exclude option can be used multiple times to add exclusions.

Exclude Options

nss: NSS pools
shared: Shared pools
nonshared: Pools that are not shared
snap: Snapshot pools that are mounted
snapnomount: Snapshot pools that are not mounted

Example

exclude=snap exclude=snapnomount

-t , --terse

Use this NLVM option to format the output for parsing.

more

Prints more information than appears in the standard output. It can be used with or without the -t NLVM option.

Example

more

all

Prints detailed information about each of the NSS pools. This is the same information that is printed for the nlvm list pool <pool_name> command. It can be used with or without the -t NLVM option.

Example

all

Command Example

nlvm list pools more exclude=shared: Print detailed information about each of the pools, but exclude shared pools.

Response Parameters

You can issue the commands with the --terse NLVM option to output the same information in a format that is more easily parsed.

Standard Output

The command returns the following information about the pools on the server:

Label	Description
Name	Name of the pool
State	State of the pool (Active, Deactive, Maintenance, Unknown, Not Mounted (for snapshot pool))
Type	Denotes the type of pool (NSS64 or NSS32 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

More Output

The command returns the following additional information about the pools on the server:

Label	Description
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
Move	If there is a pool move, its percent complete; or No

All Output

If the all option is used, the command returns the same information about each pool as is displayed for the nlvm list pool <pool_name> command.

Sample Command Response

Sample 1: nlvm list pools

nlvm list pools

 Name                  State   Type   Size Shared IsSnap
 POOL1                Active   NSS32  99.00MB  No     No
 PMOVE                Active   NSS32  99.00MB  No     No
 BIGLONGPOOLNAME      Active   NSS32  99.00MB  No     No
 RRPOOL               Active   NSS64  49.00MB  No     No
 SNAP1                Active   NSS32  99.00MB  No    Yes
 SNAPSHOT1        NotMounted   NSS32  99.00MB  No    Yes
 T1                   Active   NSS32  99.00MB  No     No
 T2                   Active   NSS32  99.00MB  No     No

Sample 2: nlvm list pools more

nlvm list pools more

 Name                 State     Size Shared IsSnap    Used      Free Segs Vols Move
 POOL1              Active   99.00MB  No     No    11.75MB   87.24MB  1    3   No
 PMOVE               Active   99.00MB  No     No    10.78MB   88.21MB  1    0  100%
 BIGLONGPOOLNAME    Active   99.00MB  No     No    10.78MB   88.21MB  1    0   No
 RRPOOL             Active   49.00MB  No     No    10.78MB   38.21MB  1    0   No
 SNAP1              Active   99.00MB  No    Yes    10.96MB   88.03MB  1    2   No
 SNAPSHOT1      NotMounted   99.00MB  No    Yes         NA        NA  1   NA   No
 T1                 Active   99.00MB  No     No    10.78MB   88.21MB  1    0   No
 T2                 Active   99.00MB  No     No    10.78MB   88.21MB  1    0   No

Sample 3: nlvm list pools all

nlvm list pools all

 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

 Name=PMOVE
  State=Active Size=99.00MB Shared=No IsSnap=No
  Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=0
  Move=PMOVE_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

 Name=BIGLONGPOOLNAME
  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

 Name=RRPOOL
  State=Active Size=49.00MB Shared=No IsSnap=No
  Used=10.78MB Free=38.21MB Segs=1 Volumes=0 Snapshots=0 Move=No
  Created: Wed Jun 12 17:30:53 2013
  Pool segments:
   Index     Start        Next     Size  Partition
     1           0      102368   49.98MB rr0p1.2

 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      572KB   88.05MB
   VOL1_SV    Active   Yes      None      600KB   88.05MB

 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 sde7.1

 Name=T1
  State=Active Size=99.00MB Shared=No IsSnap=No
  Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=0 Move=No
  Created: Tue Jun 25 17:33:25 2013
  Pool segments:
   Index     Start        Next     Size  Partition
     1           0      204768   99.98MB sdf1.1

 Name=T2
  State=Active Size=99.00MB Shared=No IsSnap=No
  Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=0 Move=No
  Created: Fri Jun 28 10:25:43 2013
  Pool segments:
   Index     Start        Next     Size  Partition
     1           0      204768   99.98MB sdf3.1

Sample 4: nlvm list pools all --terse

nlvm list pools all --terse

 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
  Index=1 Start=0 Next=204768 Size=99.98MB Part=sdc7.1
  Volume=NSS1 State=Active Mounted=Yes Quota=None Used=1.28MB Free=87.27MB
  Volume=TESTVOL State=Active Mounted=Yes Quota=None Used=564KB Free=87.27MB
  Volume=VOL1 State=Active Mounted=Yes Quota=None Used=600KB Free=87.27MB

 Name=PMOVE State=Active Size=99.00MB Shared=No IsSnap=No Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=0 Move=PMOVE_move Status=Active:Active Complete=100%
  Created=Tue Jun 11 17:18:08 2013
  Index=1 Start=0 Next=204768 Size=99.98MB Part=sdb1.1

 Name=BIGLONGPOOLNAME 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
  Index=1 Start=0 Next=204768 Size=99.98MB Part=sdb1.3

 Name=RRPOOL State=Active Size=49.00MB Shared=No IsSnap=No Used=10.78MB Free=38.21MB Segs=1 Volumes=0 Snapshots=0 Move=No
  Created=Wed Jun 12 17:30:53 2013
  Index=1 Start=0 Next=102368 Size=49.98MB Part=rr0p1.2

 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
  Index=1 Start=0 Next=202752 Size=99.00MB Part=sdi6.1
  Volume=NSS1_SV State=Active Mounted=Yes Quota=None Used=572KB Free=88.05MB
  Volume=VOL1_SV State=Active Mounted=Yes Quota=None Used=600KB Free=88.05MB

 Name=SNAPSHOT1 State=NotMounted Size=99.00MB Shared=No IsSnap=Yes Used=NA Free=NA Segs=1 Volumes=NA Snapshots=0 Move=No
  Index=1 Start=0 Next=204768 Size=99.98MB Part=sde7.1

 Name=T1 State=Active Size=99.00MB Shared=No IsSnap=No Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=0 Move=No
  Created=Tue Jun 25 17:33:25 2013
  Index=1 Start=0 Next=204768 Size=99.98MB Part=sdf1.1

 Name=T2 State=Active Size=99.00MB Shared=No IsSnap=No Used=10.78MB Free=88.21MB Segs=1 Volumes=0 Snapshots=0 Move=No
  Created=Fri Jun 28 10:25:43 2013
  Index=1 Start=0 Next=204768 Size=99.98MB Part=sdf3.1