Use the lsmdiskgrp command
to display a concise list or a detailed view of storage pools that are visible to the clustered system
(system).
Syntax
lsmdiskgrp
[ -filtervalueattribute=value
] [ -nohdr ]
[ -bytes ]
[ -delimdelimiter ]
[ -filtervalue? ] [ { object_id | object_name
} ]
Parameters
- -filtervalueattribute=value
- (Optional) Specifies a list of one or more filters.
Only objects with a value that matches the filter attribute value
are returned. If a capacity is specified, the units must also be included.
Note: Some filters allow the use of a wildcard when you enter
the command. The following rules apply to the use of wildcards when
using the command-line interface (CLI):
- -nohdr
- (Optional) By
default, headings are displayed for each column of data in a concise
style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these
headings.
Note: If there is no data to be displayed, headings are not
displayed.
- -bytes
- (Optional) Specifies
that you want the report to display all capacities as bytes.
- -delim delimiter
- (Optional) By default in a concise view, all columns
of data are space-separated. The width of each column is set to the
maximum possible width of each item of data. In a detailed view, each
item of data has its own row, and if the headers are displayed the
data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a one byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example,
the spacing of columns does not occur. In a detailed view, the data
is separated from its header by the specified delimiter.
- object_id | object_name
- (Optional) Specifies the name or ID of an object. When you use this
parameter, the detailed view of the specific object is returned and
any value specified by the -filtervalue parameter
is ignored. If you do not specify the object_id | object_name parameter, the concise view of all objects matching the
filtering requirements specified by the -filtervalue parameter are displayed.
- -filtervalue?
- Displays a list of valid filter attributes. The valid filters
for the lsmdiskgrp command are:
- name
- id
- mdisk_count
- vdisk_count
- status
- storage_pool_id
- easy_tier
- easy_tier_status
- site_id
- site_name
- parent_mdisk_grp_id
- parent_mdisk_grp_name
- child_mdisk_grp_count
- type
- encrypt
- owner_type
For more information about
filtering attributes, see Attributes of the -filtervalue parameters.
Description
This command returns a concise list or a detailed view of storage
pools visible to the system.
Command output includes values
for the following attributes:
- status
- The state of the MDisk with the highest-priority
status in the group, excluding image mode MDisks.
- VDisk_count
- The number of volume copies that are in the storage pool.
- capacity
- The total amount of MDisk storage that
is assigned to the storage pool.
- extent_size
- The size of the extents for this
group: 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, or 8192 (MB).
- free_capacity
- The amount of MDisk storage that
is assigned to the storage pool that is unused. MDisk storage can
be used for system quorum data and volumes.
- real_capacity
- The amount of MDisk storage that
is assigned to the storage pool that is assigned to volumes.
- virtual_capacity
- The total virtual size of all
the volume copies that are associated with the storage pool. This
is the same as the real_capacity value unless you
have configured thin-provisioned volume copies in this storage pool.
- used_capacity
- The total used size of all the
volume copies that are associated with the storage pool. This is the
same as the real_capacity value unless you have configured
thin-provisioned volume copies in this storage pool.
- overallocation
- Expressed as a percentage, the
ratio of the virtual_capacity value to the capacity.
An storage pool overallocation of over 100 is only possible if you
have configured thin-provisioned volume copies.
- warning
- This field is a percentage. A warning
is generated when the amount of space in the storage pool that has
been assigned exceeds this level.
- easy_tier
- This value is set by the user and determines
whether Easy Tier is permitted to manage the pool.
Note: The values
are:
- on, which indicates Easy Tier actively manages
the extents (including single-tier storage pools), and the Easy Tier
status should be active - unless a license is required.
- off, which indicates Easy Tier does not actively
manage the extents, and the Easy Tier status should be inactive .
- auto, which indicates the value of Easy Tier
status is determined by the number of tiers an storage pool has.
Note: auto, which indicates:
- on if Easy Tier is licensed or no license is
required
- off if Easy Tier requires a license and none
exists
- measure indicates
Easy Tier s collects statistics on that storage pool but does not
move any extents in the storage pool.
- easy_tier_status
- Whether the Easy Tier functions
are active on an storage pool:
- active indicates a pool is being managed by Easy
Tier to provide tier management performance-based pool balancing (for
example, extents can be moved).
- inactive indicates Easy Tier is inactive
- measured indicates
Easy Tier statistics are being collected but no Easy Tier management
is detected.
- balanced indicates
a pool is being managed by Easy Tier to provide performance-based
pool balancing (for example, extents can be moved).
| Storage pool Easy Tier ® setting |
Number of tiers in the storage pool |
Volume copy Easy Tier setting |
Volume copy Easy Tier status |
| Off |
One |
Off |
inactive (see note 2) |
| Off |
One |
On |
inactive (see note 2) |
| Off |
Two |
Off |
inactive (see note 2) |
| Off |
Two |
On |
inactive (see note 2) |
| Measure |
One |
Off |
measured (see note 3) |
| Measure |
One |
On |
measured (see note 3) |
| Measure |
Two |
Off |
measured (see note 3) |
| Measure |
Two |
On |
measured (see note 3) |
| Auto |
One |
Off |
measured (see note 3) |
| Auto |
One |
On |
balanced (see note 4) |
| Auto |
Two |
Off |
measured (see note 3) |
| Auto |
Two |
On |
active (see note 5) |
| On |
One |
Off |
balanced (see note 4) |
| On |
One |
On |
balanced
(see note 4) |
| On |
Two |
Off |
measured (see note 3) |
| On |
Two |
On |
active (see note 5) |
Note:
- If the volume copy is in image or sequential mode or
is being migrated then the volume copy Easy Tier(tm) status
is measured instead of active.
- When the volume copy status is inactive, no Easy Tier(tm) functions are enabled for that volume
copy.
- When the volume copy status is measured, the Easy Tier(tm) function collects usage statistics for
the volume but automatic data placement is not active.
- When the volume copy
status is balanced, the Easy Tier(tm) function enables performance-based pool balancing for that volume
copy.
- When the volume copy status is active, the Easy Tier(tm) function operates in automatic data
placement mode for that volume.
- The default Easy Tier setting for a storage
pool is auto, and the default Easy Tier
setting for a volume copy is on. This
means that Easy Tier functions other than pool performance balancing
are disabled for storage pools with a single tier, and that automatic
data placement mode is enabled for all striped volume copies in a
storage pool with two or more tiers.
|
- tier
- Indicates which tier information is being
reported.
- tier
- Indicates which tier information is being
reported. The values are:
- ssd
- nearline
- enterprise (the
default value for newly discovered or external volume)
- tier_mdisk_count
- Indicates the number of MDisks
in the tier.
- tier_capacity
- Indicates the total MDisk capacity assigned to the volume in the tier.
Note: For thin-provisioned copies, the capacity
by tier will be the real capacity.
- tier_free_capacity
- Indicates the unused amount
of MDisk storage in the tier.
- compression_active
- Indicates whether there
are any compressed volume copies in the storage pool.
- compression_virtual_capacity
- Indicates the total
virtual capacity for all compressed volume copies in the storage pool.
This is in unsigned decimal format.
- compression_compressed_capacity
- Indicates the
total used capacity for all compressed volume copies in the storage
pool. This is in unsigned decimal format.
- compression_uncompressed_capacity
- Indicates the
total uncompressed used capacity for all compressed volume copies
in the storage pool. This is in unsigned decimal format.
- site_id
- Indicates the site value for the storage
pool group. This numeric value is 1, 2, 3 or blank.
- site_name
- Indicates the site name for the storage
pool. This is an alphanumeric value or is blank.
- parent_mdisk_grp_id
- Indicates the storage pool
group ID. This is a numeric string (between 0 and 127 characters)
or blank.
- parent_mdisk_grp_name
- Indicates the storage pool
group name. This is an alphanumeric string (between 1 and 63 characters)
or blank.
- child_mdisk_grp_count
- Indicates the number of
child pools in the parent pools. This is a numeric string (between
0 and 127 characters) or blank.
- child_mdisk_grp_capacity
- Indicates the total
amount of space reserved for child pools.
- type
- Indicates the MDisk group type. The values
are parent and child_thick.
- encrypt
- Indicates whether the data stored on
the MDisk group is encrypted or not encrypted. The values are:
- yes if all MDisks in the group are encrypted
- no
- encrypt
- Indicates whether the data stored on
the MDisk group is encrypted or not encrypted. The values are:
- yes if the pool has an encryption key
- yes if the pool does not have an encryption key
(and the pool contains MDisks and all are encrypted)
- no if the pool does not have an encryption key
(and the pool contains MDisks and at least is not encrypted)
- Blank if the pool does not have an encryption key (and the pool
has no MDisks)
The following define the status fields, from lowest
to highest priority:
- Online
- Indicates that the storage pool is online
and available.
- Offline
- Indicates that all paths to the storage
pool are lost.
- owner_type
- Indicates the type of owning object,
such as a file system or application. This is an alphanumeric string
up to 20 characters in length.
- owner_id
- Indicates an identifier for the owning
object. It is represented by a number and is blank if there is no
object
- owner_name
- Indicates the name for the object
that owns the volume. This is an alphanumeric string up to 63 characters
in length or is blank.
A concise invocation example
lsmdiskgrp -delim :
The concise resulting output:
id:name:status:mdisk_count:vdisk_count:capacity:extent_size:free_capacity:virtual_capacity:used_capacity:real_capacity:overallocation:warning:easy_tier:easy_tier_status:compression_active:compression_virtual_capacity:compression_compressed_capacity:compression_uncompressed_capacity:encrypt:site_id:site_name
0:mdiskgrp0:online:2:1:42.18GB:512:8.00GB:34.18GB:34.18GB:34.18GB:81:0:measure:measured:no:0.00MB:0.00MB:0.00MB:yes:1:sprngfld1
A detailed invocation example
for a storage pool with one tier
lsmdiskgrp -delim : mdiskgrp1
The resulting output:
id:1
name:mdiskgrp1
status:online
mdisk_count:4
vdisk_count:6
capacity:200GB
extent_size:16
free_capacity:100GB
virtual_capacity:400.00GB
used_capacity:75.00GB
real_capacity:100.00GB
overallocation:200
warning:80
easy_tier:on
easy_tier_status:active
tier:ssd
tier_mdisk_count:0
tier_capacity: 0.00MB
tier_free_capacity:0.00MB
compression_active:yes
compression_virtual_capacity:1000.00MB
compression_compressed_capacity:0.41MB
compression_uncompressed_capacity:512.05MBsite_id:3
site_name:Quorumparent_mdisk_grp_id:3
parent_mdisk_grp_name:sisfyle
child_mdisk_grp_count:0
child_mdisk_grp_capacity:0.00MB
type:child_thickencrypt:noowner_type vvol_child_pool
owner_id
owner_name
A detailed invocation example
for a storage pool with two tiers
lsmdiskgrp -delim : mdiskgrp2
The resulting output:
id:2
name:mdiskgrp2
status:online
mdisk_count:8
vdisk_count:6
capacity:200GB
extent_size:16
free_capacity:100GB
virtual_capacity:400.00GB
used_capacity:75.00GB
real_capacity:100.00GB
overallocation:200
warning:80
easy_tier:auto
easy_tier_status:active
tier:ssd
tier_mdisk_count:2
tier_capacity:20.00GB
tier_free_capacity:0.00MB
tier:nearline
tier_mdisk_count:6
tier_capacity:180.00GB
tier_free_capacity:100.00GB
compression_active:yes
compression_virtual_capacity:1000.00MB
compression_compressed_capacity:0.41MB
compression_uncompressed_capacity:512.05MBsite_id:2
site_name:POKparent_mdisk_grp_id:2
parent_mdisk_grp_name:sysfile
child_mdisk_grp_count:0
child_mdisk_grp_capacity:0.00MB
type:child_thick
encrypt:yesowner_type vvol_child_pool
owner_id
owner_name
A detailed invocation example for a storage pool with three tiers
lsmdiskgrp -delim : mdiskgrp1
The resulting output:
id:1
name:mdiskgrp1
status:online
mdisk_count:4
vdisk_count:6
capacity:200.00GB
extent_size:16
free_capacity:100.00GB
virtual_capacity:400.00GB
used_capacity:75.00GB
real_capacity:100.00GB
overallocation:200
warning:80
easy_tier:auto
easy_tier_status:inactive
tier:ssd
tier_mdisk_count:0
tier_capacity:0.00MB
tier_free_capacity:0.00MB
tier:enterprise
tier_mdisk_count:3
tier_capacity:175.00GB
tier_free_capacity:75.00GB
tier:nearline
tier_mdisk_count:1
tier_capacity:25.00GB
tier_free_capacity:25.00GB
compression_active:no
compression_virtual_capacity:0.00MB
compression_compressed_capacity:0.00MB
compression_uncompressed_capacity:0.00MB
parent_mdisk_grp_id:1
parent_mdisk_grp_name:filesys
child_mdisk_grp_count:0
child_mdisk_grp_capacity:0.00MB
type:child_thickencrypt:yesowner_type vvol_child_pool
owner_id
owner_name