Qlogic Fibre Channel Adapter User Manual

Troubleshooting
Troubleshooting with Driver Logs
FC0054606-00 A A-5
A
Troubleshooting with Driver Logs
All messages from the QLogic FC adapter driver are logged in
/var/log/vmkernel. These messages provide additional information about the
driver operation: both normal and driver warnings. Messages from the driver are
usually preceded by scsi(%d), where %d is the adapter instance number.
The following example shows a snippet from a vmkernel file:
Nov 12 16:11:49 localhost vmkernel: 0:00:00:04.754
cpu1:1036)<6>qla2x00_set_info starts at address = 0x8b0000
Nov 12 16:11:49 localhost vmkernel: 0:00:00:04.754
cpu1:1036)<6>qla2x00: Found VID=1077 DID=2432 SSVID=1077
SSDID=138 pdev=0x2869668
Nov 12 16:11:49 localhost vmkernel: 0:00:00:04.754
cpu1:1036)qla2x00_detect(0): subsys_vend=0x1077 subsys_dev=0x138
Nov 12 16:11:49 localhost vmkernel: 0:00:00:04.754
cpu1:1036)<6>scsi(0): 64 Bit PCI Addressing Enabled.
Nov 12 16:11:49 localhost vmkernel: 0:00:00:04.756
cpu1:1036)<7>scsi(0): Allocated 4096 SRB(s).
Nov 12 16:11:49 localhost vmkernel: 0:00:00:04.756
cpu1:1036)<7>PCI: Setting latency timer of device 1f:00.0 to 64
Nov 12 16:11:49 localhost vmkernel: <6>bnx2: vmnic0 NIC Copper
Link is Up, 100 Mbps full duplex
Nov 12 16:11:49 localhost vmkernel: 0:00:00:06.410
cpu1:1036)scsi(0): Waiting for LIP to complete...
Nov 12 16:11:49 localhost vmkernel: 0:00:00:07.196
cpu1:1036)<6>scsi(0): LOOP UP detected.
Nov 12 16:11:49 localhost vmkernel: 0:00:00:07.502
cpu1:1036)<6>qla2x00_fw_ready ha_dev_f=0x0
Table A-6 lists the more common driver log messages and provides an
explanation of each.
Table A-6. Common Driver Log Messages
"qla2x00_set_info starts at address = xxxxxxxx"
Driver is reporting the starting address where the driver was loaded in case an oops occurs in the driver.
"qla2x00: Found VID=xxxx DID=yyyy SSVID=zzzz SSDID=vvvv"
Driver is reporting which adapter it has found during initialization.
"scsi(%d): Allocated xxxxx SRB(s)"
Driver is reporting the number of simultaneous commands that can be executed by the adapter. The
max_srbs option (see Table 3-1 on page 3-7) can change this number.

Qlogic Fibre Channel Adapter Specifications

General

Brand	Qlogic
Model	Fibre Channel Adapter
Category	Adapter
Language	English

Summary

Preface

Intended Audience

Describes the target users for the guide.

Related Materials

Lists other relevant QLogic and VMware documentation.

What's in This Guide

Documentation Conventions

Explains typographic conventions used in the manual.

License Agreements

Technical Support

Availability

Training

Contact Information

Hardware and Software Components

Hardware Components

Details the physical components of QLogic FC adapters.

Software Components

Describes the software elements related to QLogic FC adapters.

Boot Code

Explains the function of boot code on the adapter.

OS Driver

Details how the OS driver is handled for VMware ESX/ESXi.

Firmware

Describes the role and benefits of the firmware module.

Management Tools and Utilities

Introduces QLogic's management tools for adapters.

QLogic FC Adapters Supported on VMware ESX/ESXi

Lists supported adapter models for VMware environments.

Installation

Supported Features

Lists the features supported by QLogic FC adapters on VMware ESX.

Installing the Hardware

Provides steps for physically installing the FC adapter into a system.

Installing the Driver

Explains the driver installation process for VMware ESX/ESXi.

Installing SANsurfer FC HBA Manager

Details the installation of the SANsurfer FC HBA Manager tool.

Installing SANsurfer FC HBA CLI

Details the installation of the SANsurfer FC HBA CLI utility.

Configuration

Identifying QLogic FC Adapters on VMware ESX

Describes methods to identify FC adapters in VMware ESX systems.

Using the Fast!UTIL BIOS Utility

Explains the Fast!UTIL utility for adapter configuration and diagnostics.

Verifying That the Driver is Loaded

Provides steps to confirm the FC adapter driver is loaded on ESX.

Configuring the Driver Parameters

Details how to set QLogic FC adapter driver parameters using esxcfg-module.

Deploying NPIV for VMware ESX/ESXi

Explains the deployment of N_Port ID Virtualization (NPIV) for FC SANs.

Configuring Boot from SAN

Provides steps for configuring the boot from SAN feature for servers.

Troubleshooting

Troubleshooting with LEDs

Explains how to diagnose issues using adapter LEDs and their patterns.

Dynamic Extended Logging

Describes how to enable and use dynamic extended logging for driver debugging.

Troubleshooting with Driver Logs

Explains how to interpret driver log messages for troubleshooting.

Debugging Using Proc Information

Details how to use /proc information for driver debugging and status.

Collecting System Logs for Troubleshooting

Provides commands to collect system logs for troubleshooting.

Frequently Seen Issues

Lists common issues and their troubleshooting tips.

Glossary

adapter

Defines the term 'adapter' in the context of the document.

boot code

Defines the program that initializes a system or adapter.

boot device

Defines the device used to boot the operating system.

driver

Defines the software interfacing between the file system and hardware.

Fast!UTIL

Defines the QLogic Fast!UTIL FC adapter BIOS utility.