Troubleshooting and Maintenance Manual for LightPulse® Adapters P003409-01A Rev A Critical Connectivity SolutionsTM
Copyright © 2008 Emulex. All rights reserved worldwide. No part of this document may be reproduced by any means or translated to any electronic medium without the prior written consent of Emulex. Information furnished by Emulex is believed to be accurate and reliable. However, no responsibility is assumed by Emulex for its use; or for any infringements of patents or other rights of third parties which may result from its use.
Overview ................................................................................................................. 1 Be Informed, Stay Informed, Stay Current ......................................................... 1 Driver Updates .................................................................................................. 1 Drivers for Windows .................................................................................... 1 Drivers for Linux .............................................
Overview Be Informed, Stay Informed, Stay Current In addition to staying informed and current, these steps are a great first defense when troubleshooting any Emulex adapter software and hardware issue. • Read the documentation on the Emulex Web site. From the main Emulex Web site, click Support. Each adapter, driver, firmware and boot code has documentation posted to the Web site. • Use the Emulex knowledgebase. From the main Emulex Web site, click Support, then click knowledgebase.
Drivers for Linux • The driver for Linux supports kernels for Open Source drivers. • The driver download includes the base driver, and if it is not included in the applications kit, the application helper module install script. • The applications kit includes the HBAnyware utility and the application helper module. • The SMI-S Provider kit for RedHat includes the SMI-S adapter Provider, compliant with the SMI-S 1.0.2 specification and certified against the SNIA-CTP v1.0.2.23 suite.
The Importance of Compatibility Emulex works very closely with storage and system providers to ensure optimal performance of supported systems. As part of that work, both Emulex and the storage and system providers test specific hardware configurations and specific versions of firmware, drivers and other software for all the components of a storage area network (SAN). This testing ensures that each supported configuration performs as indicated and operates successfully in an enterprise installation.
Troubleshooting 1. Observe the problem. 2. Isolate the problem. Observing the Problem Take a step back and think about what is being seen. Ask the following questions: • If the SAN has been working, what has changed? Apart from a catastrophic hardware failure, SANs typically do not just stop working – something has changed. For example, a commonly overlooked SAN change is a switch firmware upgrade.
Isolating the Problem Once the problem is observed, determine where the problem originates. Eliminate problem sources on a coarse level, is the problem in the SAN or in the server? Determining this reduces the size and scope of the troubleshooting effort. If the SAN can be eliminated, only the server and its components need to be examined. This topic discusses common problems related to the SAN and the server. SAN Components SAN-related problems can include the switch, storage and cabling.
• • Incorrectly set configuration parameters. If the driver parameters are set incorrectly, erratic behavior can occur such as very long failure timeouts, storage being overrun by too many concurrent commands and failures in path management software that rely on specific Emulex driver settings. • Incorrect target binding. If persistent binding is not correct, devices that are expected to show in the OS storage management tool are not present.
• Check switch zoning. Large switched fabrics are complicated to set up and maintain. Zoning is a key element of a good configuration, and it is one of the most complicated to manage. An improperly zoned fabric can cause a variety of problems that are not always directly attributable to zoning.
Installation Checklist This checklist covers installation of drivers and utilities. In addition to this checklist, verify with your storage and system providers for any specific instruction they may provide. Some OEM vendors will repackage drivers and utilities. • Verify recommended driver, firmware, and boot versions from your storage and system providers. Many storage and system providers qualify specific adapter models, driver, and firmware releases.
Configuration Checklist • Verify recommended driver, firmware, and boot versions from your storage and system provider. Many providers qualify specific adapter models, driver and firmware releases that they support. Using qualified provider solutions will ensure you have a supported SAN configuration. • Verify releases for storage and system providers that have a page on the Emulex Web site. If the provider is not listed, verify any preferred driver releases.
Tools to Collect Data Emulex provides tools to collect data about a problem or behavior with Emulex products. Sometimes, more importantly, these tools provide information about general SAN operation, even if the problem appears to be outside of Emulex's domain. Driver Tools All Emulex OS device drivers can log additional events beyond critical errors. This can be useful in troubleshooting. By default, Emulex drivers log only severe errors, but can be configured to log more events.
Common Problems Hardware Issues Symptoms that indicate you may need to return the adapter to Emulex for repair: • Host system (server) does not pass power-on self test (POST). • The server does not boot. • LEDs on the adapter stop flashing or flash an error code. • The bus has incorrect power. • Hardware errors are logged in the event log or message file. • There are onboard parity errors. • There are Peripheral Component Interconnect (PCI) parity errors. • There are firmware “traps”.
Can Not See Devices or Drives Possible reasons why you can not see devices or drives: • Some devices are not powered on. Some adapter have a separate green 3.3V power indicator LED (see page 19). • The LEDs indicate that the link is down. On an adapter, a link-down is indicated when the green LED flashes and the yellow LED is off (see Table 1 on page 20). On a switch, the LED states vary depending on the switch vendor. See the switch vendor’s documentation. • The cable is not working.
Out-of-Date Firmware Version Symptoms that indicate you may need to update your firmware. For more information, see page 2. • The FC link fails to come up or stay up. • Mailbox time-out errors in the OS event log or the UNIX message file. • One or more LEDs have stopped flashing. • The system stops responding. • The system has lower than expected performance. LP21000 Problems LP21000 Checklist Check CEE Switch Configuration.
When to Contact Emulex Contact Emulex if you still experience problems after you: • Review the checklists in this manual and follow any suggestions for basic troubleshooting, such as updating driver or firmware. • Verify the environment is supported. If the adapter is a standard Emulex model, use the online knowledgebase located on the support section of www.emulex.com for resolutions to the problem. The knowledgebase is available 24/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 adapters • Emulex released driver, downloads and documentation • Contact support (OEM and Emulex e-mail and phone information) • E-mail support (Technical Support Request Form) • Emulex knowledgebase • Online support • Product registration • Return product information • Warranty information • Legacy Product documentation (ada
• Online Support. This password protected site allows you to open new cases and check the status of existing cases by clicking the online support link on the Emulex Support page. Report problems, documentation issues, web site navigation difficulties or status of an RMA. Request general information, recommend enhancements or escalate a problem. The online support system is available on all non-holiday work days, Monday through Friday, 7:00 AM to 4:00 PM (Pacific Time).
Return More than 10 Products or Check RMA Status. E-mail or phone to check repair status or return more than 10 products. Contact Emulex AfterHours, Weekends or Holidays Phone if you have after-hours, holiday or weekend issues. The Americas and in Asia: • E-mail address: tech.support@emulex.com • Telephone: 800-752-9068, option 2. Europe: • E-mail address: tech.support@emulex.com • Telephone: (44) 1189-772929 • Warranty Information. A printable .PDF of the Emulex standard limited warranty.
LED Reference Information Firmware Operation and Port Activity LEDs Emulex adapters have a POST test. Each port has a set of green and yellow LEDs (visible through openings in the adapter's mounting bracket) that indicate the conditions and results of the POST. • Green = firmware operation • Yellow = port activity Adapter LEDs also identify possible problems. For more information on LED states, see Table 1 on page 20.
4 Gb/s link up: • For 4 Gb/s adapters, a solid Green LED and triple blinking (4 Hz) yellow LED. • For 8 Gb/s adapters, a solid green LED and a fast triple blinking yellow LED. 8 Gb/s link up: • For 8 Gb/s adapters, a solid Green LED and fast quadruple blinking (4 Hz) yellow LED. Link-Down or adapter waiting • The difference between slow and fast blinking LEDs is obvious.
LED Table Note: All states except link rate apply to both HBAs and CNAs. The 4 Gb/s link rate is applicable to both HBAs and CNAs. The 2 Gb/s and 8 Gb/s link speed apply to HBAs only.