Page 2 - Document Revision History
ii FC0054607-00 A Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guide Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of...
Page 3 - Table of Contents; Preface
FC0054607-00 A iii Table of Contents Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii What’s in This Guide . . . . . . ...
Page 4 - Troubleshooting; List of Tables
iv FC0054607-00 A Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guide Using the QLogic Fast! UTIL BIOS Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5 Verifying That the Driver is Loaded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6...
Page 6 - Notes
vi FC0054607-00 A Fibre Channel and Converged Network Adapters for VMware ESX/ESXi 4.0 User’s Guide Notes
Page 7 - Intended Audience; Related Materials
FC0054607-00 A vii Preface QLogic provides a portfolio of Fibre Channel Adapters, Intelligent Ethernet Adapters, and Converged Network Adapters on the VMware ® ESX/ESXi 4.0 platform: QLogic Fibre Channel Adapters include 2Gb, 4Gb, and 8Gb adapter offerings on VMware ESX/ESXi 4.0 in PCI-X™, PCI Exp...
Page 8 - What’s in This Guide
viii FC0054607-00 A SANsurfer FC HBA CLI User’s Guide (part number SN0054614-00) SANsurfer FC HBA CLI release notes and ReadMe file Related VMware documentation: Online VMware Compatibility Guide located here: http://www.vmware.com/go/hcl VMware Fibre Channel SAN Configuration Guide located ...
Page 9 - Documentation Conventions
FC0054607-00 A ix 2 Installation details the supported features and covers installation of hardware, drivers, and SANsurfer ® management tools. 3 Configuration covers how to identify QLogic adapters, start Fast! UTIL, verify that the driver is loaded, configure driver parameters, deploy N_Port I...
Page 10 - Figure i Jagged-edged Screen Shots Depict Partial Interface; License Agreements; Technical Support
x FC0054607-00 A Text within square brackets indicates optional parameters. For example iscli [optional parameters] [ Command Variable ] Text in blue font indicates a hyperlink (jump) to a figure, table, chapter, or section in this guide, and links to Web sites are shown in underlined blue . For...
Page 11 - Availability; Contact Information
FC0054607-00 A xi Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates. Availability QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays. Training QLogic offer...
Page 13 - Hardware Components
FC0054607-00 A 1-1 1 Hardware and Software Components This chapter provides details about QLogic Fibre Channel and Converged Network Adapters in VMware ESX/ESXi, including: Hardware Components “Software Components” on page 1-3 “Supported QLogic Adapters” on page 1-4 Hardware Components A typic...
Page 14 - Figure 1-1 Adapter Components
1–Hardware and Software ComponentsHardware Components 1-2 FC0054607-00 A Figure 1-1 Adapter Components Table 1-1. Adapter Component Details Callout Number Description 1 The reduced instruction set computer (RISC) processor, also known as the intelligent stor-age peripheral (ISP) controller, is the h...
Page 15 - Software Components; Boot Code; OS Driver
1–Hardware and Software Components Software Components FC0054607-00 A 1-3 Software Components This section describes the following QLogic adapter software components: Boot Code OS Driver Firmware Management Tools and Utilities Boot Code Boot code resides on the Flash memory on the adapter. T...
Page 16 - Firmware; Management Tools and Utilities; Supported QLogic Adapters
1–Hardware and Software ComponentsSupported 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. This efficiency keeps the QLogic Fibre Channe...
Page 17 - Installation; Supported Features
FC0054607-00 A 2-1 2 Installation This chapter provides the following installation information: Supported Features “Installing the Hardware” on page 2-2 “Installing the Driver” on page 2-3 “Installing SANsurfer Management Tools” on page 2-3 Supported Features When properly installed, QLogic ...
Page 18 - Installing the Hardware; Figure 2-1 Installing the Adapter
2–InstallationInstalling the Hardware 2-2 FC0054607-00 A Support for MSI-X —on 4/8Gb Fibre Channel and Converged Network Adapters. Support for VMware SCSI path failover —for Active/Active and Active/Passive storage devices. Support for VMware VMotion™ and VMware Storage VMotion Remote SAN an...
Page 19 - Installing the Driver
2–Installation Installing the Driver FC0054607-00 A 2-3 5. Refasten the adapter's retaining bracket using the existing screw or lever. 6. Close the computer cover. 7. Plug the Fibre Channel or Ethernet cable into the adapter. 8. Plug in the power cable and turn on the computer. 9. Verify the LEDs on...
Page 20 - Installing SANsurfer FC HBA Manager
2–InstallationInstalling SANsurfer Management Tools 2-4 FC0054607-00 A Installing SANsurfer FC HBA Manager To run SANsurfer FC HBA Manager on a VMware ESX 4.0 server requires a two-step installation process, whereby: 1. You must install the SANsurfer back end, commonly called the qlremote agent , on...
Page 21 - Figure 2-2 Downloading SANsurfer FC HBA Manager—VMware
2–Installation Installing SANsurfer Management Tools 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 SANsurfer FC HBA Manager—VMware 3. Click Go . 4. On the VMware ESX/...
Page 22 - Figure 2-3 Downloading SANsurfer FC HBA Manager—Linux
2–InstallationInstalling SANsurfer Management Tools 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 “hostname” of the remote system where you plan to run SANsurfer FC HBA Manager to the following files: /etc/hosts /et...
Page 23 - Installing SANsurfer FC HBA CLI; Figure 2-4 Downloading SANsurfer FC HBA Manager—VMware
2–Installation Installing SANsurfer Management Tools FC0054607-00 A 2-7 3. Click Go . 4. Under Management Tools , click SANsurfer FC HBA Manager (x86/x64) . 5. On the End User Software License Agreement page, click Agree . 6. Save the zipped file and then use it to install SANsurfer FC HBA Manager b...
Page 25 - Configuration; Identifying QLogic Adapters on VMware; Using vSphereTM Client
FC0054607-00 A 3-1 3 Configuration QLogic Fibre Channel and Converged Network Adapters on VMware ESX/ESXi 4.0 configuration procedures include the following: Identifying QLogic Adapters on VMware ESX/ESXi 4.0 “Using the QLogic Fast!UTIL BIOS Utility” on page 3-5 “Verifying That the Driver is L...
Page 26 - Figure 3-1 vSphere Client Configuration Page; Using Console OS
3–ConfigurationIdentifying QLogic Adapters on VMware ESX/ESXi 4.0 3-2 FC0054607-00 A To identify QLogic Fibre Channel and Converged Network Adapters using vSphere: 1. Start vSphere Client and select the host you want. 2. Click the Configuration tab to bring the Configuration page to the front. 3. Un...
Page 30 - Verifying That the Driver is Loaded
3–ConfigurationVerifying That the Driver is Loaded 3-6 FC0054607-00 A Select Host Adapter setting enables you to select a specific adapter, if you have multiple Fibre Channel or Converged Network Adapters in your system, and then configure or view the adapter’s settings. The Fast! UTIL BIOS utilit...
Page 31 - Figure 3-3 Verifying That the Driver is Loaded; Configuring the Driver Parameters
3–Configuration Configuring the Driver Parameters FC0054607-00 A 3-7 Figure 3-3 Verifying 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 parameters. To configure driver parameters: 1...
Page 34 - Monitoring NPIV Virtual Ports from SANsurfer
3–ConfigurationMonitoring NPIV Virtual Ports from SANsurfer 3-10 FC0054607-00 A VMware ESX/ESXi 4.0 enables NPIV support on QLogic 4Gb/8Gb Fibre Channel Adapters and QLE8000 Series Converged Network Adapters. No additional software or hardware installation is required to support NPIV. Note that VMwa...
Page 35 - Figure 3-4 SANsurfer FC HBA Manager Showing NPIV
3–Configuration Monitoring NPIV Virtual Ports from SANsurfer FC0054607-00 A 3-11 Figure 3-4 SANsurfer FC HBA Manager Showing NPIV When you select an individual virtual port on the Topology page, SANsurfer FC HBA Manager displays additional details about the selected virtual port on four tabbed pages...
Page 36 - Figure 3-5 Virtual Port Information Page in SANsurfer; Configuring Boot from SAN
3–ConfigurationConfiguring Boot from SAN 3-12 FC0054607-00 A Figure 3-5 Virtual Port Information Page in SANsurfer Configuring Boot from SAN Boot from SAN refers to installing and booting a server’s operating system from a storage device attached to the SAN instead of from a locally attached storage...
Page 37 - Figure 3-6 Starting Fast!UTIL from the BIOS Screen
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 Channel switch configuration, refer to the appropriate user manual for the device. For VMware ESX/ESXi 4.0-specific config...
Page 39 - Troubleshooting with LEDs
FC0054607-00 A A-1 A Troubleshooting This appendix provides the following methods of determining the status of the adapters and finding solutions to common problems: Troubleshooting with LEDs “Dynamic Extended Logging” on page A-3 “Troubleshooting with Driver Logs” on page A-4 “Debugging Usi...
Page 41 - Dynamic Extended Logging
A–Troubleshooting Dynamic Extended Logging FC0054607-00 A A-3 Dynamic Extended Logging The QLogic driver provides a mechanism to dynamically enable extended error logging about driver operation. These logs provide debugging and error information to help you understand driver behavior regarding issue...
Page 42 - Troubleshooting with Driver Logs
A–TroubleshootingTroubleshooting with Driver Logs A-4 FC0054607-00 A When the logging is enabled, the driver version in the /proc/scsi/qla2xxx/< adapter number > is appended with a -debug flag as shown below: # cat /proc/scsi/qla2xxx/5 QLogic PCI to Fibre Channel Host Adapter for QLE2462: Firm...
Page 47 - Debugging Using Proc Information
A–Troubleshooting 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 information about t...
Page 48 - Collecting System Logs for Troubleshooting; Frequently Seen Issues
A–TroubleshootingCollecting System Logs for Troubleshooting A-10 FC0054607-00 A Collecting System Logs for Troubleshooting To collect all relevant data on the running system into one tar file, execute the following command: # vm-support Frequently Seen Issues Table A-8 lists some common issues and q...
Page 49 - Glossary
FC0054607-00 A Glossary-1 Glossary adapter The board that interfaces between the host system and the target devices. Adapter is synonymous with host bus adapter (HBA) , host channel adapter (HCA) , host adapter , and a dapter board . arbitrated loop A circular (ring) topology (versus point-to-point)...
Page 57 - Index
FC0054607-00 A Index-1 Index A acronyms, definitions of Glossary-1 adapter port beacon, definition of Glossary-1 adapter port, definition of Glossary-1 adapters definition of Glossary-1 identifying on VMware ESX 3-1 installing hardware 2-2 supported 1-4 agreements, license x arbitrated loop, definit...