lsmdisk

The list report style can be used to obtain two styles of report.
  1. A list containing concise information about all the managed disks visible to the cluster. (Each entry in the list corresponds to a single managed disk.)
  2. The detailed information about a single managed disk.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svcinfo -- -- lsmdisk -- ----------------------------------->

>--+-------------------------------------------------------+---->
   '- -filtervalue -- attrib=value --+-------------------+-'
                                     '- -unit --+- b --+-'
                                                +- kb -+
                                                +- mb -+
                                                +- gb -+
                                                +- pb -+
                                                '- tb -'

>-- --+----------+-- --+----------+-- -------------------------->
      '- -nohdr -'     '- -bytes -'

>--+-----------------------+-- --+-------------+-- ------------->
   '- -delim -- delimiter -'     +- object_id -+
                                 '- name ------'

>--+-----------------+-----------------------------------------><
   '- -filtervalue? -'

Parameters

-filtervalue attribute=value
Optionally 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
By default, headings are displayed for each column of data (in a concise style view), and each item of data (in a detailed style view). Using the -nohdr parameter will suppress the display of these headings.
Note:Note: If there is no data to be displayed (for example, an empty view has been returned), then headings are not displayed irrespective of whether the -nohdr option was used or not.
-bytes
Optionally used to display all capacities as bytes.
-delim delimiter
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. Using the -delim parameter will override this behavior. Valid input for the -delim parameter is a one byte character. If, for example, you entered -delim : a colon will be used to separate all items of data in a concise view (for example, the spacing of columns does not occur) and in a detailed view the data is separated from its header by a colon.
object_id | name
Optionally specifies the name or ID of an object. If not supplied, the concise view of all objects, or all of those objects matching the filtering requirements in -filtervalue (if specified), of the given type are returned. If supplied, the detailed view of the specific object is returned, and any filtervalue entry (if entered) is ignored.
-filtervalue?
Display a list of valid filter attributes. The valid filters for the svcinfo lsmdisk command are:
  • name
  • id
  • status
  • mode
  • mdisk_grp_id
  • mdisk_grp_name
  • capacity
  • controller_name

Description

This command will return a concise list or a detailed view, of MDisks visible to the cluster.

The following list provides possible values that are applicable to the attributes that are displayed as data in the output views:

status offline, excluded, degraded, online
mode unmanaged, managed, image
quorum index 0/1/2 valid Quorum index

When back-end controllers are added to the fibre-channel SAN and are included in the same switch zone as a SAN Volume Controller Cluster the cluster will automatically discover the back-end controller and will integrate the controller to determine what storage it is presented to the SAN Volume Controller. The SCSI LUs presented by the back-end controller will be displayed as unmanaged MDisks. If however the configuration of the back-end controller is modified after this has occurred then the SAN Volume Controller may be unaware of these configuration changes. This task allows a user to request the SAN Volume Controller to re-scan the fibre-channel SAN to update the list of unmanaged Mdisks.

Note:Note: The automatic discovery performed by SAN Volume Controller does not write anything to a unmanaged MDisk. It is only when a the user instructs the SAN Volume Controller to add a MDisk to a managed disk group or use a Mdisk to create an image mode virtual disk that the storage will actually be used.

Discovering MDisks: Check to see which MDisks are available by issuing the svctask detectmdisk command to manually scan the fibre-channel network for any MDisks. Issue the svcinfo lsmdiskcandidate command to show the unmanaged MDisks. These MDisks have not been assigned to an MDisk group. Alternatively, you can issue the svcinfo lsmdisk command to view all of the MDisks.

Each MDisk corresponds with a single RAID array, or a single partition on a given RAID array. Each RAID controller will define a LUN number for this disk. The LUN number and controller name or ID are needed to be able to determine the relationship between mdisks and RAID arrays or partitions.

Determining the relationship between MDisks and RAID arrays or LUNs: Show the detailed view of the given MDisk <mdiskname>, by issuing the following command:
svcinfo lsmdisk <mdiskname>
where <mdiskname> is the name of the MDisk.

Note:Note: Remember the controller name or controller ID and controller LUN number.

Show the detailed view of the controller determined in by issuing the following command:
svcinfo lscontroller <controllername>
where <controllername> is the name of the controller.

Note:Note: Remember the vendor ID, product ID, and WWNN. Use these to determine what is being presented to the MDisk.

From the native user interface for the given controller, list the LUNs it is presenting and match the LUN number. This will tell you the exact RAID array or partition that corresponds with the MDisk.

Possible failures

Examples

A concise invocation example

svcinfo lsmdisk -delim :

The concise resulting output

id:name:status:mode:mdisk_grp_id:mdisk_grp_name:capacity:
ctrl_LUN_#:controller_name:UID
0:mdisk0:online:managed:0:mdiskgrp0:68.4GB:0000000000000000:controller0:
20000004cf2422aa000000000000000000000000000000000000000000000000
1:mdisk1:online:managed:0:mdiskgrp0:68.4GB:0000000000000000:controller1:
20000004cf1fd19d000000000000000000000000000000000000000000000000
2:mdisk2:online:managed:0:mdiskgrp0:68.4GB:0000000000000000:controller2:
20000004cf242531000000000000000000000000000000000000000000000000
3:mdisk3:online:managed:0:mdiskgrp0:68.4GB:0000000000000000:controller3:
20000004cf1fd7a0000000000000000000000000000000000000000000000000
4:mdisk4:online:unmanaged:::68.4GB:0000000000000000:controller4:
20000004cf241308000000000000000000000000000000000000000000000000
5:mdisk5:online:unmanaged:::68.4GB:0000000000000000:controller5:
20000004cf2412ca000000000000000000000000000000000000000000000000
6:mdisk6:online:unmanaged:::68.4GB:0000000000000000:controller6:
20000004cf242123000000000000000000000000000000000000000000000000
7:mdisk7:online:unmanaged:::68.4GB:0000000000000000:controller7:
20000004cf2412ac000000000000000000000000000000000000000000000000
8:mdisk8:online:unmanaged:::68.4GB:0000000000000000:controller8:
20000004cf2421de000000000000000000000000000000000000000000000000
9:mdisk9:online:unmanaged:::68.4GB:0000000000000000:controller9:
20000004cf1fd7cc000000000000000000000000000000000000000000000000
10:mdisk10:online:unmanaged:::68.4GB:0000000000000000:controller10:
20000004cf1ffe88000000000000000000000000000000000000000000000000
11:mdisk11:online:unmanaged:::68.4GB:0000000000000000:controller11:
20000004cf2412aa000000000000000000000000000000000000000000000000
12:mdisk12:online:unmanaged:::68.4GB:0000000000000000:controller12:
20000004cf242374000000000000000000000000000000000000000000000000
13:mdisk13:online:unmanaged:::68.4GB:0000000000000000:controller13:
20000004cf2419fe000000000000000000000000000000000000000000000000
14:mdisk14:online:unmanaged:::68.4GB:0000000000000000:controller14:
20000004cf241932000000000000000000000000000000000000000000000000

A detailed invocation example

svcinfo lsmdisk -delim : 2

The detailed resulting output

id:2
name:mdisk2
status:online
mode:unmanaged
mdisk_grp_id:
mdisk_grp_name:
capacity:68.4GB
quorum_index:
block_size:512
controller_name:controller2
ctrl_type:4
ctrl_WWNN:20000004CF242531
controller_id:2
path_count:1
max_path_count:1
ctrl_LUN_#:0
UID:20000004cf242531000000000000000000000000000000000000000000000000

Related topics

(C) Copyright International Business Machines Corporation 2003, 2004