Qlogic fibre channel adapter настройка windows

SANsurfer FC HBA CLI

User’s Guide

Command Line Interface for QLogic Fibre Channel Host Bus Adapters

S

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 third parties which may result from its use. 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. QLogic Corporation assumes no responsibility for any errors that may appear in this document.

Apple, Finder, Mac OS, Macintosh, and Power Mac registered trademarks, and Safari is a trademark of Apple, Inc., registered in the U.S. and other countries.

EMC is a registered trademark of EMC Corporation.

Intel and Pentium are trademarks of Intel Corporation in the U.S. and other countries. Linux is a registered trademark of Linus Torvalds.

Microsoft, Windows, Windows NT operating system, Windows 2000 operating system, Windows Server 2003 operating system, Windows XP Professional operating system, and Windows Vista operating system are registered trademarks of Microsoft Corporation in the United States and other countries.

Novell and NetWare are registered trademarks of Novell, Inc.

IBM and PowerPC are registered trademarks of International Business Machines Corporation in the United States, other countries, or both.

QLogic, the QLogic logo, QLA, and SANsurfer are registered trademarks of QLogic Corporation. Red Hat and all Red Hat-based are trademarks or registered trademarks of Red Hat, Inc.

Solaris is a registered trademark of Sun Microsystems, Inc., in the United States and other countries

SPARC is a registered trademark of SPARC International, Inc. Products bearing SPARC trademarks are based on an architecture developed by Sun Microsystems, Inc.

StuffIt is a registered trademark of Smith Micro Software, Inc. SuSE is a registered trademark of SuSE Linux AG.

VMware is a registered trademark of VMware, Inc. in the United States and/or other jurisdictions.

All other brand and product names are trademarks or registered trademarks of their respective owners.

Document Revision History

Revision A, August 20, 2004

Revision B, September 28, 2005

Revision C, June 7, 2006

Revision D, October 1, 2006

Revision E, February 1, 2007

Revision F, February 2008

© 2004–2008 QLogic Corporation. All Rights Reserved Worldwide.

First Published: March 2004

QLogic Corporation, 26650 Aliso Viejo Parkway, Aliso Viejo, CA 92656, (800) 662-4471 or (949) 389-6000

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

S

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

The following options and commands were added in Rev. E:

S

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

S

The following options and commands were changed in Rev. D:

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

S

Table of Contents

S

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

4.5Target Link Speed or iiDMA Settings Menu (Command Line Option -q) . . . 4-38

4.5.4.2Target Link Speed – All HBAs – Advanced Configuration . . . . . 4-43

4.6.1Target Persistent Bindings (Per HBA Port) (Command Line

Option -p). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46

4.6.1.1Display Target Persistent Binding (Command Line

Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46

4.6.1.2Target Persistent Bindings – Bind Target(s) (Command Line

Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47

4.6.1.3Target Persistent Binding – Unbind Targets (Command Line

S

4.10.1Flash Update (Per HBA Port or All HBAs) (Command Line

Option -b). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56

4.10.2Flash Save (Per HBA Port) (Command Line Option -b and

Reserved Word “save”) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56

4.10.3HBA Parameters Update (Per HBA Port or All HBAs) (Command

Line Option -r) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-57

4.10.4HBA Parameters Save (Per HBA Port) (Command Line Option

-r and Reserved Word “save”) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-57

4.10.5HBA Parameters Template (Per HBA or All HBAs) (Command

4.12.3Diagnostics Transceiver Details – DMI (Command Line

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

5.3.15-i (Display HBA General Information or VPD Information for

One or All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

S

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

Appendix B XML Format 2

S

Appendix C Interactive Exit Codes

Appendix D Non-interactive Error Codes

Appendix E Help Commands

Glossary

Index

A

SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters

List of Figures

List of Tables

S

Section 1

Introduction

1.1

Product Overview

The SANsurfer® FC HBA CLI tool provides a command line interface (CLI) that lets you easily install, configure, and deploy QLogic® Fibre Channel (FC) host bus adapters (HBAs). It also provides robust diagnostic and troubleshooting capabilities and useful statistical information to optimize SAN performance. This tool only configures HBAs on the local machine (where SANsurfer FC HBA CLI is installed.)

SANsurfer FC HBA CLI is a simplified, condensed version of the SANsurfer FC HBA Manager graphical user interface (GUI).

SANsurfer FC HBA CLI can be operated in two modes:

Interactive mode (menu-driven interface). This mode requires user intervention.

Non-interactive mode (command line interface). Use this mode for scripting or when you want to do a single operation.

NOTE:

This guide uses interchangeably the terms HBA and adapter.

1.2

Guide Overview

This guide is intended for end users responsible for administration of QLogic FC HBAs.

1.2.1

How this Guide is Organized

The SANsurfer FC HBA CLI User’s Guide is organized into the following sections and appendices:

Section 1 Introduction: This section provides a general overview of the product, lists the supported QLogic HBAs and operating systems, lists the system hardware and software requirements, and provides contact information for technical support.

S

Section 2 Getting Started: This section describes the two modes used in SANsurfer FC HBA CLI: interactive and non-interactive. It also explains some special terms used in this guide.

Section 3 Initial Installation: This section provides step-by-step instructions for installing and uninstalling SANsurfer FC HBA CLI on Windows, Linux, Solaris, and Macintosh.

Section 4 Interactive Commands: This section provides detailed explanations and examples of the command line options used in interactive mode.

Section 5 Non-interactive Commands: This section provides detailed explanations and examples of the command line options used in non-interactive mode.

Appendix C Interactive Exit Codes: This appendix lists the exit codes that can occur while running SANsurfer FC HBA CLI in interactive mode. For each exit code number, it provides the name and description.

Appendix D Non-interactive Error Codes: This appendix lists the error codes that can occur while running SANsurfer FC HBA CLI in interactive mode. For each error code number, it provides the name and description.

Appendix E Help Commands: This appendix provides an alphabetical list of the command line actions, arguments, and functions of the help commands.

Following the appendices are a glossary of terms used and an index that will help you quickly find the information you need.

1.2.2

Documentation Conventions

This guide uses the following documentation conventions:

Text in bold font indicates a menu item, dialog box, tab, button, or check box in the user interface. For example:

From the General Information Menu, type the number for Host

Topology.

Text in a sans serif font (Courier New) indicates CLI window text output. For example:

The HBA already has the device selected as boot device.

Text in a bold sans serif font (Courier New) indicates user input (what you type). For example:

A

#scli -z

Text in ALL CAPITALS usually indicates the name of a key that you press on the keyboard. For example:

Type the number for Host Information and then press ENTER.

Italicized text indicates either a document reference, glossary term, or emphasis. For example:

Attached Port means a QLogic HBA….

For a complete list, see the QLogic SAN Interoperability Guide.

Italicized text within angle brackets indicates user-defined variables. For example:

#scli -k (<HBA Instance> | <HBA WWPN>)

Text shown in blue indicates a cross-reference hyperlink to a Web site or to another section of this guide. Click the hyperlink to jump to that site or section. For example:

Visit the QLogic support Web site at support.qlogic.com for the latest firmware and product updates.

For information on Vital Product Data (VPD), see section 4.2.1.4.

In Section 4 Interactive Commands, a “breadcrumbs” line follows most command headings to show you how to access that option; that is, it shows the hierarchical path from the top level to the command under discussion. For example, to reach the Save to Text File options from the main SANsurfer FC HBA CLI menu, you would select option 1 to open the

General Information menu, 2 to open the Host Topology menu, and 2 again to see the Save to Text File options. The following shows a breadcrumbs example:

S

1.3

Supported QLogic HBAs

SANsurfer FC HBA CLI is supported for the following QLogic HBAs:

QLA234x

QLA2xx

QLE2xx

QLE246x

QLA246x

QLE256x

1.4

Supported Operating Systems

SANsurfer FC HBA CLI is supported on the following operating systems:

Microsoft® Windows®

Windows 2000/SP4 Server and Advanced Server

Windows 2003 SP2 IA-32/IA-64/x64 Server and Enterprise Server (SP2)

Windows XP IA-32/x64 (SP1, 2)

Windows Vista® IA-32/x64

Windows 2008 Server IA-32/IA-64/x64

Linux®

Red Hat® Enterprise Linux (RHEL) 3.0 IA-32, IA-64, and x86_64 Update 8, 9

RHEL 4.0 IA-32, IA-64, and x86_64 Update 5, 6

RHEL 5.0 IA-32, IA-64, and x86_64 Update 0, 1

SuSE® Linux Enterprise Server (SLES) 8 IA-32, IA64, and x86_64 versions SP 3, 4

SLES 9 IA-32, IA64, and x86_64 versions SP 3, 4

SLES 10 IA-32, IA64, and x86_64 versions SP 0, 1

NOTE:

RHEL 3.0 and SLES 8 do not support 8Gb.

Solaris®

Solaris SPARC 2.8/9/10 (with latest patches)

A

Solaris x86 9/10 (with latest patches)

Apple® Macintosh®

Mac OS® X 10.3.x (PowerPC® (PPC)), 10.4.x (PPC/Intel), and 1.5.x (PPC/Intel)

VMware®

VMware ESX Server 3.5

NOTE:

VMware does not support 8Gb.

NOTE:

Throughout this guide, the terms Windows, Linux, Solaris, and Macintosh refer to all the respective supported operating systems unless otherwise noted.

1.5

System Requirements

The hardware and software requirements for SANsurfer FC HBA CLI are described in the following sections.

1.5.1

Hardware Requirements

The minimum hardware requirements are as follows:

QLogic HBAs (see section 1.3).

Singleor multiprocessor server or workstation:

Pentium® III with 450 MHz or greater for Windows 2000, Windows Server 2003, Windows XP Professional, Linux, and Solaris.

Windows Vista and Windows Server 2008—Use the minimum requirements from Microsoft.

Power Mac® G5 1.8 MHz or greater with 512 MB of memory.

FC devices, such as disks and RAID subsystems.

QLogic FC HBAs.

SANsurfer FC HBA CLI supports most FC devices. For a complete list of devices that support failover, see the QLogic SAN Interoperability Guide, which you can download from the QLogic Web site, www.qlogic.com/interopguide/info.asp#inter.

S

NOTE:

Tape devices are shown as part of the configuration, but are not fully supported by SANsurfer FC HBA CLI. Only persistent binding and LUN masking are available.

256 MB physical RAM are required to run SANsurfer FC HBA CLI; running with less memory can cause disk swapping (“paging” or “paging out”), which severely affects performance.

Video card capable of 256 colors and a screen resolution of 800×600 pixels.

About 7 MB of disk space.

1.5.2

Software Requirements

The minimum software requirements are as follows:

QLogic drivers for your OS platform.

Administrative privileges to do management functions.

One of the operating systems listed in section 1.4.

1.5.2.1

Unsupported Features

Depending on your system, not all SANsurfer FC HBA features are available.

1.5.2.1.1

Features Not Available When Running Windows Driver with NPIV Enabled

When running the driver with NPIV enabled on Windows, the following features are not available with virtual port:

HBA parameters settings

HBA parameters restore default

Flash update from file

Flash save to file

HBA parameters update from file

HBA parameters save to file

HBA parameters update from templates

Target link speed

Boot device settings

Driver settings

HBA beacon

Target/LUN list

A

1.5.2.1.2

Features Not Available When Running ioctl Module Driver

When running the input/output control (ioctl) module driver on a Linux OS, the following features are not available:

Persistent binding

Selective LUN

HBA port statistics

Driver settings

Host topology

1.5.2.1.3

Features Not Available When Running Sysfs Inbox Driver

When running the Sysfs Inbox driver on a Linux OS, the following features are not available:

Persistent binding

Selective LUN

HBA port statistics

Driver settings

Host topology

Link status

Loopback test

1.5.2.1.4

Features Not Available When Running VMware Driver

When running the VMware driver on a Linux OS, the following features are not available with virtual ports:

HBA parameters settings

HBA parameters restore default

Flash update from file

Flash save to file

HBA parameters update from file

HBA parameters save to file

HBA parameters update from templates

1.6

Technical Support

Customers should contact their authorized maintenance provider for technical support of their QLogic HBA products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider.

S

Visit the QLogic support Web site at: support.qlogic.com for the latest firmware and product updates.

1.6.1

Availability

QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays.

1.6.2

Training

QLogic offers certification training for the technical professional for both the QLogic FC HBAs and switches. From the training link at www.qlogic.com, you may choose Electronic-based Training or schedule an intensive “hands-on” Certification course.

Technical Certification courses include installation, maintenance, and troubleshooting QLogic SAN products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by e-mail at tech.training@qlogic.com.

1.7

Contact Information

A

S

Section 2

Getting Started

2.1

Introduction

SANsurfer FC HBA CLI operates in two modes:

Interactive (menu-driven). The CLI starts, and then waits for and executes input commands until terminated by the user. Use this mode to do multiple operations. Section 4 Interactive Commands covers this interface.

Non-interactive (command line). The CLI starts, does the functions defined by the list of parameters provided, and then terminates. Use this mode to run SANsurfer FC HBA CLI from a script file or when you want to do a single operation. Section 5 Non-interactive Commands covers this interface.

SANsurfer FC HBA CLIis not case sensitive in either mode. However, file names in some operating systems are case sensitive; in this case, SANsurfer FC HBA CLI is case sensitive for that specific file.

2.2

Starting Interactive Mode

To start SANsurfer FC HBA CLI in interactive mode, use one of these methods:

For Windows, click the SANsurfer FC CLI icon on the desktop.

For Linux or Solaris, open a command window and type:

scli INT

– Or –

scli

NOTE:

When starting SANsurfer FC HBA CLI from a Solaris console serial port connection, the CLI may take a long time to come up. To resolve this issue, specify the INT flag, as shown in the preceding bullet.

For Mac OS X, follow these steps:

1.Double-click the SANsurfer FC HBA CLI (SCLI) icon.

2.A terminal window opens. SCLI (interactive mode) scans the host for QLogic HBAs and SAN storage.

S

3.Run SCLI commands as required.

4.When finished, return to the main menu, and type the indicated number to quit SANsurfer FC HBA CLI.

5.Close the terminal window.

The Main Menu appears as shown in the following:

SANsurfer FC HBA CLI v1.x.x Build xx

Main Menu

1:General Information

2:HBA Information

3:HBA Parameters

4:Target/LUN List

6:Target Persistent Bindings

7:Selective LUNs

8:Boot Device

9:Driver Settings

10:Utilities

11:Beacon

12:Diagnostics

13:Statistics

NOTE:

The Virtual menu is available only on Windows systems running with a driver that supports NPIV (N_Port ID Virtualization).

Depending on which menu you select, may prompt you for more input. For example, if you select HBA Parameters, SANsurfer FC HBA CLI prompts you for the port number that corresponds to the HBA model you want to view.

NOTES:

The Driver Update option under Utilities (option 10) is only available on Windows.

In Solaris SPARC, the option to Save/Update BIOS is Save/Update FCode.

A

2.3

Starting Non-interactive Mode

To start SANsurfer FC HBA CLI in non-interactive mode, type the following in a command window:

scli <Parameters>

SANsurfer FC HBA CLI executes the command options, then terminates.

To list all of the available command line parameters and the SANsurfer FC HBA CLI version, type the following:

scli -h

– Or –

scli -?

In Solaris SPARC, include double quotes around the view option (?) if the system is running with a csh or tsch shell. For example:

# scli -e 0 «?»

For world wide node name (WWNN), world wide port name (WWPN), and port ID parameter inputs, SANsurfer FC HBA CLI accepts the notation with and without the dash (–). Hexadecimal values can be uppercase or lowercase.

The following input formats are valid for the WWNN and WWPN:

20-00-00-E0-8B-01-83-C4 200000E08B0183C4

The following inputs are valid for the port ID:

68-5C-AB 685CAB

All command line options must be preceded by the dash (–) or forward slash (/) notation. Most options have a corresponding menu selection in interactive mode. The valid command line options are listed in Table 2-1.

S

A

Table 2-1. Non-interactive Mode Options (Continued)

aWindows, Linux, Solaris x86

bSolaris SPARC

Options that have a corresponding menu selection cannot be combined. That is, only one option is allowed in a single command. If multiple options are specified in a command, only the first one is processed. These options, however, can be combined with one or more options that do not have a corresponding menu selection, with the exception of -F.

For all command line options, SANsurfer FC HBA CLI shows the following when there are errors in the command line input:

Error <error message> SANsurfer FC HBA CLI v1.x.x Build xx

Copyright 2003-2007 QLogic Corp. All rights reserved.

Command Line QLogic FC Host Bus Adapters

description of command entered Usage: <current command use usage>

S

2.4

Terminology

Some of the terms used in this guide are similar and some have changed slightly as technology changes. The following definitions apply:

HBA Port

HBA Port refers to the actual physical port on an HBA. For example, a QLA2462 has two ports called HBA port 1 and HBA port 2.

HBA Instance, HBA Instance number, or HBA Port Instance

When you install HBA in a system with other HBAs, each HBA port gets assigned a number by the driver or API so it knows which HBA to communicate with. This assigned number might be called HBA Instance, HBA instance number, or HBA Port Instance.

HBA Alias

When an alias is assigned to a physical HBA, no matter how many ports that HBA has, the HBA Alias refers to the HBA, not one of its ports.

Port Alias

You can also assign an alias to an individual port on an HBA. This Port Alias refers to only that port and none other.

Thus, an HBA can only have one HBA Alias, but each port on that HBA must, have a unique Port Alias.

Section 3

Initial Installation

Before you run SANsurfer FC HBA CLI, ensure that the following requirements are met:

The HBAs must be installed.

The HBA drivers must be installed.

NOTES:

Some SANsurfer FC HBA CLI features are not available when:

You have a Solaris system that is running with the driver distributed with the OS installation CDs (QLC driver).

You have a Linux system that is running with the ioctl or sysfs (inbox) driver.

You have a Linux system that is running with a VMware driver.

3.1

Downloading the Installation Package

To download the SANsurfer FC HBA CLI installation package from the QLogic Web site, follow these steps:

1.From the QLogic home page (www.qlogic.com), click Downloads (on the left).

2.On the Drivers Downloads / Manuals page, click your HBA model. The Resources page for the selected model appears.

3.Under Drivers, Management Tools and API Libraries, click the appropriate operating system.

4.In the Management Tools table, go to the SANsurfer CLI … row and in the

Download column, click (Download).

5.The system shows the End User License Agreement box. Scroll to the bottom and click Agree.

6.Click Save. Select a directory on your system and download the file.

S

3.2

Installing SANsurfer FC HBA CLI

Follow the installation instructions in the section that corresponds to your operating system (OS):

Windows—See section 3.2.1.

Linux—See section 3.2.2.

Solaris—See section 3.2.3.

Macintosh—See section 3.2.4.

3.2.1

Windows Installation

To install SANsurfer FC HBA CL on Windows, follow either the GUI or command line installation steps:

Standard (GUI) installation—See section 3.2.1.1.

Command line installation—See section 3.2.1.2.

3.2.1.1

Standard (GUI) Installation

To install SANsurfer FC HBA CLI on a Windows operating system, follow these steps:

1.Locate and double-click the installer package. The Preparing to Install dialog box appears, as shown in Figure 3-1. The status bar indicates that the installation package is loading.

Figure 3-1 Preparing to Install Dialog Box

After the install package is loaded, the Welcome dialog box appears as shown in Figure 3-2.

A

Figure 3-2 Welcome Dialog Box

2.Read the information, and then click Next.

The Choose Destination Location dialog box appears as shown in Figure 3-3.

Figure 3-3 Choose Destination Location Dialog Box

3.In the Choose Destination Location dialog box, do one of the following:

To select the destination location in the dialog box, click Next (recommended). The default location for a Windows system is:

Program FilesQLogic CorporationSANsurferCLI

S

To select a different location:

a.Click Browse.

b.Select an installation location.

c.The Choose Destination Location dialog box reappears. Click

Next.

The Ready to Install the Program dialog box appears as shown in Figure 3-4.

Figure 3-4 Ready to Install the Program Dialog Box

4.Read the information, and then click Install.

The Setup Status dialog box appears as shown in Figure 3-5.

Figure 3-5 Setup Status Dialog Box

A

If you want to stop the installation, click Cancel.

The InstallShield Wizard Complete dialog box appears as shown in

Figure 3-6.

Figure 3-6 InstallShield Wizard Complete DIalog Box

5.(Optional.) Select one of the following:

If you want to see more information about SANsurfer FC HBA CLI, select the I would like to view the README file check box.

If you want to start SANsurfer FC HBA CLI, select the I would like to launch SANsurfer FC CLI check box.

6.Click Finish.

3.2.1.2

Command Line Installation

To install SANsurfer FC HBA CLI using the command line installation, follow the steps for either standard or silent installation:

Standard installation—See section 3.2.1.2.1

Silent installation—See section 3.2.1.2.2

3.2.1.2.1

Standard Command Line Installation

Type the following text for a standard installation of SANsurfer FC HBA CLI on a Windows operating system, where xx indicates the version of SANsurfer FC HBA CLI:

scli-1.x.x.xx.windows.exe

S

By default, SANsurfer FC HBA CLI is installed in the following directory:

Program filesQLogic CorporationSANsurferCLI

If you want to change the default location, enter the directory in the command line; for example:

scli-1.x.x—xx.windows.exe installdir=»c:sansurfercli»

3.2.1.2.2

Silent Command Line Installation

The command for a silent installation is the same as for a standard installation (see section 3.2.1.2.1), with the addition of the command parameters listed in Table 3-2. Examples using these parameters follow the table.

Table 3-2. Windows Command Line Installation Parameters

a InstallScript and InstallScript MSI projects only.

A

To create a response file for a silent installation of SANsurfer FC HBA CLI, enter the following:

scli-1.x.x—xx.windows.exe /r /f1″C:Tempinstall_1.iss»

To run the installation in silent mode with a log file, enter the following:

scli-1.x.x—xx.windows.exe /s /f1″C:Tempinstall_2.iss»

To run the installation in silent mode with an alternate file in a temporary directory, enter the following:

scli-1.x.x-xx.windows.exe /s /f1″C:Tempinstall_1.iss» /f2″C:Tempinstall_3.log»

NOTE:

After installing SANsurfer FC HBA CLI, you can create an uninstallation script for future use by creating a response file with a different name. For example:

scli-1.x.x-xx.windows.exe /r /f1″C:Tempuninstall.iss»

3.2.2

Linux Installation

To install SANsurfer FC HBA CLI on a Red Hat/SuSE Linux operating system, follow these steps:

1.Download the scli-x.xx.xx-xx.i386.rpm.gz file (from the QLogic Web site or the FC HBA Manager CD-ROM) to your local machine. In the file name, x.xx.xx stands for the current version of SANsurfer FC HBA CLI.

2.Uncompress the file with the following command:

gunzip <file name>

3. Enter the following command to install the package:

rpm -iv scli-x.xx.xx-xx.i386.rpm

NOTE:

For SuSE SLES IA64, the command line is:

rpm —iv scli-x.xx.xx-xx.ia64.rpm —nodeps

The new package is installed in the following directory:

/opt/QLogic_Corporation/SANsurferCLI

S

To query for the installed SANsurfer FC HBA CLI package name, enter the following text from the command line:

rpm -q scli

3.2.3

Solaris Installation

To install SANsurfer FC HBA CLI on Solaris, follow the steps in one of these sections:

Solaris SPARC 8, 9, 10—See section 3.2.3.1.

Solaris x86 9 and 10—See section 3.2.3.2.

3.2.3.1

Solaris SPARC 8, 9, 10 Installation

Follow these steps to install SANsurfer FC HBA CLI on a Solaris SPARC 8, 9, or 10 operating system:

1.Download the scli-x.xx.xx-xx.sparc.Solaris.pkg file (from the QLogic Web site or the FC HBA Manager CD-ROM) to a temporary directory on your machine. For example:

/tmp

NOTE:

In the file name, x.xx.xx-xx stands for the current version of SANsurfer FC HBA CLI. The -xx stands for the build version.

2.To see the available package file, type the following:

#ls

The available packages appear. For example:

#scli-x.xx.xx-xx.sparc.Solaris.pkg

3.To install SANsurfer FC HBA CLI, type the following:

#pkgadd -d scli-x.xx.xx-xx.sparc.Solaris.pkg

4.You are prompted to select a package. For example:

The following packages are available:

1QLScli QLogic SANsurfer FC HBA CLI (HBA Configuration Utility) (sparc) x.xx.xx Build xx

Select package(s) you wish to process (or ‘all’ to process all packages). (default: all) [?,??,q]:

Enter 1 to proceed with the installation.

A

5.The pkgadd program does a series of checks, and then posts a script warning and asks whether to continue the installation. For example:

Processing package instance <QLScli> from

</space/chuynh/scli/qlogic/Solaris/pkgs/x>

QLogic SANsurfer FC CLI (HBA Configuration Utility) (sparc) x.xx.xx Build xx

QLogic Corporation

## Executing checkinstall script.

Using </> as the package base directory.

##Processing package information.

##Processing system information.

39 package pathnames are already properly installed.

##Verifying disk space requirements.

##Checking for conflicts with packages already installed.

##Checking for setuid/setgid programs.

This package contains scripts which will be executed with super-user permission during the process of installing this package.

Do you want to continue with the installation of <QLScli> [y,n,?]

To continue, type y, then press ENTER.

6.Messages appear showing what files have been installed. The system shows a final message when installation is complete. For example:

Installing QLogic SANsurfer FC CLI (HBA Configuration Utility)

as <QLScli>

## Installing part 1 of 1. /opt/QLogic_Corporation/SANsurferCLI/adapters.properties /opt/QLogic_Corporation/SANsurferCLI/libs/libqlsdm.so /opt/QLogic_Corporation/SANsurferCLI/menu.properties /opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2 2.dat /opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2 3.dat

. . .

Installation of <QLScli> was successful.

3.2.3.2

Solaris x86 9 and 10 Installation

To install SANsurfer FC HBA CLI on a Solaris x86 9 or 10 operating system, follow these steps:

1.Download the scli-x.xx.xx-xx.x86.Solaris.pkg file (from the QLogic Web site or the FC HBA Manager CD-ROM) to a temporary directory on your machine. For example:

/tmp

S

NOTE:

In the file name, x.xx.xx-xx stands for the current version of SANsurfer FC HBA CLI. The -xx stands for the build version.

2.To uncompress the file, type the following:

#uncompress scli-x.xx.xx-xx.x86.Solaris.pkg

3.To see the available package file, type the following:

#ls

The available packages appear. For example:

#scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg

4.To install SANsurfer FC HBA CLI, type the following:

#pkgadd -d scli-x.xx.xx-xx.SPARC-X86.Solaris.pkg

5.You are prompted to select a package. For example:

The following packages are available:

1QLSclix QLogic SANsurfer FC HBA CLI (HBA Configuration Utility) (i386) x.xx.xx Build xx

Select package(s) you wish to process (or ‘all’ to process all packages). (default: all) [?,??,q]: q

Enter 1 to proceed the installation.

6.Type the number that corresponds to your operating system, and then press ENTER.

The pkgadd program does a series of checks, posts a script warning, and asks whether to continue the installation. For example:

Processing package instance <QLSclix> from </space/chuynh/scli/qlogic/Solaris/pkgs/x>

SANsurfer FC HBA CLI (HBA Configuration Utility) (sparc) 1.xx.xx (Build xx Solaris 8-10)

QLogic Corporation

##Executing checkinstall script.

##Processing package information.

##Processing system information. 3 package pathnames are already properly installed.

##Verifying disk space requirements.

##Checking for conflicts with packages already installed.

##Checking for setuid/setgid programs.

.

.

A

.

[ verifying class <none>]

## Executing postinatall script. Installation of <QLSclix> was successful.

3.2.4

Macintosh Installation

To install SANsurfer FC HBA CLI, follow either the standard GUI or command line installation method:

Standard (GUI) installation—See section 3.2.4.1.

Command line installation—See section 3.2.4.2.

3.2.4.1

Standard (GUI) Installation

Follow these steps to install SANsurfer FC HBA CLI on a Macintosh:

1.You must have Admin privileges to install SANsurfer FC HBA CLI. To verify/enable Admin privileges, go to System Preferences, select Account, and then Security Tab. Make sure the Allow user to administer this computer check box is selected.

2.Download the SCLI zip file with Safari™ or other browser.

3.When the download has finished, StuffIt® expands the zip file to a tar file onto the desktop.

4.Double-click the SCLI tar file icon to create the SCLI pkg file.

5.Double-click the SCLI pkg file icon.

6.Follow the Installer menu.

The installation directory is:

$HOME/Applications/QLogic_Corporation/SANsurferCLI

where $HOME is Root.

7.After the installation process has finished, you can delete the SCLI pkg and tar files.

3.2.4.2

Command Line Installation

To install SANsurfer FC HBA CLI on a Macintosh, follow these steps:

1.Download the SCLI install package for Mac OS x (compressed tar file) to a local directory.

2.Uncompress the file by typing the following command:

S

tar -zxvf <file>.tgz

For example:

qlogic:~ root#tar -zxvf scli-x.x.x-x.macos.pkg.tgz

./scli-x.x.x-x.pkg/

./scli-x.x.x-x.pkg/Contents/

./scli-x.x.x-x.pkg/Contents/Archive.bom

./scli-x.x.x-x.pkg/Contents/Archive.pax.gz

…

…

This command extracts the compressed file to a directory named scli-x.x.x—x.pkg.

3. Install the package to the default directory. For example:

installer -pkg scli-x.x.x-x.pkg -target /

This command installs the product in the default Applications directory:

/var/root/Applications/QLogic_Corporation/SANsurferCLI

If this is the first time you are installing SANsurfer FC HBA CLI, the system shows the following messages:

qlogic:~ root# installer -pkg scli-x.x.x-x.pkg -target / installer: Package name is SANsurfer FC HBA CLI x.x.x Build x installer: Installing onto volume mounted at /.

installer: The install was successful.

If there is a previous version of SANsurfer FC HBA CLI on the system, the installer automatically runs an update operation. For example:

qlogic:~ root# installer -pkg scli-x.x.x-x.pkg -target / installer: Package name is SANsurfer FC HBA CLI x.x.x Build x installer: Upgrading volume mounted at /.

installer: The upgrade was successful.

3.3

Uninstalling SANsurfer FC HBA CLI

Refer to the following sections for the appropriate procedure to uninstall SANsurfer FC HBA CLI from your system:

3.3.1 Windows Uninstall

3.3.2 Linux Uninstall

3.3.3 Solaris Uninstall

3.3.4 Macintosh Uninstall

A

3.3.1

Windows Uninstall

To uninstall SANsurfer FC HBA CLI, use either the standard GUI or command line method:

Standard (GUI) uninstall—See section 3.3.1.1

Command line uninstall—See section 3.3.1.2

3.3.1.1

Standard (GUI) Uninstall

To uninstall SANsurfer FC HBA CLI using the GUI, do the following steps:

1.From the Control Panel, click Add or Remove Programs.

2.Highlight SANsurfer FC HBA CLI.

3.Click Remove. No re-boot is required.

Alternately, invoke scli-1.x.x—xx.windows.exe and select the option to Remove all installed features.

3.3.1.2

Command Line Uninstall

To uninstall SANsurfer FC HBA CLI using the command line, type the following:

scli-1.x.x-x.windows.exe /uninst /s

If you created an uninstall script in section 3.2.1.2.2, you can uninstall SANsurfer FC HBA CLI in silent mode by type the following:

scli-1.x.x-x.windows.exe /s /f1”C:Tempuninstall.iss»

3.3.2

Linux Uninstall

To uninstall SANsurfer FC HBA CLI, go to the command line and type one of the following commands, where x.xx.xx is the current version of CLI:

rpm -e scli-x.xx.xx-xx rpm -e scli

To query for the installed SANsurfer FC HBA CLI package name, type the following text from the command line:

rpm -q scli

3.3.3

Solaris Uninstall

To uninstall SANsurfer FC HBA CLI, follow one of these procedures:

S

Solaris SPARC 8, 9, 10—See section 3.3.3.1.

Solaris x86 8, 9, 10—See section 3.3.3.2.

3.3.3.1

Solaris SPARC 8, 9, and 10 Uninstall

Follow these steps to uninstall SANsurfer FC HBA CLI:

1.Type the following to remove SANsurfer FC HBA CLI:

#pkgrm QLScli

2.The program shows the package name and a script warning asking whether to continue the uninstall process. For example:

3.Type y and press ENTER. The program shows a script warning asking whether to continue the uninstall process. For example:

## Removing installed package instance <QLScli>

This package contains scripts which will be executed with super-user permission during the process of removing this package

Do you want to continue with the removal of this package [y,n,?,q]

4.Type y and press ENTER. The pkgrm program notifies you when the uninstall process is complete. For example:

##Verifying package dependencies.

##Processing package information. …

/opt/QLogic_Corporation/SANsurferCLI/adapters.properties /opt/QLogic_Corporation/SANsurferCLI

##Executing postremove script. scli removed.

Menu property file removed. Adapter property file removed. SCLI property file removed.

##Updating system information. Removal of <QLScli> was successful.

3.3.3.2

Solaris x86 8, 9, and 10 Uninstall

Follow these steps to uninstall SANsurfer FC HBA CLI:

1.Type the following to remove SANsurfer FC HBA CLI:

#pkgrm QLSclix

• 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 HAn» Indicates the command does not point to an adapter structure. «%s(): **** CMD derives a NULL search HAn» 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 layern» 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 adaptern»…

• 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.

• 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 HAn» Indicates the command does not point to an adapter structure. «%s(): **** CMD derives a NULL search HAn» 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 layern» 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 adaptern»…

• 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.