lsmdiskgrp

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):
  • The wildcard character is an asterisk (*).
  • The command can contain a maximum of one wildcard, which must be the first or last character in the string.
  • When using a wildcard, you must enclose the filter entry within double quotation marks (""), as follows:
    lsmdiskgrp -filtervalue  "name=md*"
-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:
  1. 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.
  2. off, which indicates Easy Tier does not actively manage the extents, and the Easy Tier status should be inactive .
  3. 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
  4. 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:
  1. 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.
  2. When the volume copy status is inactive, no Easy Tier(tm) functions are enabled for that volume copy.
  3. 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.
  4. When the volume copy status is balanced, the Easy Tier(tm) function enables performance-based pool balancing for that volume copy.
  5. When the volume copy status is active, the Easy Tier(tm) function operates in automatic data placement mode for that volume.
  6. 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