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

-delim delimiter: (Optional) Specify a delimiter to separate data in the output.
-nohdr: (Optional) Suppress the headings in the output.
-filtervalue attribute=value: (Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?: (Optional) Displays a list of valid filter attributes.

-bytes: (Optional) Specifies that you want the report to display all capacities as bytes.
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.

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_capacity can 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_capacity value 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:

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).

tier

Indicates which tier information is being reported. The values are:

tier0_flash
tier1_flash
tier_enterprise
tier_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, and child_quotaless.

A child pool that does not have a quota does not contribute any extents to the parent pool.

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 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.
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 yes and the system setting has vdisk_protection_enabled set to yes. 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.

protection_provisioned_capacity: The amount of capacity provisioned to store point-in-time copies for volumes in the storage pool. This includes snapshots and consistency protection for replication.
protection_written_capacity: The amount of capacity written to store point-in-time copies for volumes in the storage pool before any data reduction. This includes volume snapshots and consistency protection for replication.
protection_vdisk_count: The number of point-in-time copies for volumes in the storage pool that contribute to the protection capacity values. This includes snapshots and consistency protection for replication. These hidden volumes are included in the value in the vdisk_count field.
replication_pool_link_uid: Display the replication pool link unique identifier (UID) assigned to the pool. This value is used to link pools between systems for policy-based replication.
format_required: Indicate that freed extents belonging to the storage pool require formatting before they can be allocated to volumes. The formatting process is automatic.