6.4.4 Handling SCSI-related messages output to syslog
SCSI-related messages might be output to syslog. This subsection describes the messages that are output to syslog and how to handle them.
- Organization of this subsection
(1) Messages that are output
This subsection shows the types of SCSI-related messages that are output to syslog. In the messages shown in this section, x indicates an alphanumeric character. The message format might differ depending on the OS.
- Messages output regardless of whether the disk is in a single-path configuration or multipath configuration
-
These messages are output because the active server has reserved the disk for protection. You do not need to handle these messages because they were output for normal behavior.
Table 6‒2: Messages output regardless of whether the disk is in a single-path configuration or multipath configuration Message that is output
When the message is output
kernel: sd x:x:x:x: reservation conflict
-
This message is output when the OS is restarted while a server is operating as the active system on the remote host.
-
This message is output when hot-standby switchover is performed.
-
- Messages that are output if the disk is in a multipath configuration (DMMP)
-
These messages are output because the active server has reserved the disk for protection. You do not need to handle these messages because they were output for normal behavior. However, we recommend that you move these messages to reduce the data output to syslog. For details about how to move messages, see (2) Example settings for moving SCSI-related messages from syslog.
Table 6‒3: Messages that are output if the disk is in a multipath configuration (DMMP) Active/standby system
Message that is output
When the message is output
Active system
kernel: sdx: sdxx
This message is output at five-second intervals (if the default setting is used) for each device that is in a multipath configuration if there is an active server. If the scsi_check operand is specified, this message is output at the interval (in seconds) specified in this operand.
Standby system
-
kernel: sdx: sdxx
-
kernel: sd x:x:x:x: reservation conflict
-
kernel: sd x:x:x:x: [sdx] Test Unit Ready failed: Result: hostbyte=DID_OK driverbyte=DRIVER_OK
This message is output at one-minute intervals (if the default setting is used) for each device that is in a multipath configuration if there is a standby server. If the scsi_pathcheck operand is specified, this message is output at the interval (in seconds) specified in this operand.
-
(2) Example settings for moving SCSI-related messages from syslog
This subsection shows example settings for moving messages from syslog to another log file. If necessary, set log rotation. With the example settings, SCSI-related messages are output to the /var/log/hamon-scsi file instead of /var/log/messages.
- Path of the settings file to be created:
-
/etc/rsyslog.d/hamon-scsi.conf
- Settings in the settings file:
-
# kernel: sdb: sdb1 :msg, regex, "^ sd[a-z]: sd[a-z][0-9]$" /var/log/hamon-scsi & stop # kernel: sd 0:0:0:2: reservation conflict :msg, regex, "^sd [0-9]..*[0-9]: reservation conflict$" /var/log/hamon-scsi & stop # kernel: sd 0:0:0:2: [sdb] Test Unit Ready failed: Result: hostbyte=DID_OK driverbyte=DRIVER_OK :msg, regex, "^sd [0-9]..*[0-9]: .sd[a-z]. Test Unit Ready failed: Result: hostbyte=DID_OK driverbyte=DRIVER_OK" /var/log/hamon-scsi & stop