Qlogic Fibre Channel Adapter User Manual
  1. Manuals
  2. Brands
  3. Qlogic Manuals
  4. Adapter
  5. QLogic Fibre Channel Switch
  6. User manual

Qlogic Fibre Channel Adapter User Manual

For vmware esx
Hide thumbs Also See for Fibre Channel Adapter:
Table of Contents

Advertisement

Quick Links

Fibre Channel Adapter for VMware ESX
User's Guide
FC0054606-00 A

Advertisement

Table of Contents
loading

Related Manuals for Qlogic Fibre Channel Adapter

Summary of Contents for Qlogic Fibre Channel Adapter

  • Page 1 Fibre Channel Adapter for VMware ESX User’s Guide FC0054606-00 A...

  • Page 2: Document Revision History

    QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification.

  • Page 3: Table Of Contents

    Configuration Identifying QLogic FC Adapters on VMware ESX ....Using VI Client......... . .
  • Page 4 Fibre Channel Adapter for VMware ESX User’s Guide Configuring the Driver Parameters....... . Deploying NPIV for VMware ESX/ESXi .

  • Page 5: Preface

    This guide provides detailed instructions on the installation, configuration, and troubleshooting of QLogic FC adapters on VMware ESX/ESXi. It also provides details on the use of QLogic FC adapter features to enhance the value of server virtualization using VMware ESX/ESXi. Such features include virtual adapter configuration using N_Port ID Virtualization (NPIV) and “boot from SAN”...

  • Page 6: What's In This Guide

    This user’s guide provides a brief introduction to the FC adapter offerings from QLogic at a broad level. The main focus of this guide is to explain the FC adapter software driver features, management tools available on VMware ESX/ESXi, and the supported features.
  • Page 7 Text in ALL CAPITALS indicates the name of a key that you press on the keyboard. For example: On the QLogic BIOS banner screen, press CTRL+Q. Text in italics indicates emphasis, terms, or document titles. For example: Refer to the VMware IO Compatibility Guide.

  • Page 8: License Agreements

    License Agreements Refer to the QLogic Software End User License Agreement for a complete listing of all license agreements affecting this product. Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support;...

  • Page 9: Hardware And Software Components

    Hardware and Software Components This chapter provides details about QLogic FC adapters for VMware, including: “Hardware Components” on page 1-1 “Software Components” on page 1-3 “QLogic FC Adapters Supported on VMware ESX/ESXi” on page 1-4 Hardware Components A typical QLogic FC adapter includes the following major components:...

  • Page 10: Fc Adapter Components

    The non-volatile memory, also referred to as Flash memory, contains the boot code run by the RISC processor (see 1) when the adapter is powered up. On QLogic FC adapter 2400 series and later, the Flash memory contains multiple boot images—the FCode, x86 BIOS, and EFI—to support multi-boot capability on different platforms.

  • Page 11: Software Components

    QLogic adapter. This type of configuration is referred to as boot from SAN. OS Driver For all QLogic FC adapters currently supported on VMware ESX/ESXi, the driver is supported natively with ESX;...

  • Page 12: Management Tools And Utilities

    FC adapter management by means of scripting and interactive mode. QLogic FC Adapters Supported on VMware ESX/ESXi For a complete list of QLogic FC adapters supported on VMware ESX/ESXi, refer to the VMware IO Compatibility Guides located as follows: VMware ESX 3.5: http://www.vmware.com/pdf/vi35_io_guide.pdf...

  • Page 13: Installation

    “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 FC adapters for VMware ESX support the following features: Topologies—FC-AL, FC-AL2, point-to-point, and switched fabric. Protocols—FCP-3-SCSI, FC-tape (FCP-2).

  • Page 14: Installing The Hardware

    Installation Installing the Hardware Installing the Hardware Adapter hardware installation requires that you open the computer and locate the appropriate bus slot for housing the adapter, as detailed in the following steps. Figure 2-1 shows the hardware placement. ADAPTER LEVER SCREW 64-BIT PCI-X SLOT ADAPTER...

  • Page 15: Installing The Driver

    IP address or host name of the ESX host on which the qlremote agent is installed. When SANsurfer FC HBA Manager is connected to the qlremote agent, you can use it to view and manage the QLogic adapters. FC0054606-00 A...

  • Page 16: Downloading Sansurfer Fc Hba Manager-Vmware

    # service portmap restart SANsurfer FC HBA Manager requires that you select the download link to the package for your operating system, either from an installation CD or the QLogic Web site. To install SANsurfer FC HBA Manager on VMware:...

  • Page 17: Downloading Sansurfer Fc Hba Manager-Linux

    Install the qlremote agent on your ESX host using silent mode as follows: # ./standalone_sansurfer5.0.1b33_linux_install.bin -i silent To install SANsurfer FC HBA Manager on Linux or Windows: Go to the QLogic Driver Downloads / Documentation page at the following URL: http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/default.aspx Click the by Operating System button, and then select Fibre Channel HBAs, Linux (or Windows) OS, and the specific OS version.

  • Page 18: Installing Sansurfer Fc Hba Cli

    Follow these steps to download and install the SANsurfer FC HBA CLI utility. To install SANsurfer FC HBA CLI: From the QLogic Web site or the SANsurfer Management Suite CD-ROM, download the scli-x.xx.xx-xx.i386.rpm.gz file to your local machine. (In the file name, x.xx.xx indicates the current version of SANsurfer FC HBA CLI.

  • Page 19: Configuration

    Using VI Client Using Console OS Using VI Client You can use the VM Infrastructure Client (VI Client) to identify QLogic FC adapters on a VMware ESX system. To identify QLogic FC adapters using VI Client: Start VM Infrastructure Client and select the host you want.

  • Page 20: Using Console Os

    Identifying QLogic FC Adapters on VMware ESX Figure 3-1 VI Client Configuration Page Using Console OS You can use the console OS to identify QLogic FC adapters on a VMware ESX system. To identify QLogic FC adapters using console OS:...

  • Page 21: Finding Adapters On Vmware Esx

    Configuration Identifying QLogic FC Adapters on VMware ESX To list the QLogic storage adapters present on the system, run the following command: ls /proc/scsi/qla2300 An example output may be: # ls /proc/scsi/qla2300/ HbaApiNode To view additional details, run the following command: cat /proc/scsi/qla2300/<adapter_number>...

  • Page 22: Using The Fast!Util Bios Utility

    Using the Fast!UTIL BIOS Utility Using the Fast!UTIL BIOS Utility QLogic FC adapters provide a BIOS utility, Fast!UTIL, which you can invoke at the BIOS. QLogic FC adapters support the Fast!UTIL BIOS utility on VMware ESX systems. Fast!UTIL does not require any installation.

  • Page 23: Verifying That The Driver Is Loaded

    Configuration Verifying That the Driver is Loaded Verifying That the Driver is Loaded Follow this procedure to ensure that the QLogic FC adapter driver is loaded on the ESX system To verify that the QLogic FC adapter driver is loaded: Log in to the service console as root user.

  • Page 24: Configuring The Driver Parameters

    Configuration Configuring the Driver Parameters Configuring the Driver Parameters Use the esxcfg-module command to configure the QLogic FC adapter driver parameters. To configure driver parameters: To list the driver parameters, execute the following command: # esxcfg-module -g qla2300_707_vmw To set the driver parameters, execute the following command: # esxcfg-module -s <options>...

  • Page 25: Configurable Driver Parameters

    Configuration Configuring the Driver Parameters Table 3-1. Configurable Driver Parameters Driver Parameter Description Target persistent binding method. 0 = bind by port name (default); 1 Bind = bind by port ID. Option to enable extended error logging. 0 = no logging (default); 1 = extended_error_logging log errors.
  • Page 26 Configuration Configuring the Driver Parameters Table 3-1. Configurable Driver Parameters (Continued) Driver Parameter Description Option to disable handling of NOT-READY status in the driver. 1 = han- ql2xprocessnotready dled by the driver (default); 0 = disable the handling inside the driver. Maximum number of mid-layer retries allowed for a command.

  • Page 27: Deploying Npiv For Vmware Esx/Esxi

    Deploying NPIV for VMware ESX/ESXi Deploying NPIV for VMware ESX/ESXi QLogic FC adapters support N_Port ID virtualization (NPIV) for FC SANs. NPIV enables each virtual machine to have its own FC world wide port name (WWPN) by creating multiple virtual adapters on a single physical adapter.

  • Page 28: Sansurfer Fc Hba Manager Showing Npiv

    Configuration Monitoring NPIV Virtual Ports from SANsurfer 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 detail about the selected virtual port on four tabbed pages.

  • Page 29: Configuring Boot From San

    Configuration Configuring Boot from SAN 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 device.

  • Page 30: Starting Fast!Util From The Bios Screen

    Configuration Configuring Boot from SAN VMware ESX 3.x provides the boot from SAN capability on QLogic FC adapters. For storage array and FC switch configuration, refer to the appropriate user manual for the device. For VMware ESX-specific configuration requirements, refer...
  • Page 31 To toggle the value to Enabled, press ENTER After the Selectable Boot is enabled, select the boot device. QLogic FC adapters allow the specification of up to four WWPN/LUNs as boot devices. To select up to three boot devices, follow these steps:...
  • Page 32 Configuration Configuring Boot from SAN Notes 3-14 FC0054606-00 A...

  • Page 33: Troubleshooting

    “Collecting System Logs for Troubleshooting” on page A-11 “Frequently Seen Issues” on page A-11 Troubleshooting with LEDs QLogic FC adapters have LEDs that can help you diagnose problems. Typically, administrators observe the LED patterns to perform first-level troubleshooting that can indicate some obvious firmware or hardware issues.

  • Page 34: Qla234X/Qla210/Qle220 Adapter Led Scheme

    Troubleshooting Troubleshooting with LEDs Table A-2. QLA234x/QLA210/QLE220 Adapter LED Scheme Green LED Amber LED Activity ❍ ❍ Power off ● ● Power ● ❍ Online ❍ ● Link ❍ Flashing Loss of synchronization Alternate Alternate Firmware error flashing flashing ❍ Flashing Beacon Table A-3.

  • Page 35: Qem2462 Power And Attention Switch Led Scheme

    Troubleshooting Troubleshooting with LEDs Table A-4. QEM2462 Power and Attention Switch LED Scheme Green Activity Power ❍ Power off Insertion or removal of the adapter is permitted ● Power Insertion or removal of the adapter is not permitted Blinking Hot-plug operation is in progress and insertion or removal of the adapter is not permitted Yellow Activity...

  • Page 36: Dynamic Extended Logging

    Troubleshooting Dynamic Extended Logging 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 issues related to the adapter.

  • Page 37: Troubleshooting With Driver Logs

    Troubleshooting Troubleshooting with Driver Logs Troubleshooting with Driver Logs All messages from the QLogic FC adapter driver are logged in /var/log/vmkernel. These messages provide additional information about the driver operation: both normal and driver warnings. Messages from the driver are usually preceded by scsi(%d), where %d is the adapter instance number.
  • Page 38 Indicates the firmware connection type. %s will be one of the following: FL-PORT, N-PORT, F-PORT, NL-PORT, and host adapter loop ID. "scsi%d : QLogic XXXXXX PCI to Fibre Channel Host Adapter: ... " Firmware version: 4.04.06, Driver version 7.08vm62" Driver is reporting information discovered during its initialization. This information includes the board ID, firmware version, and driver version.
  • Page 39 Troubleshooting Troubleshooting with Driver Logs Table A-6. Common Driver Log Messages (Continued) Driver received an async ISP system error event from the firmware. Additional information follows the message (that is, mailbox values from the firmware). "scsi(%d): Configuration change detected: value %d." Driver received a change in connection async event from the firmware.
  • Page 40 Troubleshooting Troubleshooting with Driver Logs Table A-6. Common Driver Log Messages (Continued) "%s(): **** CMD derives a NULL HA\n" Indicates the command does not point to an adapter structure. "%s(): **** CMD derives a NULL search HA\n" Indicates the command does not point to the adapter structure. "scsi(%ld:%d:%d:%d): now issue ADAPTER RESET.\n"...
  • Page 41 Troubleshooting Troubleshooting with Driver Logs Table A-6. Common Driver Log Messages (Continued) "WARNING qla2x00: couldn't register with scsi layer\n" Indicates the driver could not register with the SCSI layer, usually because it could not allocate the mem- ory required for the adapter. "WARNING scsi(%d): [ERROR] Failed to allocate memory for adapter\n"...

  • Page 42: Debugging Using Proc Information

    Troubleshooting Debugging Using Proc Information Debugging Using Proc Information The driver /proc/scsi/qla2300/<adapter_number> provides debugging information that can help you troubleshoot problems with the driver. The /proc entry provides firsthand information about the current state of the driver. Table A-8 lists the /proc output fields and provides a description of each. Table A-7.

  • Page 43: Collecting System Logs For Troubleshooting

    Errors similar to the following occur when the sys- There are too many devices taking up extended tem is booted up. In addition, the ALT+Q QLogic BIOS data area (EBDA) memory resources. To BIOS banner is not shown; or FlashUTIL! is hang- free up enough resources to allow the adapters to ing when trying to flash the adapters.
  • Page 44 Troubleshooting Frequently Seen Issues Notes A-12 FC0054606-00 A...

  • Page 45: Glossary

    Glossary adapter Boot code for QLogic FC adapters is required if the computer system is booting The board that interfaces between the from a storage device (disk drive) attached host system and the target devices. to the adapter. The primary function of the...
  • Page 46 Fibre Channel Adapter for VMware ESX User’s Guide L2 cache—Secondary (larger) cache. Nexus Drivers. Nexus drivers provide Either on the processor chip or bus mapping and translation services external to the processor. to subordinate nexus and leaf devices. These include drivers for PCI-to-PCI device bridges, PCMCIA adapters, and SCSI A target, typically a disk drive.
  • Page 47 FC switches. E_Port, F_Port, FL_Port, L_Port, N_Port (Node Port), NL_Port (Node Loop Port) Fast!UTIL QLogic Fast!UTIL FC adapter BIOS utility. Host bus adapter. See adapter. FCode HBA port A type of boot code for Sun's SPARC platforms. See boot code and Flash.
  • Page 48 Fibre Channel Adapter for VMware ESX User’s Guide L_Port N_Port (Node Port) Loop port. Does arbitrated loop functions A port that connects by a point-to-point link and protocols. NL_Ports and FL_Ports are to either a single N_Port or a single examples of loop-capable ports.
  • Page 49 Fibre Channel Adapter for VMware ESX User’s Guide NL_Port (Node Loop Port) path A port capable of arbitrated loop functions A path to a device is a combination of a and protocols. An NL_Port connects adapter port instance and a target port as through an arbitrated loop to other distinct from internal paths in the fabric NL_Port and at most a single FL_Port.
  • Page 50 Fibre Channel Adapter for VMware ESX User’s Guide port SCSI Access points in a device where a link Small computer system interface. A attaches. There are four types of ports, as high-speed interface used to connect follows: devices, such as hard drives, CD drives, printers, and scanners, to a computer.

  • Page 51: Index

    Index adapters cache, definition of Glossary-1 definition of Glossary-1 certification training viii identifying on VMware ESX class driver, definition of Glossary-2 installing hardware CMPI providers, supported supported collecting system logs A-11 adjunct driver level, definition of Glossary-2 components agreements, license viii hardware arbitrated loop, definition of...
  • Page 52 G_Port (Generic Port), definition Glossary-3 glossary of terms Glossary-1 guide, typographic conventions E_Port (Expansion Port), definition Glossary-3 e-mailing QLogic support viii end user license agreements viii hardware esxcfg-module command components extended BIOS data area (EBDA) A-11...
  • Page 53 Glossary-4 messages, driver log parameters, configuring driver miniport driver level, definition of Glossary-2 path, definition of Glossary-5 monitoring NPIV virtual ports phoning QLogic support viii monolithic driver, definition of Glossary-2 FC0054606-00 A Index-3...
  • Page 54 Glossary-6 layers, definition of Glossary-2 Small Computer System Interface (SCSI), definition of Glossary-6 QLogic Technical Support, contacting viii SNIA Common HBA API, supported qlremote agent, requirement for software components boot code firmware management tools and utilities...
  • Page 55 A-10 numbers, different assigned A-11 OS, missing persistent binding method what’s in this guide technical support, obtaining viii Windows telephoning QLogic support viii driver level structure Glossary-2 terms, definitions of Glossary-1 SANsurfer, installing on topologies, supported training from QLogic viii...
  • Page 56 QLogic (UK) LTD. Quatro House Lyon Way, Frimley Camberley Surrey, GU16 7ER UK +44 (0) 1276 804 670 © 2009 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLogic and the QLogic logo are registered trademarks of QLogic Corporation. VMware is a registered trademark of VMware, Inc. PCI-X, ExpressModule, and PCIe are trademarks and PCI Express is a registered trademark of PCI-SIG Corporation.

Table of Contents