You are on page 1of 103

Troubleshooting and

Maintenance Manual
for Emulex HBAs
Copyright© 2007 Emulex Corporation. All rights reserved worldwide. No part of this document may be reproduced
by any means nor translated to any electronic medium without the written consent of Emulex Corporation.
Information furnished by Emulex Corporation is believed to be accurate and reliable. However, no responsibility is
assumed by Emulex Corporation for its use; or for any infringements of patents or other rights of third parties which
may result from its use. No license is granted by implication or otherwise under any patent or patent rights of Emulex
Corporation.
Emulex, AutoPilot Installer, BlockGuard, cLAN, FabricStream, FibreSpy, Giganet, HBAnyware, InSpeed, IntraLink,
LightPulse, MultiPulse, SAN Insite, SBOD and Vixel are registered trademarks, and AutoPilot Manager, EZPilot,
SLI and VMPilot are trademarks, of Emulex Corporation. All other brand or product names referenced herein are
trademarks or registered trademarks of their respective companies or organizations.
Emulex provides this manual "as is" without any warranty of any kind, either expressed or implied, including but not
limited to the implied warranties of merchantability or fitness for a particular purpose. Emulex Corporation may
make improvements and changes to the product described in this manual at any time and without any notice. Emulex
Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties
that may result. Periodic changes are made to information contained herein; although these changes will be
incorporated into new editions of this manual, Emulex Corporation disclaims any undertaking to give notice of such
changes.

Troubleshooting and Maintenance Manual for Emulex HBAs Page ii


Overview ................................................................................................................................... 1
Be Informed, Stay Informed ..................................................................................... 1
Isolating the Problem ............................................................................................... 1
Gathering Information Before Contacting Emulex Technical Support....................... 2
Common Problems .................................................................................................................. 2
Hardware Issues...................................................................................................... 2
Link Down................................................................................................................ 2
Can’t See Devices or Drives .................................................................................... 3
Out-of-Date Driver Version ...................................................................................... 4
Emulex Driver Updates...................................................................................... 4
Out-of-Date Firmware Version ................................................................................. 5
Firmware Updates ............................................................................................. 5
LEDs.......................................................................................................................................... 6
Firmware Operation and Port Activity LEDs............................................................. 6
Common LED States ............................................................................................... 6
Power Indicator LEDs........................................................................................ 6
LED Reference.................................................................................................. 6
Emulex Web Site and Emulex Support ................................................................................... 8
Emulex Support Page.............................................................................................. 8
Storage and System Supplier-Qualified and Supported HBAs........................... 8
Emulex Driver Downloads and Documentation.................................................. 8
Emulex Knowledgebase .................................................................................... 8
Product Registration .......................................................................................... 9
Product Repair and Return ...................................................................................... 9
Obtain an RMA for 10 Products or Fewer .......................................................... 9
Check on the Status of an RMA for 10 Products or Fewer................................. 9
Return More than 10 Products, Check RMA Status or Contact
Emulex After -Hours, Weekends or Holidays................................................... 10
Online Support System.................................................................................... 10
The HBAnyware Utility........................................................................................................... 11
Introduction............................................................................................................ 11
Starting HBAnyware from the Desktop ............................................................ 11
HBAnyware Window Element Definitions ........................................................ 12
Starting the HBAnyware Security Configurator ................................................ 14
Resetting the HBA ........................................................................................... 16
Determine the HBA Link State - The General Tab ........................................... 16
Enable or Disable Boot Code - Firmware Tab.................................................. 18
Performing Basic Diagnostic Tests .................................................................. 19
Running Advanced Diagnostic Tests ............................................................... 22
Driver-specific Tools .............................................................................................................. 26
Windows-specific Tools.......................................................................................... 26
UNIX-specific Tools ............................................................................................... 27
Unix (Solaris, Linux and HP-UX) ..................................................................... 27
Linux-specific Tools ......................................................................................... 27
The Offline Utility ................................................................................................................... 28
Introduction............................................................................................................ 28
Prerequisites: ........................................................................................................ 28
Hardware Compatibility.......................................................................................... 28
Using the Offline Utility .......................................................................................... 28
Running the Offline Utility from the Command Prompt .................................... 29
Resetting the HBA - reset................................................................................ 29
Viewing HBA Information ....................................................................................... 29
Troubleshooting and Maintenance Manual for Emulex HBAs Page iii
Viewing the Offline Utility’s Version Information - version ................................ 29
Viewing Vital Product Data - vpd ..................................................................... 30
Viewing Help Syntax for Commands - help ..................................................... 30
Viewing Boot Device Information - readbootdevice ......................................... 31
Viewing BootBIOS Versions - listboot .............................................................. 31
Viewing all HBAs in the System - listhba ......................................................... 31
Viewing WWN of all HBAs in the System - listWWN........................................ 32
Viewing PCI I/O Base Addresses of all HBAs in the System - listIOBase ........ 32
Viewing Firmware Program Revisions - listrev ................................................ 32
Firmware and Boot Code Download Commands ................................................... 33
Downloading a File - download ....................................................................... 33
Accessing the Flash Device Directly - directdownload..................................... 34
World Wide Name Commands............................................................................... 34
Writing WWN and Updating NVPARMS - writeWWN....................................... 34
Reading IEEE Information and Saving It to a File - saveWWN........................ 35
Restoring WWN and Updating NVPARMS - restoreWWN ............................... 35
Boot Code Commands .......................................................................................... 35
Enabling or Disabling BootBIOS - enable/disable............................................ 36
Selecting a Boot Device - setbootdevice ......................................................... 36
Selecting One or More Alternate Boot Devices - setAlBoot ............................. 36
Configuration Commands ...................................................................................... 37
Setting the HBA to Use Soft Jumpers or the Hardware Default - jumper ......... 37
Updating Configuration Regions - config ......................................................... 37
Running Diagnostic Tests ...................................................................................... 38
Running External Loopback Test - extloopback ............................................... 38
Running Internal Loopback Test - intloopback ................................................. 38
Running PCI Loopback Test - pciloopback ...................................................... 38
Using Script Files................................................................................................... 39
Creating Script Files ........................................................................................ 39
Script File Commands ..................................................................................... 39
Creating a logfile - logfile................................................................................. 40
Error Codes ........................................................................................................... 42
The lp6dutil Utility .................................................................................................................. 44
Introduction............................................................................................................ 44
Start lp6dutil .................................................................................................... 44
Use the Menu Bar ........................................................................................... 45
Navigation Tips................................................................................................ 45
Use the Command Line................................................................................... 46
Commands and Syntax Reference Table ....................................................... 47
Reset the HBA....................................................................................................... 48
Perform a Warm Start ............................................................................................ 49
Exit the lp6dutil Utility ............................................................................................ 49
View HBA Information............................................................................................ 50
View Adapter Parameters................................................................................ 50
View DC Bridge Information ............................................................................ 50
View VPD Information ..................................................................................... 51
View PCI Information....................................................................................... 52
View Revision Information ............................................................................... 52
View Service Parameters ................................................................................ 53
View Counter Information ................................................................................ 54
View Link Status Information ........................................................................... 54
View Link Attention Data ................................................................................. 55
View Wakeup Parameters ............................................................................... 56

Troubleshooting and Maintenance Manual for Emulex HBAs Page iv


View Service Level Interface Memory (SLIM) .................................................. 56
View Mailbox ......................................................................................................... 57
View the Registers .......................................................................................... 58
Update Boot Code ................................................................................................. 59
Change the Boot Code State ........................................................................... 59
Load and Update Firmware, Test and Boot Code Files ................................... 60
View and Maintain the Flash Load List ............................................................ 61
View and Maintain Configuration Regions ............................................................. 62
View Configuration Region Information ........................................................... 62
Initialize a Region or Cleaning a Configuration................................................ 63
Set an HBA to Use Soft Jumpers........................................................................... 63
Use Script Files ............................................................................................... 64
View the Log File ................................................................................................... 66
Run Diagnostic Tests ............................................................................................. 67
Select HBAs to Test......................................................................................... 67
Select Tests ..................................................................................................... 68
Configure Tests ............................................................................................... 68
Start Tests ....................................................................................................... 69
Set or Reset Status Word Mask....................................................................... 70
Debug Tasks.......................................................................................................... 71
Dump Memory ................................................................................................. 71
Run Program ................................................................................................... 72
Run Diagnostics .............................................................................................. 72
Try to Recover HBA ........................................................................................ 74
Solaris SFS Driver Console and Log Messages .................................................................. 76
Introduction............................................................................................................ 76
Severity Levels ................................................................................................ 78
Message Log Example .................................................................................... 78
Miscellaneous Events ............................................................................................ 79
Driver Events ......................................................................................................... 79
HBA Initialization Events........................................................................................ 81
Memory Management Events ................................................................................ 82
SLI Events ............................................................................................................. 83
Mailbox Events ...................................................................................................... 85
Node Events .......................................................................................................... 86
Link Events ............................................................................................................ 87
ELS Events............................................................................................................ 88
General I/O Packet Events .................................................................................... 90
FCP Traffic Events................................................................................................. 92
IP Traffic Events .................................................................................................... 92
Solaris SFS Events................................................................................................ 93
IOCTL Events ........................................................................................................ 95
Firmware Download Events ................................................................................... 96
Common Transport Events .................................................................................... 97

Troubleshooting and Maintenance Manual for Emulex HBAs Page v


Overview
This troubleshooting manual provides information on isolating, identifying and solving common
hardware problems. This manual provides information for the following types of problems:
• Hardware problems (see page 2)
• Link down (see page 2)
• Cannot see drives (see page 3)
• Out-of-date driver (see page 4)
• Out-of-date firmware (see page 5)
Other topics covered in this manual include:
• Light emitting diodes (LEDS) - includes a reference table for the many LED states (see “LEDs”
on page 6)
• How to contact Emulex Technical Support (see page 8)
• The Offline Utility (see page 28)
• The lp6dutil Utility (see page 44)
• Event trace message and error log information for these Emulex drivers for Windows and UNIX:
• Storport Miniport driver (see page 96)
• SCSIport Miniport driver (see page 111)
• FC Port driver (see page 126)
• lpfc driver for Linux (see page 135)
• Driver for Solaris (see page 178)
• Driver for HP-UX (see page 217)

Be Informed, Stay Informed


• Read the documentation on the Emulex Web Site. Each host bus adapter (HBA), driver,
firmware and boot code has documentation posted to the Web site. Documentation is also
contained on the CD-ROM disc provided with the HBA.
• Use the Emulex knowledgebase. From the main Emulex Web site, click the support link, then
click the knowledgebase link. This manual also provides some knowledgebase solutions that
may be helpful in finding answers to your problem or question.
Note: The Emulex knowledgebase solutions in this manual are current as of the
manual’s release date. Check the Emulex Web site for any solution updates
or new solutions applicable to your problem or question.

Isolating the Problem


• Isolate the problem to hardware, firmware, driver, or non-HBA (for example, zoning):
• Verify that the HBA firmware version is up-to-date per the original equipment manufacturer
(OEM) or storage vendor (also check for known issues).
• Verify that you have current switch firmware.
• Use a good cable.
• Check HBA and switch LEDs.
• If system hangs, install the HBA in another server.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 1


• Verify that the current HBA driver is installed.
• Verify that cluster software and other storage and third-party applications are up-to-date.
• Check with disk and tape vendors for known issues.
• Reload firmware using the Offline Utility ? download (see page 33).
• Reload firmware using lp6dutil/nr. (see page 60).

Gathering Information Before Contacting Emulex Technical Support


• Collect detailed event logging. Review error log information for your driver.
• Collect required information for returning an HBA before you call Emulex. See page 9 for a
check list. This will save you time.

Common Problems
Hardware Issues
Any of the following symptoms indicate that you may need to return your HBA to Emulex for repair:
• Host system (server) does not pass power-on self test (POST).
• The server does not boot.
• LEDs on the HBA stop flashing or flash an error code.
• The bus has incorrect power.
• Hardware errors are logged in the event log or message file.
• Onboard parity errors.
• Peripheral Component Interconnect (PCI) parity errors.
• Firmware “traps”.
• A physical Fibre Channel (FC) interface problem looks similar to a bad cable but follows the
HBA.
• A high error count is reported by the HBAnyware utility Statistics tab.
• CRC errors, frames out of order, bad frames (replacing the cable may provide a quick fix
to these types of problems)
• Bad HBA optics
See “Product Repair and Return” on page 9 for information on returning your HBA for repair.

Link Down
Any of these symptoms may indicate the cause of a link down:
• Firmware operation and port activity indicate that the link is down.
LEDs are visible through openings in the HBA’s mounting bracket and indicate the conditions
and results of the POST function. A link-down is indicated when the green LED flashes and the
yellow LED is off (see Table 1 on page 6).
• If the HBA has a power LED, the power LED indicates that power is off.
Some HBA models have a separate green 3.3V power indicator LED (see page 6).
• Topology and link speed are improperly matched for the HBA and the devices connected to it.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 2


When the driver loads, it attempts to bring the link up. If the topology and link speed are properly
matched, the link comes up. If there is a mismatch, the link does not come up. If you make
changes to the topology or link speed parameters, you may need to reboot the system.
• The boot code is improperly loaded, enabled or configured.
If the boot code is loaded, enabled and properly configured, the link comes up before the operat-
ing system and the driver are loaded. If boot code is enabled, the link is reset any time the driver
is loaded. If the boot code is not enabled, the link does not come up. If boot code brings the link
up, the link goes down when the HBA is reset.
• The status of the link is other than operational.
Use the HBAnyware utility to determine the link state. Click on the General tab and look at the
Link Status field. If the status is operational, the link is up. If the status is other than operational,
the link is down (see page 16).
• The cable working is not working.
You can use a cable from a known working connection to test. Isolate the problem to the HBA,
the cable or the connected device.
• If you have a loopback connector, the HBA fails the external loopback tests.
If you have isolated the problem to the HBA, run an external loopback tests using the HBAny-
ware utility (see page 23), the Offline Utility (see page 38), or lp6dutil (see page 72).
• The HBA optics do not match the cabling.
If the HBA is single mode or multimode and your cabling is the other type, the link will not come
up.

Can’t See Devices or Drives


Any of the following symptoms indicate why you cannot see drives or other devices:
• All devices are not powered on.
Some HBA models have a separate green 3.3V power indicator LED (see page 6).
• The LEDs indicate that the link is down.
On an HBA, a link-down is indicated when the green LED flashes and the yellow LED is off (see
Table 1 on page 6).
On a switch, the LED states vary depending on the switch vendor. See the switch vendor docu-
mentation.
• The cable is not working.
Make sure you have a good cable. You can test with a cable from a known working connection.
Isolate the problem to the HBA, the cable, or the connected device.
• The driver is improperly installed or loaded.
Verify that a compatible driver is completely installed and loaded. Some devices may require a
specific device driver installed on the host.
• Automap is turned off.
The first time the machine boots with automap off, the devices will not be mapped to the operat-
ing system.
• On the FC Port driver, automap is off by default. It can be enabled with the HBAnyware utility
or elxcfg. See the driver user manual for more information.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 3


• On the Storport Miniport and SCSIport Miniport drivers, automap is on by default. It can be
changed with the HBAnyware utility or the driver-specific lputilnt utility. See the driver user
manual for more information.
• On the driver for Solaris, automap is on by default. It can be changed with the HBAnyware
utility. See the driver user manual for more information.
• On the driver for Linux, lpfc_automap is on by default. It can be changed with the
HBAnyware utility. See the driver user manual for more information.
• On the driver for HP-UX, automap is on by default and automatically assigns SCSI IDs by
World Wide Port Name (WWPN). Three parameters (scan-down, fc-bind and automap)
control how the Emulex driver maps FC devices. You can change parameters at the
command line. See the driver user manual for more information.
• The targets are not discovered.
Use the HBAnyware utility to determine discovered targets.
• To determine the number of discovered targets, click on Discovered Elements in the dis-
covery-tree.
• To view information specific to a target, sort by host name and click on the Target
Attributes tab.
• The switch is configured incorrectly.
The HBA needs to be placed in the proper zone to see the target device.
• The array is configured incorrectly.
Check settings in the Redundant Array of Independent Disks (RAID) system security settings.
Verify that the array knows the HBA’s world wide node name (WWNN).

Out-of-Date Driver Version


Any of these symptoms indicate that you may need to update the driver:
• Target devices appear incorrectly in device manager.
• The Emulex driver operated correctly before cluster services were installed, but now that the
server has rebooted, the cluster will not start or there are connection time-outs.
Verify with the cluster or path management software vendor that you have the latest versions of
software and that you are running Emulex drivers and firmware that are qualified for that soft-
ware.
• Problem with third-party management software.
Verify with the software vendor that you have the latest versions of software and that you are
running Emulex drivers and firmware qualified for that software.
• An operating system error (blue screen) occurs.
• Tape operation problems.

Emulex Driver Updates


You can download the latest Emulex driver and utilities from the Emulex Web site. Click the Drivers,
Downloads and Documentation link to navigate to the Support page. On the Support page, click the link
for your operating system.
• The drivers for Windows support Windows Server 2003, Windows 2000 Server and Windows NT
(No future versions of drivers for Windows NT are planned.)
• The driver kit download includes the base driver, the HBAnyware utility and a driver-specific
utility.
Troubleshooting and Maintenance Manual for Emulex HBAs Page 4
• If you are running Windows Server 2003 or Windows 2000 Server, the driver kit download
includes AutoPilot Installer, which is a quick way to install (or update) Emulex drivers and
utilities and configure HBAs, drivers and utilities. Windows drivers and utilities can be
installed manually without using AutoPilot Installer. This is accomplished by following the
same steps used before AutoPilot Installer was available.
• The driver for Linux supports kernels for Open Source drivers.
• The driver download includes the base driver, and, if it is not included in the applications kit,
the application helper module install script.
• The applications kit includes the HBAnyware utility, the driver-specific lputil utility and the
application helper module.
• The SMI-S Provider kit for RedHat includes the SMI-S HBA Provider, compliant with the
SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite.
• The SMI-S Provider kit for SLES-8 is pre-packaged with OpenPegasus CIMOM v2.3.2, as a
turnkey SMI-S agent for ease of installation and deployment.
• The lpfc driver for Solaris supports several versions of 32-bit and 64-bit operating systems. The
driver kit includes the lpfc base driver, the HBAnyware utility and lputil. Links to the Solaris’ SFS
FCA drivers are provided as well.
• The driver for HP-UX supports PA-RISC and the 64-bit Itanium processor family. The driver kit
download includes the base driver and the lputil utility.
• The driver for NetWare supports several versions of NetWare. The downloads include the base
driver only (no utilities).
• Installation and update procedures and instructions for using the HBAnyware utility and driver-
specific utilities are in the driver user manual. If applicable, instructions for AutoPilot Installer are
in the quick installation manual and the complete user manual.

Out-of-Date Firmware Version


Any of the following symptoms indicate that you may need to update your firmware:
• The FC link fails to come up or stay up.
• Mailbox time-out errors in the operating system event log or the UNIX message file.
• One or more LEDs has stopped flashing.
• System hangs.
• Lower than expected performance.

Firmware Updates
You can download the latest Emulex firmware from the Emulex Web site. Click the Drivers, Downloads
and Documentation link to navigate to the Support page. On the Support page, click the link for your
HBA model. A page appears with downloads for firmware, boot code and drivers. Download the
firmware, and then use the HBAnyware utility or a driver-specific utility to update the firmware on the
HBA.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 5


LEDs
Firmware Operation and Port Activity LEDs
Emulex HBAs have a POST function. Green and yellow LEDs are visible through openings in the HBA's
mounting bracket. These LEDs indicate the conditions and results of the POST function. Green indicates
firmware operation, and yellow signifies port activity. Each port has a corresponding set of green and
yellow LEDs. HBA LEDs identify possible problems. For more information on LED states, see Table 1 on
page 6.
LEDs will help you locate:
• Bad cables.
• Bad transceivers.
• Bad switches or hub ports.
LEDs will help you determine whether:
• The switch or hub is on.
• The driver is loaded.
• The driver reset the HBA.

Common LED States


Although the HBA LED has many possible states, the three most common are:
• Normal link-up
• Link-down or HBA waiting
• Heart-beat indication

Power Indicator LEDs


In addition to the firmware operation and port activity LEDs, some HBA models have a separate green
3.3V power indicator LED.
• HBA models LP9402DC, LP1050, LP1050DC, LP10000 and LP10000 have an LED located on
the upper back corner of the HBA (not the mounting bracket). If lit, the HBA has power.
• HBA model LP9002C has an additional LED on the mounting bracket labeled, “Power”. If this
LED is lit, the cPCI bus slot is supplying 3.3V power to the HBA.

LED Reference
Table 1: LED Reference Table

Yellow LED Green LED State

Off Off Wake-up failure (dead board)

On Off POST failure (dead board)

Slow blink Off Wake-up failure monitor

Fast blink Off POST failure

Flashing Off POST process in progress

Troubleshooting and Maintenance Manual for Emulex HBAs Page 6


Table 1: LED Reference Table (Continued)

Off On Failure while functioning

On On Failure while functioning

4-Gb HBAs:
1 blink On 1-Gb link rate - normal, link up
2 blinks On 2-Gb link rate - normal, link up
3 blinks On 4-Gb link rate - normal, link up

2-Gb HBAs:
Slow blink On 1-Gb link rate - normal, link up
Fast blink On 2-Gb link rate - normal, link up

Off Slow blink Normal - link down or not started

Slow blink Slow blink Off-line for download

Fast blink Slow blink Restricted offline mode (waiting for restart)

Flashing Slow blink Restricted offline mode (test active)

Troubleshooting and Maintenance Manual for Emulex HBAs Page 7


Emulex Web Site and Emulex Support
Emulex Support Page
The Emulex Support page contains links to the following:
• Storage and system supplier-qualified and supported HBAs
• Emulex driver, downloads and documentation
• Emulex knowledgebase
• Product registration
The Emulex Support page is part of the Emulex Web site at www.emulex.com.

Storage and System Supplier-Qualified and Supported HBAs


Most system and storage suppliers market and sell Emulex products under their own respective brands
and qualify Emulex drivers, software and documentation for these products. The Support page provides
qualified drivers, software and documentation as well as support information for suppliers of Emulex
products.

Emulex Driver Downloads and Documentation


The Emulex Support page contains downloads and documentation for several driver types, boot code
and firmware for each Emulex HBA model.

Emulex Knowledgebase
The searchable Emulex knowledgebase is an on-going effort to provide you with answers to questions
regarding all facets of Emulex products. Information is provided for older (legacy) products as well as for
current products. Knowledgebase topics are stored by knowledgebase solution ID (solution number). A
link to the Emulex knowledgebase is available from the Support page.
Search for information using the knowledgebase:
• By a word or phrase:
• Conduct a general search by entering one word (such as “Storport”) in the Keywords
field or by entering multiple words and choosing Any as the match method.
• Conduct a specific search by entering multiple words and choosing All as the match
method.
• By the solution ID:
• Enter a 1-5 digit solution ID in the Solution ID field (you must know the solution ID to
conduct this search).

Troubleshooting and Maintenance Manual for Emulex HBAs Page 8


Product Registration
Use this page to register your product online. You need the following information to register your
product:
• Customer name
• E-mail address
• Fax number
• Company name
• Contact name
• Address (street, city, state and zip code)
• Product model or part number
• Product serial number
• Purchase date

Product Repair and Return


Whether you contact Emulex through the Emulex Web site, by e-mail or by telephone, gather the
following information before you contact Emulex:
• Bill to and ship to company and address
• Model number
• Part number - required on all products to be returned
• Serial number - required on all products to be returned
• Purchase date - required for all cLAN products
• Description of failure

Note: Model and serial numbers are located on bar code labels on the product
itself. Record the information from the bar code label and not the packaging.

Obtain an RMA for 10 Products or Fewer


To return your product to Emulex for repair or replacement, you must obtain authorization using the RMA
request form for up to 10 units. Return products one of these ways:
• RMA form - Use this online Return Material Authorization form to return up to 10 units.
• E-mail service - Send an e-mail message to the Emulex service department.

Check on the Status of an RMA for 10 Products or Fewer


Call the Emulex Support Services Repair Hotline to check on the status of an existing RMA:
In the Americas:
• Telephone:
800-752-9068, select option 2 and then option 3
In Europe:
• Telephone:
(44) 1189-772929
In Asia:

Troubleshooting and Maintenance Manual for Emulex HBAs Page 9


• Telephone (call the Emulex 800 number, Monday through Friday, between 7:00 AM to 4:00 PM
(Pacific Time)
In China, Philippines: 00 + 1+ 800-752-9068, select option 2 and then option 3
In Japan, South Korea: 001 + 1 + 800-752-9068, select option 2 and then option 3
In Taiwan: 002 + 1 + 800-752-9068, select option 2 and then option 3

Return More than 10 Products, Check RMA Status or Contact


Emulex After -Hours, Weekends or Holidays
Phone to check repair status or return more than 10 products. Also, phone if you have after-hours,
holiday or weekend issues.
Within the Americas and in Asia:
• E-mail address:
tech.support@emulex.com
• Telephone:
800-752-9068, option 2.
Within Europe:
• E-mail address:
tech.support@emulex.com
• Telephone:
(44) 1189-772929

Online Support System


Open new cases and check the status of existing cases by clicking the online support link on the Emulex
Support page. The online support system is available on all non-holiday work days, Monday through
Friday, 7:00 AM to 4:00 PM (Pacific Time). If you have after-hours holiday or weekend issues, telephone
Emulex Technical Support.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 10


The HBAnyware Utility
Introduction
The HBAnyware utility runs on Windows, Solaris and Linux systems. The HBAnyware utility incorporates
driver-based technology to enable complete management of Emulex HBAs, including the ability to
upgrade firmware anywhere in a FC or Internet SCSI SAN from a single console.

Starting HBAnyware from the Desktop


After the HBAnyware server has been installed, access the utility from the desktop Start menu.
To start HBAnyware for Windows:
• On the Windows desktop, click Start, Programs /HBAnyware.
Initially discovery information for the host appears:

Figure 1: HBAnyware Utility, Discovery Information (Example)

The HBAnyware utility contains five basic elements: the menu bar, the toolbar, the discovery-tree, the
property tabs and the status bar (see “HBAnyware Window Element Definitions” on page 12).
The element that you select in the discovery-tree determines whether a menu item or toolbar icon is
active. For example, if you select the local host or other system host, the Reset Adapter item on the
Adapter menu becomes unavailable. The Reset Adapter toolbar button becomes unavailable as well.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 11


HBAnyware Window Element Definitions

Figure 2: HBAnyware Utility Window with Element Call Outs

The Menu Bar


The menu bar contains command menus that enable you to perform a variety of tasks such as exiting
HBAnyware, resetting HBAs and sorting items in the discovery-tree. Many of the menu bar commands
are also available from the toolbar.

The Toolbar
The toolbar contains buttons that enable you to refresh the discovery-tree, reset the selected HBA and
sort the discovery-tree. The toolbar is visible by default. Many of the toolbar functions are also available
from the menu bar.
Use the Toolbar item in the View menu to hide/view the toolbar. If the menu item is checked, the toolbar
is visible.

The Toolbar Buttons

Click Rediscover to refresh the discovery-tree display.

Click Reset to reset the selected HBA.

Sort Toolbar Buttons


Sort discovered HBAs by host name, fabric addresses or local HBAs. By default, HBAs are sorted by
host name, with local HBAs appearing first.
Show only local or remote HBAs. See page 51 for details on sorting buttons.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 12


Sort by host name (default)

Sort by fabric address

Local HBAs only

Help

Discovery-Tree
The discovery-tree (left pane) shows icons that represent discovered network SAN elements (local host
name, system host names and all HBAs active on each host). Targets and LUNs, when present, are also
displayed.

Figure 3: HBAnyware Utility, Discovery-Tree

Discovery-Tree Icons
Discovery-tree icons represent the following:

The local host.

Other hosts connected to the system.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 13


A green HBA icon with black descriptive text represents an online HBA.

A gray HBA icon with red descriptive text represents an HBA that is offline or otherwise temporarily
inaccessible. Several situations could cause an offline or inaccessible HBA:
• The HBA on a local host is not connected to the network, but is still available for local access.
• The HBA on a local host has malfunctioned and is inaccessible to the local host as well as the
network.
• The HBA on a local host is busy performing a local download and therefore temporarily
inaccessible to the local host as well as the network.

The target icon represents connections to individual storage devices.

The LUN icon represents connections to individual LUNs.

Property Tabs
The property tabs display configuration, statistical and status information for network elements. The set
of available tabs is context-sensitive, depending on the type of network element or HBA currently
selected in the discovery-tree.

Status Bar
As you navigate through the menu bar or the toolbar, help messages appear on the status bar near the
bottom of the HBAnyware window.
The status bar is visible by default. Use the Status Bar item in the View menu to hide the status bar. If
checked, the status bar is visible.

Management Mode
The management mode determines whether you can manage HBAs on the host. If you cannot manage
HBAs from the host, the host has restricted access. See the driver user manual for more information on
setting and changing the management mode.

Starting the HBAnyware Security Configurator


You can use the HBAnyware security package to control which HBAnyware systems can remotely
access and manage HBAs on other systems in a FC network. HBAnyware security is systems-based,
not user-based. Anyone with access to a system that has been granted HBAnyware client access to
remote HBAs can manage those HBAs. Any unsecured system is still remotely accessible by the
HBAnyware client software (HBAnyware utility). See the driver user manual for more information on the
HBAnyware Security Configurator.

Note: Before you start the Security Configurator, you must make sure that all of the systems
that are part of, or will be part of, the security configuration are online on the FC network
so that they receive updates or changes made to the security configuration.

Any system already part of the security installation might not run with the proper security
attributes if updates to the security configuration are made while it is offline. Any system
that is part of the security installation and that is offline when the Security Configurator
starts will not be available for security configuration changes even if it is brought online
while the Security Configurator is running.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 14


To start the HBAnyware Security Configurator for Windows Server 2003 or Windows 2000 Server:
1. On the desktop, click Start, then select Programs/ HBAnyware Security Configurator. The
HBAnyware Security Configurator Discovery window appears:

Figure 4: HBAnyware Security Configurator Discovery Window

2. After discovery is completed, the HBAnyware Security Configurator appears.

Figure 5: HBAnyware Security Configurator, Access Control Group Tab

Troubleshooting and Maintenance Manual for Emulex HBAs Page 15


Resetting the HBA
To reset the HBA:
1. Start HBAnyware.
2. In the directory-tree, click the HBA you want to reset.
3. Do one of the following:
• From the menu bar, click Adapter, and then Reset Adapter.

• Click the button.


The following warning screen appears:

Figure 6: HBAnyware Utility, Reset Warning Screen


4. Click Yes on the warning screen to proceed with the reset.
The reset may require several seconds to complete. While the HBA resets, “Reset in progress” is
displayed in the status bar. “Ready” is displayed in the status bar when reset has finished.

Determine the HBA Link State - The General Tab


The General tab contains general HBA information. The Status field indicates the current HBA link state.
In the discovery-tree, a green HBA icon with black descriptive text represents an online HBA.
“Operational” appears in the Status field on the General tab. Operational indicates that the HBA is
connected to the network and operating normally. Figure 7 is an example of the HBA in an operational
state.

Figure 7: HBAnyware Utility, General Tab Example

Troubleshooting and Maintenance Manual for Emulex HBAs Page 16


Adapter Summary Field Definitions
Model - the Emulex HBA model number.
Port WWN - the WWPN of the HBA.
Node WWN -the WWNN of the selected HBA.
Fabric Name or Host Name - the Fabric Name field is displayed if you selected Sort by Host Name. The
fabric name is a 64-bit worldwide unique identifier assigned to the fabric. The Host Name field is
displayed if you selected Sort by Fabric ID. The host name is the name of the host containing the HBA.
Driver Version - the version of the driver installed on the HBA.
Firmware Version - the version of Emulex firmware currently active on the HBA.
Driver Name - the executable file image name for the driver as it appears in the Emulex driver download
package.
Boot BIOS - indicates whether the boot code is enabled or disabled.

Adapter Status Field Definitions


• State - The current operation state of the HBA: Up or Down.
• Link Status - the current link status between the HBA and the fabric. There are several possible
states:
• The operational state indicates that the HBA is connected to the network and operating
normally.
• All other states indicate the HBA is not connected to the network. Gray HBA icons with red
descriptive text indicate an offline HBA. These offline states are:
• User offline - the HBA is down or not connected to the network.
• Bypassed - the HBA is in FC discovery mode.
• Diagnostic Mode - the HBA is controlled by a diagnostic program.
• Link Down - there is no access to the network.
• Port Error - the HBA is in an unknown state; try resetting it.
• Loopback - an FC-1 mode in which information passed to the FC-1 transmitter is
shunted directly to the FC-1 receiver. In loopback mode, the FC interface loopback sig-
nal overrides any external signal detected by the receiver.
• Unknown - the HBA is offline for an unknown reason.
• Link Speed - the link speed of the HBA in gigabits per second.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 17


Enable or Disable Boot Code - Firmware Tab
Use the Firmware tab to view current firmware versions and update firmware and boot code on remote
and local HBAs.

Figure 8: HBAnyware Utility, Firmware Tab

Firmware Area Field Definitions


• Firmware Version - the Emulex firmware version number installed on the HBA.
• Operational Firmware Name - if visible, the name of the operational firmware.
• Initial firmware - the firmware version stub responsible for installing the Service Level Interface
(SLI) code into its proper slot.
• SLI-1 Firmware Name - the name of the SLI-1 firmware overlay.
• SLI-2 Firmware Name - the name of the SLI-2 firmware overlay.
• Kernel Version - the version of the firmware responsible for starting the driver

Firmware Buttons
• Update Firmware - click to open the HBAnyware utility Firmware Download dialog box and
update firmware. Using the HBAnyware Firmware Download dialog box, browse to the file you
wish to download and download the file.
• Enable/Disable - click to enable or disable the boot code.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 18


Performing Basic Diagnostic Tests
Use the Diagnostics tab to do the following:
• Run these tests on Emulex HBAs installed in the system:
• PCI Loopback (see page 23)
• Internal Loopback (see page 23)
• External Loopback (see page 23)
• POST (see page 20)
• Echo Test (see page 24)
• Quick Test (see page 19)
• Perform a diagnostic dump (see page 21).
• View PCI registers and wakeup parameter (see page 22).
• Control HBA beaconing (see page 21).

Figure 9: HBAnyware Utility, Diagnostics Tab

All functions are supported locally and remotely, except for the dump feature which is only supported
locally.

Running a Quick Test


The Quick Test consists of 50 PCI Loopback test cycles and 50 Internal Loopback test cycles.
To run a quick test:
1. Start HBAnyware.
2. From the discovery-tree, select the HBA on which you wish to run the Quick Test.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 19


3. Select the Diagnostics tab and click Quick Test. The following message appears:

Figure 10: HBAnyware Utility, Quick Test Message


4. Click OK to run the test. The Quick Diagnostics Test message shows the PCI Loopback and
Internal Loopback test results.

Figure 11: HBAnyware Utility, Quick Diagnostics Test Results

Running POST
A POST is a firmware test normally performed on an HBA after a reset or restart. A POST does not
require any configuration to run.
To run a POST:
1. Start HBAnyware.
2. From the discovery-tree, select the HBA on which you wish to run a POST.
3. Select the Diagnostics tab and click Power-on Self Test (POST). A warning dialog box appears
(see Figure 11).
4. Click OK. A POST Test window shows POST test information.

Figure 12: HBAnyware Utility, POST Test Window

Troubleshooting and Maintenance Manual for Emulex HBAs Page 20


Using Beaconing
The beaconing feature enables you to force a specific HBA’s LEDs to blink in a particular sequence. The
blinking pattern acts as a beacon, making it easier to locate a specific HBA among racks of other HBAs.
When you enable beaconing, the two LEDs blink rapidly in unison for 24 seconds, after which the LEDs
report the HBA health status for 8 seconds. When the 8 seconds are up, the HBA returns to beaconing
mode. This cycle repeats indefinitely until you disable this feature or you reset the HBA.

Note: The beaconing buttons are disabled if the selected HBA does not support
beaconing.

To enable/disable beaconing:
1. Start HBAnyware.
2. From the discovery-tree, select the HBA whose LEDs you wish to set.
3. Select the Diagnostics tab and click Beacon On or Beacon Off.

Starting a Diagnostic Dump

Note: The Diagnostic Dump feature is only supported for local HBAs. If a remote
HBA is selected from the tree-view, the Initiate Diagnostic Dump is disabled.

To start a diagnostic dump:


1. Start HBAnyware.
2. From the discovery-tree, select a local HBA whose diagnostic information you want to dump.
3. Select the Diagnostics tab and click Diagnostic Dumps. The Diagnostic Dump dialog box
appears. You can specify how many files you want to save using the Files Retained counter.
Click Delete Existing Dump Files if you wish to remove existing dump files from your system.

Figure 13: HBAnyware Utility, Diagnostic Dump Dialog Box


4. Click Start Dump.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 21


Displaying PCI Registers and Wakeup Information
A PCI Register dump for the selected HBA appears in the lower left panel of the Diagnostics tab.
Wakeup information for the selected HBA appears in the lower right panel of the Diagnostics tab. The
information is read-only and is depicted below:

Figure 14: HBAnyware Utility, PCI Registers and Wakeup Parameters Area of the Diagnostics Tab

Running Advanced Diagnostic Tests


The Advanced Diagnostics feature gives you greater control than the Quick Test over the type of
diagnostics tests that run. Through Advanced Diagnostics, you can specify which tests to run, the
number of cycles to run, and what to do in the event of a test failure.
To run advanced diagnostics tests:
1. Start HBAnyware.
2. Click Advanced Diagnostics Test on the Diagnostics tab to view the Advanced Diagnostics
dialog box.
You can run four types of tests:
• PCI Loopback
• Internal Loopback
• External Loopback
• ECHO
Note: You cannot run the External Loopback test and ECHO test concurrently. If you select
External Loopback the ECHO test section is disabled and vice versa.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 22


All test results, plus the status of running tests, are time stamped and appear in the log at bottom of the
dialog box.

Figure 15: HBAnyware Utility, Advanced Diagnostics

Running Loopback Tests


To run a loopback test, use the Loopback Test section of the Advanced Diagnostics dialog box.
You can run the following loopback test combinations using the appropriate boxes:
• PCI Loopback Test - A firmware-controlled diagnostic test in which a random data pattern is
routed through the PCI bus without being sent to an HBA link port. The returned data is
subsequently validated for integrity.
• Internal Loopback Test - A diagnostic test in which a random data pattern is sent down to an
HBA link port, then is immediately returned without actually going out on the port. The returned
data is subsequently validated for integrity.
• External Loopback Test - A diagnostic test in which a random data pattern is sent down to an
HBA link port. The data goes out the port and immediately returns via a loopback connector. The
returned data is subsequently validated for integrity.

Note: You cannot run the External Loopback test and ECHO test concurrently. If you select
External Loopback the ECHO test section is disabled and vice versa.

You can specify the number of test cycles by clicking one of the cycle counts values in the Test Cycles
section of the dialog box or enter a custom cycle count if you wish. The Test Status section displays how
many cycles of each test ran. The Error Action section of the dialog box enables you to define what
should be done in the event of a test failure.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 23


There are two error action options:
• Stop Test - The error will be logged and the test aborted. No further tests will run.
• Ignore - Log the error and proceed with the next test cycle.
To run loopback tests:
1. Start HBAnyware.
2. From the discovery-tree, select the HBA on which you wish to run the Loopback Test.
3. Select the Diagnostics tab and click Advanced Diagnostics Tests. From the Loopback Test
section of the dialog box, choose the type of Loopback test you wish to run and define the
loopback test parameters.

Note: You must insert a loopback plug in the selected HBA before running an
External Loopback test.

4. Click Start. The following warning appears:

Figure 16: HBAnyware Utility, Advanced Diagnostic Tests Warning


5. Click OK. If you choose to run an External Loopback test the following window appears:

Figure 17: HBAnyware Utility, Advanced Diagnostic Tests Warning for External Loopback
6. Click OK. The progress bar indicates that the test is running.
Periodic test feedback, consisting of the current loopback test/cycle plus the completion status
of each type of test, is displayed in the Test Log section of the dialog box. Click Clear to erase
the contents of the log display or click Save to File to save the log file.

Running ECHO Test


Run echo tests using the ECHO Test section of the Diagnostics tab. The end-to-end test enables you
send an ECHO command/response sequence between an HBA port and a target port.
Note: Not all remote devices respond to an echo command.

You cannot run the ECHO test and the External Loopback test concurrently. If you
select the ECHO Test the External Loopback test is disabled.

To run end-to-end echo tests:


1. Start HBAnyware.
2. From the discovery-tree, select the HBA from which you wish to initiate the ECHO Test.
3. Select the Diagnostics tab. Click Advanced Diagnostics Test.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 24


4. Do one of the following:
• Check Echo Test. Enter the WWPN for the target.
• Click Select From List if you do not know the actual WWPN of the test target. The
Select Echo Test Target dialog box appears. Select the port you wish to test from the
tree-view and click Select.
All relevant information for the selected port is automatically added to the Target Identifier sec-
tion of the Diagnostics dialog box.

Figure 18: HBAnyware Utility, Select Echo Test Target Window


5. Click Start. The following warning window appears:

Figure 19: HBAnyware Utility, Advanced Diagnostic Tests Warning


6. Click OK. A result screen appears and the test results appear in the Test Log. Click Clear to
erase the contents of the log display or click Save to File to save the log file.

Saving the Log File


You can save the test log to a log file for later viewing or printing. When new data is written to a saved
file, the data is appended to the end of the file. Each entry has a two-line header that contains the
identifier of the HBA being tested and the date and time of the test. Over time, the data accumulates to
forms a chronological history of the diagnostics performed on the HBA.
After writing an entry into the log, you are prompted to clear the display.
The default name of the saved file is DiagTestLog.log and by default is located in:
/usr/sbin/hbanyware/Dump

Troubleshooting and Maintenance Manual for Emulex HBAs Page 25


An example of a saved log file appears below:

Figure 20: Diag Testlog Window

To save the log file:


1. After running a test from the Diagnostic Test Setup dialog box, Click Save to File. The Select
Diagnostic Log file Name dialog box appears. The default name of a saved file is
DiagTestLog.log.
2. Browse to the desired directory, change the log file name if you wish and click Save.

Driver-specific Tools
In addition to the HBAnyware utility, Emulex provides Windows-specific and UNIX-specific utilities.

Windows-specific Tools
• The lputilnt utility is provided for the SCSIport Miniport and the Storport Miniport drivers. Use
lputilnt to identify problems on the local HBA only. See the driver user manual for more
information on lputilnt.
• The elxcfg utility is provided for the FC Port driver. Use elxcfg to identify problems on the local
HBA only. See the driver user manual for more information on elxcfg.
• Error and event logs (see page 96).
• Registry dump (see the driver user manual for parameter descriptions).
• The FC Information Tool (FCINFO, or FCIT) is available directly from Microsoft and runs only on
x86 platforms. FCINFO is a tool used to discover SAN resources and configuration information
on the FC SAN. To download this tool, access the Microsoft Web site and search for “fcinfo” on
the Downloads page. This tool provides local information such as:
• List of HBA WWNs.
• Versions of installed firmware/driver.
• List of discovered targets.
• Statistics about installed HBAs.
The following Emulex drivers are compatible with FCINFO:
• Storport Miniport driver, version 1.03 (or later)
• SCSIport Miniport driver, version 5.10a10 (or later)

Troubleshooting and Maintenance Manual for Emulex HBAs Page 26


UNIX-specific Tools

Unix (Solaris, Linux and HP-UX)


• The lputil utility is a command-line interface. Use lputil to identify problems on the local HBA
only. See the driver user manual for more information on lputil.
• Message file logs (see page 132).
• lpfc.conf, sd.conf (disk), st.conf (tape) files. See the driver user manual for more information.

Linux-specific Tools
Use Linux-specific tools to do the following:
• Boot from SAN with Linux and Emulex HBAs.
• Access the No-Reboot Dynamic Target/LUN Discovery Tool.
• Access the System Grab Diagnostic Tool.
• Re-insert an offline device (lun_change_state.sh).
• Adjust time-out for array behavior (set_target_timeout.sh).
See the driver user manual for more information on Linux-specific tools. Also, see the Linux tools, which
are available from the Linux page in the Support section of the Emulex Web site.
.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 27


The Offline Utility
Introduction
The Offline Utility is an Emulex program to configure Emulex HBAs before a server operating system is
installed or booted.The Offline Utility can be used with Microsoft MS-DOS or FreeDOS.
You can use the Offline Utility to do the following:
• View information on Emulex HBAs
• Reset the HBA
• Download firmware and boot code files
• Select a boot device
• Read and update worldwide names
• Enable BootBIOS
• Update configuration regions
• Set up the HBA to use soft jumpers
• Run diagnostic tests
• Read and process script files

Prerequisites:
• The Offline Utility on a bootable media with MS-DOS or FreeDOS.

Hardware Compatibility
The Offline Utility supports:
• All current Emulex HBAs
• Up to 12 HBAs on one system

Using the Offline Utility


• Commands are not case-sensitive.
• Commands require one space between the command name and the first argument and one
space between additional arguments. There is no space before or after the equal sign within an
argument.
• World Wide Name (WWN) values are reported and specified with two 8-byte hexadecimal words
— WWN word 0 (w0) and WWN word 1 (w1). The w0 and w1 values are concatenated together
for the full WWN.
• The Offline Utility detects the number of HBAs it can support if your system has limited memory
(530 KB or less). If your system has limited memory, a message specifies an additional
argument you must add to each command, such as:
"Insufficient Memory to support 8 adapters. Use max=7 at the end of EACH command."
As directed in the message, you would need to add max=7 to the end of each command. In this
example, if your system had eight HBAs and you entered max=7 at the end of a command, only
the first seven HBAs would be seen by the Offline Utility. If your system has more than 530 KB of
memory, the Offline Utility can support up to twelve HBAs and no Insufficient Memory message
is displayed.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 28


Running the Offline Utility from the Command Prompt
Note: You cannot start the Offline Utility at the DOS prompt in Windows.

1. Boot the system with MS-DOS or FreeDOS.


2. You can start the Offline Utility with a valid command or a valid script file name.
• To start the Offline Utility with a command, from the directory where the DOSLPCFG.exe file
resides, type:
doslpcfg <valid command>
• Example of starting the Offline Utility with a reset command:
doslpcfg reset n=2 s=1

• To start the Offline Utility with a script file name, from the directory where the
DOSLPCFG.exe file resides, type:
doslpcfg @<script file name>
• Example of starting the Offline Utility with script1.txt in the c:\test directory:
doslpcfg @C:\test\script1.txt
Note: To redirect screen output to a file, add >filename at the end of each command.

Example:
DOSLPCFG listboot n=1 >result.out

Note: For more information on script files, See “Creating Script Files” on page 39 and
“Script File Commands” on page 39.

Resetting the HBA - reset


This command resets one specific HBA or all HBAs in the system. The s argument determines whether
POST is skipped when the HBA(s) restart. Enter s=1 to skip POST or s=0 to run POST. The s argument
is not optional for this command.
• To reset the HBA, type:
doslpcfg reset n=<all/adapter number> s=<skip POST argument>
• The following example resets all HBAs in the system and runs POST when the HBAs restart.
doslpcfg reset n=all s=0

Viewing HBA Information

Viewing the Offline Utility’s Version Information - version


This command displays the Offline Utility’s version information.
• To view this information, type:
doslpcfg version
• Sample response:
DOSlpcfg version 1.0a8 released on May 26, 2007.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 29


Viewing Vital Product Data - vpd
This command displays the vital product data (VPD) contents of the HBA specified by its number.
• To display VPD, type:
doslpcfg vpd n=<adapter number>
• The following example displays VPD for HBA #2:
doslpcfg vpd n=2
• Sample response:

Model: LP250048-900
Serial Number: 0003
Port Number:
Model Description:
EMULEX LIGHTPULSE LP250048-900 2 GIGABIT PCI FC ADAPTER
Program Type:
T2: 0xB2, 0xB8, T3: 0xB1, 0xB2, 0xB3, 0xB5, 0xB6, 0xB7, T6: 0xB2, T7: 0xB2

Viewing Help Syntax for Commands - help


• To view all available commands, type:
doslpcfg help
or
doslpcfg ?
• To view syntax for a specific command, type:
doslpcfg help <command>
or
doslpcfg ? <command>
For example,
doslpcfg help download
or
doslpcfg ? download
both return a response similar to the following:

download <n=adapter> <i=imagepath>


or
download <a=adaptertype> <i=imagepath>

Troubleshooting and Maintenance Manual for Emulex HBAs Page 30


Viewing Boot Device Information - readbootdevice
This command shows the WWN, the LUN (in decimal format) and the topology of the currently selected
boot device.
• To show this information, type:
doslpcfg readbootdevice n=<adapter number>
• The following example reads WWN and LUN for HBA #1:
doslpcfg readbootdevice n=1
• Sample response:
Boot Device WWN: 104AC6D2 C920A4D6
Boot Device LUN: 43
Topology Point-to-Point

Viewing BootBIOS Versions - listboot


This command lists all the BootBIOS versions with indexes (base 1) and their code names, that are
loaded in the flash of the HBA specified by its number. If the selected HBA does not have any BootBIOS
loaded, error code 39 is returned.
• To list BootBIOS versions, type:
doslpcfg listboot n=<adapter number>
• The following example lists BootBIOS versions that are loaded on HBA #3:
doslpcfg listboot n=3
• Sample Response:

boot 1 (enabled): RB1.60A7


boot 2 (disabled): RB1.52A1

Viewing all HBAs in the System - listhba


This command lists all installed HBAs in the system. Information includes the HBA number (base 1),
WWN, the functional firmware, the HBA type and possible mailbox errors.
• To list all HBAs in the system, type:
doslpcfg listhba
• Sample response:
adapter 1: 10000000 C920A4B3 Functional FW: ES1.91A0 LP250048-900
adapter 2: WWN err. !!! ReadRev Error !!! LP8000
adapter 3: 10000000 C920B4C2 Functional FW: CS3.81A3 LP850
adapter 4: 10000000 C920A6D1 Functional FW: CS3.90A4 LP9000
adapter 5: 10000000 C920C6B4 Functional FW: HS1.00A2 LP9802
adapter 6: 10000000 C920E4B6 Functional FW: RS3.90A6 LP950

Troubleshooting and Maintenance Manual for Emulex HBAs Page 31


Viewing WWN of all HBAs in the System - listWWN
This command lists all HBAs installed in the system and shows the factory-assigned WWN, the Non-
volatile WWPN and the WWNN used to identify an HBA in the SAN.
The factory-assigned WWN is listed in two parts and is an Institute of Electrical and Electronic Engineers
(IEEE) address that cannot be changed in the field. Concatenate 10000000 and the number that follows
in the response to obtain the WWN.
The non-volatile WWPN and WWNN can be modified using the write WWN command or the
scriptWWPN and scriptWWNN commands. For more information on the WWN, see “Writing WWN and
Updating NVPARMS - writeWWN” on page 34.
If the system does not have any Emulex HBAs installed, error code 45 is returned.
• To show information, type:
doslpcfg listWWN
• Sample response:
adapter 1: LP250048-900 Config IEEE 10000000 C920B2F4 Non-Volatile WWPN: 2AB148C6
46A2D3F2, WWNN: 4B5C6D8E
12345678
adapter 2: LPe11000 Config IEEE 10000000 C920DAB8 Non-Volatile WWPN: 5AB0E2F4
B620DAB8, WWNN: 46A0B4DA
E2F4C8A0

where the Config IEEE is the original IEEE address from manufacturing, obtained from Configu-
ration Region 16 or 32. The Non-Volatile WWPN and WWNN are the port name and node name
(respectively) you have written using the scriptWWPN and scriptWWNN commands (respec-
tively) or the WWNN command.

Viewing PCI I/O Base Addresses of all HBAs in the System - listIOBase
This command lists the PCI I/O base addresses of all HBAs present. If the system does not have any
Emulex HBAs installed, error code 45 is returned.
• To list PCI I/O base addresses, type:
doslpcfg listIoBase
• Sample response:

adapter 1: 00001800
adapter 2: 00002000
adapter 3: 00001000
adapter 4: 00001400
adapter 5: 00001600
adapter 6: 00001300

Viewing Firmware Program Revisions - listrev


This command shows firmware versions that are loaded in the flash of the HBA, specified by its number.
• To show revisions, type:
doslpcfg listrev n=<adapter number>

Troubleshooting and Maintenance Manual for Emulex HBAs Page 32


• The following example lists information for HBA #3:
doslpcfg listrev n=3
• Sample response:
Chipset Rev:
BIU: 1001206D
SM: 00000000
SM FW: 07B21950
ENDEC: 00000000
FW Rev:
Current FW: SLI-2 Overlay
Kernel Rev: FFB01314
Kernel LP250048-9001.30a4
Init FW: LP250048-900Init Load 1.91a0 (ES1.91A0)
SLI-1: LP250048-900Overlay 1.91a0 (E1M1.91A0)
SLI-2: LP250048-900Overlay 1.91a0 (E2M1.91A0
FC-PH Version Supported:
Highest FC-PH Version Supported = 4.3
Lowest FC-PH Version Supported = 4.3

Firmware and Boot Code Download Commands

Downloading a File - download


This command downloads a firmware or boot code file to all HBAs of the same name or to a specific
HBA.
• To download a firmware image file to all HBAs of the same specified name, type:
doslpcfg download a=<adapter name> i=<firmware image filename>
Note: The adapter name is the name that appears when you run the listHBA
command. For more information on the listHBA command, see .“Viewing all HBAs in
the System - listhba” on page 31.

The following example downloads the hd100a4.all firmware file to all LP9802 HBAs:
doslpcfg download a=lp9802 i=c:\image\hd100a4.all
• To download a firmware image file to an HBA specified by its number, type:
doslpcfg download n=<adapter number> i=<firmware image filename>
The following example downloads the 1.70a3 BootBIOS file to HBA # 6; in this example, the x86
BootBIOS file is for an LP982 HBA:
doslpcfg download n=6 i=lb170a3.prg

Troubleshooting and Maintenance Manual for Emulex HBAs Page 33


Accessing the Flash Device Directly - directdownload
This command directly accesses the flash device on the HBA without interfacing with the HBA firmware.
This feature is useful in downloading a read-only memory (ROM) file image if the firmware has been
corrupted. You can use this feature on the following Emulex HBAs:
• LPe11002, LPe11000 and LPe1150
• LP11002, LP11000 and LP1150
• LP10000ExDC and LP1050Ex
• LP10000DC and LP10000
• LP1005DC-CM2
• LP1050 and LP1050DC
Note: This command cannot be used in a script file.

• To access the flash device on the HBA directly, type:


doslpcfg directdownload a=<adapter name/default> i=<firmware image
filename>
Note: The adapter name is the name that appears when you run the listHBA
command. For more information on the listHBA command, see .“Viewing all HBAs in
the System - listhba” on page 31.

The following example accesses the flash device on an LP1050 HBA:


doslpcfg directdownload a=lp1050 i=C:\image\mfp191a5.rom
The following example accesses the flash device if the Offline Utility cannot detect the HBA type
and there is only one single-channel HBA or one dual-channel HBA in the system:
doslpcfg directdownload a=default i=C:\image\tdu191a5.rom
Note: The a=default option can be used only if there is one single-channel HBA or
one dual-channel HBA in the system.

World Wide Name Commands

Writing WWN and Updating NVPARMS - writeWWN


This command allows you to enter word 1 and word 0 of the WWPN or WWNN via the keyboard or a
barcode scanner to update a specified HBA’s non-volatile parameters (NVPARMS) with a new WWPN or
WWNN. The new WWPN and WWNN will be used when the HBA is discovered. The HBA will also retain
the original WWPN and WWNN in another region of the firmware that can be used to identify the HBA as
manufactured. The writeWWN command is not valid in a script file; use the scriptWWPN and
scriptWWNN commands instead.
Caution: Use the writeWWN command with caution. Do not use the same WWPN or
WWNN on more than one HBA in a fabric, or unpredictable results may occur.

• To modify the WWPN and WWNN, type:


doslpcfg writeWWN n=<all/adapter number>
• The Offline Utility prompts you to enter a new WWPN or WWNN. The following example writes
the WWPN and WWNN for HBA #1.
doslpcfg writeWWN n=1

Troubleshooting and Maintenance Manual for Emulex HBAs Page 34


Reading IEEE Information and Saving It to a File - saveWWN
This command reads the original words 0 and 1 of the IEEE address from manufacturing, obtained from
configuration regions 16 (or 32) of the HBA specified by its number and saves the configuration region
information in the selected WWN file.
• To save the WWN, type:
doslpcfg saveWWN n=<adapter number> c=<wwn filename>
• The following example reads the configuration region information on HBA #4 and saves it to the
contents of the ctwwn.sav file:
doslpcfg saveWWN n=4 c=ctwwn.sav
Restoring WWN and Updating NVPARMS - restoreWWN
This command restores words 0 and 1 of the IEEE address from a specified file and uses this
information to update the NVPARMS port name with this IEEE address. The HBA will use this WWPN to
identify its port.
• To restore the WWN, type:
doslpcfg restoreWWN n=<adapter number> c=<wwn filename>
• The following example reads the WWN on HBA #4 and updates the NVPARMS with the
ctwwn.sav file.
doslpcfg restoreWWN n=4 c=ctwwn.sav

Boot Code Commands


To set the boot device with the Offline Utility, perform the following commands in this order:
1. Verify that the BootBIOS is present with the listboot command . (See “Viewing BootBIOS
Versions - listboot” on page 31 for more information.)
2. If necessary, enable BootBIOS with the enableboot command . (See See “Enabling or Disabling
BootBIOS - enable/disable” on page 36 for more information.)
3. Set the boot device with the setbootdevice command . (See "See “Selecting a Boot Device -
setbootdevice” on page 36 for more information.)
Example:
doslpcfg listboot n=1
Returns the following:
boot 1 (enabled): RB1.70A3
boot 2 (disabled): RB1.50A8
doslpcfg enableboot n=1 i=2
doslpcfg setbootdevice n= 1 w0=a1b2c3d4 w1=b946a4e8 l=2
Configure the system BIOS to have the HBA boot device highest in the boot order.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 35


Enabling or Disabling BootBIOS - enable/disable
This command enables or disables the BootBIOS (selected by its index) for the specified HBA number.
Index i is one of the indexes (base 1) shown when you run the listboot command.
• To enable BootBIOS, type:
doslpcfg enableboot n=<adapter number> i=<index>
The following example enables BootBIOS on HBA #6:
doslpcfg enableboot n=6 i=1
• To disable BootBIOS, type:
doslpcfg disableboot n=<adapter number>
The following example disables BootBIOS on HBA #6:
doslpcfg disableboot n=6
Selecting a Boot Device - setbootdevice
This command sets up the boot device specified by its WWN, LUN and desired topology. Set t to 1 for
Point-to-Point and 0 for Arbitrated Loop. The selected device will boot when the system reboots.
Note: The boot code must be enabled before you can issue the setbootdevice command.

• To set the boot device, type (all on one line):


doslpcfg setbootdevice n=<adapter number> w0=<WWPN word 0>
w1=<WWPN word 1> l=<Decimal ID of LUN> t=<topology>
Note: The command for specifying the LUN is a lower- or upper-case L.
• The following example set the boot device on HBA #1, LUN #46 with a desired topology of
Arbitrated Loop:
doslpcfg setbootdevice n=1 w0=a1b2c3d4 w1=b946a4e8 l=46 t=0
Note: If PLOGI fails after 50 msecs, the boot will be retried once.

Selecting One or More Alternate Boot Devices - setAlBoot


This command sets up alternate boot devices. You can set up to 7 alternate boot devices (index i can be
from 1 to 7).
Note: The boot code must be enabled before you can issue the setAltBoot command.

• To set up one or more alternate boot devices, type (all on one line):
doslpcfg setAltBoot n=<adapter number> i=<index> w0=<WWPN word 0>
w1=<WWPN word 1> l=<Decimal ID of LUN>
Note: The command for specifying the LUN is a lower- or upper-case L.
• The following example set the alternate boot device on HBA #1, LUN #3:
doslpcfg setAltBoot n=1 i=1 w0=12345678 w1=a842b6 1=3

Troubleshooting and Maintenance Manual for Emulex HBAs Page 36


Configuration Commands

Setting the HBA to Use Soft Jumpers or the Hardware Default - jumper
This command allows you to select the default PCI configuration or alternate configurations. Selections
are 0 for none, 1 for hardware default or 2 for soft jumper. Alternate regions are 6 or 7 (used only for
selection 2, soft jumper).
• To set soft jumpers or the hardware default, type (all on one line):
doslpcfg jumper n=<adapter number> s=<selection> r=<alternate
region>
• The following example sets up HBA #5 to use soft jumpers in region 7:
doslpcfg jumper n=5 s=2 r=7
• The following example selects the default PCI configuration for HBA #4:
doslpcfg jumper n=4 s=1
Updating Configuration Regions - config
To update configuration regions, those configuration regions must be initialized prior to running the
config command. Valid region numbers range from 0 to 32.
HBA name is the one that appears in when you run the listHBA command.

• To update a specified configuration region with all HBAs of the same selected name with
contents from a selected configuration file, type (all on one line):
doslpcfg config a=<adapter name> r=<region number> l=<byte length>
c=<configuration filename>
Note: The adapter name is the name that appears when you run the listHBA command. For
more information on the listHBA command, see .“Viewing all HBAs in the System -
listhba” on page 31.

The command for specifying byte length is a lower- or upper-case Byte length is in
decimal format.

The following example updates region 6 of all LP9000 HBAs with ctplus1.cfl.
doslpcfg config a=lp9000 r=6 l=68 c=ctplus1.cfl
The following example updates region 17of all ABC24-FC56 HBAs with d:\dfplus1.cfl.\:
doslpcfg config a=ABC24-FC56 r=17 l=100 c=d:\dfplus1.cfl
• To update a specified configuration region of only one HBA specified by its number with contents
from a selected configuration file, type (all on one line):
doslpcfg config n=<adapter number> r=<region number> l=<byte
length> c=<configuration filename>
The following example updates region 17 of HBA number 4 with heplus1.cf1:
doslpcfg config n=4 r=17 l=100 c=heplus1.cfl
The following example updates region 6 of HBA number 2 with d:\dfplus1.cf1:
doslpcfg config n=2 r=6 l=68 c=d:\dfplus1.cfl

Troubleshooting and Maintenance Manual for Emulex HBAs Page 37


Running Diagnostic Tests

Running External Loopback Test - extloopback


This command runs the external loopback test. A loopback plug must be installed. Run the test on a
specific HBA or on all HBAs in the system, specify the number of times you want the test to repeat, and
direct the test response if an error is encountered. o is the test action option on error; enter o=1 for stop,
o=2 for repeat or o=3 for ignore.
• To run the external loopback test, type (all on one line):
doslpcfg extloopback n=<all/adapter number> r=<repeat count>
o=<option on error>
• The following example runs the external loopback test 50 times on HBA #1 and stops the test if
an error is encountered:
doslpcfg extloopback n=1 r=50 o=1
• The following example runs the external loopback test 20 times on all HBAs in the system and
ignores any errors encountered:
doslpcfg extloopback n=all r=20 o=3
Running Internal Loopback Test - intloopback
This command runs the internal loopback test. Run the test on a specific HBA or on all HBAs in the
system, specify the number of times you want the test to repeat, and direct the test response if an error
is encountered. o is the test action option on error; enter o=1 for stop, o=2 for repeat or o=3 for ignore.
• To run the internal loopback test, type (all on one line):
doslpcfg intloopback n=<all/adapter number> r=<repeat count>
o=<option on error>
• The following example runs the internal loopback test 100 times on HBA #1 and stops the test if
an error is encountered:
doslpcfg intloopback n=1 r=100 o=1
• The following example runs the internal loopback test 25 times on all HBAs in the system and
ignores any errors encountered:
doslpcfg extloopback n=all r=25 o=3
Note: The internal loopback test will fail on the LP1005DC-CM2.

Running PCI Loopback Test - pciloopback


This command runs the PCI loopback test. Run the test on a specific HBA or on all HBAs in the system,
specify the number of times you want the test to repeat, and direct the test response if an error is
encountered. o is the test action option on error; enter o=1 for stop, o=2 for repeat or o=3 for ignore.
• To run the PCI loopback test, type (all on one line):
doslpcfg pciloopback n=<all/adapter number> r=<repeat count>
o=<option on error>
• The following example runs the PCI loopback test 100 times on all HBAs in the system and
stops the testing if any errors are encountered.
doslpcfg pciloopback n=all r=100 o=1

Troubleshooting and Maintenance Manual for Emulex HBAs Page 38


Using Script Files

Creating Script Files


You can group together and execute commands using a script file so that a set of commands can be
carried out. You can also enter comment lines (which begin with a semicolon). Each line follows the
same command syntax as those documented in this manual. The Offline Utility allows you to:
• Execute commands entered in a script file. Use the @ command to execute the script file.
• Execute commands multiple times. Add the repeat command as the last line of the script file.
• Stop execution of a script file at any time by pressing <s>.

Script File Commands


Sample script file:
version
screendisplay o=0
;reset n=1 s=0
reset n=all s=0
listboot n=1
enableboot n=1 i=2
pciloopback n=all r=50 o=3
intloopback n=all r=10 o=1
extloopback n=all r=40 o=3
;repeat r=10 Repeat command disabled
Repeating a Series of Commands - repeat
This command is valid only in a script file and is not entered in the way a command is usually entered.
Enter this command at the end of a script file to repeat a series of commands from the beginning of the
script file a specific number of times.
Note: To interrupt and stop the repeat command, press <S> or <s>.

• To repeat the series of commands in the script file, add the following as the last line of the file:
repeat r=<repeat count>
• The following example repeats the series of commands in the script file 10 times.
repeat r=10
Enabling or Disabling Test Messages on the Screen - screendisplay
This command enables or disables test messages from being displayed on the screen. o=1 enables
message to appear on the screen, o=0 prevents messages from appearing on the screen.
• To enable or disable test message displays, type:
doslpcfg screendisplay o=<display option>

Troubleshooting and Maintenance Manual for Emulex HBAs Page 39


• In the following script file example, the result messages from the version and listhba commands
are output to the log file and to the screen. After the screendisplay command is set to o=0, all the
successive commands (download, listboot, enableboot) have the result messages output only to
the log file, and not to the screen.
version
listhba
screendisplay o=0
download a=lp8000 i=c:\temp\dd381a3.awc
listboot n=2
enableboot n=2 i=1
Updating NVPARMS - scriptWWNN
This command reads the WWNN words 0 and 1 from the command line to update the NVPARMS. This
command can also be executed from a script file. The new WWNN value will be used when the HBA is
discovered. The HBA will also retain the original WWNN in another region of the firmware that can be
used to identify the HBA’s manufacturer.
Note: Use the scriptWWNN command with caution. Do not use the same WWNN on more
than one HBA in a fabric or unpredictable results may occur.

To read WWNN words 0 and 1 from the command line, type (all in one line):
scriptWWNN n=<adapter number> w0=<WWNN word 0> w1=<WWNN word 1>
• The following example updates NVPARMS WWNN word 0 and word 1 for HBA #1:
scriptWWNN n=1 w0=40A2D6B8 w1=B620A1B2
Updating NVPARMS - scriptWWPN
This command reads the WWPN words 0 and 1 from the command line to update the NVPARMS. This
command can also be executed from a script file. The new WWPN value will be used when the HBA is
discovered, not the original IEEE address assigned by manufacturing in Configuration Region 16 (or
32)..
Note: Use the scriptWWPN command with caution. Do not use the same WWPN on more
than one HBA in a fabric or unpredictable results may occur.

To read WWPN words 0 and 1 from the command line, type (all in one line):
scriptWWPN n=<adapter number> w0=<WWPN word 0> w1=<WWPN word 1>
• The following example updates NVPARMS WWPN word 0 word 1 for HBA #1:
scriptWWPN n=1 w0=40A2D6B8 w1=C920A1B2
Creating a logfile - logfile
This command is valid only in a script file. This command creates a log file with a specified directory and
file name. The default log file is lpcfglog.txt and is created in the system’s current directory."
• To create a log file use the following command as the first command in your script file, type:
logfile l=<filename>
• The following example creates a file called hplplog.txt in the d:\ directory:
logfile 1=d:\log\hplplog.txt
Note: The command for creating a logfile is a lower- or upper-case L.

Results of all commands are recorded in a log file. Unless otherwise specified by the logfile command,
the default log file is lpcfglog.txt in the current directory.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 40


• Sample log file:

>>>>>>>> Test Script starts @ 10:34:28 on 05/31/05 >>>>>>>>


listhba
adapter 1: C92E511A Functional FW: HS1.90A4 LP9802
adapter 2: C9396BA6 Functional FW: ES1.91A0 LP250048-900
extloopback n=all r=500 o=1
**Start tests on Adapter 1
Run EXT Loopback
Pass 500 test(s)
*Complete tests on Adapter 1, NO error
**Start tests on Adapter 2
Run EXT Loopback
Pass 500 test(s)
*Complete tests on Adapter 2, NO error

intloopback n=all r=500 o=1


**Start tests on Adapter 1
Run INT Loopback
Pass 500 test(s)
*Complete tests on Adapter 1, NO error
**Start tests on Adapter 2
Run INT Loopback
Pass 500 test(s)
*Complete tests on Adapter 2, NO error
pciloopback n=all r=500 o=1
**Start tests on Adapter 1
Run PCI Loopback
Pass 500 test(s)
*Complete tests on Adapter 1, NO error
**Start tests on Adapter 2
Run PCI Loopback
Pass 500 test(s)
*Complete tests on Adapter 2, NO error
extloopback n=all r=500 o=1
**Start tests on Adapter 1
EXTLB: Error - Link is not UP
Encounter Error, stop all tests
--------- Test Script stops @ 10:34:56 on 05/31/05 ---------

Troubleshooting and Maintenance Manual for Emulex HBAs Page 41


Error Codes

Table 2: The Offline Utility Error Codes

Error Code Description

0 No error
1 Invalid adapter number
2 Mailbox command error
3 No valid boot code found
4 Open file error
5 Invalid configuration region
6 Invalid adapter name
7 Download error
8 Invalid boot code index
9 Link not up for external loopback test
10 Link not up for internal loopback test
11 Invalid jumper selection (in jumper command)
12 Invalid alternate configuration region (in jumper command)
13 PCI loopback test fails
14 Adapter reset error
15 Read configuration region error
16 No VPD information available
17 No command in command line
18 Open log file error
19 Read wakeup parameters error
20 Update wakeup parameters error
21 Incorrect test parameters
22 Stopped by user
23 Internal loopback test fails
24 External loopback test fails
25 Error exists after four retries
26 Invalid command
27 Incorrect syntax
28 Command supported only in script file
29 Read_rev error
30 Dump configuration region error
31 Read file error
32 Short file error
33 Read NVPARMS error

Troubleshooting and Maintenance Manual for Emulex HBAs Page 42


Table 2: The Offline Utility Error Codes (Continued)

Error Code Description

34 Write NVPAMRMS error


35 Command does not support all adapters
36 Invalid LUN
37 No boot code enabled
38 Update configuration region error
39 No boot code found
40 Dump memory error
41 Update erasable read-only memory (EROM) error
42 Delete load entry error
43 Write WWN error
44 Not supported in script file
45 No Emulex HBA found
46 Invalid Alternate Boot Device Index

Troubleshooting and Maintenance Manual for Emulex HBAs Page 43


The lp6dutil Utility
Introduction
The lp6dutil utility for DOS includes options for performing routine diagnostic tasks and for viewing a
variety of information for the HBA.
All lp6dutil tasks can be performed using the graphical user interface (GUI) screen menus. All screens
require navigation and selection using the keyboard.
Some lp6dutil tasks can be performed using the command line. These include downloading images,
setting up and running diagnostics.
Information in view-only screens is typically presented in hexadecimal format.

Start lp6dutil
Note: You cannot start lp6dutil at the DOS prompt in Windows.

4. Boot up the system with DOS.


5. From the directory where the lp6dutil.exe file resides, enter the following command:
lp6dutil
Note: For debugging, activate the lp6dutil utility without restarting the adapter by entering
the following command: lp6dutil /nr

An Introduction screen is displayed. A menu bar is near the top and the lp> is prompt near the bottom of
the screen.

Figure 21: Introduction Screen

Troubleshooting and Maintenance Manual for Emulex HBAs Page 44


Use the Menu Bar
• To select a function, press and hold down <Alt> and press the letter that is highlighted in the
function title. A menu is displayed. For example, if you hold down <Alt> and press <L>, the
Flash menu is displayed.To move through items within a menu, press the up and down arrow
keys. You can also press the letter that is highlighted for that menu item. In the following
example, press <D> to open the Download Image screen.

Figure 22: Flash Menu, Download Selected

Figure 23: Download Image Screen

Navigation Tips
• To move from box to box (area to area) within a screen, tab to move to the right, or hold down
<Shift> and tab to move to the left. If the box title has a highlighted letter, hold down <Alt> and
press the letter to move into the box.
• To move through items within a box or area, press the up and down arrow keys.
• ( ) round brackets next to an item indicate that one choice must be selected. There is
typically a default option selected. Press the up and down arrow keys to move through
choices and select a different choice.
• [ ] square brackets near or next to an item indicate an optional choice. Tab to the item
list. Press the spacebar to select or clear an item. Sometimes optional choices are not
active unless a specific required choice is selected.
• Boxes within various screens may contain a vertical scroll bar on the right side of the box. This
indicates that the box contains additional information that exceeds the display capabilities of the
box. Click on the scroll bar to view additional information or selections.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 45


• To select a button, hold down <Alt> and press the letter in red, or tab to the button and press
<Enter>. If an option does not contain a red letter, tab to that button and press <Enter>.

Note: Press <Enter> after selecting an item in a screen. If you do not press
<Enter>, the selection is not made.

• Close a screen within lp6dutil by pressing <Esc>.

Use the Command Line


At the lp> prompt, enter the desired command with the correct syntax, then press <Enter>.
• To view all available help commands, type:
help
• To view the syntax for a command, enter help followed by the command name.For example,
type:
help download
The syntax for the download command is displayed:

Syntax: download <n=adapter> <i=imagepath>

or

Syntax: download <a=adaptertype> <i=imagepath>

• The syntax requires one space between the command name and the first argument, and a
space between additional arguments.
• There is no space before or after the equal sign within an argument.
• To exit lp6dutil, type:
exit
The DOS prompt is displayed.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 46


Commands and Syntax Reference Table
Note: Internal loopback and static random-access memory (SRAM) tests are not supported
for the LP1005DC-CM2.

Table 3: Commands and Syntax

Command Syntax Description

@ @ <command-file> Executes commands in a script file. The @


sign is followed by the pathname of the script
file. Example: @a:\script1.txt

enableboot enableboot <n=adapter> <i=index> Enables the selected boot code on the HBA
specified by its number.

logfile logfile <l=filename> Creates a log file using the specified file
name.

exit exit Terminates the lp6dutil session and passes


control to DOS.

jumper jumper <n=adapter> Changes the state of the HBA soft jumpers,
<s=selection> <r=region> which can be used in place of the physical
jumpers on the HBA. s=0 for none, 1 for
hardware default, 2 for soft jumper. Alternate
regions, r= 6 or r=7 (used only for selection 2,
soft jumper).

pciloopback pciloopback <n=adapter/all> <r=repeat- Runs the pciloopback test. You can run this
count> <o=option> test on one HBA or on all HBAs in the system.
Options: o=1 for stop, o=2 for repeat, and o=3
for ignore.

disableboot disableboot <n=adapter> Disables the current boot code on the HBA
specified by its number.

extloopback extloopback <n=adapter/all> <r=repeat- Runs the external loopback test. The
count> <o=option> loopback plug must be installed. You can run
this test on one HBA or on all HBAs in the
system. Options: o=1 for stop, o=2 for repeat,
and o=3 for ignore.

listhba listhba Lists the HBAs that are installed in the system
(HBA #, WWN, functional FW, HBA type and
mailbox error (if any).

reset reset <n=adapter/all> <s=custom/ Resets one or all adapters in the system. s=1
standard reset> skips POST during a restart, s=0 performs a
standard reset.

repeat repeat <script> This command is used at the end of a script


file to repeat a series of commands from the
beginning of the script file.

download download <a=adapter name> Downloads the specified firmware image to all
<i=firmware image filename> HBAs of the same name.

download download <n=adapter number> Downloads the specified firmware image file
<i=firmware image filename> to the one HBA, as specified by its number.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 47


Table 3: Commands and Syntax

Command Syntax Description

help help <command> Lists the syntax for the specified command.

listboot listboot <n=adapter> Lists boot code versions with indexes (base 1)
that are currently loaded in the flash of the
HBA specified by its number.

vpd vpd n=<adapter number> This command displays the VPD contents of
the adapter specified by its number.

Reset the HBA


1. Select the Adapter menu.

Figure 24: Adapter Menu, Reset Selected


2. Press <R>. The Reset Adapter screen is displayed.

Figure 25: Reset Adapter Screen


3. Select the adapter to reset. The default is adapter #1.
4. Specify the type of reset:
• Standard is a normal reset.
• Custom allows you to reset the HBA with one or both of the custom options selected.
• STUB resets only the functional firmware.
If you select a custom or STUB only reset, the Custom Options area becomes active and you
can specify whether to skip POST or whether to ignore errors. Select one or both options by
pressing the spacebar to select. Press the spacebar again to clear.
5. Select Reset. "Resetting" is displayed briefly.
6. Select Done. The screen is closed.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 48


Perform a Warm Start
1. Select the Adapter menu.

Figure 26: Adapter Menu, Warmstart/NoRam Selected


2. Press <W>. The Warmstart Adapter screen is displayed.

Figure 27: Warmstart Adapter Screen


3. Specify a type of warm start:
• Warmstart Mode accesses the RAM.
• NORAM Mode does not access RAM.
• Restart causes the adapter to start in warm start mode and then restart normally.
4. Proceed to initiate the warm start.
5. Select Done to close the screen.

Exit the lp6dutil Utility


To exit lp6dutil:
1. Select the File menu.

Figure 28: File Menu, Exit Selected


2. Press <X>. The lp6dutil session is terminated and the DOS prompt appears.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 49


View HBA Information

View Adapter Parameters


To display a list of HBAs installed in the system, including HBA model number and device ID, from the
Adapter menu:
1. Select the Adapter menu.

Figure 29: Adapter Menu, Display Selected


2. Press <D>. The Installed Adapter Parameters screen is displayed.

Figure 30: Installed Adapter Parameters Screen


3. Select an HBA in the Adapters box. Information is displayed in the Adapter Info box. This
information is view-only.
4. Select OK to close the screen.
Note: A HS20 Blade can have one HBA and two ports (appears as a 1005DC HBA). A
HS40 Blade can have two HBAs or two ports (appears as two 1005DC HBAs).

View DC Bridge Information


1. Select the Adapter menu.

Figure 31: Adapter Menu, DC Bridges Selected

Troubleshooting and Maintenance Manual for Emulex HBAs Page 50


2. Press <B>. The Dual Channel Bridges screen is displayed.

Figure 32: Dual Channel Bridges Screen


3. Select an HBA in the Adapters box. Adapter information is displayed in the Information box.
4. Select OK to close the screen.

View VPD Information


1. Select the Adapter menu.

Figure 33: Adapter Menu, VPD Selected


2. Press <V>. The Adapters VPD screen is displayed.

Figure 34: Adapter VPD Screen


3. Select an HBA in the Adapters box. The adapter's VPD information is displayed in the VPD box.
4. Select OK to close the screen.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 51


View PCI Information
1. Select the Info menu.

Figure 35: Info Menu, PCI Info Selected


2. Press <P>. The PCI Parameters screen is displayed.

Figure 36: PCI Parameters Screen


3. Select an HBA in the Adapters box. PCI information is displayed in the PCI Info box.
4. Select OK to close the screen.

View Revision Information


1. Select the Info menu.

Figure 37: Info Menu, Revisions Selected

Troubleshooting and Maintenance Manual for Emulex HBAs Page 52


2. Press <R>. The Revisions Info screen is displayed.

Figure 38: Revisions Info Screen


3. Select an HBA in the Adapters box. Revision information is displayed in the Rev Info box.
4. Select OK to close the screen.

View Service Parameters


1. Select the Info menu.

Figure 39: Info Menu, Service Parameters Selected


2. Press <S>. The Service Parameters screen is displayed.

Figure 40: Service Parameters Screen


3. Select an HBA in the Adapters box. Service parameters are displayed in the Service Parameters
box.
4. Select OK to close the screen.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 53


View Counter Information
1. Select the Info menu.

Figure 41: Info Menu, Counters Selected


2. Press <C> The Counters Display screen appears.

Figure 42: Counters Display Screen


3. Select an HBA in the Adapters box. Counter information is displayed in the Counters Info box.
4. To set the counters to zero for all fields, select Clear.
5. Select Done to close the screen.

View Link Status Information


1. Select the Info menu.

Figure 43: Info Menu, Link Status Selected

Troubleshooting and Maintenance Manual for Emulex HBAs Page 54


2. Press <L>. The Link Status screen is displayed.

Figure 44: Link Status Screen


3. Select an HBA in the Adapters box. Link status information is displayed in the Link Status box.
4. Select OK to close the screen.

View Link Attention Data


5. Select the Info menu.

Figure 45: Info Menu


6. Press <A>. The Link Attention Data screen is displayed.

Figure 46: The Link Attention Data Screen


7. Select an HBA in the Adapters box. Link attention data is displayed in the Link Attention box.
8. Select OK to close the screen.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 55


View Wakeup Parameters
1. Select the Flash menu.

Figure 47: Flash Menu, Wakeup Parms Selected


2. Press <W>. The Wakeup Parameters screen is displayed.

Figure 48: Wakeup Parameters Screen


3. Select an HBA in the Adapters box. Wakeup parameters are displayed in the Parameters box.
4. Select OK to close the screen.

View Service Level Interface Memory (SLIM)


1. Select the Debug menu.

Figure 49: Debug Menu, SLIM Selected

Troubleshooting and Maintenance Manual for Emulex HBAs Page 56


2. Press <S>. The SLIM Memory screen is displayed.

Figure 50: SLIM Memory Screen


3. Select an HBA in the Adapters box.
4. Enter values to specify how SLIM is to be displayed:
• The Offset field represents the starting byte at which information is displayed. An offset
of 0 means information is displayed at the beginning of SLIM. This value is displayed
based on your last session. You can change this value.
• The Length field represents the number of bits that will be displayed.
The contents of the SLIM are displayed in the SLIM Contents box.
5. Select OK to close the screen.

View Mailbox
1. Select the Debug menu.

Figure 51: Debug Menu, Mailbox Selected


2. Press <M>. The Read Mailbox screen is displayed.

Figure 52: Read Mailbox Screen


3. Select an HBA in the Adapter box. The contents of the mailbox are displayed in the Mailbox
Contents box.
4. Select OK to close the screen.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 57


View the Registers
1. Select the Debug menu.

Figure 53: Debug Menu, Registers Selected


2. Press <R>. The Registers screen is displayed.

Figure 54: Registers Screen

Select an HBA in the Adapters box. Register information is displayed in the Registers box.
• Host attention corresponds to 31 bits that describe information that the HBA provides to the
host. In Figure 54 the HBA informs the host when a current mailbox command is finished.
• Chip attention (also known as port attention) corresponds to how the utility gets the HBA's
attention. For the example, the utility informs the HBA when a pending Mailbox Attention
command has an error.
• Host status corresponds to errors and events.
• Host control corresponds to the driver utility.
3. Select OK to close the screen.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 58


Update Boot Code

Change the Boot Code State


This procedure allows you to enable or disable boot code (if x86 BootBIOS or OpenBoot is installed).
1. Select the Flash menu.

Figure 55: Flash Menu, Boot Bios Selected


2. Press <B>. The Change Boot BIOS State screen is displayed.

Figure 56: Boot Code Disabled


3. Select an HBA in the Adapters box.
4. Select the boot code image in the BIOS Images list.
5. Select Change. The boot code is enabled or disabled for the selected HBA. In the following
example, the boot code is enabled.

Figure 57: Boot BIOS Enabled


6. Select OK to close the screen.
Note: The Change Boot BIOS State screen is used to enable or disable the boot code. For
x86 BootBIOS, you must also enable the HBA to boot from the SAN using the BIOS
utility.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 59


Load and Update Firmware, Test and Boot Code Files
You can load and update files and images to one or more HBAs using the menu bar. You can also load
and update files using the utility that was loaded with the driver.
1. Select the Flash menu.

Figure 58: Flash Menu, Download Selected


2. Press <D>. The Download Image screen is displayed.

Figure 59: Download Image Screen


3. Select the location of the image file and the HBA to be updated.
4. Select the Reset After Download setting.
• Defaults to Yes. If you are updating a single file to one HBA, keep the default setting.
• If you are updating several HBAs or several files to one HBA, select No.
5. Select OK. The screen closes and the load process begins. Various steps of the download
process are displayed. When the download is finished, the results of the download (success or
error) are displayed.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 60


View and Maintain the Flash Load List
The flash load list enables you to view or delete the images that have been installed on the HBA.
To view the flash load list:
1. Select the Flash menu.

Figure 60: Flash Menu, Display Flash Selected


2. Press <F>. The Flash Load List screen is displayed.

Figure 61: Flash Load List Screen


3. Select the HBA. The flash load list Information is displayed for the selected HBA.
4. Select Done to close the screen.
To delete an image from the HBA:
1. Display the flash load list and select an HBA.
2. Select the image you want to delete.
3. Select Delete.
A warning screen is displayed. On the warning screen, select Delete to delete the file, or Cancel
to close the warning screen and cancel the delete.The image selected in the Images box is
deleted.
4. Select Done to close the screen.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 61


View and Maintain Configuration Regions

View Configuration Region Information


1. Select the Flash menu.

Figure 62: Flash Menu, Configuration Regions Selected


2. Press <C>. The Configuration Regions screen is displayed.

Figure 63: Configuration Regions Screen


3. Select the HBA and corresponding region.
Region Specifics -
• Region 1 represents Node A configuration
• Region 2 represents Node B configuration
• Region 3 represents Node C configuration
• Region 4 represents the wakeup parameters
• Region 5 represents the default PCI configuration
• Region 6 represents the download 1 (on the Soft Jumpers screen, PCI Alt-1)
• Region 7 represents the download 2 (on the Soft Jumpers screen, PCI Alt-2)
Select Cleanup to clear the first 4 bytes of the specified configuration region in flash so that this
region can be programmed.
4. Enter values in the Hex Input area to specify the configuration region:
• The Offset field represents the starting byte at which information is displayed. An offset
of 0 means information is displayed at the beginning of the region. The value displayed
is based on your last session. You can change this value.
• The Length field represents the number of bits that are displayed.
For example, if you set the Offset value to 100 and the Length field to 100, information for the
selected region is displayed beginning at byte 100 and continuing through the next 100 bytes.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 62


5. Select Read. Region information is displayed in the Region Data box.

Figure 64: Configuration Regions Screen with Information


6. Select Done to close the screen, or proceed to initializing or cleaning a region.

Initialize a Region or Cleaning a Configuration


1. After you have viewed configuration region information and determined that you want to initialize
a region or clean a configuration, make sure the adapter and region are selected in the
Configuration Regions screen.
On the Configuration Regions screen, select Init. The Init Region screen is displayed.

Figure 65: Init Region Screen


2. To initialize, select Init Region.
3. After the configuration is initialized, you can clean the configuration. Select Clean Config .
4. Select Done to close the screen.

Set an HBA to Use Soft Jumpers


You can change the state of the adapter soft jumpers, which can be used in place of the physical
jumpers on the adapter.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 63


1. Select the Flash menu.

Figure 66: Flash Menu, Soft Jumpers Selected


2. Press <J>. The Soft Jumpers screen is displayed.

Figure 67: Soft Jumpers Screen


3. Specify the adapter.
4. Specify Hardware Default or Soft Jumpers.
To select or clear an option, tab to it and press the spacebar.
If you select soft jumpers, you must select an alternate PCI region.
• PCI Alt-1 represents Download 1 and Region 6 on the Configuration Regions screen.
• PCI Alt-2 represents Download 2 and Region 7 on the Configuration Regions screen.
5. Select Update, then select Done. The information is updated on the HBA and the screen is
closed.

Use Script Files


Create or Edit Script Files
You can create script files to download images and run scripts from one file. You can download firmware
and boot code images from the Input Script screen.
Use a text editor to create or edit scripts. Script files follow these rules:
• You can run scripts on one adapter in the system or on all adapters in the system.
• n represents the number of adapters and may equal either a numeric value or all.
• r represents the repeat count. You can cause the series of all commands in the script file to
repeat indefinitely by adding the repeat command as the last line of the script file. If you include
this command, press <s> to stop a running script at any time.
• o represents the action option if an error is encountered. 1= stop the test, 2= repeat the test and
3= ignore the error.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 64


For your convenience, this sample script (samplescript.txt) is included in the same directory as the
lp6dutil application:
download a=lp8000 i=c:\temp\dd381a3.awc;
reset n=1 s=0
;reset n=2 s=0
;reset n=all s=0
;pciloopback n=1 r=10 o=1
;pciloopback n=2 r=10 o=2
pciloopback n=all r=50 o=3
extloopback n=all r=40 o=3
Copy this sample script and modify it to fit your needs. Commented lines begin with a semicolon and are
not executed.
Note: All script files end with .txt.

Run Script Files from the Menu Bar


Use the Select Input Script screen to select and run script files. The results are logged in an output file
named lp6dlog.txt and are displayed in the Test Logfile screen.
1. Select the File menu.

Figure 68: File Menu, Open Input Script Selected


2. Press <O>. The Select Input Script screen is displayed.

Figure 69: Select Input Script Screen


3. Select the location of the script file.
4. Select OK.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 65


5. The Select Input Script screen is closed. All scripts listed in the file are run. Results are logged in
the output file.
To close the screen without selecting an input script, select Cancel.

Run Script Files Using the Command Line


Use the @ command to run scripts files. In the following example, the script1.txt script residing on the
root directory of the A drive would run:
@a:\script1.txt
Note: You can view results (log files) with a text editor by opening the lp6dlog.txt file
(always saved in c:\lp6dutil\lp6dlog.txt), or by using the menu bar. You can change
the name and location of the log file using the command line.

View the Log File


After you have run input scripts, view the test results in the Test Logfile screen. These test results are
logged in an output file named lp6dlog.txt. This file is automatically placed in the c:\lp6dutil directory. The
system appends the lp6dlog.txt file as tests are run and results are logged.
To save the test results and ensure that future test results are logged, copy and rename the lp6dlog.txt
file. The lp6dlog.txt file has a limited scrolling buffer size of approximately 12 screens. Copying and
renaming the .txt file helps you to avoid accumulating a large lp6dlog.txt file.
1. Select the File menu.

Figure 70: File Menu, Read Logfile Selected


2. Press <L>. The Test Logfile screen is displayed. Figure 71 below contains tips for using the log
file, rather than an example of the log file itself.

Figure 71: Test Logfile Screen

The most recent test results are displayed at the bottom of the screen. Use the up and down
arrows on your keyboard to scroll through the test results.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 66


3. Select OK. The screen is closed.
Note: You can always view test results using a Text Editor. After you copy and rename the
log file however, you cannot view the file in the Test Logfile screen. Renamed log files
must be viewed using a text editor.

Run Diagnostic Tests

Select HBAs to Test


1. Select the Test menu.

Figure 72: Test Menu, Select Adapters Selected


2. Press <A>. The Select Adapters screen is displayed.

Figure 73: Select Adapters Screen


3. Select the HBAs you want to test.
• To select one HBA, press the up and down arrow keys.
• To select all HBAs, select All.
To close the screen without selecting any HBAs, select None.
4. Select OK. The adapters are selected and the screen is closed.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 67


Select Tests
Note: Internal loopback and SRAM tests are not supported for the LP1005DC-CM2 HBA.

1. Select the Test menu.

Figure 74: Test Menu, Select Tests Selected


2. Press <T>. The Select Tests screen is displayed.

Figure 75: Select Tests Screen


3. Select the tests you want to perform on the HBAs.
• To move through the test list, press <Tab>.
• To select a test, move to the [ ] field for the test and press the spacebar or <Enter>.
• To select all tests within a box, select All.
• To clear all tests (de-select all tests), select None.
To close the screen without selecting any tests, select Cancel.
4. To confirm your options, select OK. Tests are now selected and the screen is closed.

Configure Tests
Note: Internal loopback and SRAM tests are not supported for the LP1005DC-CM2 HBA.

1. Select the Test menu.

Figure 76: Test Menu, Select Options Selected

Troubleshooting and Maintenance Manual for Emulex HBAs Page 68


2. Press <O>. The Configure Test Parameters screen is displayed.

Figure 77: Configure Test Parameters Screen


3. Select the test to configure. Press <Tab> to select the Test Specific Options box. Press the up
and down arrows keys to select the test you want to configure.
4. If you want the selected test to be repeated if an error is encountered, specify a value in the
Repeat Count field. The repeat count defaults to the last value entered in this field. To change
this value, tab to the Repeat Count field and press <Backspace> to clear the necessary fields.
Enter the new value. To repeat the tests indefinitely, set the count to 0.
5. To change the error action, tab to the Error Action list. Press the up and down arrow keys to select
an error action:
• Stop - stops the test if an error is encountered. This is the default error action.
• Repeat - runs the failed test again.
• Ignore - ignores the error.
6. To confirm your options, select Done.
To cancel out of this screen, press <Esc>.

Start Tests
1. After you have configured the tests, select Start Tests from the Test menu.

Figure 78: Test Menu, Start Tests Selected

Troubleshooting and Maintenance Manual for Emulex HBAs Page 69


2. The Test Results screen is displayed.

Figure 79: Test Results Screen


3. Select Start. All tests are run on all HBAs in the Under Tests box. As applicable, test result
messages are displayed in the Messages box.
To interrupt a test while it is running, select Stop
When all tests are finished, select Done. The screen is closed.

Set or Reset Status Word Mask


The Set/Reset Status Word Bits screen allows you to test the HBA's behavior in various modes.
1. Select the Adapter menu.

Figure 80: Adapter Menu, Set Status Word Selected


2. Press S. The Set/Reset Status Word Bits screen is displayed.

Figure 81: Set/Reset Status Word Bits Screen


3. Select the HBA to test. The default is adapter #1.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 70


4. Select the status and mask bits. Tab to the bit and press the spacebar to select or clear it. To
close the screen without changes, select Done.
5. Select Set, then select Done. The bits you have selected are set and the screen is closed.

Debug Tasks

Dump Memory
1. Select the Debug menu.

Figure 82: Debug Menu, Dump Selected


2. Press <D>. A warning screen is displayed.

Figure 83: Dump Memory Warning Screen


3. To continue with the memory dump, on the Warning screen select OK. To close the Warning
screen without dumping memory, select Cancel.
4. The Dump Memory screen is displayed.

Figure 84: Dump Memory Screen


5. Select an HBA in the Adapters box.
6. Enter values in the Hex Input area to set up the memory dump:
• The Adr field represents the starting address.
• The Len field represents the number of bytes.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 71


7. Select Dump. The memory contents are displayed.
8. Select OK to close the screen.

Run Program
The Run Program screen allows you to run firmware test programs, if the firmware test images have
been downloaded. The test results are also displayed in this screen.
1. Select the Debug menu.

Figure 85: Debug Menu, Run Program Selected


2. Press <P>. The Run Program screen is displayed.

Figure 86: Run Program Screen


3. Select an HBA in the Adapter box.
4. Tab to the Program ID Word 1 field. Press <Backspace> to clear the necessary fields. Enter the
firmware test program name.
5. Select Start. Test results display in the Result box.
6. Select Done to close the screen.

Run Diagnostics
• Four standard tests can be run using the Test menu (see “Run Diagnostics” on page 72). The
Run Diags screen allows you to run customized tests that must be downloaded to the HBA.
Instructions for creating customized tests are beyond the scope of this manual.
• To download customized tests, use the same procedure for downloading other files and images
(see “Load and Update Firmware, Test and Boot Code Files” on page 60).
The Run Diags screen allows you to run up to five tests at one time.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 72


1. After starting lp6dutil, Select the Debug menu.

Figure 87: Debug Menu, Run Diag Selected


2. Press <I>. The Run Diags screen is displayed.

Figure 88: Run Diags Screen


3. Select an HBA in the Adapter box.
4. Specify values in the Select Common Parameters area. To change a value, tab to the field, and
press <Backspace> to clear the field.
• Repeat Count -
• 0 = Test will loop indefinitely until the test is stopped manually.
• X = Enter any other number to indicate the number of times you want tests to be
repeated. If more than one test is specified, you cannot stop a test until all tests
are completed.
• Display Option - A binary code that determines the message information that will be
printed in ASCII format to a serial port.
• 00 = No information is printed.
• 1F = All information is printed.
• 03 = Minimal information is printed.
• Request Type -
• 1 = Only one test can be run.
• 2 = Multiple tests (up to five) can be run.
• Entry Count - The number of tests to be run.
• Error Action -

Troubleshooting and Maintenance Manual for Emulex HBAs Page 73


• Stop = Test is stopped if an error is encountered.
• Ignore = Errors are ignored during testing.
• Repeat = If an error is encountered, the test is rerun.
• Loop = If an error is encountered, all tests are rerun.
• Select Parameters for - This field allows you to access a Parameters Selection screen
for the selected test. If multiple tests are downloaded, a down arrow is displayed on the
right side of this box. A separate Parameters Selection screen is displayed for each test.
Parameters Selection screen -
a. Enter values in this screen for the following custom test parameters:
• Version
• Program ID
• Revision Compatibility
• Subtest 3
• Subtest 2
• Subtest 1
• Subtest Selection
b. Select OK on the Parameters Selection screen to set up the test. The screen is closed.
5. On the Run Diags screen, select Start. Results are displayed in the Test Results box. If multiple
tests have run, a vertical scroll bar is displayed on the right side of the box. This indicates that
the box contains additional test results that exceed the display capabilities of the box. Click on
the scroll bar to view additional test results.
6. Select Done to close the screen.

Try to Recover HBA


If the HBA cannot be reset, the Try to Recover screen allows you to attempt recovery.
1. Select the Debug menu.

Figure 89: Debug Menu, Recovery Selected

Troubleshooting and Maintenance Manual for Emulex HBAs Page 74


2. Press <E>. All adapters that are active in the system are displayed in the Try to Recover screen:

Figure 90: Try To Recover Screen


3. Select an HBA to recover.
4. Select Proceed to attempt recovery or Done to close the screen.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 75


Solaris SFS Driver Console and Log Messages
Introduction
Log messages are logged to the /var/adm/messages system file.
Table 1: Notice, Warnings and Error Types

Default/ Effect of Changing


Driver Parameter Related lpfc Driver Parameters
Min/Max Default

console-notices 0 Sets the verbose level for log-only (when set to 0, log
driver notices to the messages are logged to the
console. system log file and also printed on
the console.)
console-warnings 0 Sets the verbose level for
driver warnings to the Default = Disabled
console.

console-errors 0 Sets the verbose level for


driver errors to the console.

log-notices 0xffffffff; Sets the verbose level for log-verbose (when set to non-zero,
driver notices to the system verbose messages are generated.)
log file.
Default = Disabled
log-warnings 0xffffffff; Sets the verbose level for
driver warnings to the
system log file.

log-errors 0xffffffff; Sets the verbose level for


driver errors to the system
log file.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 76


Table 2 lists the types of log messages that can be logged to the system file.

Table 2: Log Message Types

LOG Message Verbose Verbose Description


Verbose Bit
Mask

LOG_MISC 0x00000001 Miscellaneous events

LOG_DRIVER 0x00000002 Driver attach and detach events

LOG_INIT 0x00000004 HBA Initialization events

LOG_MEM 0x00000008 Memory management events

LOG_SLI 0x00000010 SLI events

LOG_MBOX 0x00000020 Mailbox events

LOG_NODE 0x00000040 Node events

LOG_LINK 0x00000080 Link events

LOG_ELS 0x00000100 ELS events

LOG_PKT 0x00000200 General I/O packet events

LOG_FCP 0x00000400 FCP traffic events

LOG_TGTM 0x00000800 FCP target mode events

LOG_IP 0x00001000 IP traffic events

LOG_SFS 0x00002000 Solaris SFS events

LOG_IOCTL 0x00004000 IOCTL events

LOG_FIRMWARE 0x00008000 Firmware download events

LOG_CT 0x00010000 FC Common Transport events

LOG_RESERVED 0x01FE0000 Reserved for future use

LOG_NODE_DETAIL 0x02000000 Detailed Node events

LOG_IOCTL_DETAIL 0x04000000 Detailed IOCTL events

LOG_IP_DETAIL 0x08000000 Detailed IP events

LOG_FIRMWARE_DETAIL 0x10000000 Detailed Firmware events

LOG_Solaris SFS_DETAIL 0x20000000 Detailed Solaris SFS events

LOG_MBOX_DETAIL 0x40000000 Detailed Mailbox events

LOG_SLI_DETAIL 0x80000000 Detailed HBA SLI events

LOG_ALL_MSG 0XFFFFFFFF Detailed Node events

Troubleshooting and Maintenance Manual for Emulex HBAs Page 77


Severity Levels
Table 3: Severity Levels
Level Message Description

DEBUG (Informational Message provides engineering debug information.

NOTICE (Informational) Message provides a general purpose information.

WARNING Message provides a general purpose warning.

ERROR Message indicates that a driver error has occurred.

PANIC (Severe) Message indicates that the driver has forced a system panic to occur.

Message Log Example


The following is an example of a message on the system console.
[5.0336]emlxs0: NOTICE: 720: Link up. (1Gb, fabric)
The following is an example of the same message in the system message log (/var/adm/messages) file.
Jan 19 14:45:36 sunv240 emlxs: [ID 349649 kern.info] [5.0336]emlxs0: NOTICE: 720:
Link up. (1Gb, fabric)
In the above system log message:
• Jan 19 14:45:36 unidentified the date and time when the error or event occurred.
• sunv240 identifies the name of the host machine.
• emlxs identifies the message came from the Emulex emlxs driver.
• [ID 349649 kern.info] identifies a Solaris-specific message ID and kernel message level. This
will change from one driver message to another.
• [5.0336] identifies the emlxs driver message context tag. This may change from one driver
version to another.
• emlxs0 identifies the message is coming from the emlxs driver instance zero. This will change
from one driver instance to another.
• NOTICE identifies the emlxs message severity level. This may change from one driver version
to another.
• 720 identifies the emlxs drive message id. This will not change from one driver version to
another.
• Link up identifies the actual error or event message. This will not change from one driver version
to another.
• (1Gb, fabric) identifies additional information specific to the error or event message. This
information is normally intended for Technical support / engineering use. This may change from
one driver version to another.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 78


Miscellaneous Events

MSG_ID: 0001 Debug


VERBOSE_MASK: LOG_MISC (0x00000001)
DESCRIPTION: This is a general purpose informational message.
SEVERITY LEVEL: Debug
MESSAGE: None
ACTION: No action needed, informational.

MSG_ID: 0002 Notice


VERBOSE_MASK: LOG_MISC (0x00000001)
DESCRIPTION: This is a general purpose informational message.
SEVERITY LEVEL: Notice
MESSAGE: None
ACTION: No action needed, informational.

MSG_ID: 0003 Warning


VERBOSE_MASK: LOG_MISC (0x00000001)
DESCRIPTION: This is a general purpose warning message.
SEVERITY LEVEL: Warning
MESSAGE: None
ACTION: No action needed, informational.

MSG_ID: 0004 Error


VERBOSE_MASK: LOG_MISC (0x00000001)
DESCRIPTION: This is a general purpose error message.
SEVERITY LEVEL: Error
MESSAGE: None
ACTION: No action needed, informational.

MSG_ID: 0005 Panic


VERBOSE_MASK: LOG_MISC (0x00000001)
DESCRIPTION: This is a general purpose panic message.
SEVERITY LEVEL: Panic (Severe)
MESSAGE: None
ACTION: Contact Technical Support.

Driver Events

MSG_ID: 0100 Notice: Driver Attach


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver is performing an attach operation.
SEVERITY LEVEL: Notice
MESSAGE: None
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 79


MSG_ID: 0101 Error: Driver Attach Failed
VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver was unable to attach due to some issue.
SEVERITY LEVEL: Error
MESSAGE: Driver attach failed
ACTION: Check your hardware and software configuration. If problems persist, report these errors to
Technical Support.

MSG_ID: 0102 Debug: Driver Attach


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver is performing an attach operation.
SEVERITY LEVEL: Debug
MESSAGE: Driver attach
ACTION: No action needed, informational.

MSG_ID: 0110 Notice: Driver Detach


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver is performing an detach operation.
SEVERITY LEVEL: Notice
MESSAGE: Driver detach
ACTION: No action needed, informational.

MSG_ID: 0111 Error: Driver Detach Failed


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver was unable to detach due to some issue.
SEVERITY LEVEL: Error
MESSAGE: Driver detach failed
ACTION: Check your hardware and software configuration. If problems persist, report these errors to
Technical Support.

MSG_ID: 0112 Debug: Driver Detach


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver is performing an detach operation.
SEVERITY LEVEL: Debug
MESSAGE: Driver detach
ACTION: No action needed, informational.

MSG_ID: 0120 Debug: Driver Suspend


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver is performing a suspend operation.
SEVERITY LEVEL: Debug
MESSAGE: Driver suspend
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 80


MSG_ID: 0121 Error: Driver Suspend Failed
VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver was unable to suspend due to some issue.
SEVERITY LEVEL: Error
MESSAGE: Driver suspend failed
ACTION: Check your hardware and software configuration. If problems persist, report these errors to
Technical Support.

MSG_ID: 0130 Debug: Driver Resume


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver is performing a resume operation.
SEVERITY LEVEL: Debug
MESSAGE: Driver resume
ACTION: No action needed, informational.

MSG_ID: 0131 Error: Driver Resume Failed


VERBOSE_MASK: LOG_DRIVER (0x00000002)
DESCRIPTION: This indicates that the driver was unable to resume due to some issue.
SEVERITY LEVEL: Error
MESSAGE: Driver resume failed
ACTION: Check your hardware and software configuration. If problems persist, report these errors to
Technical Support.

HBA Initialization Events

MSG_ID: 0200 Notice: Adapter Initialization


VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that the adapter is initializing.
SEVERITY LEVEL: Notice
MESSAGE: Adapter Initialization
ACTION: No action needed, informational.

MSG_ID: 0201 Error: Adapter Initialization Failed


VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that an attempt to initialize the adapter has failed.
SEVERITY LEVEL: Error
MESSAGE: Adapter initialization failed
ACTION: Check your hardware configuration. If problems persist, report these errors to Technical Support.

MSG_ID: 0202 Debug: Adapter Initialization


VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that the adapter is initializing.
SEVERITY LEVEL: Debug
MESSAGE: Adapter Initialization
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 81


MSG_ID: 0210 Debug: Adapter Transition
VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that the adapter is changing states.
SEVERITY LEVEL: Debug
MESSAGE: Adapter transition
ACTION: No action needed, informational.

MSG_ID: 0220 Debug: Adapter Online


VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that the adapter is online and ready to communicate.
SEVERITY LEVEL: Debug
MESSAGE: Adapter online
ACTION: No action needed, informational.

MSG_ID: 0230 Debug: Adapter Offline


VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that the adapter is offline and unable to communicate.
SEVERITY LEVEL: Debug
MESSAGE: Adapter offline
ACTION: No action needed, informational.

MSG_ID: 0230 Warning: Adapter Shutdown


VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that the adapter has been shutdown and will require a reboot to reinitialize.
SEVERITY LEVEL: Warning
MESSAGE: Adapter shutdown
ACTION: Contact Technical Support.

MSG_ID: 0240 Error: Adapter Reset Failed


VERBOSE_MASK: LOG_INIT (0x00000004)
DESCRIPTION: This indicates that an attempt to reset the adapter has failed.
SEVERITY LEVEL: Error
MESSAGE: Adapter reset failed
ACTION: Check your hardware configuration. If problems persist, report these errors to Technical Support.

Memory Management Events

MSG_ID: 0300 Debug: Memory Allocated


VERBOSE_MASK: LOG_MEM (0x00000008)
DESCRIPTION: This indicates that the driver allocated system memory.
SEVERITY LEVEL: Debug
MESSAGE: Memory alloc
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 82


MSG_ID: 0301 Error: Memory Allocation Failed
VERBOSE_MASK: LOG_MEM (0x00000008)
DESCRIPTION: This indicates that the driver was unable to allocate system memory. The system is low
on memory resources.
SEVERITY LEVEL: Error
MESSAGE: Memory alloc failed
ACTION: No action needed. If problems persist, report these errors to your system administrator.

MSG_ID: 0310 Error: Memory Pool Error


VERBOSE_MASK: LOG_MEM (0x00000008)
DESCRIPTION: This indicates that a problem has occurred with the memory buffer pool management.
SEVERITY LEVEL: Error
MESSAGE: Memory pool error
ACTION: No action needed. If problems persist, report these errors to Technical Support.

MSG_ID: 0311 Debug: Memory Pool Allocation Failed


VERBOSE_MASK: LOG_MEM (0x00000008)
DESCRIPTION: This indicates that the driver was unable to allocate memory from one of its own memory
pools.
SEVERITY LEVEL: Debug
MESSAGE: Memory pool alloc failed
ACTION: If the problem occurs frequently you may be able to configure more resources for that pool. If this
does not solve the problem, report these errors to Technical Support.

MSG_ID: 0320 Notice: No Unsolicited Buffer Available


VERBOSE_MASK: LOG_MEM (0x00000008)
DESCRIPTION: This indicates that the driver’s unsolicited buffer pool is exhausted. The I/O will be
dropped and most likely retried by the remote device.
SEVERITY LEVEL: Notice
MESSAGE: No unsolicited buffer available
ACTION: If the problem occurs frequently you may be able to configure more resources for that pool. If this
does not solve the problem, report these errors to Technical Support.

SLI Events

MSG_ID: 0400 Debug: Vital Product Data


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This provides vendor-specific information about the adapter.
SEVERITY LEVEL: Debug
MESSAGE: Vital Product Data
ACTION: No action needed, informational.

MSG_ID: 0410 Debug: Link Attention


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that the adapter has triggered a link attention interrupt.
SEVERITY LEVEL: Debug
MESSAGE: Link attn
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 83


MSG_ID: 0411 Debug: State Change
VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that the adapter has changed state.
SEVERITY LEVEL: Debug
MESSAGE: State change
ACTION: No action needed, informational.

MSG_ID: 0420 Error: Adapter Hardware Error


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that an interrupt has occurred and the status register indicates a
nonrecoverable hardware error.
SEVERITY LEVEL: Error
MESSAGE: Adapter hardware error
ACTION: This error usually indicates a hardware problem with the adapter. Try running adapter
diagnostics. Report these errors to Technical Support.

MSG_ID: 0430 Debug: Ring Event


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that an SLI ring event has occurred.
SEVERITY LEVEL: Debug
MESSAGE: Ring event
ACTION: No action needed, informational.

MSG_ID: 0431 Debug: Ring Error


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that an SLI ring error is being reported by the adapter.
SEVERITY LEVEL: Debug
MESSAGE: Ring error
ACTION: No action needed, informational.

MSG_ID: 0432 Debug: Ring Reset


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates an SLI ring is being reset.
SEVERITY LEVEL: Debug
MESSAGE: Ring reset
ACTION: No action needed, informational.

MSG_ID: 0440 Debug: Adapter Msg


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that a message was sent to the driver from the adapter.
SEVERITY LEVEL: Debug
MESSAGE: Adapter msg
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 84


MSG_ID: 0450 Error: IOCB Invalid
VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that an IOCB was received from the adapter with an illegal value. This error
could indicate a driver or firmware problem.
SEVERITY LEVEL: Error
MESSAGE: IOCB invalid
ACTION: No action needed. If problems persist, report these errors to Technical Support.

MSG_ID: 0451 Debug: IOCB Queue Full


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates that the IOCB queue is full. This will occur during normal operation.
SEVERITY LEVEL: Debug
MESSAGE: IOCB queue full
ACTION: No action needed, informational.

MSG_ID: 0452 Debug: IOCB Error


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates an IOCB local error is being reported by the adapter.
SEVERITY LEVEL: Debug
MESSAGE: IOCB error
ACTION: No action needed, informational.

MSG_ID: 0453 Debug: IOCB Stale


VERBOSE_MASK: LOG_SLI (0x00000010)
DESCRIPTION: This indicates an IOCB completed after its associated packet completed.
SEVERITY LEVEL: Debug
MESSAGE: IOCB stale
ACTION: No action needed, informational.

MSG_ID: 0460 Debug: SLI Detail


VERBOSE_MASK: LOG_SLI _DETAIL (0x20000000)
DESCRIPTION: This provides detailed information about an SLI event.
SEVERITY LEVEL: Debug
MESSAGE: SLI detail
ACTION: No action needed, informational.

Mailbox Events

MSG_ID: 0500 Debug: Mailbox Event


VERBOSE_MASK: LOG_MBOX (0x00000020)
DESCRIPTION: This indicates that a mailbox event has occurred.
SEVERITY LEVEL: Debug
MESSAGE: Mailbox event
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 85


MSG_ID: 0501 Debug: Mailbox Detail
VERBOSE_MASK: LOG_MBOX _DETAIL (0x40000000)
DESCRIPTION: This provides detailed information about a mailbox event.
SEVERITY LEVEL: Debug
MESSAGE: Mailbox detail
ACTION: No action needed, informational.

MSG_ID: 0510 Debug: Stray Mailbox Interrupt


VERBOSE_MASK: LOG_MBOX (0x00000020)
DESCRIPTION: This indicates that a mailbox command completion interrupt was received and the mailbox
is not valid. This error could indicate a driver or firmware problem.
SEVERITY LEVEL: Debug
MESSAGE: Stray mailbox interrupt
ACTION: No action needed, informational. If problems persist, report these errors to Technical Support.

MSG_ID: 0520 Error: Mailbox Completion Error


VERBOSE_MASK: LOG_MBOX (0x00000020)
DESCRIPTION: This indicates that an unsupported or illegal mailbox command was completed. This error
could indicate a driver or firmware problem.
SEVERITY LEVEL: Error
MESSAGE: Mailbox completion error
ACTION: No action needed. If problems persist, report these errors to Technical Support.

Node Events

MSG_ID: 0600 Debug: Node Create


VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that a node has been created for a remote device.
SEVERITY LEVEL: Debug
MESSAGE: Node create
ACTION: No action needed, informational.

MSG_ID: 0601 Debug: Node Opened


VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that a node has been opened for I/O transport.
SEVERITY LEVEL: Debug
MESSAGE: Node opened.
ACTION: No action needed, informational.

MSG_ID: 0602 Notice: Node Create Failed


VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that a node create request for a remote device has failed.
SEVERITY LEVEL: Notice
MESSAGE: Node create failed
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 86


MSG_ID: 0603 Debug: Node Updated
VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that a node has been updated for a remote device.
SEVERITY LEVEL: Debug
MESSAGE: Node updated
ACTION: No action needed, informational.

MSG_ID: 0610 Debug: Node Destroy


VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that a node has been destroyed for a remote device.
SEVERITY LEVEL: Debug
MESSAGE: Node destroyed
ACTION: No action needed, informational.

MSG_ID: 0611 Debug: Node Closed


VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that a node has been temporarily closed for I/O transport.
SEVERITY LEVEL: Debug
MESSAGE: Node closed
ACTION: No action needed, informational.

MSG_ID: 0612 Notice: Node Missing


VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that an FCP2 device node has been found missing.
SEVERITY LEVEL: Notice
MESSAGE: Node missing
ACTION: No action needed, informational.

MSG_ID: 0620 Debug: Node Not Found


VERBOSE_MASK: LOG_NODE (0x00000040)
DESCRIPTION: This indicates that there was an attempt to send an I/O packet to an unknown device
node. The driver maintains a node table entry for every device it needs to communicate with on the FC
network.
SEVERITY LEVEL: Debug
MESSAGE: Node not found
ACTION: No action needed, informational. If problems persist, report these errors to Technical Support.

Link Events

MSG_ID: 0700 Debug: Link Event


VERBOSE_MASK: LOG_SLI (0x00000010) or LOG_LINK (0x00000080)
DESCRIPTION: This indicates that a link event has occurred.
SEVERITY LEVEL: Debug
MESSAGE: Link event
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 87


MSG_ID: 0710 Notice: Link Down
VERBOSE_MASK: LOG_LINK (0x00000080)
DESCRIPTION: This indicates that the FC link is down to the adapter.
SEVERITY LEVEL: Notice
MESSAGE: Link down
ACTION: Check your network connections. If problems persist, report these errors to system administrator.

MSG_ID: 0720 Notice: Link Up


VERBOSE_MASK: LOG_LINK (0x00000080)
DESCRIPTION: This indicates that the FC link is up.
SEVERITY LEVEL: Notice
MESSAGE: Link up
ACTION: No action needed, informational.

MSG_ID: 0721 Notice: NPIV Link Up


VERBOSE_MASK: LOG_LINK (0x00000080)
DESCRIPTION: This indicates that the FC link is up for all virtual ports.
SEVERITY LEVEL: Notice
MESSAGE: NPIV Link up
ACTION: No action needed, informational.

MSG_ID: 0730 Notice: Link Reset


VERBOSE_MASK: LOG_LINK (0x00000080) or LOG_SFS (0x00002000)
DESCRIPTION: This indicates that an issue has forced the FC link to be reset.
SEVERITY LEVEL: Notice
MESSAGE: Link reset
ACTION: No action needed, informational.

MSG_ID: 0731 Error: Link Reset Failed


VERBOSE_MASK: LOG_LINK (0x00000080) or LOG_SFS (0x00002000)
DESCRIPTION: This indicates that an attempt to reset the FC link has failed.
SEVERITY LEVEL: Error
MESSAGE: Link reset failed
ACTION: No action needed. If problems persist, report these errors to Technical Support.

ELS Events

MSG_ID: 0800 Debug: ELS Sent


VERBOSE_MASK: LOG_ELS (0x00000100)
DESCRIPTION: This indicates that an ELS command is being sent.
SEVERITY LEVEL: Debug
MESSAGE: ELS sent
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 88


MSG_ID: 0801 Debug: ELS Comp
VERBOSE_MASK: LOG_ELS (0x00000100)
DESCRIPTION: This indicates that an ELS command completed normally.
SEVERITY LEVEL: Debug
MESSAGE: ELS comp
ACTION: No action needed, informational.

MSG_ID: 0810 Error: Stray ELS Completion


VERBOSE_MASK: LOG_ELS (0x00000100)
DESCRIPTION: This indicates that an ELS command completion was received without issuing a
corresponding ELS command. This error could indicate a driver or firmware problem.
SEVERITY LEVEL: Error
MESSAGE: Stray ELS completion
ACTION: No action needed. If problems persist, report these errors to Technical Support.

MSG_ID: 0811 Debug: Abnormal ELS Completion


VERBOSE_MASK: LOG_ELS (0x00000100)
DESCRIPTION: This indicates that an ELS command completion with a status error in the IOCB. It could
mean the FC device on the network is not responding or the FC device is not an FCP target. The driver will
automatically retry this ELS command if needed.
SEVERITY LEVEL: Debug
MESSAGE: Abnormal ELS completion
ACTION: If the command is a PLOGI or PRLI, and the destination PortID is not an FCP target, no action is
needed. Otherwise, check the physical connections to the FC network and the state of the remote PortID.

MSG_ID: 0820 Debug: ELS Rcvd


VERBOSE_MASK: LOG_ELS (0x00000100)
DESCRIPTION: This indicates that an unsolicited ELS command was received.
SEVERITY LEVEL: Debug
MESSAGE: ELS recvd
ACTION: No action needed, informational.

MSG_ID: 0821 Debug: Unsolicited ELS Dropped


VERBOSE_MASK: LOG_ELS (0x00000100)
DESCRIPTION: This indicates that an unsolicited ELS command was received and then dropped for some
reason.
SEVERITY LEVEL: Debug
MESSAGE: Unsolicited ELS dropped
ACTION: No action needed, informational.

MSG_ID: 0822 Debug: ELS Reply


VERBOSE_MASK: LOG_ELS (0x00000100)
DESCRIPTION: This indicates that a reply is being sent for an unsolicited ELS command.
SEVERITY LEVEL: Debug
MESSAGE: ELS reply
ACTION: No action needed, informational.

MSG_ID: 0830 Error: Invalid ELS Command Found


VERBOSE_MASK: LOG_ELS (0x00000100)

Troubleshooting and Maintenance Manual for Emulex HBAs Page 89


DESCRIPTION: This indicates that an ELS command was found with an invalid command code.
SEVERITY LEVEL: Error
MESSAGE: Invalid ELS command found
ACTION: No action needed. If problems persist, report these errors to Technical Support.

General I/O Packet Events

MSG_ID: 0900 Notice: Packet Abort


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an I/O packet is being aborted.
SEVERITY LEVEL: Notice
MESSAGE: Packet abort
ACTION: No action needed, informational.

MSG_ID: 0901 Warning: Packet Abort Failed


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an attempt to abort an I/O packet has failed.
SEVERITY LEVEL: Warning
MESSAGE: Packet abort failed
ACTION: No action needed. If problems persist, report these errors to Technical Support.

MSG_ID: 0910 Debug: Packet Timeout


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an I/O packet has timed out and is being aborted.
SEVERITY LEVEL: Debug
MESSAGE: Packet timeout
ACTION: No action needed, informational.

MSG_ID: 0911 Debug: Ring Watchdog


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that I/O(s) are getting stale waiting on a ring TX queue
SEVERITY LEVEL: Debug
MESSAGE: Ring watchdog
ACTION: No action needed, informational.

MSG_ID: 0911 Debug: TXQ Watchdog


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that I/O(s) was found missing from the transmit queue.
SEVERITY LEVEL: Debug
MESSAGE: TXQ watchdog
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 90


MSG_ID: 0920 Debug: Packet Flush
VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an I/O packet is being flushed.
SEVERITY LEVEL: Debug
MESSAGE: Packet flush
ACTION: No action needed, informational.

MSG_ID: 0921 Debug: Packet Flushed


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an I/O packet has been flushed.
SEVERITY LEVEL: Debug
MESSAGE: Packet flushed
ACTION: No action needed, informational.

MSG_ID: 0922 Notice: Packet Flush Timeout


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an I/O packet flush request has timed out with some I/O packets still
not completed. The driver will attempt to recover by itself.
SEVERITY LEVEL: Notice
MESSAGE: Packet flush timeout
ACTION: No action needed, informational. If problems persist, report these errors to Technical Support.

MSG_ID: 0930 Notice: Packet Transport Failed


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an attempt to send an I/O packet failed. The I/O packet will be retried
by the upper layer.
SEVERITY LEVEL: Notice
MESSAGE: Packet transport failed
ACTION: No action needed, informational.

MSG_ID: 0931 Error: Packet Transport Error


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an error occurred while attempting to send an I/O packet. The I/O
packet will likely be failed back to the user application.
SEVERITY LEVEL: Error
MESSAGE: Packet transport error
ACTION: No action needed. If problems persist, report these errors to Technical Support.

MSG_ID: 0932 Debug: Packet Transport


VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This provides additional information about a packet being sent.
SEVERITY LEVEL: Debug
MESSAGE: Packet transport
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 91


MSG_ID: 0940 Debug: Packet Completion Error
VERBOSE_MASK: LOG_PKT (0x00000200)
DESCRIPTION: This indicates that an I/O packet was completed with an error status. This can occur
during normal operation.
SEVERITY LEVEL: Debug
MESSAGE: Packet completion error.
ACTION: No action needed, informational. If problems persist, report these errors to Technical Support.

FCP Traffic Events

MSG_ID: 1000 Debug: Stray FCP Completion


VERBOSE_MASK: LOG_FCP (0x00000400)
DESCRIPTION: This indicates that an FCP command completion was received without issuing a
corresponding FCP command. This error could indicate a driver or firmware problem.
SEVERITY LEVEL: Debug
MESSAGE: Stray FCP completion
ACTION: No action needed, informational. If problems persist, report these errors to Technical Support.

MSG_ID: 1001 Debug: FCP Completion Error


VERBOSE_MASK: LOG_FCP (0x00000400)
DESCRIPTION: This indicates that an FCP command completed with an error status. These errors can
occur during normal operation.
SEVERITY LEVEL: Debug
MESSAGE: FCP completion error
ACTION: No action needed, informational.

IP Traffic Events

MSG_ID: 1200 Debug: IP Detail


VERBOSE_MASK: LOG_IP_DETAIL (0x08000000)
DESCRIPTION: This provides detailed information about the driver’s IP interface.
SEVERITY LEVEL: Debug
MESSAGE: IP detail
ACTION: No action needed, informational.

MSG_ID: 1210 Error: Stray IP Completion


VERBOSE_MASK: LOG_IP (0x00001000)
DESCRIPTION: This indicates that an IP sequence completion was received without issuing a
corresponding IP sequence. This error could indicate a driver or firmware problem.
SEVERITY LEVEL: Error
MESSAGE: Stray IP completion
ACTION: No action needed. If problems persist, report these errors to Technical Support.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 92


MSG_ID: 1211 Debug: Abnormal IP Completion
VERBOSE_MASK: LOG_IP (0x00001000)
DESCRIPTION: This indicates that an IP sequence completed with a status error in the IOCB. It could
mean the FC device on the network is not responding.
SEVERITY LEVEL: Debug
MESSAGE: Abnormal IP completion
ACTION: No action needed, informational. If problems persist, report these errors to system administrator.

MSG_ID: 1220 Debug: Unsolicited IP Dropped


VERBOSE_MASK: LOG_IP (0x00001000)
DESCRIPTION: This indicates that an unsolicited IP sequence was received, but was dropped for some
reason.
SEVERITY LEVEL: Debug
MESSAGE: Unsolicited IP dropped
ACTION: No action needed, informational.

MSG_ID: 1221 Debug: IP Recvd


VERBOSE_MASK: LOG_IP (0x00001000)
DESCRIPTION: This indicates that an unsolicited IP sequence was received.
SEVERITY LEVEL: Debug
MESSAGE: IP received
ACTION: No action needed, informational.

MSG_ID: 1230 Error: Invalid IP Sequence Found


VERBOSE_MASK: LOG_IP (0x00001000)
DESCRIPTION: This indicates that an IP sequence was found with an invalid code.
SEVERITY LEVEL: Error
MESSAGE: Invalid IP sequence found
ACTION: No action needed. If problems persist, report these errors to Technical Support.

Solaris SFS Events

MSG_ID: 1300 Debug: SFS


VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This provides general information about the driver’s Solaris SFS interface.
SEVERITY LEVEL: Debug
MESSAGE: SFS
ACTION: No action needed, informational.

MSG_ID: 1301 Debug: SFS Detail


VERBOSE_MASK: LOG_SFS_DETAIL (0x20000000)
DESCRIPTION: This provides detailed information about the driver’s Solaris SFS interface.
SEVERITY LEVEL: Debug
MESSAGE: SFS detail
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 93


MSG_ID: 1310 Warning: Diagnostic Error
VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This indicates that a diagnostic request did not complete because of some issue.
SEVERITY LEVEL: Warning
MESSAGE: Diagnostic error
ACTION: No action needed. If problems persist, report these errors to Technical Support.

MSG_ID: 1311 Debug: ECHO Diagnostic Completed


VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This indicates that an ECHO diagnostic has completed.
SEVERITY LEVEL: Debug
MESSAGE: ECHO diagnostic completed
ACTION: No action needed, informational.

MSG_ID: 1312 Warning: ECHO Diagnostic Failed


VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This indicates that an ECHO diagnostic has failed to return a positive result. This could
indicate a connectivity problem with your FC network.
SEVERITY LEVEL: Warning
MESSAGE: ECHO diagnostic failed
ACTION: Check your network connections. If problems persist report these errors to system administrator.

MSG_ID: 1313 Debug: BIU Diagnostic Completed


VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This indicates that a BIU diagnostic has completed.
SEVERITY LEVEL: Debug
MESSAGE: BIU diagnostic completed
ACTION: No action needed, informational.

MSG_ID: 1314 Error: BIU Diagnostic Failed


VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This indicates that a BIU diagnostic has failed to return a positive result. This is usually
caused by an adapter hardware problem.
SEVERITY LEVEL: Error
MESSAGE: BIU diagnostic failed
ACTION: Report this error to Technical Support.

MSG_ID: 1315 Debug: POST Diagnostic Completed


VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This indicates that a POST diagnostic has completed.
SEVERITY LEVEL: Debug
MESSAGE: POST diagnostic completed
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 94


MSG_ID: 1316 Error: POST Diagnostic Failed
VERBOSE_MASK: LOG_SFS (0x00002000)
DESCRIPTION: This indicates that a POST diagnostic has failed to return a positive result. This is usually
caused by an adapter hardware problem.
SEVERITY LEVEL: Error
MESSAGE: POST diagnostic failed
ACTION: Report this error to Technical Support.

IOCTL Events

MSG_ID: 1400 Debug: IOCTL


VERBOSE_MASK: LOG_IOCTL (0x00004000)
DESCRIPTION: This provides general information about the driver’s IOCTL interface.
SEVERITY LEVEL: Debug
MESSAGE: IOCTL
ACTION: No action needed, informational.

MSG_ID: 1401 Debug: IOCTL Detail


VERBOSE_MASK: LOG_IOCTL_DETAIL (0x04000000)
DESCRIPTION: This provides detailed information about the driver’s IOCTL interface.
SEVERITY LEVEL: Debug
MESSAGE: IOCTL detail
ACTION: No action needed, informational.

MSG_ID: 1410 Debug: DFC


VERBOSE_MASK: LOG_IOCTL (0x00004000)
DESCRIPTION: This provides general information about the driver’s DFC interface.
SEVERITY LEVEL: Debug
MESSAGE: DFC
ACTION: No action needed, informational.

MSG_ID: 1411 Debug: DFC Detail


VERBOSE_MASK: LOG_IOCTL_DETAIL (0x04000000)
DESCRIPTION: This provides detailed information about the driver’s DFC interface.
SEVERITY LEVEL: Debug
MESSAGE: DFC detail
ACTION: No action needed, informational.

MSG_ID: 1420 Debug: DFC Error


VERBOSE_MASK: LOG_IOCTL (0x00004000)
DESCRIPTION: This indicates that an error was found while processing a DFC request.
SEVERITY LEVEL: Debug
MESSAGE: DFC error
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 95


Firmware Download Events

MSG_ID: 1500 Debug: Firmware Image


VERBOSE_MASK: LOG_FIRMWARE (0x00008000)
DESCRIPTION: This provides information about the firmware interface.
SEVERITY LEVEL: Debug
MESSAGE: Firmware image
ACTION: No action needed, informational.

MSG_ID: 1501 Debug: Firmware Image Detail


VERBOSE_MASK: LOG_FIRMWARE_DETAIL (0x10000000)
DESCRIPTION: This provides detailed information about the firmware interface.
SEVERITY LEVEL: Debug
MESSAGE: Firmware detail
ACTION: No action needed, informational.

MSG_ID: 1510 Error: Bad Firmware Image


VERBOSE_MASK: LOG_FIRMWARE (0x00008000)
DESCRIPTION: This indicates that a bad firmware image was provided to the download function.
SEVERITY LEVEL: Error
MESSAGE: Bad firmware image
ACTION: Obtain the proper image file. If problems persist report these errors to Technical Support.

MSG_ID: 1511 Error: Firmware Image Not Compatible


VERBOSE_MASK: LOG_FIRMWARE (0x00008000)
DESCRIPTION: This indicates that the firmware image provided was not compatible with the existing
hardware.
SEVERITY LEVEL: Error
MESSAGE: Firmware image not compatible
ACTION: Obtain the proper image file. If problems persist report these errors to Technical Support.

MSG_ID: 1520 Notice: Firmware Download


VERBOSE_MASK: LOG_FIRMWARE (0x00008000)
DESCRIPTION: This indicates that an attempt to download a firmware image has occurred.
SEVERITY LEVEL: Notice
MESSAGE: Firmware download
ACTION: No action needed, informational. If problems persist report these errors to Technical Support.

MSG_ID: 1521 Notice: Firmware Download Complete


VERBOSE_MASK: LOG_FIRMWARE (0x00008000)
DESCRIPTION: This indicates that an attempt to download a firmware image was successful.
SEVERITY LEVEL: Notice
MESSAGE: Firmware download complete
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 96


MSG_ID: 1522 Error: Firmware Download Failed
VERBOSE_MASK: LOG_FIRMWARE (0x00008000)
DESCRIPTION: This indicates that an attempt to download a firmware image was failed.
SEVERITY LEVEL: Error
MESSAGE: Firmware download failed
ACTION: Check your hardware configuration. If problems persist, report these errors to Technical Support.

Common Transport Events

MSG_ID: 1600 Debug: CT sent


VERBOSE_MASK: LOG_CT (0x00010000)
DESCRIPTION: This indicates that a CT command is being sent.
SEVERITY LEVEL: Debug
MESSAGE: CT sent
ACTION: No action needed, informational.

MSG_ID: 1601 Debug: CT comp


VERBOSE_MASK: LOG_CT (0x00010000)
DESCRIPTION: This indicates that a CT command completed normally.
SEVERITY LEVEL: Debug
MESSAGE: CT comp
ACTION: No action needed, informational.

MSG_ID: 1610 Error: Stray CT completion


VERBOSE_MASK: LOG_CT(0x00010000)
DESCRIPTION: This indicates that a CT command completion was received without issuing a
corresponding CT command. This error could indicate a driver or firmware problem.
SEVERITY LEVEL: Error
MESSAGE: Stray CT completion
ACTION: No action needed. If problems persist, report these errors to Technical Support.

MSG_ID: 1611 Debug: Abnormal CT completion


VERBOSE_MASK: LOG_CT(0x00010000)
DESCRIPTION: This indicates that a CT command completed with a status error in the IOCB. It could
mean the FC device on the network is not responding. The driver will automatically retry this CT command
if needed.
SEVERITY LEVEL: Debug
MESSAGE: Abnormal CT completion
ACTION: Check physical connections to FC network and the state of the remote PortID.

MSG_ID: 1620 Debug: CT rcvd


VERBOSE_MASK: LOG_CT(0x00010000)
DESCRIPTION: This indicates that an unsolicited CT command was received.
SEVERITY LEVEL: Debug
MESSAGE: CT rcvd
ACTION: No action needed, informational.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 97


MSG_ID: 1621 Debug: Unsolicited CT dropped
VERBOSE_MASK: LOG_CT(0x00010000)
DESCRIPTION: This indicates that an unsolicited CT command was received and then dropped for some
reason.
SEVERITY LEVEL: Debug
MESSAGE: Unsolicited CT dropped.
ACTION: No action needed, informational.

MSG_ID: 1622 Debug: CT reply


VERBOSE_MASK: LOG_CT(0x00010000)
DESCRIPTION: This indicates that a reply is being sent for an unsolicited CT command.
SEVERITY LEVEL: Debug
MESSAGE: CT reply
ACTION: No action needed, informational.

MSG_ID: 1630 Error: Invalid CT command found


VERBOSE_MASK: LOG_CT(0x00010000)
DESCRIPTION: This indicates that a CT command was found with an invalid command code.
SEVERITY LEVEL: Error
MESSAGE: Invalid CT command found
ACTION: No action needed. If problems persist, report these errors to Technical Support.

Troubleshooting and Maintenance Manual for Emulex HBAs Page 98

You might also like