This article describes how to configure extended logging on QLogic Fiber Channel (FC) Host Bus Adapter (HBA). You may find that a similar procedure applies to other HBAs.

Requirements

• Super user credentials (root) on Xen hosts

• Knowledge of vi or Nano text editor (this article uses the vi editor)

Instructions

The /sys/module/qla2xxx/parameters directory includes parameters for the qla2xxx module. The ql2xextended_error_logging parameter defines whether the driver prints verbose logging information (0 to disable; 1 to enable).

To configure extended logging, complete the following steps:

1. Create new file in /etc/modprobe.d/ directory using the following command:
   # vi /etc/modprobe.d/qlogic

2. Add the following module option at the end of the file:
   options qla2xxx ql2xextended_error_logging=1
   Note: To disable extended logging, use # to comment out the following line:
   #options qla2xxx ql2xextended_error_logging=1

3. Restart the host.

4. Watch the extended logging in /var/log/messages. 
   # tail –f /var/log/message
   Note: Press CTRL+C to exit.

Jan 28 14:05:13 x2 kernel: qla2xxx 0000:06:00.1:
Jan 28 14:05:13 x2 kernel: QLogic Fibre Channel HBA Driver: 8.02.00.k5.xs4.2-02-debug
Jan 28 14:05:13 x2 kernel: QLogic QLE2462 - PCI-Express to 4Gb FC, Dual Channel
Jan 28 14:05:13 x2 kernel: ISP2432: PCIe (2.5Gb/s x4) @ 0000:06:00.1 hdma-, host#=5, fw=4.03.02 [IP]
Jan 28 14:05:13 x2 kernel: scsi(5): Asynchronous LIP RESET (f8f7).
Jan 28 14:05:13 x2 kernel: qla2xxx 0000:06:00.1: LIP reset occured (f8f7).
Jan 28 14:05:13 x2 kernel: scsi(5): LIP occured (f8f7).
Jan 28 14:05:13 x2 kernel: qla2xxx 0000:06:00.1: LIP occured (f8f7).
Jan 28 14:05:13 x2 kernel: scsi(5): Asynchronous LIP RESET (f7f7).
Jan 28 14:05:13 x2 kernel: qla2xxx 0000:06:00.1: LIP reset occured (f7f7).
Jan 28 14:05:13 x2 kernel: scsi(5): Asynchronous P2P MODE received.
Jan 28 14:05:13 x2 kernel: scsi(5): Asynchronous LOOP UP (4 Gbps).
Jan 28 14:05:13 x2 kernel: qla2xxx 0000:06:00.1: LOOP UP detected (4 Gbps).
Jan 28 14:05:13 x2 kernel: scsi(5): Asynchronous PORT UPDATE.
Jan 28 14:05:13 x2 kernel: scsi(5): Port database changed ffff 0006 0000.
Jan 28 14:05:13 x2 kernel: scsi(5): Asynchronous PORT UPDATE ignored 0000/0004/0600.
Jan 28 14:05:13 x2 kernel: scsi(5): Asynchronous PORT UPDATE ignored 0000/0007/0b00.
Jan 28 14:05:13 x2 kernel: scsi(4): qla2x00_reset_marker()
Jan 28 14:05:13 x2 kernel: scsi(4): qla2x00_loop_resync()
Jan 28 14:05:13 x2 kernel: scsi(4): F/W Ready – OK
....................

The ql2xextended_error_logging parameter can also be updated dynamically (on kernels later than 2.6.8) while the driver is loaded. If it does not work, you can remove a module and add it again or restart the whole server.

To enable logging (depending on kernel version), run one of the following commands:

# echo 1 > /sys/module/qla2xxx/ql2xextended_error_logging

# echo 1 >/sys/module/qla2xxx/parameters/ql2xextended_error_logging

To disable logging (depending on kernel version), run one of the following commands:

# echo 0 > /sys/module/qla2xxx/ql2xextended_error_logging

Or

# echo 0 > /sys/module/qla2xxx/parameters/ql2xextended_error_logging