Hitachi Dynamic Link Manager Software Users Guide for Linux

Information Collected by the DLMgetras Utility for
Collecting HDLM Error Information
Immediately after an error occurs, execute the DLMgetras utility for collecting
HDLM error information, since restarting the machine might delete error
information before the information is collected by DLMgetras.
For details about the DLMgetras utility and the error information it collects,
see
DLMgetras Utility for Collecting HDLM Error Information on page 7-3.
Checking Error Information in Messages
When you want to configure the system so that HDLM messages are output
to syslog, specify user for the name of the system function defined in the
syslogd settings file. In the following example, the system function name is
user, and messages at the Information level or higher are output to
the /etc/syslog.conf file:
user.info /tmp/syslog.user.log
You can check path errors by referring to the KAPL08xxx messages that are
output to the syslog.
To obtain detailed information about a path failure, check the execution
results of the view operation as indicated by the error message.
For details on the view operation, see
view (Displays Information) on page
6-31.
The following is an example of a message:
KAPL08022-E Error in path occurred. A path error occurred. ErrorCode
= aa...aa, PathID = bb...bb, PathName =
cc...cc.dd...dd.ee...ee.ff...ff, DNum = gg...gg, HDevName = hh...hh
The message elements are explained below:
ErrorCode
The error number generated when Linux detects a path error.
PathID
The ID assigned to a path. This ID is called the AutoPATH_ID.
AutoPATH_IDs are re-assigned every time the host is restarted. When you
want to add a new LU without restarting the host, AutoPATH_IDs are re-
assigned to each path of the LU when you execute the dlmcfgmgr utility.
This path ID is also the same as PathID displayed by the dlnkmgr
command's view operation. For details on this view operation, see
view
(Displays Information) on page 6-31.
PathName
5-2
Troubleshooting
Hitachi Dynamic Link Manager (for Linux®) User Guide