lsmdiskgrp
Use the lsmdiskgrp command to display a concise list or a detailed view of storage pools that are visible to the system.
Syntax
Parameters
- -filtervalue attribute=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.
- -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
- owner_id
- owner_name
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. For quotaless child pools, this is the free capacity of the parent 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 immediately available. Additionally,
reclaimable_capacitycan eventually become available. For quotaless child pools, this is the free capacity of the parent pool. - real_capacity
- The total MDisk storage
capacity assigned to volume copies. Reports 0.00 MB for quotaless
child pools.Note: It includes
reclaimable_capacity. - virtual_capacity
- The total host mappable capacity of all volume copies in the storage pool.
- used_capacity
- The amount of data that is
stored on MDisks. standard-provisioned volumes contribute their entire capacity. Reports 0.00 MB for quotaless child pools.Note: It includes
reclaimable_capacity. - overallocation
- Expressed as a percentage, the
ratio of the
virtual_capacityvalue to the capacity. A storage pool overallocation of over 100 is only possible if you configure thin-provisioned volume copies. For data reduction parent pools, this calculation includes the virtual capacity of any quotaless child pools. No value is reported for quotaless child pools. - 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. For quotaless child pools, this is the parent pool's warning 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:
onindicates that Easy Tier actively manages the extents (including single-tier storage pools), and the Easy Tier status must beactive- unless a license is required.offindicates that Easy Tier does not actively manage the extents, and the Easy Tier status must beinactive.autoindicates that the value of Easy Tier status is determined by the number of tiers in a storage pool.Note: The following values apply toauto:onif Easy Tier is licensed or no license is required.offif Easy Tier requires a license and none exists.
measureindicates 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.
activeindicates that a pool is being managed by Easy Tier to provide tier management performance-based pool balancing (for example, extents can be moved).inactiveindicates that Easy Tier is inactive.measuredindicates that Easy Tier statistics are being collected but no Easy Tier management is detected.balancedindicates 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.Table 1. Easy Tier settings for storage pools and volumes 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 1) Off One On inactive (see note 1) Off Two Off inactive (see note 1) Off Two On inactive (see note 1) Measure One Off measured (see note 2) Measure One On measured (see note 2) Measure Two Off measured (see note 2) Measure Two On measured (see note 2) Auto One Off measured (see note 2) Auto One On balanced (see note 3) Auto Two Off measured (see note 2) Auto Two On active (see note 4) On One Off balanced (see note 3) On One On balanced (see note 3) On Two Off measured (see note 2) On Two On active (see note 4) Notes: - When the volume copy status is inactive, no Easy Tier functions are enabled for that volume copy.
- When the volume copy status is measured, the Easy Tier function collects usage statistics for the volume but automatic data placement is not active.
- When the volume copy status is balanced, the Easy Tier function enables performance-based pool balancing for that volume copy.
- When the volume copy status is active, the Easy Tier function operates in automatic data placement mode for that volume.
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. The values are:
tier0_flashtier1_flashtier_enterprisetier_nearline- tier_scm
- tier_mdisk_count
- Indicates the number of MDisks in the tier.
- tier_capacity
- The amount of MDisk storage in this tier that is assigned to the storage pool.
- tier_free_capacity
- The amount of MDisk storage in this tier that has not been assigned.
- 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 provisioned (virtual) capacity for all compressed volume copies in regular storage pools.
- compression_compressed_capacity
- Indicates the total used capacity for all compressed volume copies in regular storage pools.
- compression_uncompressed_capacity
- Indicates the total uncompressed used capacity for all compressed volume copies in regular storage 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,child_thick, andchild_quotaless.
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.
- data_reduction
- Indicates that the storage pool is a data reduction pool. The values are
yesorno. - 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
yesorno. - overhead_capacity
- The MDisk capacity that is reserved for internal usage. Reports 0.00 MB for data reduction child pools.
- vdisk_protection_enabled
- Indicates if this pool has volume protection enabled. This field is combined with the system setting vdisk_protection_enabled to determine the pool vdisk_protection_status. The value is either yes or no.
- vdisk_protection_status
- Indicates whether volume protection is active for this pool. Volumes with one or more copies in
a pool where vdisk_protection_status is active are protected. Volumes with all
copies in pools with an inactive volume protection status are not protected volumes. This field
depends on the system setting for vdisk_protection_enabled and the pool setting
for vdisk_protection_enabled. It is active only when the storage pool has
vdisk_protection_enabled set to
yesand the system setting has vdisk_protection_enabled set toyes. Otherwise, it is inactive. - easy_tier_fcm_over_allocation_max
- Displays the maximum over allocation which Easy Tier can migrate onto FlashCore Module arrays, when the array is used as the top tier in a multitier pool. The value acts as a multiplier of the physically available space. This value is a percentage or blank for unsupported products.
- provisioning_policy_id
- Displays the ID of the provisioning policy.
- provisioning_policy_name
- Displays the name of the provisioning policy.
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_thick
encrypt:no
owner_type vvol_child_pool
owner_id
owner_name
physical_capacity:1.23TB
physical_free_capacity:1.11TB
shared_resources:yes
data_reduction:yes
reclaimable_capacity:0.00MB
used_capacity_before_reduction:24.03GB
used_capacity_after_reduction:18.17GB
deduplication_capacity_saving:3.22GB
overhead_capacity
owner_id 0
owner_name tenantA
vdisk_protection_enabled:yes
vdisk_protection_status:active
easy_tier_fcm_over_allocation_max 100%
auto_expand no
auto_expand_max_capacity 0.00MB
safeguarded no
provisioning_policy_id
provisioning_policy_name
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
encrypt:yes
owner_type vvol_child_pool
owner_id
owner_name
physical_capacity:1.63TB
physical_free_capacity:1.52TB
shared_resources:no
data_reduction:yes
reclaimable_capacity:15.00MB
used_capacity_before_reduction
used_capacity_after_reduction
overhead_capacity
owner_id 0
owner_name tenantA
vdisk_protection_enabled:yes
vdisk_protection_status:active
easy_tier_fcm_over_allocation_max 100%
auto_expand no
auto_expand_max_capacity 0.00MB
safeguarded no
provisioning_policy_id
provisioning_policy_name
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
site_id:2
site_name:POK
parent_mdisk_grp_id:1
parent_mdisk_grp_name:filesys
child_mdisk_grp_count:0
child_mdisk_grp_capacity:0.00MB
type:child_thick
encrypt:yes
owner_type vvol_child_pool
owner_id
owner_name
physical_capacity:1.63TB
physical_free_capacity:1.52TB
shared_resources:no
data_reduction:yes
reclaimable_capacity:20.00MB
used_capacity_before_reduction
used_capacity_after_reduction
overhead_capacity
owner_id 0
owner_name tenantA
vdisk_protection_enabled:yes
vdisk_protection_status:active
easy_tier_fcm_over_allocation_max 100%
auto_expand no
auto_expand_max_capacity 0.00MB
safeguarded no
provisioning_policy_id
provisioning_policy_name