Instruction/ maintenance manual of the product FC0054607-00 A Q-Logic
Go to page of 62
FC0054607-00 A Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User ’ s Guide.
ii FC0054607-00 A Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Information fu rnished in this manual is believed to be accurate and reliable.
FC0054607-00 A iii T able of Content s Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
iv FC0054607-00 A Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Using the QLogic Fast! UTIL BIOS Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5 V erifying That the Driver is Loaded . . . . . .
FC0054607-00 A v Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guid e A-6 Common Driver Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6 A-7 Proc Output . . . . . . . . . .
vi FC0054607-00 A Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Notes.
FC0054607-00 A vii Preface QLogic provides a port folio of Fibre Channel Adapters, Intelligent Ethern et Adapters, and Converged Network Ada pters on the VMware ® ESX/ESXi 4.0 platform: QLogic Fibre Channel Adapters include 2Gb, 4Gb, and 8Gb adapter offerings on VMware ESX/ESXi 4.
viii FC0054607-00 A SANsurfer FC HBA CLI User ’s Guide (p art number SN0054614-00) SANsurfer FC HBA CLI release notes and ReadMe file Related VMware document ation: Online VMware Comp atibility Guide located here: http://www .vmware.com/go/hcl VMware Fibre Channel SAN Configuration Guide located here: http://www .
FC0054607-00 A ix 2 Installatio n details the sup ported features and covers installation of hardware, drivers, and SANsurfer ® manageme nt tools.
x FC0054607-00 A T ext within square brackets indicates optional p arameters. For example iscli [optional parameters] [ Command Variable ] Te x t i n blue font indicates a hyperlink (ju mp) to a figure, table, chapter , or section in this guide, and link s to W eb sites are shown in underlined blue .
FC0054607-00 A xi Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates. A vailability QLogic T echnical Support for product s under wa rranty is available during local standard working hours exclud ing QLogic Observed Holidays.
xii FC0054607-00 A Notes.
FC0054607-00 A 1-1 1 Hardware and Sof tware Component s This chapter provides details a bout QLogic Fibre Channel and Converged Network Adapters in VMware ESX/ESXi, including: Hardware Component s.
1–Hardware and So ftware Components Hardware Components 1-2 FC0054607-00 A Figure 1-1 Adapter Components T able 1-1. Adapter Com ponent Details Callout Number Description 1 The reduced instruction set comp uter (RISC) processor , also known as the intelligent stor- age periphera l (ISP) controller , is the heart of the adapter .
1–Hardware and Sof tware Component s Software Comp onents FC0054607-00 A 1-3 Sof tware Component s This section describes the following QLogic adapter software component s: Boot Code OS Driver Firmware Management T ools and Utilities Boot Code Boot code resides on the Flash memory on the ada pter .
1–Hardware and So ftware Components Supported QLogic Adapters 1-4 FC0054607-00 A Firmware The firmware module performs most of the Fibre Channel and FCoE protocol-related functions, thus freeing the system CPU and memory resources from protocol processing.
FC0054607-00 A 2-1 2 Inst allation This chapter provides the follo wing inst allation information: Supported Features “Installing the Hardware” o n page 2-2 “Installing the Drive r.
2–Installation Installing the Hardware 2-2 FC0054607-00 A Support for MSI-X —on 4/8Gb Fibre Channel and Converged Ne twork Adapters. Support for VMware SCSI p ath failover —for Active/Active and Active/Passive stora ge devices.
2–Installation Installing the Driver FC0054607-00 A 2-3 5. Refasten the adapter's reta ining bracket using the existing screw or lever . 6. Close the computer cover . 7. Plug the Fibre Channel or Etherne t cable into the adapter . 8. Plug in the power cable and turn on the comp uter .
2–Installation Installing SANsurfer Management T ools 2-4 FC0054607-00 A Inst al ling SANsurfer FC HBA Manage r T o run SANsurfer FC HBA Manager on a VMware ESX 4.0 server requires a two-step installation process, whereb y: 1. Y ou must install the SANsurfer back end, commonly called the qlremote agent , on the ESX server .
2–Installation Installing SANsurfer Management T ools FC0054607-00 A 2-5 2. Click the by Operating System button, and then select Fibre Channel Adapters , VMware , and VMware ESX/ESXi , as shown in Figure 2-2 . Figure 2-2 Downloading SANs urfer FC HBA Manager—VMware 3.
2–Installation Installing SANsurfer Management T ools 2-6 FC0054607-00 A c. In the command window , type hostname , and then press ENTER . 9. On the ESX Host, add the IP address and the “ho stname” of the remote system where you plan to run SANsur fer FC HBA Manager to the following files: /etc/hosts /etc/hosts.
2–Installation Installing SANsurfer Management T ools FC0054607-00 A 2-7 3. Click Go . 4. Under Management T ools , click SANsurfer FC HBA Manager (x86/x64) . 5. On the End User Sof tware License Agreement p age, click Agree . 6. Save the zipped file and then use it to inst all SANsurfer FC HBA Manager by following the installation wizard.
2–Installation Installing SANsurfer Management T ools 2-8 FC0054607-00 A 4. On the VMware ESX/ESXi download page under Management T ools , click SANsurfer FC HBA CLI (x86/x64) . 5. On the End User Sof tware License Agreement p age, click Agree . 6. Save the scli- x .
FC0054607-00 A 3-1 3 Configuration QLogic Fibre Channel an d Converged Network Adapters on VMware ESX/ESXi 4.0 configuration proce dures include the following: Identifying QLogic Adapters on VMware ESX/ESXi 4.
3–Configuration Identifying QLogic Adapte rs on VMware ESX/ESXi 4.0 3-2 FC0054607-00 A T o identify QLogic Fibre Channel and Converged Ne twork Adapters using vSph ere: 1. S tart vS phere Client and select the host you want. 2. Click the Configuration tab to b ring the Configuration page to the front.
3–Configuration Identifying QLogic Adapter s on VMware ESX/ESXi 4.0 FC0054607-00 A 3-3 T o identify QLogic Fibre Channel and Converged Ne twork Adapters using console OS: 1.
3–Configuration Identifying QLogic Adapte rs on VMware ESX/ESXi 4.0 3-4 FC0054607-00 A Figure 3-2 Finding Adapte rs on VMware ESX/ESXi 4.0 Driver information includes the following: Host adapter: loop state specifies the current state of the adapter port, including: READY —Driver is ready to handle IO commands.
3–Configuration Using the QLogic Fast!UTIL BIOS Utility FC0054607-00 A 3-5 NPIV Supported indicates wh ether the adapter port suppo rts NPIV . If Yes , the maximum number of supported virtual port s on that specific adapter port is shown in the next line, Max Virtu al Ports .
3–Configuration V erifying That the Driver is Loaded 3-6 FC0054607-00 A Select Host Adapter setting enables you to select a specific ada pter , if you have multiple Fibre Channel or Converged Network Adap ters in your system, and then configure or view the adapter ’s settings.
3–Configuration Configuring the Driver Parameters FC0054607-00 A 3-7 Figure 3-3 V erifying That the Driver is Loaded Configuring the Driver Parameters Use the esxcfg-module command to configure the QLogic Fibre Channel and Converged Network Adapter driver p arameters.
3–Configuration Configuring the Driver Parameters 3-8 FC0054607-00 A where < options > is one of the configurable p arameters listed in T able 3-1 on pa ge 3-8 . For example, the following command set s the maximum device qu eue depth reported by the QLogic to a value of 32 : # esxcfg-module -s ql2xmaxqdepth=32 qla2 xxx 3.
3–Configuration Deploying NPIV for VMware ESX/ESXi 4.0 FC0054607-00 A 3-9 Deploying NPIV for VMware ESX/ESXi 4.0 QLogic Fibre Channel and Converged Ne twork Adapt ers support N_Port ID virtualization (NPIV) for Fibre Channe l and FCoE SANs.
3–Configuration Monitoring NPIV Virtual Ports from SANsurfer 3-10 FC0054607-00 A VMware ESX/ESXi 4.0 enables NPIV supp ort on QLogic 4Gb/ 8Gb Fibre Channel Adapters and QLE8000 Series Co nverged Network Adapters. No additional software or ha rdware installation is required to support NPIV .
3–Configuration Monitoring NPIV V irtual Ports from SANsurfer FC0054607-00 A 3-1 1 Figure 3-4 SANsurfer FC HBA Manager Showing NPIV When you select an in dividual virtual por t on the T opology pa ge, SANsurfer FC HBA Manager displays additional det ails about the selected virtu al port on four tabbed p ages.
3–Configuration Configuring Bo ot from SAN 3-12 FC0054607-00 A Figure 3-5 V irtual Port In formation Page in SANsurfer Configuring Boot from SAN Boot from SAN refers to installing and booting a server ’ s operating system from a storage device atta ched to the SAN instead of from a locally att ached storage device.
3–Configuration Configuring Boot from SAN FC0054607-00 A 3-13 VMware ESX/ESXi 4.0 provides boot from SAN capability on QLogic Fibre Channel Adapters. For storage array and Fibre Chann el switch configuration, refer to the appropriate user manual for the device.
3–Configuration Configuring Bo ot from SAN 3-14 FC0054607-00 A 7. After the Host Adapter BIOS is enabled, select the boot device as shown in the following tab le: a. Choose Select able Boot Settings , and then press ENTER . b. On the Selectab le Boot Settings p age, choose Select able Boot .
FC0054607-00 A A-1 A T roubleshooting This appendix provides the following met hods of determining the stat us of the adapters and finding solutions to common prob lems: T roubleshooting with LEDs.
A–T roubleshoot ing T roubleshoot ing with LEDs A-2 FC0054607-00 A T able A-2. QLA24 xx/QLE24xx/QEM2462 Adapter LED Scheme Y ellow LED Green LED Amber LED Activity ❍ ❍ ❍ Power of f ●●● P.
A–T roubleshooting Dynamic Exte nded Logging FC0054607-00 A A-3 Dynamic Extended Logging The QLogic driver provides a mechani sm to dynamically enable extended error logging about driver operation. Thes e logs provide debugging and error information to help you underst and driver behavior regarding issues related to the adapter .
A–T roubleshoot ing T roubleshooting with Driver Lo gs A-4 FC0054607-00 A When the logging is enabled, the d river version in the /proc/scsi/qla2xxx/< adapter numbe r > is appended with a -debug flag as shown below: # cat /proc/scsi/qla2xxx/5 QLogic PCI to Fibre Channel Host Adapter for QLE2462: Firmware version 4.
A–T roubleshooting T roubleshoot ing with Driver Log s FC0054607-00 A A-5 Aug 18 15:15:13 localhost vmkernel: 0:00:00:34.550 cpu6:4109)<6>qla2xxx 0000:0a:00.0: Allocated (1413 KB) for firmware dump... Aug 18 15:15:13 localhost vmkernel: 0:00:00:34.
A–T roubleshoot ing T roubleshooting with Driver Lo gs A-6 FC0054607-00 A T able A-6 lists the more common driver log messages and provid es an explanation of each.
A–T roubleshooting T roubleshoot ing with Driver Log s FC0054607-00 A A-7 "scsi(%d): RSCN,..." Driver received a registe red state chang e notification (RSCN) async event from the firmware . Additional information follows the message (tha t is, mailbox values from the firmware).
A–T roubleshoot ing T roubleshooting with Driver Lo gs A-8 FC0054607-00 A "WARNING qla2xxx: Couldn't allocate host from scsi layer!" Indicates the driver could not r egister with the SCSI la yer , usua lly because it could n ot allocate the mem- ory required for the adapter .
A–T roubleshooting Debugging Using Proc Information FC0054607-00 A A-9 Debugging Using Proc Information The driver /proc/scsi/qla2xxx/ < adapter_number > provides debugging information that can help you troubleshoot problems with the driver . The /proc entry provides firsthand informa tion about the current state of th e driver .
A–T roubleshoot ing Collecting System Logs for T roubleshooting A-10 FC0054607-00 A Collecting System Logs for T roubleshooting T o collect all relevant dat a on the running system into one ta r fil.
FC0054607-00 A Glossary-1 Glossary adapter The board that interfaces between the host system and the t arget devices. Adapter is synonymous with host bus adapter (HBA) , host channel adapter (HCA) , host adapter , and a dapter board .
Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Glossary-2 FC0054607-00 A cache A temporary high-speed storage (memory) area where recently used or freque ntly accessed data is st ored for rapid access, thus increasing the ef ficiency of processor operations.
FC0054607-00 A Glossary-3 Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guid e fabric switch Also, switched fabric. Connect s multiple devices from independent Fibre Channel-arbitrated loop s (FC-ALs) and point-to-point topologies into a fabric using Fibre Channel switches.
Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Glossary-4 FC0054607-00 A ISL Inter-switch link. The connection between two switches using E_Port s.
FC0054607-00 A Glossary-5 Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guid e N_Port Node port. A port that connect s by a point-to-point link to either a single N_Port or a single F_Port . N_Port s handle creation, detection, and flow of messag e units to a nd from the connected systems.
Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Glossary-6 FC0054607-00 A This is important to the driver when selecting the proper method of failover notification.
FC0054607-00 A Glossary-7 Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guid e ta rg e t The storage-device end point of a SCSI session. Initiators request dat a from target s (usually disk-drives, tape-drives, or other media devices).
Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Glossary-8 FC0054607-00 A Notes.
FC0054607-00 A Index-1 Index A acronyms, definitions of Glossary-1 adapter port beacon, defin ition of Glossary-1 adapter port, definition o f Glossary-1 adapters definition of Glossary-1 identifying .
Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Index-2 FC0054607-00 A device boot, configuring 3-5 definition of Glossary-2 external boot 1-3 fibre, scanning for.
FC0054607-00 A Index-3 Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guid e installing 2-1 driver 2-3 hardware 2-2 SANsurfer FC HBA CLI 2-7 SANsurfer FC HBA Manager 2-4.
Fibre Channel and Conver ged Network Adapters for VMware ESX/ESXi 4.0 User ’s Guide Index-4 FC0054607-00 A NPIV definition of Glossary-5 deploying 3-9 virtual ports, monitorin g 3-10 NVRAM definitio.
FC0054607-00 A Index-5 Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guid e supported adapters 1-4 features 2-1 system logs, collecting A-10 T target definition of Glos.
© 2009 QLogic Corporation. Specifications ar e subject to change without notice. All ri ghts reserved worldwide. QLogic and the Q Logic logo are registered trademarks of QLog ic Corporation. VMware is a registered trademark, and vCenter , VMotion, and vS phere are trademarks of VMware , Inc.
An important point after buying a device Q-Logic FC0054607-00 A (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Q-Logic FC0054607-00 A yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Q-Logic FC0054607-00 A - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Q-Logic FC0054607-00 A you will learn all the available features of the product, as well as information on its operation. The information that you get Q-Logic FC0054607-00 A will certainly help you make a decision on the purchase.
If you already are a holder of Q-Logic FC0054607-00 A, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Q-Logic FC0054607-00 A.
However, one of the most important roles played by the user manual is to help in solving problems with Q-Logic FC0054607-00 A. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Q-Logic FC0054607-00 A along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
