HP-UX iSCSI Software Initiator Support Guide (Edition 7)

C Diagnostic Messages
C.1 Diagnostic Messages
By default, the iSCSI Software Interface Driver logs all diagnostic messages to the Support Tools
Manager (STM) log files. At the time of this publication, there is no support to display messages
logged by the iSCSI driver in the HP-UX 11i v3 version of STM. When this support is released,
STM can be used to view these diagnostic messages.
EMS can be configured to automatically notify the system administrator when diagnostic messages
are logged by the iSCSI Software Initiator.
In addition to logging all diagnostic messages to the STM log files, the iSCSI Software Initiator
logs some of the diagnostic messages to the /var/adm/syslog/syslog.log file.
The messages that can be logged to the syslog.log file are defined at 8 levels. By default,
messages with numerical values less than or equal to LVL_ERR (Level 3) will be logged. See Table 5:
“Logging Levels for the syslog.log File, below, for detailed descriptions of logging levels.
Table 5 Logging Levels for the syslog.log File
DescriptionLevel[LINEBREAK]NumberLogging Level
The system is unusable and a panic will follow. The message will provide
additional data about the panic.
0LVL_PANIC
The system has entered a state that requires an action by the administrator. The
message describes the condition, and the action that must be taken
1LVL_ALERT
A critical event has occurred. The system is still usable. The message will provide
additional details about the event.
2LVL_CRIT
An error condition has occurred. The system is still usable. The message will
provide additional details about the error.
3LVL_ERR
An event has occurred that may indicate some future action is necessary. The
system is still usable, and the current system operation has not been affected.
The message will provide additional details about the warning.
4LVL_WARN
An event has occurred that fits the normal profile of operation, however, the
event is called out so that it may be viewed in the context of other things
5LVL_NOTE
occurring in the system. The system is still usable, and the current system
operation has not been affected. The message will provide additional details
about the noted event.
An informational message regarding some unusual, but acceptable, event that
occurred during system operation. The system is usable, and the information
can be ignored. The message will provide additional details.
6LVL_INFO
A debug message used internally by the HP lab to assist in debugging an
exception event. Customers should not attempt to interpret messages at this
level.
7LVL_DEBUG
To change the level of event logging, execute the following command:
iscsiutil [/dev/iscsi] -b <dbg_level>[LINEBREAK][LINEBREAK]where dbg_level
is one of the level numbers listed in Table 5: “Logging Levels for the syslog.log File” (page 47).
Logging of events is always turned on. By default, messages at the LVL_ERR and lower levels are
displayed in the syslog.log file. Level zero reporting cannot be turned off.
The messages detailed in the following “Message Descriptions” section, may be generated when
the iSCSI Software Initiator is in use.
The first value in the first line of each message listing is defined in an iSCSI header file and can
be used to reference a specific message. The second value is the level of the event.
The second entry in each message listing is the message string presented in C language format
with print format characters present.
C.1 Diagnostic Messages 47