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) 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)

Other topics covered in this manual include:

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. Page 1

Troubleshooting and Maintenance Manual for Emulex HBAs

• • • • •

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 operating 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 HBAnyware 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 documentation. • 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 operating 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 discovery-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 software. • 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. Page 4

Troubleshooting and Maintenance Manual for Emulex HBAs

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 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 driver for Linux supports kernels for Open Source drivers. • • • •

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 driverspecific 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. The switch or hub is on. The driver is loaded. The driver reset the HBA.

LEDs will help you determine whether:

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 Off On Slow blink Fast blink Flashing Green LED Off Off Off Off Off State Wake-up failure (dead board) POST failure (dead board) Wake-up failure monitor POST failure POST process in progress

Troubleshooting and Maintenance Manual for Emulex HBAs

Page 6

Table 1: LED Reference Table (Continued)
Off On 4-Gb HBAs: 1 blink 2 blinks 3 blinks 2-Gb HBAs: Slow blink Fast blink Off Slow blink Fast blink Flashing On On On On On On On Slow blink Slow blink Slow blink Slow blink Failure while functioning Failure while functioning 1-Gb link rate - normal, link up 2-Gb link rate - normal, link up 4-Gb link rate - normal, link up 1-Gb link rate - normal, link up 2-Gb link rate - normal, link up Normal - link down or not started Off-line for download Restricted offline mode (waiting for restart) 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. Enter a 1-5 digit solution ID in the Solution ID field (you must know the solution ID to conduct this search).

By the solution ID: •

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 Telephone: (44) 1189-772929

In Europe: • 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. E-mail address: tech.support@emulex.com Telephone: (44) 1189-772929

Within Europe: • •

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 signal 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 section 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. Storport Miniport driver, version 1.03 (or later) SCSIport Miniport driver, version 5.10a10 (or later)

• • • •

The following Emulex drivers are compatible with FCINFO:

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: Boot Device LUN: Topology 104AC6D2 43 Point-to-Point C920A4D6

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: adapter 2: adapter 3: adapter 4: adapter 5: adapter 6: 10000000 WWN err. 10000000 10000000 10000000 10000000 !!! C920A4B3 Functional FW: ES1.91A0 !!! LP8000 LP850 LP9000 LP9802 LP950 LP250048-900

ReadRev Error C920B4C2 C920A6D1 C920C6B4 C920E4B6

Functional FW: CS3.81A3 Functional FW: CS3.90A4 Functional FW: HS1.00A2 Functional FW: RS3.90A6

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 Nonvolatile 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:
LP250048-900 Config IEEE 10000000 C920B2F4 Non-Volatile WWPN: 2AB148C6 46A2D3F2, WWNN: 4B5C6D8E 12345678 Non-Volatile WWPN: 5AB0E2F4 B620DAB8, WWNN: 46A0B4DA E2F4C8A0 adapter 1:

adapter 2:

LPe11000

Config IEEE 10000000

C920DAB8

where the Config IEEE is the original IEEE address from manufacturing, obtained from Configuration 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 (respectively) 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: adapter 2: adapter 3: adapter 4: adapter 5: adapter 6: 00001800 00002000 00001000 00001400 00001600 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: SM: SM FW: ENDEC: FW Rev: Current FW: Kernel Rev: Kernel Init FW: SLI-1: SLI-2: LP250048-9001.30a4 LP250048-900Init Load 1.91a0 (ES1.91A0) LP250048-900Overlay 1.91a0 (E1M1.91A0) LP250048-900Overlay 1.91a0 (E2M1.91A0 SLI-2 Overlay FFB01314 1001206D 00000000 07B21950 00000000

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: adapter 2: C92E511A C9396BA6 Functional FW: Functional FW: HS1.90A4 ES1.91A0

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

Troubleshooting and Maintenance Manual for Emulex HBAs

Page 42

Table 2: The Offline Utility Error Codes (Continued)
Error Code 34 35 36 37 38 39 40 41 42 43 44 45 46 Description Write NVPAMRMS error Command does not support all adapters Invalid LUN No boot code enabled Update configuration region error No boot code found Dump memory error Update erasable read-only memory (EROM) error Delete load entry error Write WWN error Not supported in script file No Emulex HBA found 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 @ <command-file> Description Executes commands in a script file. The @ sign is followed by the pathname of the script file. Example: @a:\script1.txt Enables the selected boot code on the HBA specified by its number. Creates a log file using the specified file name. Terminates the lp6dutil session and passes control to DOS. Changes the state of the HBA soft jumpers, 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). Runs the pciloopback test. 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. Disables the current boot code on the HBA specified by its number. Runs the external loopback test. The 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. Lists the HBAs that are installed in the system (HBA #, WWN, functional FW, HBA type and mailbox error (if any). Resets one or all adapters in the system. s=1 skips POST during a restart, s=0 performs a standard reset. This command is used at the end of a script file to repeat a series of commands from the beginning of the script file. Downloads the specified firmware image to all HBAs of the same name. Downloads the specified firmware image file to the one HBA, as specified by its number.

enableboot logfile exit jumper

enableboot <n=adapter> <i=index> logfile <l=filename> exit jumper <n=adapter> <s=selection> <r=region>

pciloopback

pciloopback <n=adapter/all> <r=repeatcount> <o=option>

disableboot extloopback

disableboot <n=adapter> extloopback <n=adapter/all> <r=repeatcount> <o=option>

listhba

listhba

reset

reset <n=adapter/all> <s=custom/ standard reset> repeat <script>

repeat

download download

download <a=adapter name> <i=firmware image filename> download <n=adapter number> <i=firmware image filename>

Troubleshooting and Maintenance Manual for Emulex HBAs

Page 47

Table 3: Commands and Syntax
Command help listboot Syntax help <command> listboot <n=adapter> Description Lists the syntax for the specified command. Lists boot code versions with indexes (base 1) that are currently loaded in the flash of the HBA specified by its number. This command displays the VPD contents of the adapter specified by its number.

vpd

vpd n=<adapter 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. Page 71

Troubleshooting and Maintenance Manual for Emulex HBAs

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. 1 = Only one test can be run. 2 = Multiple tests (up to five) can be run.

Request Type • •

• •

Entry Count - The number of tests to be run. Error Action Page 73

Troubleshooting and Maintenance Manual for Emulex HBAs

• • • • •

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
Driver Parameter console-notices Default/ Min/Max 0 Effect of Changing Default Sets the verbose level for driver notices to the console. Sets the verbose level for driver warnings to the console. Sets the verbose level for driver errors to the console. Sets the verbose level for driver notices to the system log file. Sets the verbose level for driver warnings to the system log file. Sets the verbose level for driver errors to the system log file. log-verbose (when set to non-zero, verbose messages are generated.) Default = Disabled Related lpfc Driver Parameters log-only (when set to 0, log messages are logged to the system log file and also printed on the console.) Default = Disabled

console-warnings

0

console-errors log-notices

0 0xffffffff;

log-warnings

0xffffffff;

log-errors

0xffffffff;

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 Mask LOG_MISC LOG_DRIVER LOG_INIT LOG_MEM LOG_SLI LOG_MBOX LOG_NODE LOG_LINK LOG_ELS LOG_PKT LOG_FCP LOG_TGTM LOG_IP LOG_SFS LOG_IOCTL LOG_FIRMWARE LOG_CT LOG_RESERVED LOG_NODE_DETAIL LOG_IOCTL_DETAIL LOG_IP_DETAIL LOG_FIRMWARE_DETAIL LOG_Solaris SFS_DETAIL LOG_MBOX_DETAIL LOG_SLI_DETAIL LOG_ALL_MSG Verbose Bit 0x00000001 0x00000002 0x00000004 0x00000008 0x00000010 0x00000020 0x00000040 0x00000080 0x00000100 0x00000200 0x00000400 0x00000800 0x00001000 0x00002000 0x00004000 0x00008000 0x00010000 0x01FE0000 0x02000000 0x04000000 0x08000000 0x10000000 0x20000000 0x40000000 0x80000000 0XFFFFFFFF Verbose Description Miscellaneous events Driver attach and detach events HBA Initialization events Memory management events SLI events Mailbox events Node events Link events ELS events General I/O packet events FCP traffic events FCP target mode events IP traffic events Solaris SFS events IOCTL events Firmware download events FC Common Transport events Reserved for future use Detailed Node events Detailed IOCTL events Detailed IP events Detailed Firmware events Detailed Solaris SFS events Detailed Mailbox events Detailed HBA SLI events Detailed Node events

Troubleshooting and Maintenance Manual for Emulex HBAs

Page 77

Severity Levels
Table 3: Severity Levels
Level DEBUG (Informational NOTICE (Informational) WARNING ERROR PANIC (Severe) Message Description Message provides engineering debug information. Message provides a general purpose information. Message provides a general purpose warning. Message indicates that a driver error has occurred. 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