Qlogic Fibre Channel Adapter User Manual

Troubleshooting
Dynamic Extended Logging
A-4 FC0054606-00 A
S
Dynamic Extended Logging
The QLogic driver provides a mechanism to dynamically enable extended error
logging about driver operation. These logs provide debugging and error
information to help you understand driver behavior regarding issues related to the
adapter. These logs are saved in a system log file named vmkernel, in the
/var/log/ directory.
To enable extended error logging, execute the following command:
# echo "scsi-qlaenable-log" > /proc/scsi/qla2300/<adapter_number>
To disable extended error logging, execute the following command:
# echo "scsi-qladisable-log" > /proc/scsi/qla2300/<adapter_number>
When the logging is enabled, the driver version in the
/proc/scsi/qla2300/<adapter number> is appended with a -debug flag
as shown below:
# cat /proc/scsi/qla2300/5
QLogic PCI to Fibre Channel Host Adapter for QLE2462:
Firmware version: 4.04.05, Driver version 7.08-vm62-debug
Boot Code Version:
BIOS : v2.02, Fcode : v2.00, EFI : v2.00
Entry address = 0x8b0000
NOTE:
Although the driver logs provide debugging and error information, they also
increase I/O latency. Therefore, QLogic does not recommend that you
enable extended logging during normal operations.

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.