Use this command to display information about one or more storage
pools. You can also use this command to monitor migration processes for
the storage pool.
Any administrator can issue this command.
Display details for the storage pool named POOL1.
- Storage Pool Name
- The name of the storage pool.
- Storage Pool Type
- The type of storage pool.
- Device Class Name
- The name of the device class assigned to the storage pool.
- Estimated Capacity (MB)
- The estimated capacity of the storage pool, in megabytes.
For DISK devices, this is the capacity of all volumes in the storage pool,
including any volumes that are varied offline.
For sequential access devices, this is an estimate of the total space of
all the sequential access volumes in the storage pool, regardless of their
access mode. If the storage pool has stored data on at least one
scratch volume, the estimated capacity includes the maximum number of scratch
volumes allowed for the pool.
- Pct Util
- An estimate of the utilization of the storage pool, as a
percentage.
For sequential access devices, this is expressed as a percentage of the
number of active bytes on each sequential access volume and the estimated
capacity of all volumes in the storage pool.
For disk devices, this is expressed as a percentage of the estimated
capacity, including cached data and data that resides on any volumes that are
varied offline. The value for Pct Util can be higher than the value for
Pct Migr if you issue this command while a file creation transaction is in
progress. The value for Pct Util is determined by the amount of space
actually allocated (while the transaction is in progress). The value
for Pct Migr represents only the space occupied by committed
files. At the end of the transaction, these values become
synchronized.
The Pct Util value includes cached data on disk volumes. Therefore,
when cache is enabled and migration occurs, the Pct Util value remains the
same because the migrated data remains on the volume as cached data.
The Pct Util value decreases only when the cached data expires or when the
space that cached files occupy needs to be used for noncached files.
- Pct Migr (primary storage pools only)
- An estimate of the percentage of data in the storage pool that can be
migrated. The server uses this value and the high and low migration
thresholds to determine when to start and stop migration.
For disk devices, this value is specified as a percentage of the value for
the estimated capacity, excluding cached data, but including data on any
volumes varied offline.
For sequential access devices, this value is the percentage of the total
number of volumes in the pool that contain at least 1 byte of active
data. The total number of volumes includes the maximum number of
scratch volumes.
The Pct Util value includes cached data on a volume; the Pct Migr
value excludes cached data. Therefore, when cache is enabled and
migration occurs, the Pct Migr value decreases but the Pct Util value remains
the same because the migrated data remains on the volume as cached
data. The Pct Util value decreases only when the cached data expires or
when the space that cached files occupy needs to be used for noncached
files.
- Pct Logical
- The logical occupancy of the storage pool as a percentage of the total
occupancy. Logical occupancy is space occupied by client files that may
or may not be part of an aggregate. A Pct Logical value less than 100%
indicates that there is vacant space within aggregates in the storage
pool.
- High Mig Pct (primary storage pools only)
- The high migration threshold, which specifies when the server can begin
migration for the storage pool. The server starts migration processes
when the percentage of data that can be migrated reaches this
threshold.
- Low Mig Pct (primary storage pools only)
- The low migration threshold, which specifies when the server can stop
migration for the storage pool. The server stops migration processes
when the percentage of data that can be migrated reaches this
threshold.
- Migration Delay (primary storage pools only)
- The minimum number of days that a file must remain in a storage pool
before the server can migrate the file to the next storage pool. For a
disk storage pool, the days are counted from the time that the file was stored
in the storage pool or last retrieved by a client. For a sequential
access storage pool, the days are counted from the time that the file was
stored in the storage pool.
- Migration Continue (primary storage pools only)
- Whether the server continues to migrate files to the next storage pool
even if the files have not been in the pool for the number of days specified
by the migration delay.
- Migration Processes (random access storage pools only)
- The number of processes that are used for migrating files from a storage
pool. When files are migrated from this storage pool to a storage pool
that uses physical drives, each migration process uses a drive.
Therefore, the number of migration processes should not exceed the number of
drives that can be dedicated to migration processing.
- Next Storage Pool (primary storage pools only)
- The storage pool that is the destination for data that is migrated from
this storage pool.
- Reclaim Storage Pool (primary, sequential access storage
pools only)
- If specified, the storage pool that is the destination for data moved from
volumes during reclamation processing. If no pool is specified, by
default reclamation processing moves data only among volumes within the same
storage pool.
- Maximum Size Threshold (primary storage pools only)
- The maximum size of files that may be stored in the storage pool during a
session with a client.
- Access
- How the data in the storage pool can be accessed.
- Description
- The description of the storage pool.
- Overflow Location (sequential access storage pools
only)
- Overflow location does not apply to this operating environment.
- Cache Migrated Files? (random access storage pools
only)
- Whether caching is enabled for files migrated to the next storage
pool.
- Collocate? (sequential access storage pools only)
- Whether collocation is enabled.
- Reclamation Threshold (sequential access storage pools
only)
- The threshold that determines when volumes in a storage pool are
reclaimed. The server compares the percentage of reclaimable space on a
volume to this value to determine if reclamation is necessary.
- Maximum Scratch Volumes Allowed (sequential access storage
pools only)
- The maximum number of scratch volumes that the server can request for the
storage pool.
- Delay Period for Volume Reuse (sequential access storage
pools only)
- The number of days that must elapse after all files have been deleted from
a volume, before the server returns the volume to scratch or reuses the
volume.
- Migration in Progress? (primary storage pools only)
- Whether at least one migration process is active for the storage
pool.
- Amount Migrated (MB) (primary storage pools only)
- The amount of data, in megabytes, that has been migrated, if migration is
in progress. If migration is not in progress, this value indicates the
amount of data migrated during the last migration. When multiple,
parallel migration processes are used for the storage pool, this value
indicates the total amount of data migrated by all processes.
- Elapsed Migration Time (seconds) (primary storage pools
only)
- The amount of time that has elapsed since migration began, if migration is
active. If migration is not active, this value indicates the amount of
time required to complete the last migration. When multiple, parallel
migration processes are used for the storage pool, this value indicates the
total time from the beginning of the first process until the completion of the
last process.
- Reclamation in Progress? (sequential access storage pools
only)
- Whether a reclamation process is active for the storage pool.
- Volume Being Migrated/Reclaimed (sequential access storage
pools only)
- The name of a volume for which migration or reclamation processing is
active. If no migration or reclamation processes are active, this field
is blank.
- Last Update by (administrator)
- The name of the administrator that has defined or most recently updated
the storage pool.
- Last Update Date/Time
- The date and time that an administrator defined or most recently updated
the storage pool.
- Data Format
- The data format used to write data to this storage pool, for example
NATIVE or NETAPPDUMP .
- Copy Storage Pool (s)
- The copy storage pools listed here will have data simultaneously written
to them when data is backed up or archived to the primary storage pool queried
by this command.
- Continue Copy on Error?
- Whether a server should continue writing data to other copy storage pools
in the list or terminate the entire transaction when a write failure occurs to
one of the copy pools in the list.
- Validate Data?
- Whether data is validated by a cyclic redundancy check (CRC) when data is
transferred during data storage and retrieval on a device.