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
[ -filtervalue attribute=value
] [ -nohdr ] [ -bytes
] [ -delim delimiter
]
[ -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 you use 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 no data is available
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 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 1-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 that is specified
by the -filtervalue parameter
is ignored. If you do not specify the object_id
| object_name parameter,
the concise view of all objects that match the
filtering requirements that are specified by the
-filtervalue parameter are displayed.
- -filtervalue?
- (Optional)
Displays a list of valid filter attributes. The valid filters for
the lsmdiskgrp command
are the following values:
- 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
- data_reduction
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 sizes of the extents for this
group are the following values: 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 size is the same as the
real_capacity value unless you
configure 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 size is the same as the
real_capacity value unless you configure
thin-provisioned volume copies in this
storage pool.
- overallocation
- Expressed as a percentage, the
ratio of the virtual_capacity value to the capacity. A storage pool
overallocation of over 100 is only possible if you configure
thin-provisioned volume copies.
- warning
- This field is a percentage. A warning
is generated when the amount of space
in the storage pool that is 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 indicates that Easy Tier actively
manages the extents (including single-tier
storage pools), and the Easy
Tier status must be active - unless a license is
required.
- off indicates that Easy Tier does not
actively manage the extents, and
the Easy Tier status must be
inactive .
- auto indicates that the value of Easy Tier status
is determined by the number
of tiers in a storage pool.
Note: The following values apply to
auto:
- on if Easy Tier is licensed
or no license is required.
- off if Easy Tier requires a
license and none exists.
- measure indicates that Easy Tier s collects
statistics on that storage
pool but does not move any
extents in the storage pool.
- easy_tier_status
- This field indicates whether
the Easy Tier functions are active on a storage pool.
- active indicates that a pool is being managed
by Easy Tier to
provide tier management performance-based pool
balancing (for example, extents
can be moved).
- inactive indicates that Easy Tier is inactive.
- measured indicates that Easy Tier statistics
are being collected
but no Easy Tier
management is detected.
- balanced indicates that a pool is being managed
by Easy Tier to
provide performance-based pool balancing (for
example, extents can be moved).
The following table describes the storage pool Easy Tier settings.
If the volume copy is in image or
sequential mode or is being migrated, the
volume copy Easy Tier status is
measured instead of
active.
The default Easy Tier
setting for a storage pool is auto, and the default
Easy Tier setting for a volume copy
is on. Thus,
Easy Tier functions except
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:
- tier0_flash
- tier1_flash
- tier_enterprise
- tier_nearline
- tier_mdisk_count
- Indicates the number of MDisks
in the tier.
- tier_capacity
- Indicates the total MDisk capacity
that is assigned to the volume in the
tier.
Note: For thin-provisioned copies, the capacity by tier is the
real capacity.
- tier_free_capacity
- Indicates the unused amount
of MDisk storage in the tier.
- compression_active
- Indicates whether any compressed
volume copies are in the storage pool.
This field is blank for storage pools
that are data reduction pools.
- compression_virtual_capacity
- Indicates the total
virtual capacity for all compressed volume copies in
the storage pool. This value is in unsigned decimal
format. This field reports 0.00MB for storage pools that are data
reduction pools.
- compression_compressed_capacity
- Indicates the
total used capacity for all compressed volume copies in
the storage pool. This value is in unsigned decimal
format. This field reports 0.00MB for storage pools that are data
reduction pools.
- compression_uncompressed_capacity
- Indicates the
total uncompressed used capacity for all compressed volume
copies in the storage pool. This value is in
unsigned decimal format. This
field reports 0.00MB for storage pools that are data
reduction pools.
- 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 value is an alphanumeric value
or is blank.
- parent_mdisk_grp_id
- Indicates the storage pool
group ID. This value is a numeric string (in
the range 0 - 127 characters) or blank.
- parent_mdisk_grp_name
- Indicates the storage pool
group name. This value is an alphanumeric
string (in the range 1 - 63 characters) or blank.
- child_mdisk_grp_count
- Indicates the number of
child pools in the parent pools. This value is a
numeric string (in the range 0 - 127 characters) or blank.
- child_mdisk_grp_capacity
- Indicates the total
amount of space that is reserved for child
pools.
- type
- Indicates the MDisk group type. The values
are parent and child_thick.
- encrypt
- Indicates whether the data that is 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 one 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 attribute 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 no owning object exists.
- owner_name
- Indicates the name for the object
that owns the volume. This attribute is
an alphanumeric string up to 63 characters in length or is blank.
- data_reduction
- Indicates that the storage pool
is a data reduction pool. The values are yes or no.
- physical_capacity
- Indicates the total physical
capacity of MDisks that belong to this
storage pool. For any disks that do not display their physical capacity,
displays the logical capacity value. The
value must be a number (indicated in units)
that is rounded to two decimal places.
- physical_free_capacity
- Indicates the total free
physical capacity of MDisks that belong to this
storage pool. For any disks that do not display their physical
capacity, displays the logical capacity
value. The value must be a number (indicated
in units) that is rounded to two decimal places.
- shared_resources
- Indicates that one or more MDisks
in this storage pool shares a resource
provisioning group with an MDisk in another storage pool. It indicates
cross contamination over-provisioning
of physical resources between the storage
pools. The value must be yes or
no.
- reclaimable_capacity
- Indicates the unused (free)
capacity that will be available after data is reduced. Accurate to
within +/-1% of used_capacity_before_reduction. For storage pools that are not data reduction pools, this field
reports 0.00MB.
- used_capacity_before_reduction
- Indicates the
total amount of data that was written to thin-provisioned and compressed
volume copies in the storage pool before data reduction occurs. This
value does not include fully allocated volumes (that can be created
in a data reduction pool) because they are not eligible for reduction.
This field is blank for storage pools that are not data reduction
pools.
- used_capacity_after_reduction
- Indicates the total
amount of capacity that is used for thin-provisioned and compressed
volume copies in the storage pool after data reduction occurs. This
field is blank for storage pools that are not data reduction pools.
- deduplication_capacity_saving
- The amount of used
capacity that is saved by data deduplication in the
storage pool. This saving is before any compression.
This field is blank for storage pools
that are not data reduction pools.
- overhead_capacity
- Indicates the overhead capacity
consumption in the storage pool that is not attributed to the data.
- compression_opportunity
- The total amount of capacity
of all volume-copies within the data reduction
pool that are enabled for compression. It does not include
Real-time Compression capacity. This value excludes
capacity that has been saved by data deduplication.
- deduplication_opportunity
- The total amount of used_capacity_before_reduction
of all volume-copies within the data reduction pool that are
enabled for data deduplication.
A concise invocation example
lsmdiskgrp -delim :
The following concise output is displayed:
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:
parent_mdisk_grp_id:parent_mdisk_grp_name:child_mdisk_grp_count:child_mdisk_grp_capacity:type:encrypt:
owner_type:site_id:site_name:data_reduction:used_capacity_before_reduction:used_capacity_after_reduction:
deduplication_capacity_saving:reclaimable_capacity
0:mdiskgrp0:online:2:0:399.00GB:256:399.00GB:0.00MB:0.00MB:
0.00MB:0:0:auto:balanced:no:
0.00MB:0.00MB:0.00MB:
0:mdiskgrp0:0:0.00MB:parent:no:
none:::no:0.00MB:0.00MB:
0.00MB:0.00MB
1:A9000:online:3:2:584.69GB:64:518.69GB:66.00GB:66.00GB:
66.00GB:11:0:auto:balanced:no:
0.00MB:0.00MB:0.00MB:
1:A9000:0:0.00MB:parent:no:
none:::no:0.00MB:0.00MB:
0.00MB:0.00MB
2:Storwize:online:3:2:592.50GB:64:526.50GB:66.00GB:66.00GB:
66.00GB:11:0:auto:balanced:no:
0.00MB:0.00MB:0.00MB:
2:Lenovo Storage V series:0:0.00MB:parent:no:
none:::no:0.00MB:0.00MB:
0.00MB:0.00MB
A detailed invocation example
for a storage pool with one tier
lsmdiskgrp -delim : mdiskgrp1
The following output
is displayed:
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
tier tier0_flash
tier_mdisk_count 1
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier1_flash
tier_mdisk_count 1
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier_enterprise
tier_mdisk_count 0
tier_capacity 0.00MB
tier_free_capacity 0.00MB
tier tier_nearline
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.05MB
site_id:3
site_name:Quorum
parent_mdisk_grp_id:3
parent_mdisk_grp_name:sisfyle
child_mdisk_grp_count:0
child_mdisk_grp_capacity:0.00MB
type:child_thickowner_type vvol_child_pool
owner_id
owner_namephysical_capacity:1.23TB
physical_free_capacity:1.11TB
shared_resources:yesdata_reduction:yes
reclaimable_capacity:10.00MB
used_capacity_before_reduction
used_capacity_after_reduction
overhead_capacity
A detailed invocation example for
a storage pool with two tiers
lsmdiskgrp -delim : mdiskgrp2
The following output is displayed:
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 tier0_flash
tier_mdisk_count 1
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier1_flash
tier_mdisk_count 1
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier_enterprise
tier_mdisk_count 0
tier_capacity 0.00MB
tier_free_capacity 0.00MB
tier tier_nearline
tier_mdisk_count 0
tier_capacity 0.00MB
tier_free_capacity 0.00MB
tier_mdisk_count:6
tier_capacity:180.00GB
tier_free_capacity:100.00GB
tier:ri_ssd
tier_mdisk_count:
tier_capacity:
tier_free_capacity:
compression_active:yes
compression_virtual_capacity:1000.00MB
compression_compressed_capacity:0.41MB
compression_uncompressed_capacity:512.05MB
site_id:2
site_name:POK
parent_mdisk_grp_id:2
parent_mdisk_grp_name:sysfile
child_mdisk_grp_count:0
child_mdisk_grp_capacity:0.00MB
type:child_thick
owner_type vvol_child_pool
owner_id
owner_namephysical_capacity:1.63TB
physical_free_capacity:1.52TB
shared_resources:nodata_reduction:yes
reclaimable_capacity:15.00MB
used_capacity_before_reduction
used_capacity_after_reduction
overhead_capacity
A detailed invocation example for
a storage pool with three tiers
lsmdiskgrp -delim : mdiskgrp1
The following output is displayed:
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 tier0_flash
tier_mdisk_count 1
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier1_flash
tier_mdisk_count 1
tier_capacity 1.63TB
tier_free_capacity 1.63TB
tier tier_enterprise
tier_mdisk_count 0
tier_capacity 0.00MB
tier_free_capacity 0.00MB
tier tier_nearline
tier_mdisk_count 0
tier_capacity 0.00MB
tier_free_capacity 0.00MB
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_thickowner_type vvol_child_pool
owner_id
owner_namephysical_capacity:1.63TB
physical_free_capacity:1.52TB
shared_resources:nodata_reduction:yes
reclaimable_capacity:20.00MB
used_capacity_before_reduction
used_capacity_after_reduction
overhead_capacity