To display LU information

When displaying LU information, if the -item parameter, -c parameter, or the -c -item parameter is specified at the same time as the -lu parameter, you can add and display items and display a summary of LU information. This section describes each parameter and the LU information and displayed items.

To display LU information

-lu

When neither the -c nor -item parameter is specified with the -lu parameter, the information about the LU recognized by HDLM is displayed without selecting items to be displayed or displaying a summary. The sorting key is iLU and its configuration information is displayed for each LU.

For details on the content of each displayed item, see Table 3. The sub-parameters are:

-pstv|-vstv

If the -pstv parameter is specified, information about the physical storage system is displayed. If the -vstv parameter is specified, information about the storage system recognized by the operating system is displayed. If neither parameter is specified, information is displayed according to the value specified in the -pstv parameter of set operations.

For information about the items that are displayed differently depending on the specified -pstv and -vstv parameters, see TO_SET_UP_THE_HDLM_OPERATING_ENVIRONMENT=GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543=2=EN=.html#GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543__HYO07004V080001.

-hdev host-device-name|-pathid AutoPATH_ID

Displays information only for the paths accessing the specified host device, if the -hdev parameter is specified.

Specify the name of the logical device file (minus the partition number), /dev/sddlm[aa-pap], for the HDLM device. For details on logical device files for HDLM devices, see LOGICAL_DEVICE_FILES_FOR_HDLM_DEVICES=GUID-1FB8E878-1356-4536-B854-9F544BC9B9C6=2=EN=.html.

If the -pathid parameter is specified, only information about the LU connected to the path with the specified AutoPATH_ID is displayed.

-t: Omits the title for each information item.

Example

The following example shows how to display the LU information without selecting items to be displayed:

# /opt/DynamicLinkManager/bin/dlnkmgr view -lu
Product : VSP_5000
SerialNumber : 39304
LUs : 3
iLU HDevName Device PathID Status
000BE0 sddlmad  /dev/sdk 000006 Online
                /dev/sdh 000007 Online
000BE1 sddlmae  /dev/sdm 000008 Online
                /dev/sdi 000009 Online
000BE2 sddlmaf  /dev/sdo 000010 Online
                /dev/sdj 000011 Online

Product : VSP_Gx00
SerialNumber : 410025
LUs : 3
iLU HDevName Device PathID Status
001800 sddlmaa  /dev/sdb 000000 Online
                /dev/sde 000001 Online
001801 sddlmab  /dev/sdc 000002 Online
                /dev/sdf 000003 Online
001802 sddlmac  /dev/sdd 000004 Online
                /dev/sdg 000005 Online
KAPL01001-I The HDLM command completed normally. Operation name = view(-vstv), completion time = yyyy/mm/dd hh:mm:ss
#

To display LU information (by adding items to be displayed)

-lu -item

The items specified with the -item option are displayed among with those displayed by the -lu option.

When the value of the -item parameter is omitted or all is specified, all the items, except for Physical-LDEV, and Virtual-LDEV, that can be displayed are displayed.

The table below lists the correspondence between the display items that can be added by using the -item parameter and the parameter values that can be specified after the -item parameter.

Table. Correspondence between the items displayed by the dlnkmgr view -lu -item command and the values of the -item parameter
Items displayed by the dlnkmgr view -lu -item command	Values specified after the -item parameter
`SLPR`	`slpr`
`PathName`	`pn`
`ChaPort`	`cp`
`CLPR`	`clpr`
`Type`	`type`
`IO-Count`	`ic`
`IO-Errors`	`ie`
`DNum`	`dnu`
`IEP`	`iep`
`HCTL`	`hctl`
`Physical-LDEV`	`phys`
`Virtual-LDEV`	`virt`
All items are displayed	`all`

For details on the contents of each displayed item, see Table 3.

The sub-parameters are:

-pstv|-vstv

If the -pstv parameter is specified, information about the physical storage system is displayed. If the -vstv parameter is specified, information about the storage system recognized by the operating system is displayed. If neither parameter is specified, information is displayed according to the value specified in the -pstv parameter of set operations.

For information about the items that are displayed differently depending on the specified -pstv and -vstv parameters, see TO_SET_UP_THE_HDLM_OPERATING_ENVIRONMENT=GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543=2=EN=.html#GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543__HYO07004V080001.

-hdev host-device-name|-pathid AutoPATH_ID

Displays information only for the paths accessing the specified host device, if the -hdev parameter is specified.

Specify the name of the logical device file (minus the partition number), /dev/sddlm[aa-pap], for the HDLM device. For details on logical device files for HDLM devices, see LOGICAL_DEVICE_FILES_FOR_HDLM_DEVICES=GUID-1FB8E878-1356-4536-B854-9F544BC9B9C6=2=EN=.html.

If the -pathid parameter is specified, only information about the LU connected to the path with the specified AutoPATH_ID is displayed.

-t: Omits the title for each information item.

Example

The following example shows how to display LU information by using iLUs as a sorting key, and selecting the items to be displayed. Execute the following command to display SLPR, PathName, ChaPort, CLPR, Type, IO-Count, IO-Errors, DNum, IEP, and HCTL:

# /opt/DynamicLinkManager/bin/dlnkmgr view -lu -item slpr pn cp clpr type ic ie dnu iep hctl
Product       : VSP_5000
SerialNumber  : 39368           
LUs           : 4

iLU    SLPR HDevName Device    PathID PathName                        ChaPort CLPR Status     Type IO-Count   IO-Errors  DNum IEP HCTL     
000610    - sddlmaa  /dev/sdd  000000 000E.0000.0000000000000000.0000 7A         0 Offline(E) Own           0          0    0 *   14.0.0.0 
                     /dev/sdh  000004 000E.0000.0000000000000001.0000 8A         0 Offline(E) Own           0          0    0 3   14.0.1.0 
                     /dev/sdl  000008 000F.0000.0000000000000000.0000 8A         0 Online     Own     4592505          0    0 2   15.0.0.0 
                     /dev/sdp  000009 000F.0000.0000000000000001.0000 7A         0 Online     Own     4592719          0    0 3   15.0.1.0 
000611    - sddlmab  /dev/sde  000001 000E.0000.0000000000000000.0001 7A         0 Offline(E) Own           0          0    0 *   14.0.0.1 
                     /dev/sdi  000005 000E.0000.0000000000000001.0001 8A         0 Offline(E) Own           0          0    0 3   14.0.1.1 
                     /dev/sdm  000010 000F.0000.0000000000000000.0001 8A         0 Online     Own     4591549          0    0 2   15.0.0.1 
                     /dev/sdq  000011 000F.0000.0000000000000001.0001 7A         0 Online     Own     4595293          0    0 3   15.0.1.1 
000612    - sddlmac  /dev/sdf  000002 000E.0000.0000000000000000.0002 7A         0 Offline(E) Own           0          0    0 *   14.0.0.2 
                     /dev/sdj  000006 000E.0000.0000000000000001.0002 8A         0 Offline(E) Own           0          0    0 -   14.0.1.2 
                     /dev/sdh  000012 000F.0000.0000000000000000.0002 8A         0 Online     Own     4593318          0    0 -   15.0.0.2 
                     /dev/sdr  000013 000F.0000.0000000000000001.0002 7A         0 Online     Own     4594969          0    0 -   15.0.1.2 
000613    - sddlmad  /dev/sdg  000003 000E.0000.0000000000000000.0003 7A         0 Offline(E) Own           0          0    0 *   14.0.0.3 
                     /dev/sdk  000007 000E.0000.0000000000000001.0003 8A         0 Offline(E) Own           0          0    0 3   14.0.1.3 
                     /dev/sdb  000014 000F.0000.0000000000000000.0003 8A         0 Online     Own     4591758          0    0 2   15.0.0.3 
                     /dev/sdsi 000015 000F.0000.0000000000000001.0003 7A         0 Online     Own     4596038          0    0 3   15.0.1.3 
KAPL01001-I The HDLM command completed normally. Operation name = view(-vstv), completion time = yyyy/mm/dd hh:mm:ss
#

To display a summary of LU information

-lu -c

When the -c parameter is specified with the -lu parameter, a summary of LU configuration information is displayed on one line. The total number of paths recognized by HDLM and the number of online paths are displayed for each LU.

You cannot specify the -c parameter together with the -hdev or -pathid parameter.

For details on the contents of each display item, see Table 3.

The sub-parameters are as follows:

-pstv|-vstv

If the -pstv parameter is specified, information about the physical storage system is displayed. If the -vstv parameter is specified, information about the storage system recognized by the operating system is displayed. If neither parameter is specified, information is displayed according to the value specified in the -pstv parameter of set operations.

For information about the items that are displayed differently depending on the specified -pstv and -vstv parameters, see TO_SET_UP_THE_HDLM_OPERATING_ENVIRONMENT=GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543=2=EN=.html#GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543__HYO07004V080001.

-t: Omits the title for each information item.

Example

The following example shows how to display a summary of LU information (without selecting items to be displayed):

# /opt/DynamicLinkManager/bin/dlnkmgr view -lu -c
Product  S/N      LUs iLU    HDevName Paths  OnlinePaths
VSP_5000 39368      3 000BE0 sddlmad       2           2
                      000BE1 sddlmae       2           2
                      000BE2 sddlmaf       2           2
VSP_Gx00 489072     3 000800 sddlmaa       2           2
                      000801 sddlmab       2           2
                      000802 sddlmac       2           2
KAPL01001-I The HDLM command completed normally. Operation name = view(-vstv), completion time = yyyy/mm/dd hh:mm:ss
#

To display a summary of LU information (by selecting items to be displayed)

-lu -c -item

The items displayed when the -item option is added to the -lu -c options.

When the value of the -item parameter is omitted, all the items that can be displayed are displayed.

The following table lists the correspondence between the display items that can be added by using the -item parameter and the parameter values that can be specified after the -item parameter.

Table. Correspondence between the item displayed by the dlnkmgr view -lu -c -item command and the value of the -item parameter
Item displayed by the dlnkmgr view -lu -c -item command	Value specified after the -item parameter
`SLPR`	`slpr`

The sub-parameter is:

-pstv|-vstv

If the -pstv parameter is specified, information about the physical storage system is displayed. If the -vstv parameter is specified, information about the storage system recognized by the operating system is displayed. If neither parameter is specified, information is displayed according to the value specified in the -pstv parameter of set operations.

For information about the items that are displayed differently depending on the specified -pstv and -vstv parameters, see TO_SET_UP_THE_HDLM_OPERATING_ENVIRONMENT=GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543=2=EN=.html#GUID-D1BCA75A-32B0-45BF-A8E5-66FBD9877543__HYO07004V080001.

-t: Omits the title for each information item.

Example

The following example shows how to display a summary of LU information, and selecting the items to be displayed. Execute the following command to display SLPR:

# /opt/DynamicLinkManager/bin/dlnkmgr view -lu -c -item
Product  S/N      LUs iLU    SLPR HDevName Paths  OnlinePaths
VSP_5000 39368      3 000BE0    - sddlmad       2           2
                      000BE1    - sddlmae       2           2
                      000BE2    - sddlmaf       2           2
VSP_Gx00 489072     3 000800    - sddlmaa       2           2
                      000801    - sddlmab       2           2
                      000802    - sddlmac       2           2
KAPL01001-I The HDLM command completed normally. Operation name = view(-vstv), completion time = yyyy/mm/dd hh:mm:ss
#

Items of LU information

Table 3 describes the displayed LU information. The following explains the table headings:

No summary displayed: The user specifies the -lu parameter or -lu -item parameter.
Summary displayed: The user specifies the -lu -c parameter or -lu -c -item parameter.

Table. LU information
Displayed item		Description
No summary displayed	Summary displayed	Description
`Product`		Model ID of the storage system
`SerialNumber`	`S/N`	Serial number of the storage system
`LUs`		Total number of LUs managed by HDLM among the LUs in the storage system
`iLU`		LU number in the storage system. This number combined with the storage system name (shown in `DskName`) identifies the LU that is accessed by a path. For XP8 indicated by a hexadecimal number. The first two characters of `iLU` are 00, the middle two numbers are the CU number, and the last two characters are the internal LU number within the CU. For VSP 5000 series, VSP One B20, VSP E series, VSP Gx00 models, VSP Fx00 models , and VSP N series indicated by a hexadecimal number. The first two characters of `iLU` are the number of the logical DKC (Disk Controller), the middle two numbers are the CU number, and the last two characters are the internal LU number within the CU.
`SLPR`^#1	`SLPR`^#2	The number of the SLPR to which an LU belongs, indicated by a number from 0 to 31. A hyphen (`-`) is displayed if the storage logical partition functionality for the storage system for the target LU is not supported. Note that a hyphen (`-`) is displayed even if the iLU is a virtualized volume.
`HDevName`^#1	`HDevName`	Host device name. The name of the logical device file (minus the partition number), `/dev/sddlm`[`aa-pap`], for the HDLM device. For details on logical device files for HDLM devices, see LOGICAL_DEVICE_FILES_FOR_HDLM_DEVICES=GUID-1FB8E878-1356-4536-B854-9F544BC9B9C6=2=EN=.html.
`Device`	`-`	SCSI device associated with an HDLM device. If the SCSI device is not connected when a host starts, or the assigned LU is released, this column displays a hyphen (-).
`PathID`	`-`	The AutoPATH_ID. AutoPATH_ID is assigned every time the host is restarted. When a new LU was added and the host has not been restarted, AutoPATH_ID is re-assigned to each path of the LU when you execute the HDLM-configuration definition utility (`dlmcfgmgr`).
`PathName`^#1	`-`	The path name, which indicates a path. When you modify the system configuration or replace a hardware item, you should check the path names to identify the path that will be affected by the change. `Path` `name` consists of the following four elements, separated by periods: Host port number (hexadecimal number) Bus number (hexadecimal number) Target ID (hexadecimal number) Host LU number (hexadecimal number) For details about each element of the path name and its representation in Linux, see TO_DISPLAY_PATH_INFORMATION=GUID-D7AE2E25-5B26-4D8E-988B-F27B4310A278=3=EN=.html#GUID-D7AE2E25-5B26-4D8E-988B-F27B4310A278__HYO07021.
`ChaPort`^#1	`-`	Port number of the CHA, which identifies the CHA port that is mounted on the storage system. You can identify an actual CHA port by referencing this number from the storage system management program.
`CLPR`^#1	`-`	The number of the CLPR to which the CHA belongs, indicated by a number from 0 to 31. Note that a hyphen (`-`) is displayed if the following items are subject to display: CHA ports in the storage system that do not support the cache logical partition function
`Status`	`-`	Status of the path `Online`: Online `Offline(C)`: Offline status caused by a command operation `Offline(E)`: Offline due to an error `Online(E)`: Failure has occurred (If none of the paths accessing one Dev have an `Online` status, one of those paths is changed to the `Online(E)` status.) Paths that are `Offline(E)` or `Online(E)` require corrective action. The appropriate action can be determined by referring to COM_NL_WHAT_TO_DO_FOR_A_PATH_ERROR=GUID-477D552A-B034-4CE0-AB4E-DF8EEDA4C398=3=EN=.html.
`Type`^#1	`-`	Attribute of the path `Own`: Owner path `Non`: Non-owner path If the storage system is supported by HDLM, usually all paths are owner paths.^#3
`IO-Count`^#1	`-`	Total I/O count for a path. The maximum value that can be displayed is 2³²- 1 (4294967295). If the total I/O count reaches the maximum value, it is reset, and the count is re-started from 0. To reset the `IO-Count` value to 0, execute the `dlnkmgr` command's `clear` operation. Executing the `clear` operation also resets the number of I/O errors (`IO-Errors`) to 0. For details about the `clear` operation, see COM_MNL_CLEAR_(RETURNS_THE_PATH_STATISTICS_TO_THE_INITIAL_VALUE)=GUID-38CB6E46-33AD-4900-A011-3F2687D6F85C=3=EN=.html.
`IO-Errors`^#1	`-`	Total I/O error count for a path. The maximum value that can be displayed is 2³²- 1 (4294967295). If the total I/O error count reaches the maximum value, it is reset, and the count is re-started from 0. To reset the `IO-Errors` value to 0, execute the `dlnkmgr` command's `clear` operation. Executing the `clear` operation also clears the number of I/O operations (`IO-Count`) to 0. For details about the `clear` operation, see COM_MNL_CLEAR_(RETURNS_THE_PATH_STATISTICS_TO_THE_INITIAL_VALUE)=GUID-38CB6E46-33AD-4900-A011-3F2687D6F85C=3=EN=.html. If the setting for retrying I/O when all paths fail is enabled (setting when using a channel board (25-Gbps iSCSI optical)), the value might be larger because I/O errors are counted even during I/O retries.
`DNum`^#1	`-`	Dev number, where 0 (fixed) is displayed. This item pertains to a partition number.
`IEP`^#1	`-`	The displayed paths are assumed to be in an intermittent error status and checked whether those paths are to be operated for automatic failbacks. One of the following values is displayed for each path: `-`: Indicates that intermittent error monitoring is disabled or the monitoring time for an intermittent error is out of range. A value of at least 0: Indicates the number of errors that occurred during intermittent error monitoring. `*`: Indicates that an intermittent error occurred (automatic failback does not check the path).
`HCTL`^#1	`-`	SCSI device configuration information. The following information is shown in "`a`.`b`.`c`.`d`" format: `a`: Host port number (decimal number) `b`: Bus number (decimal number) `c`: Target ID (decimal number) `d`: Host LU number (decimal number)
`Physical-LDEV`	`-`	The model ID, serial number, and iLU number of a physical volume are separated by periods and displayed. You can identify the physical volume from this information. If the volume is not virtualized, a hyphen (`-`) is displayed.
`Virtual-LDEV`	`-`	Displays the model ID, serial number, and iLU number of a virtual volume, separated by periods. You can identify the virtual volume from this information. If the volume is not virtualized, a hyphen (`-`) is displayed.
`-`	`Paths`	Total number of the paths recognized by HDLM for the LU to be displayed.
`-`	`OnlinePaths`	Number of available paths in the displayed paths, indicated by a decimal number. When the value of `Paths` equals the value of `OnlinePaths`, all paths are online. If the value of `OnlinePaths` is less than that of `Paths`, some paths are offline. In this case, you should check the offline paths and take appropriate action for any paths that have an error status.

Legend:: - : Not displayed

#1

This information is displayed when one of the following conditions exist:

- The user selected the item to be displayed by using the -lu -item parameter.

- all was specified.

- No value was specified for the parameter.

#2

This information is displayed when one of the following conditions exist:

- The user selected the item to be displayed by using the -lu -c -item parameter.

- No value was specified for the parameter.

#3

Non-owner paths exist in the following cases:

When a global-active device is being used, and the non-preferred path option is set