The lsmdiskgrp command returns a concise list or a detailed view of MDisk groups visible to the cluster.
Syntax
>>- svcinfo -- -- lsmdiskgrp -- --------------------------------> >--+--------------------------------+-- --+----------+-- -------> '- -filtervalue -- attrib=value -' '- -nohdr -' >--+----------+-- --+-----------------------+-- -- -------------> '- -bytes -' '- -delim -- delimiter -' >--+-----------------+--+---------------+---------------------->< '- -filtervalue? -' +- object_id ---+ '- object_name -'
Parameters
- -filtervalue attrib=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 with the SAN Volume Controller 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:
svcinfo 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?
- Display a list of valid filter attributes. The valid filters for
the svcinfo lsmdiskgrp command are:
- name
- storage_pool_id
- mdisk_count
- vdisk_count
- extent_size
- status
- id
Description
This command returns a concise list or a detailed view of MDisk groups visible to the cluster.
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 VDisk copies that are in the MDisk group.
- capacity
- The total amount of MDisk storage that is assigned to the MDisk group.
- free_capacity
- The amount of MDisk storage that is assigned to the MDisk group that is unused. MDisk storage can be used for cluster quorum data and VDisks.
- real_capacity
- The amount of MDisk storage that is assigned to the MDisk group that is assigned to VDisks.
- virtual_capacity
- The total virtual size of all the VDisk copies that are associated with the MDisk group. This is the same as the real_capacity value unless you have configured space-efficient VDisk copies in this MDisk group.
- used_capacity
- The total used size of all the VDisk copies that are associated with the MDisk group. This is the same as the real_capacity value unless you have configured space-efficient VDisk copies in this MDisk group.
- overallocation
- Expressed as a percentage, the ratio of the virtual_capacity value to the capacity. An MDisk group overallocation of over 100 is only possible if you have configured space-efficient VDisk copies.
- warning
- This field is a percentage. A warning is generated when the amount of space in the MDisk group that has been assigned exceeds this level.
The following
define the status fields, from lowest to highest priority:
- Online
- The MDisk is online and available.
- Degraded ports
- There are one or more MDisk port errors.
- Degraded paths
- One or more paths to the MDisk have been lost; the MDisk is not online to every node in the cluster.
- Offline
- All paths to the MDisk are lost.
- Excluded
- The MDisk is excluded from use by the cluster; the MDisk port error count exceeded the threshold.
A concise invocation example
svcinfo 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
0:mdiskgrp0:degraded_paths:4:0:34.2GB:16:34.2GB:0:0:0:0:0
1:mdiskgrp1:online:4:6:200GB:16:100GB:400GB:75GB:100GB:200:80
A detailed invocation example
svcinfo lsmdiskgrp -delim : 0
The detailed resulting output
id:0 name:mdiskgrp0 status:online mdisk_count:2 vdisk_count:26 capacity:33.3GB extent_size:16 free_capacity:26.8GB virtual_capacity:6.00GB used_capacity:10.56GB real_capacity:6.00GB overallocation:18 warning:0