SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters SN0054614-00 K
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters 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 that may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Added new FCoE menu option to Interactive Commands chapter. 3 Interactive Commands Added Flash Image Version to list of actual VPD information. “Generate Report (Per Adapter Port)” on page 3-11 Added new ENode MAC Address information for QLE81xx adapters. “HBA Information (Command Line Option -i)” on page 3-21 Added cautions about deleting the LUN persistent name for a LUN with active I/O.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Notes iv SN0054614-00 K
Table of Contents Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Materials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Uninstalling SANsurfer FC/CNA HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . Windows Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard (GUI) Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Line Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Linux Uninstall . . . . . . . . . . . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters HBA Parameters Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HBA Parameters (Per Adapter Port) . . . . . . . . . . . . . . . . . . . . . . . . . . Display HBA Parameters (Command Line Option -c#). . . . . . . . Configure HBA Parameters (Command Line Option -n). . . . . . . Restore Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Target Persistent Binding (All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . Display Target Persistent Binding . . . . . . . . . . . . . . . . . . . . . . . . Target Persistent Binding: Bind Targets . . . . . . . . . . . . . . . . . . . Target Persistent Binding: Unbind Targets . . . . . . . . . . . . . . . . . Selective LUNs Menu (Command Line Option -m) . . . . . . . . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Diagnostics Menu (Command Line Options -kl, -kr, and -dm) . . . . . . . . . . . Diagnostics Loopback Test (Command Line Option -kl) . . . . . . . . . . . Display Test Parameters (Loopback) . . . . . . . . . . . . . . . . . . . . . Reset Test Parameters (Loopback) . . . . . . . . . . . . . . . . . . . . . . Configure Test Parameters (Loopback) . . . . . . . . . . . . . . . . . . . Start Diagnostic Test (Loopback) .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters FCoE Utilities Menu for QLx81xx Adapters (Command Line Option -cna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Center Bridging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DCE Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters TestIncrement (TI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnError (OE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LoopbackType (LT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Run a Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -kl (Run HBA Diagnostics Loopback Test). . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Display HBA Information (Command Line Option -i) . . . . . . . . . . . . . . Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . Display LUN List (Command Line Option -l) . . . . . . . . . . . . . . . . . . . . Target Persistent Binding (Command Line Option -p) . . . . . . . . . . . . . Selective LUNs (Command Line Option -m) . . . . . . . . . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Boot Device (Command Line Option -e) . . . . . . . . . . . . . . . . . . . . . . . Diagnostics Results—Loopback Test (Command Line Option -kl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Diagnostics Results—Read/Write Buffer Test (Command Line Option -kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters List of Tables 1-1 2-1 3-1 3-2 3-3 3-4 3-5 3-6 3-7 3-8 3-9 3-10 3-11 3-12 3-13 4-1 4-2 4-3 4-4 4-5 4-6 4-7 4-8 4-9 4-10 4-11 4-12 4-13 4-14 A-1 B-1 C-1 D-1 D-2 xiv Windows Command Line Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 Non-interactive Mode Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface The SANsurfer® FC/CNA HBA CLI tool provides a command line interface (CLI) that lets you easily install, configure, and deploy QLogic® Fibre Channel (FC) adapters, as well as QLogic Fibre Channel over Ethernet (FCoE) converged network adapters (CNAs). It also provides robust diagnostic and troubleshooting capabilities and useful statistical information to optimize SAN performance. This tool only configures adapters on the local machine (where SANsurfer FC/CNA HBA CLI is installed.
Preface What’s in This Guide The remainder of this guide is organized into the following chapters and appendices: 1 Installation and Removal lists the supported QLogic adapters and operating systems, lists the system hardware and software requirements, and provides step-by-step instructions for installing and uninstalling SANsurfer FC/CNA HBA CLI on Windows, Linux, Solaris, and Macintosh. 2 Getting Started describes the two modes used in SANsurfer FC/CNA HBA CLI: interactive and non-interactive.
Preface License Agreements Text in ALL CAPITALS 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 adapter.... For a complete list, see the QLogic SAN Interoperability Guide. Italicized text within angle brackets indicates user-defined variables.
Preface Technical Support 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; others will be redirected to their authorized maintenance provider. Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates.
1 Installation and Removal This chapter lists the supported QLogic adapters and system requirements, provides procedures for downloading and installing SANsurfer FC/CNA HBA CLI, and instructions for removing the product.
1–Installation and Removal Supported QLogic Adapters Supported QLogic Adapters SANsurfer FC/CNA HBA CLI is supported for the following QLogic adapters: QLA2xx QLA234x QLE2xx QLA246x QLE246x QLE256x QLE8042 QLE81xx QMI81xx Not all SANsurfer FC/CNA HBA CLI features are available on every supported adapter. For more information, see “Unsupported Features” on page 1-5.
1–Installation and Removal Supported Operating Systems Supported Operating Systems SANsurfer FC/CNA HBA CLI is supported on the following operating systems: Microsoft® Windows®: Windows 2000, 32-bit, Intel x86 Intel 64, AMD64 Windows Server 2003, 32-bit Intel x86, Intel 64, AMD64 Windows Server 2008, 32-bit Intel x86, Intel 64, AMD64 Windows XP Professional, 32-bit Intel x86, Intel 64, AMD64 Windows XP Professional, x64-bit Intel 64, AMD64 Windows Vista, 32-bit Intel x86 Windows Vista
1–Installation and Removal System Requirements NOTES: Throughout this guide, the terms Windows, Linux, Solaris, and Macintosh refer to all the respective supported operating systems unless otherwise noted. For specific service packs (SPs) and OS updates, refer to the descriptions where this software version is posted on the QLogic Web site: http://support.qlogic.com.
1–Installation and Removal System Requirements 256 MB physical RAM are required to run SANsurfer FC/CNA 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 800x600 pixels. About 7 MB of disk space. Software Requirements The minimum software requirements are as follows: QLogic drivers for your OS platform.
1–Installation and Removal Downloading the Installation Package Features Not Available When Running Linux with Converged Network Adapters When running Linux OS with converged network adapters (QLE81xx and QMI81xx), the following features are not available: Support for inbox driver only; no driver update support Persistent binding Adapter port statistics iiDMA support Loopback test Features Not Available When Running Sysfs Inbox Driver When running the Sysfs Inbox driver on a Linux OS, the follo
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI Figure 1-1 shows an example. Figure 1-1 Selecting Adapter Model (Example) The resources page for the selected model appears. 3. Under Management Tools, click SANsurfer CLI.... The End User Software License Agreement page appears. 4. Scroll to the bottom and click Agree. 5. On the File Download dialog box, click Save. Select a directory on your system and download the file.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI Windows Installation To install SANsurfer FC/CNA HBA CLI on Windows, follow either the GUI or command line installation steps: “Standard (GUI) Installation” on page 1-8 “Command Line Installation” on page 1-12 Standard (GUI) Installation Follow these steps to install SANsurfer FC/CNA HBA CLI on a Windows operating system using the standard (GUI) method. To install SANsurfer FC/CNA HBA CLI on Windows (GUI): 1.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI After the install package is loaded, the Welcome dialog box appears as shown in Figure 1-3. Figure 1-3 Welcome Dialog Box 2. SN0054614-00 K Read the information, and then click Next.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI The Choose Destination Location dialog box appears as shown in Figure 1-4. Figure 1-4 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 Files\QLogic Corporation\SANsurferCLI 1-10 To select a different location: a. Click Browse. b.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI The Ready to Install the Program dialog box appears as shown in Figure 1-5. Figure 1-5 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 1-6.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI If you want to stop the installation, click Cancel. The InstallShield Wizard Complete dialog box appears as shown in Figure 1-7. Figure 1-7 InstallShield Wizard Complete DIalog Box 5. 6. (Optional.) Select one of the following: If you want to see more information about SANsurfer FC/CNA HBA CLI, select the I would like to view the README file check box.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI Standard Command Line Installation Type the following text for a standard installation of SANsurfer FC/CNA HBA CLI on a Windows operating system, where xx indicates the version of SANsurfer FC/CNA HBA CLI: scli-1.x.x.xx.windows.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI Table 1-1. Windows Command Line Installation Parameters (Continued) Parameter /f2 Meaning Specify alternative log file namea Description When running an InstallScript MSI or InstallScript installation in silent mode (using the /s parameter), the log file Setup.log is created in the same directory and with the same name (except for the extension) as the response file.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 2. Decompress the file with the following command: gunzip 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.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 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/CNA 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: 1 QLScli QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (sparc) x.xx.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI /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 was successful. Solaris x86 9 and 10 Installation Follow these steps to install SANsurfer FC/CNA HBA CLI on a Solaris x86 9 or 10 operating system.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 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.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 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.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI If this is the first time you are installing SANsurfer FC/CNA 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/CNA HBA CLI x.x.x Build x installer: Installing onto volume mounted at /. installer: The install was successful.
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI Uninstalling SANsurfer FC/CNA HBA CLI Refer to the following sections for the appropriate procedure to uninstall SANsurfer FC/CNA HBA CLI from your system: “Windows Uninstall” on page 1-21 “Linux Uninstall” on page 1-22 “Solaris Uninstall” on page 1-22 “Macintosh Uninstall” on page 1-24 “VMware Uninstall” on page 1-24 Windows Uninstall To uninstall SANsurfer FC/CNA HBA CLI, use either the standard GUI or command line method:
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI Linux Uninstall To uninstall SANsurfer FC/CNA HBA CLI on a Linux system, 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.
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI ## 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 was successful.
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI SCLI property file removed. ## Updating system information. Removal of was successful. Macintosh Uninstall Uninstalling SANsurfer FC/CNA HBA CLI is not necessary for Mac OS X; the native installer automatically updates the product whenever it detects a change in the product version.
2 Getting Started This chapter provides the following sections to help you get started using SANsurfer FC/CNA HBA CLI: “Starting Interactive Mode” on page 2-1 “Starting Non-Interactive Mode” on page 2-4 “Terminology” on page 2-9 “Advanced Features” on page 2-10 SANsurfer FC/CNA HBA CLI Modes SANsurfer FC/CNA HBA CLI operates in two modes: Interactive (menu-driven). The CLI starts and prompts for user input.
2–Getting Started Starting Interactive Mode NOTE: When starting SANsurfer FC/CNA 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/CNA HBA CLI (SCLI) icon. 2. A terminal window opens. SCLI (interactive mode) scans the host for QLogic adapters and SAN storage. 3. Run SCLI commands as required. 4.
2–Getting Started Starting Interactive Mode NOTE: Selections on the Main Menu are dynamic, and what you see depends on your system’s operating system, drivers, and adapter type. Based on your specific system, this menu may contain different items. For example: Selection 5: may be either Target Link Speed or iiDMA Settings. The Virtual menu selection is available only on Windows systems running with a driver that supports NPIV (N_Port ID virtualization).
2–Getting Started Starting Non-Interactive Mode Starting Non-Interactive Mode To start SANsurfer FC/CNA HBA CLI in non-interactive mode, type the following in a command window: scli SANsurfer FC/CNA HBA CLI executes the command options, and then terminates.
2–Getting Started Starting Non-Interactive Mode Table 2-1.
2–Getting Started Starting Non-Interactive Mode Table 2-1.
2–Getting Started Starting Non-Interactive Mode Table 2-1.
2–Getting Started Starting Non-Interactive Mode Table 2-1.
2–Getting Started Terminology For all command line options, SANsurfer FC/CNA HBA CLI shows the following when there are errors in the command line input: Error SANsurfer FC/CNA HBA CLI v1.x.x Build xx Copyright 2003-2009 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters description of command entered Usage: Terminology Some of the terms used in this guide are similar and some have changed slightly as technology changes.
2–Getting Started Advanced Features Advanced Features SANsurfer FC/CNA HBA CLI adds the following advanced features to its toolset: N_Port ID virtualization (NPIV). NPIV (N_Port ID virtualization) allows you to make the most of your server and Fibre Channel fabric. For instance, you can partition your server to support multiple operating systems at the same time, maximizing server utilization. By creating virtual ports from a single physical adapter port, you allow multiple initiators.
3 Interactive Commands This chapter describes the interactive mode command line options for specific QLogic FC adapters. The interactive mode uses a series of menus from which you select the option you want and enter the number for that option. (For information on non-interactive mode operation—in which you simply enter a one- or two-letter code to perform operations on the adapter—refer to 4 Non-Interactive Commands.
3–Interactive Commands Starting Interactive Mode To start the interactive mode, type one of the following: [ scli ] [ scli int] (on some Solaris installations) When you start SANsurfer FC/CNA HBA CLI in interactive mode, the Main Menu appears as follows: Main Menu 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 3-2 General Information HBA Information HBA Parameters Target/LUN List Target Link Speed or 5: iiDMA Settings Target Persistent Bindings Selective LUNs Boot Device Driver Settings Utilities Bea
3–Interactive Commands NOTES: Selections on the Main Menu are dynamic, and what you see depends on your system’s operating system, drivers, and adapter type. Based on your specific system, this menu may contain different items. For example: Selection 5: may be either Target Link Speed or iiDMA Settings. The Virtual menu selection is available only on Windows systems running with a driver that supports NPIV (N_Port ID virtualization).
3–Interactive Commands General Information Menu (Command Line Option -g) 1: General Information 2: Host Topology 2: Save As Txt File General Information Menu (Command Line Option -g) 1: General Information This option shows you general information for the adapter. To see the HBA General Information menu, from the Main Menu, type the number for the General Information option, and then press ENTER.
3–Interactive Commands General Information Menu (Command Line Option -g) Total number of QLogic adapters detected NOTE: The SAN Device Management (SDM) API is a QLogic-specific library required for SANsurfer FC/CNA HBA CLI. The version number of this library is useful in debugging. -----------------------------------------------------------------------------Host Name : BRAGI OS Type : Microsoft Windows Svr 2003 Enterprise Ed. x86 OS Version : Service Pack 1 (Build 3790 SDM API Uersion : 1.28.0.
3–Interactive Commands General Information Menu (Command Line Option -g) Save As Txt file Save As XML File Display (Host Topology) (Command Line Option -tp | -topology) 1: General Information 2: Host Topology 1: Display The host topology option shows information about interconnect elements (switches or adapters) and switch ports. NOTE: Attached Port means a QLogic adapter, a tape or disk target device, or GBIC connected to a physical port on a switch.
3–Interactive Commands General Information Menu (Command Line Option -g) Number of Port Beacon Status Port Type Port State Port Information (repeats for each port) (Every port may not use all items): Physical Port Number (switch or adapter port number), including: Port Name (WWPN) Port State (Online or Loop Down) Port Type TX Port Type Port Module Type Attached Port (Repeats for every target/initiator that functions as an attached port).
3–Interactive Commands General Information Menu (Command Line Option -g) Host : BRAGI Number of Port : 1 Beacon status : Unsupported Port Type : L_Port Port State : Online ================================= = InterConnect Element = ================================= Type : Switch World Wide Name : 10-00-00-C0-DD-00-6A-9F Domain ID : 4 (0x4) Management ID : 0 IP Address : 10.3.10.
3–Interactive Commands General Information Menu (Command Line Option -g) Product Serial Number : LT06464600001011HGGH Target/Initiator Node Name Port Name Vendor Id Product Id Product Revision Product Serial Number : : : : : : : Target 20-00-00-20-37-11-FF-EF 21-00-00-20-37-11-FF-EF SEAGATE ST118273 CLAR18 SG1D LP60266900001919HQ1K . . .
3–Interactive Commands General Information Menu (Command Line Option -g) Beacon status Port Type Port State : Off : Unknown : LinkDown Hit to continue: Save As Txt File (Command Line Option -b) 1. General Information 2: Host Topology 2: Save As Txt File When you save the host topology to a text file, the system responds with the file name. For example: Topology has been successfully saved to file BRAGI_topology_06152009_093855.
3–Interactive Commands General Information Menu (Command Line Option -g) Adapter Model Port Number Port WWPN Port Status Generate Report (Per Adapter Port) 1: General Information 3: Report 1 - n: Port Number If you enter the number for an adapter port instance from the list, the system shows a variety of adapter and system information including: SANsurfer FC/CNA HBA CLI header Version and build Adapter header Host name OS type OS version SDM API version Adapter Model (Ser
3–Interactive Commands General Information Menu (Command Line Option -g) Adapter VPD Header (Vital Product Data) Information (for QLA/QLE24xx and QLE81xx only) Adapter Instance Adapter Part Number Port Number WWPN Port ID Adapter Parameter Settings 3-12 Product Identifier Part Number Serial Number Misc.
3–Interactive Commands General Information Menu (Command Line Option -g) Driver Settings Information Header (Command Line Options -fg) Driver Settings - Group: Persistent Persistently bound Plus New targets Persistently bound targets only Driver Settings - Group: Binding Bind by WWPN Bind by Port ID Device/LUNs Information Header (Repeats for each adapter instance) Adapter Instance Adapter Part Number Port Number WWPN PORT ID Device/LUNs Information (R
3–Interactive Commands General Information Menu (Command Line Option -g) LUN N (Repeats for each LUN) Adapter Instance Adapter Part Number Port Number WWPN Port ID Selective LUN Information Product Vendor Product ID Product revision LUN Size Type WWULN Selective LUN Information Header (repeats for each selective LUN) Status Device Vendor ID Device Product ID Serial Number Device Port Name Device Port ID Boot Device Settings Selectabl
3–Interactive Commands General Information Menu (Command Line Option -g) Host Name : BRAGI OS Type : Microsoft Windows Server 2003 Enterprise Edition x86 OS Version : Service Pack 1 (Build 3790) SDM API Version : 1.28.0.50 QLSDM.
3–Interactive Commands General Information Menu (Command Line Option -g) HBA VPD Information -----------------------------------------------------------------------------Feature is not supported with selected HBA (Instance 1 - 2200)! -----------------------------------------------------------------------------HBA Parameters Settings ----------------------------------------------------------------------------------------------------------------------------------------------------------HBA Instance 1: 2200 P
3–Interactive Commands General Information Menu (Command Line Option -g) -----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00 -----------------------------------------------------------------------------Path : 0 Target : 0 Device ID : 0x82 Product Vendor : SEAGATE Product ID : ST136403FC Product Revision : FF5F Serial Number : LT06464600001011HGGH Node Name : 20-00-00-20-37-1A-6B-CF Port Name : 21-00-00-20-37-1
3–Interactive Commands General Information Menu (Command Line Option -g) Product Vendor Product ID Product Revision LUN Size Type : : : : : : SEAGATE ST118273 CLAR18 SG1D 0 16.95 GB SBC-2 Direct access block device (e.g.
3–Interactive Commands HBA Information Menu (Command Line Option -i) ---------------------------00-00-00-00-00-00-00-00 ---------------------------(Alternate 1) Boot Port Name ---------------------------00-00-00-00-00-00-00-00 ---------------------------(Alternate 2) Boot Port Name ---------------------------00-00-00-00-00-00-00-00 ---------------------------(Alternate 3) Boot Port Name ---------------------------00-00-00-00-00-00-00-00 Finish in 1 second(s)...
3–Interactive Commands HBA Information Menu (Command Line Option -i) Additional adapters (as appropriate) All adapters Here is an example of a typical HBA Information Menu.
3–Interactive Commands HBA Information Menu (Command Line Option -i) If you select a number corresponding to an FCoE engine rather than a port, the following general information is shown: ----------------------------------------------------------------Host Name : TARGET3 HBA Model : QLE8042 HBA Description : QLE8042 Mercury CNA Firmware Version : 1.1.
3–Interactive Commands HBA Information Menu (Command Line Option -i) To create, modify, or delete an adapter alias: 1. From the Main Menu, type the number for the HBA Information option, and then press ENTER. 2. Type the number for the adapter you want to configure, and then press ENTER. 3. Type the number for the HBA Alias option, and then press ENTER.
3–Interactive Commands HBA Information Menu (Command Line Option -i) To create, modify, or delete an adapter port alias: 1. From the Main Menu, type the number for the HBA Information option, and then press ENTER. 2. Type the number for the HBA Port for which you want to change the Port Alias, and then press ENTER. 3. Type the number for the HBA Port Alias option, and then press ENTER. 4. The Port Alias Menu appears.
3–Interactive Commands HBA Parameters Menu BIOS Version (Windows and Linux) FCode Version (Solaris) Flash Image Version (QLE81xx adapters only) If the adapter does not support VPD, the following message appears: VPD not supported on current HBA x! HBA Information (All HBAs) 2: HBA Information n: All HBAs Depending on how many adapters are in the host, the number to select this option varies.
3–Interactive Commands HBA Parameters Menu All adapters Here is an example of an HBA Parameters Menu. In this example, the host includes three adapters with two ports each and one adapter with a single port (see HBA Parameters (Per Adapter Port) and HBA Parameters (All HBAs)): HBA Model QLA2342: 1. Port 1 WWPN 21-00-00-EO-8B-01-43-9B Online 2. Port 2 WWPN 21-01-00-E0-8B-21-43-9B Online HBA Model QLA2300: 3. Port 1 WWPN 21-00-00-E0-8B-05-CB-D8 Loop down 4.
3–Interactive Commands HBA Parameters Menu Display HBA Parameters (Command Line Option -c#) 3: HBA Parameters n: Port Instance 1: Display HBA Parameters When you select this option, the following parameters appear: Connection Options Data Rate (4Gb and above adapters) Frame Size Hard Loop ID Loop Reset Delay (seconds) Enable Host Adapter BIOS Enable Hard Loop ID Enable FC Tape Support Operation Mode Interrupt Delay Timer (100 ms) Execution Throttle Login Retry Cou
3–Interactive Commands HBA Parameters Menu Enable LIP Full Login (QLA/QLE23xx adapters) Link Down Timeout (seconds) Enable Target Reset LUNs per Target Enable Receive Out Of Order Frame Commit Changes Abort Changes Table 3-1 lists the configurable adapter parameters alphabetically by name and alias, and provides values and descriptions of each. Table 3-1. Adapter Parameters Settings (NVRAM) Parameter Name Alias Value ConnectionOption CO 0–3 See table note 1.
3–Interactive Commands HBA Parameters Menu Table 3-1. Adapter Parameters Settings (NVRAM) (Continued) Parameter Name ResetDelay Alias Value RD 0–255 Description Table Notes 1. Connection Options (read-only on QLE8042, QLE/QMI81xx, and SMB adapters): 0 = Loop Only 1 = Point-to-point Only 2 = Loop preferred, otherwise Point-to-Point 3 = Point-to-Point, otherwise Loop (QLA22xx Only) 2. Data Rate (read only on QLE8042 and SMB adapters): 0 = 1 Gbs 1 = 2 Gbs 2 = Auto 3 = 4 Gbs 4 = 8 Gbs 3.
3–Interactive Commands HBA Parameters Menu Data Rate 3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Data Rate This option shows the Data Rate menu. (Note that data rate configuration is not available for all adapter port instances.) From this menu you can select: Auto 1 Gbps 2 Gbps 4 Gbps 8 Gbps NOTE: The 1 Gbps data rate is not supported with 8G adapters. QLE/QMI81xx adapters support 10Gbps only and cannot be modified.
3–Interactive Commands HBA Parameters Menu Enable HBA Port BIOS 3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Enable HBA Port BIOS This option allows you to enable or disable the BIOS boot setting. When this setting is disabled, the ROM BIOS on the adapter is disabled. If you are booting from a FC hard disk attached to the adapter, you must enable this setting. The default is disabled. Enable HBA Hard Loop ID 3: HBA Parameters N: Port Number 2: Configure HBA Parameters n.
3–Interactive Commands HBA Parameters Menu Login Retry Count 3: HBA Parameters N: Port Number 2: Configure HB\A Parameters n. Login Retry Count This choice gives you the option to set the Login Retry Count to a value from 0 to 255. Enable LIP Reset 3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Enable LIP Reset This choice gives you the option to Enable or Disable LIP Reset. Port Down Retry Count 3: HBA Parameters N: Port Number 2: Configure HBA Parameters n.
3–Interactive Commands HBA Parameters Menu Commit Changes 3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Commit changes Choose this option to make the changes permanent. CAUTION! There is undo after you commit to making changes to the adapter parameters. Abort Changes 3: HBA Parameters N: Port Number 2: Configure HBA Parameters n: Abort changes Choose this option to stop without making any changes.
3–Interactive Commands HBA Parameters Menu HBA Parameters (Per FCoE Engine) 3: HBA Parameters n: FCoE Engine The FCoE Parameters menu appears only for the QLE8042 adapter and has the following options: Display FCoE Parameters Configure FCoE Parameters Return to Previous Menu Display FCoE Parameters 3: HBA Parameters n: FCoE Engine 1: Display FCoE Parameters When you select this option, the FCoE Port Selection menu appears.
3–Interactive Commands HBA Parameters Menu FCoE Parameters Menu FCoE Engine (QLE8042) Port 0 Desc: QLE8042 Mercury CNA 1: 2: 3: 4: 5: Port Type Pause Type FCoE COS Save Changes Return to Previous Menu If you make any changes to the configuration of the FCoE engine, select the Save Changes option before you leave the FCoE Parameters menu. Port Type 3: HBA Parameters N: FCoE Engine 2: Configure FCoE Parameters n. Port Type This option shows the Port Type menu.
3–Interactive Commands HBA Parameters Menu Priority Flow Control enables you to manage pauses in traffic according to assigned priorities to class of service (CoS) frames; that is, on per-flow basis. CoS is a way of managing traffic in a network by grouping similar types of traffic (for example, e-mail, streaming video, voice, large document file transfer) together and treating each type as a class with its own level of service priority.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) The priority pause mask is a bitmap of CoS values for which pause is being enabled. SANsurfer FC/CNA HBA CLI allows you to select or clear boxes from 0 to 7, representing the different CoS values for which pause is being enabled (or disabled). Because FCoE uses CoS 3 and because FC is lossless, you must enable pause for CoS 3. If you need to change the FCoE CoS value, you should also enable pause for the new CoS value.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Table 3-2. Target/LUN Information Variable Description
IP address. Adapter number (adapter instance number). Adapter world wide port name, format xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx. Logical unit number (0–255). Target ID. Target world wide port name, format xx-xx-xx or xxxxxx.3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Vendor Product ID Product Rev Serial Number Node Name Portname Port ID : : : : : : : SEAGATE ST318453FC 0006 3JA9TN7600007523T6P1 20-00-00-11-C6-2D-5B-FA 22-00-00-11-C6-2D-5B-FA 02-0A-DE And so on. You can select any LUN and view additional information by entering its number at the prompt and then pressing ENTER.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Desc: QLE2462 PCI Express to 4Gb FC Dual Channel 1: 2: 3: Information Persistent Names Return to Previous Menu Information 4: Target/LUN List 1 - n Target List Menu Port n 1 - n: Target 1 - n: LUN (Number) 1: Information When you select Information from the previous menu, the following information for that LUN appears: Product Vendor Product ID Product Revision LUN Size Type WWULN OS LUN Name (on Solaris an
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) When you select Persistent Names from the previous menu, the following Persistent Names Menu for that LUN appears. This menu provides options to view, add, and delete persistent names for the LUN. For example: Persistent Names Menu HBA Instance 2 (QLE2462 Port 1) : Online WWPN: 21-00-00-E0-8B-86-E5-D0 Desc: QLE2462 PCI Express to 4Gb FC Dual Channel 1: 2: 3: 4: Info Add Delete Return to Previous Menu 1.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) 3. Delete To delete persistent binding for the LUN, select 3 on the Persistent Names Menu. SANsurfer FC/CNA HBA CLI lists the existing LUN persistent binding names, prompts you to select one for deletion, and then immediately deletes the persistent LUN name.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Here is an example of the LUN information. Product Vendor Product ID Product Revision LUN Size : : : : : SEAGATE ST318453FC 0006 0 SBC-2 Direct Access block device (e.g. magnetic disk) WWULN : 20-00-00-11-C6-2D-5A-3F -----------------------------------------------------------------Hit to continue: And so on. Repeats for each LUN.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) 1: Disk 1 on QLA2462 (HBA Instance 0) Vendor : SEAGATE Product ID : ST336607FC Product Rev : 0006 Serial Number : 3JA9TN7600007517FK7W Port Name : 22-00-00-11-C6-2D-5A-B8 Port ID : 02-0A-EO And so on.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Product Vendor Product ID Port Name Port ID LUN ID OS LUN Name (on Solaris and Linux) NOTE: In the Solaris OS, the QLA adapter driver supports a maximum of 256 LUNs. In the Solaris OS, the QLC adapter driver supports a maximum of 16K LUNs. Here is an example of the LUN information: Product Vendor Product ID Product Revision LUN Size Type : : : : : : SEAGATE ST336607FC 0006 0 34.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Here is an example of the All Targets option.
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) ------------------------------------------------------------HBA Instance 0: QLA2462 Port 1 WWPN 21-00-00-E0-8B-1F-9D-F0 Port ID 02-00-00 ------------------------------------------------------------Target WWPN (22-00-00-04-CF-9C-24-CA) ------------------------------------------------------------Product Vendor : SEAGATE Product ID : ST318203FC Product Revision : 0006 LUN : 0 Size : 34.
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) Target Link Speed or iiDMA Settings Menu (Command Line Option -q) 5: Target Link Speed or 5: iiDMA Settings NOTE: Depending on your system, the SANsurfer FC/CNA HBA CLI Main Menu may show either the Target Link Speed option or the iiDMA Settings option.
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) Table 3-3. Target Link Speed Settings (Continued) Target Link Speed Settings Description Target ID. Target world wide port name, format xx-xx-xx or xxxxxx. Target World Wide Node Name, format xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx. Target world wide port name, format xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx. -targets | -t All targets.
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) iiDMA settings have been saved to selected target(s) on HBA instance n. 5. To exit iiDMA Settings without making any changes, select No. To use Advanced Configuration: a. Select the adapter. b. From the device list, select a device (disk) that is currently attached to this adapter. c. From the iiDMA speed list, select the iiDMA (1 Gbps, 2 Gbps, 4 Gbps, or 8 Gbps) that you want to set for this device. d.
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) HBA Instance 0 (QLA2463 Port 1) : Online Desc: QLA2462 PCI-X 2.
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) Vendor : Product ID : Product Rev : Serial Number : Port Name : Port ID : Intelligent Interleave Factor: SEAGATE ST118273 CLAR18 SG1D LP60266900001919HQ1K 21-00-00-20-37-11-FF-EF 11-01-E8 4 Gbps 3: Apply Changes to selected Target(s) 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: Advanced Configuration 5: Target Link Speed n: Port Number 2: Advanced Configuration When you select a p
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) Target Link Speed: All HBAs, Basic Configuration 5: Target Link Speed 2: All HBAs 1: Basic Configuration When you select this option, the Target Link Speed Menu (Basic) for All HBAs appears. It offers the link speed options. The options vary according to the adapter in use. For example: 1 Gbps 2 Gbps 4Gbps 8 Gbps Respond Yes to the Proceed? prompt to apply the change to all port instances on all adapters.
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) Vendor Product ID Product Rev Serial Number Port Name Port ID Max Target Link Rate : : : : : : : SEAGATE ST318453FC 00006 3JA9AYSG000072496FBJ 22-00-00-0C-50-68-1E-9A 11-0A-E2 4 Gbps ... m: Disk 2 on QLA2462 (HBA Instance 1) Vendor : SEAGATE Product ID : ST318453FC Product Rev : 00006 Serial Number : 3AJA9ALAG0000724966ZK Port Name : 22-00-00-11-C6-2D-5A-3F Port ID : 11-0A-E2 Max Target Link Rate : 4 Gbps ...
3–Interactive Commands Target Persistent Bindings Menu (Command Line Option -p) New iiDMA setting has been saved to seleted target(s) on HBA instance 0.
3–Interactive Commands Target Persistent Bindings Menu (Command Line Option -p) Target Persistent Bindings (Per Adapter Port) (Command Line Option -p) 6: Target Persistent Bindings 1 - n: Target Persistent Bindings HBA Instance n When you select an adapter instance to view or change its binding, this menu the Target Persistent Bindings Menu for a specific adapter instance appears.
3–Interactive Commands Target Persistent Bindings Menu (Command Line Option -p) Here is an example of the Target Persistent Binding Menu for HBA Instance n: Target Persistent binding Menu HBA Instance 0 1: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-04-CF-9C-24-CA Port ID : 02-00-E1 Bind : No Target ID : 2: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-0C-50-68-1E-9A Port ID : 11-0A-E2 Bind : No Target ID : ...
3–Interactive Commands Target Persistent Bindings Menu (Command Line Option -p) Type the number for the option you want, and then press ENTER. Target Persistent Binding: Unbind Targets (Command Line Option -p) 6: Target Persistent Binding 1 - n: Target Persistent Binding HBA Instance n 3: Unbind Target(s) The Unbind Targets option is like the Bind Targets option (see “Target Persistent Bindings: Bind Target(s) (Command Line Option -p)” on page 3-55).
3–Interactive Commands Selective LUNs Menu (Command Line Option -m) Selective LUNs Menu (Command Line Option -m) 7: Selective LUNs When you select this option, SANsurfer FC/CNA HBA CLI shows the Selective LUNs Menu (see ), allowing you to select an individual adapter port or All HBAs.
3–Interactive Commands Selective LUNs Menu (Command Line Option -m) 1: 2: 3: Disk Vendor Product ID Port Name Port ID Bind : Target ID : Disk Vendor Product ID Port Name Port ID Bind : Target ID : Return to Previous Menu : : : : SEAGATE ST136403FC 21-00-00-20-37-1A-6B-CF 11-01-E4 : : : : SEAGATE ST118273 CLAR18 21-00-00-20-37-11-FF-EF 11-01-E8 Yes 0 Yes 1 The general view shows: -----------------------------------------------------------------------------HBA Instance 5: QLA2300 Port 2 WWPN 21-01-
3–Interactive Commands Boot Device Menu (Command Line Option -e) Please reboot the system for the saved configuration to become effective. Boot Device Menu (Command Line Option -e) 8: Boot Device NOTE: The Boot Device Menu option is not supported on Red Hat or Novell PowerPC64. When you select this option, SANsurfer FC/CNA HBA CLI shows the standard HBA Port Instance menu (see “HBA Port Instance” on page 3-49) allowing you to select an individual adapter port or All HBAs.
3–Interactive Commands Boot Device Menu (Command Line Option -e) -----------------------------------------------------------------------------HBA Instance 0: 2200 Port 1 WWPN 21-00-00-E0-8B-03-55-7C PortID 00-00-EF -----------------------------------------------------------------------------Boot Device Settings: --------------------------------------Selectable Boot: Disabled --------------------------------------(Primary ) Boot Port Name LUN --------------------------------00-00-00-00-00-00-00-00 0 -------
3–Interactive Commands Driver Settings Menu (Command Line Option -fg) LUN List Menu 8: Boot Device n: Port Number 2: Configure Boot Device 2: Boot Device Settings 1: LUN List Menu When you select this option, SANsurfer FC/CNA HBA CLI shows the LUN List Menu, which includes a list of LUNs on the selected device. You can select any of the lUNs as the boot device: LUN: 0 LUN: 1 And so on.
3–Interactive Commands Driver Settings Menu (Command Line Option -fg) NOTE: Options on the Driver Settings menu differ according to the driver type: failover, non-failover, Windows, Solaris, or Macintosh: Present persistently bound target(s) plus any new target(s) with driver default (option available for all drivers) Present persistently bound target(s) Only (option available for all drivers) Present targets with driver default (option available for failover driver only) Bind by World Wide Port Na
3–Interactive Commands Utilities Menu Table 3-4. Driver Settings (Continued) Alias Value NewOnlya NO 0, 1 Present targets with driver default. BindWWPN BW 0, 1 Bind devices by WWPNs. BindPortID BP 0, 1 Bind devices by port IDs. Parameter Name Description Table Notes a Driver Parameter NewOnly (NO) is supported only with the failover driver.
3–Interactive Commands Utilities Menu Update Flash (Per Adapter Port or All HBAs) (Command Line Option -b) 10: Utilities 1: Update Flash When you select Update Flash, you are prompted to select either one of your adapter port instances or All HBAs to update. SANsurfer FC/CNA HBA CLI then prompts you to Update Entire Image, to enter a file name (.bin) for the Flash update file, and to confirm the operation. The Flash update progress appears as in the following example: Validating Flash Image File...
3–Interactive Commands Utilities Menu Warning: Please update the HBA parameters with extreme care. Incorrectly updating the HBA parameters may render the HBA inoperable. If you currently have boot device information set up in the HBA parameters, updating the HBA parameters from a file may result in changing that information.
3–Interactive Commands Utilities Menu Maximum LUNs Per Target specifies the maximum number of LUNs per target. Multiple LUN support is typically for RAID boxes that use LUNs to map drives. Port Down Retry Count specifies the number of times SANsurfer FC/CNA HBA CLI retries a command to a port returning port down status. Link Down Timeout specifies the time the driver waits for the link to come up after link down before returning the I/Os.
3–Interactive Commands Utilities Menu Table 3-7. Template Supported Parameter Settings for QLA23xx Adapters (ISP2300/2310) Setting QLogic EMC IBM Sun Execution Throttle 16 256 256 16 Descending Loop ID Search 0 1 0 0 Maximum LUNs Per Target 128 256 0 8 Port Down Retry Count 30 45 30 30 Link Down Timeout 30 45 30 0 Table 3-8.
3–Interactive Commands Utilities Menu HPQ (HP-specific settings—2Gb HP adapters) IBM (IBM-specific settings) QLGC (QLogic-specific settings) SUN (Sun-specific settings) Select one of the templates to apply it immediately to the adapter port instance (or All HBAs.) The following is returned: Updating HBA Parameters on HBA instance n - QLA2nnn. Please wait... HBA Parameters update complete. Changes have been saved and applied to the HBA instance n.
3–Interactive Commands Utilities Menu Firmware Preload Table Update Menu HBA Model QLA2462 Port 1: WWPN: 21-00-00-E0-8B-1F-9D-F0 Loop Down Port 2: WWPN: 21-01-00-E0-8B-3F-9D-F0 Online HBA Model QLE2562 1: Port 1: WWPN: 21-00-00-1B-32-1B-4E-4C Online Port 2: WWPN: 21-01-00-1B-32-3B-4E-4C Online 2: All HBAs 3: Return to Previous Menu The CLI issues a warning and prompts you to confirm that you want to proceed with the firmware preload table update.
3–Interactive Commands Utilities Menu Port 1: WWPN: 21-00-00-E0-8B-1F-9D-F0 Port 2: WWPN: 21-01-00-E0-8B-3F-9D-F0 HBA Model QLE2562 1: Port 1: WWPN: 21-00-00-1B-32-1B-4E-4C Port 2: WWPN: 21-01-00-1B-32-3B-4E-4C 2: Return to Previous Menu Loop Down Online Online Online Note: 0 to return to Main Menu Enter Selection: 1 Enter a file name or Hit to abort: QLE2562_fwp.
3–Interactive Commands Utilities Menu Current Version: v1.0 Enter a file name or Hit to abort: c:\QLE8142_MPI.dat Saving current MPI config table of HBA instance 0 to c:\QLE8142_MPI.dat... Mpi Configuration v1.0 of HBA instance 0 saved successfully. Driver Rescan (Command Line Option -rs) 10: Utilities n: Driver Rescan The Driver Rescan option is available only on Solaris systems with the QLA driver.
3–Interactive Commands Utilities Menu 2. Select the number corresponding to the QLE256x adapter port for which you want to update firmware, or select the option for All HBAs. SANsurfer FC/CNA HBA CLI shows the following warning: Warning: Please update the HBA firmware area with extreme care. Incorrectly updating the firmware area may render the HBA inoperable. Do you want to proceed with the operation? 1: Yes 2: No 3. Select option 1 to proceed. 4.
3–Interactive Commands Utilities Menu ; ; FW Area data file for standard card ;************************************************************************** ; !!!!! DO NOT CHANGE THE ORDER OF THE DATA !!!!!!!!!!!! ;************************************************************************** ; ;*************************************************** ; FW Area header (BYTE OFFSET 0000h - 0013h) ;*************************************************** FW Signature [0-FFFFFFFFh] = caba3821 ...
3–Interactive Commands Beacon Menu Beacon Menu 11: Beacon The Beacon menu provides options for beaconing: a process by which an LED on a device (adapter or target) is flashed or blinked to locate it. Use the Locate HBA option to beacon a specified adapter. Use the Locate Target option to beacon a specified storage device (the Locate Target option assumes that the target is a JBOD device rather than RAID).
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) 2: 3: 4: Disk Vendor Product ID Port Name Port ID Beacon : No Beacon Selected Target(s) Return to Previous Menu : : : : SEAGATE ST118273 CLAR18 21-00-00-20-37-11-FF-EF 11-01-E8 You can select a disk number to blink the LED on that target. The blinking asterisk (*) below the Device Port Name line shows that the target beacon is active.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) When you select this option from the Main Menu, SANsurfer FC/CNA HBA CLI shows Diagnostics Menu with the standard list of adapter ports. Type the number for the port on which you want to run diagnostic tests and then press ENTER.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Display Test Parameters Reset Test Parameters Configure Test Parameters Start Diagnostic Test NOTE: The diagnostic loopback test is not available for the QLE8042 adapter. Diagnostic tests interrupt normal adapter operations. At the completion of the testing, the adapter’s state before the tests are restored. Note the following: Run these tests when no other activities are required of the adapter.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) If the adapter port is not connected to the fabric through a point-to-point connection (F-port) and is not connected to a switch, change the setting to loop only, if not currently set to this option. If the adapter port is connected to the fabric through a point-to-point connection (F-port) and is connected to a switch, change the setting to point-to-point only, if not currently set to this option.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Data Size (Bytes) : 512 Number of test(s)(1-65535) : 65535 Test Increment(1-65535) : 1 On Error : Ignore Test Continuous : OFF Loopback Type : External Loopback ------------------------------------------------------------------------------ Reset Test Parameters (Loopback) 12: Diagnostics n: Port Number 1: Loopback Test 2: Reset Test Parameters Select this option to reset the current loopback test parameters to the default
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Table 3-10.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Selecting the Loopback Type option (available only for 8Gb adapters) shows the currently type and allows you to change the type to one of the following loopback test types: 10 bit Internal Loopback 1 bit Serial Loopback External Loopback (QLE81xx adapters support only the external loopback test and require a loopback connector) For example: Diagnostics Start Mode HBA Instance 2 (QLE2562 Port 1) : Online WWPN: 21-00-00-
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Finished 6376 iterations in 1 second(s)...
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) 4. 6. 1 = Loopback Test 2 = Read/Write Buffer Test The Read/Write Buffer Test Menu appears. Select one of the following options: 1. Display Test Parameters. Type 1 to show the current parameter values. 2. Reset Test Parameters. Type 2 to return all parameters to their default values. 3. Configure Test Parameters. Type 3 to customize any or all of the parameter values. Continue with Step 5. 4.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) operations. Please make sure there is no active I/O before starting the test(s). Do you want to proceed with the test(s)? 1. Yes 2. No Type 1 to proceed or 2 to cancel the operation.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) NOTE: The diagnostic transceiver details (DMI) are not available for the QLE8042 FCoE engine. Transceiver Details: General Select the General option on the Transceiver Details menu to view general information for the selected adapter port.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Address A0 Identifier: SFP Ext. Identifier: GBIC/SFP defined by serial ID only Connector: LC Ethernet Speed: 10 GBytes/Sec Compliance: 0x00 0x00 0x00 FC Link Length: FC Transmitter Tech: FC Transmission Media: FC Speed: Encoding: Reserved BR, Nominal: 0x67 Length (9um) - km: 0x00 Length (9um): 0x00 Length (50um): 0x08 Length (62.5um): 0x03 Length (Copper): 0x00 Vendor name: FINISAR CORP.
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Address A2 Temp High Alarm: 0x4e00 Temp Low Alarm: 0x0c00 Temp High Warning: 0x4900 Temp Low Warning: 0x1100 Voltage High Alarm: 0x9088 Voltage Low Alarm: 0x7148 Voltage High Warning: 0x8ca0 Voltage Low Warning: 0x7530 Bias High Alarm: 0x170c Bias Low Alarm: 0x07d0 Bias High Warning: 0x1518 Bias Low Warning: 0x09c4 TX Signal Power High Alarm: 0x207e TX Signal Power Low Alarm: 0x09d0 TX S
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) Reserved MSB: 0x00 Reserved LSB: 0x00 Status/Control Bits:-Data_Ready_Bar: 0x0 -LOS: 0x0 -TX Fault: 0x0 -Soft RX Rate Select: 0x0 -RX Rate Select State: 0x1 -Soft TX Disable: 0x0 -TX Disable State: 0x0 -TX Signal Power Low Alarm: 0x0 -TX Signal Power High Alarm: 0x0 -TX Bias Low Alarm: 0x0 -TX Bias High Alarm: 0x0 -Vcc Low Alarm: 0x0 -Vcc High Alarm: 0x0 -Temp Low Alarm: 0x0 -Temp High Alarm: 0x0 -RX Signal Power Low Alarm: 0x0 -RX S
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) NOTE: Under Solaris, adapter statistics are disabled if you are using the driver from the OS installation CDs (QLC driver). Under Linux, this feature is disabled if you are using the IOCTL or sysfs (inbox) driver. Under Solaris, link statistics are disabled if you are using the driver from the OS installation CDs (QLC driver).
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) LogToFile (LF): null.csv 5. To restore the adapter defaults, select Restore Default, and then press ENTER. The following message appears: Resetting to default settings..., done. 6. To change the polling, select Auto Poll, and then press ENTER. Then select either Auto Poll or Manual Poll, and then press ENTER to enable that selection. 7. To change the sampling rate, select Set Rate, and then press ENTER.
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) Resetting to default settings..., done. Auto Poll 13: Statistics 1: HBA Statistics 1: Configuration 3: Auto Poll SANsurfer FC/CNA HBA CLI shows two polling options: AutoPoll Manual Poll If you select the Auto Poll option, the system enables Auto Poll and returns a message: Auto Poll enabled.
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) The file name extension .csv indicates a comma separated value file type. Show HBA Statistics 13: Statistics 1: HBA Statistics 1: Show HBA Statistics To view the adapter port statistics: 1. From the Main Menu, type the number for the Statistics option, and then press ENTER. 2. From the Statistics Menu, type the number for the HBA Statistics option, and then press ENTER. 3.
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) “Configuration” on page 3-94 “Show Link Status” on page 3-96 Configuration 13: Statistics 2: Link Status 1: Configuration When you select the Configuration option, the Link Status Settings Menu appears and allows you to view and configure the following: Current Settings Restore Default Auto Poll Set Rate Log to file Table 3-12 shows the statistics and link status options. Table 3-12.
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) Resetting to default settings..., done. Auto Poll Menu 13: Statistics 2: Link Status 1: Configuration 3: Auto Poll SANsurfer FC/CNA HBA CLI shows two polling options: Auto Poll Manual Poll If you select the Auto Poll option, the system enables Auto Poll and returns a message: Auto Poll enabled.
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) The file name extension .csv indicates a comma separated value file type. Show Link Status 13: Statistics 2: Link Status 2: Show Link Status The Show Link Status option shows a menu of port numbers from which you can select the port for which you want the link status. To view the link status: 1. Type the number for the Statistics option, and then press ENTER. 2. The Statistics Menu appears.
3–Interactive Commands Virtual Menu (Command Line Option -vp) Virtual Menu (Command Line Option -vp) 14: Virtual Menu NOTES: The option to use N_Port ID virtualization (NPIV) only appears on the Main Menu if the adapters and system support it. NPIV requires a Windows or Solaris system running with a driver that supports NPIV. Virtual menu options are not available for the QLE8042 adapter with FCoE engine. QLE81xx adapters support NPIV.
3–Interactive Commands Virtual Menu (Command Line Option -vp) When you select the Virtual Menu option from the main menu, the Virtual Menu appears, showing: Adapter Model Port Number WWPN Status (Online/Loop down) (Additional adapters) (Additional ports) Virtual port options include the following: is the world wide port name (WWPN) of a virtual port. is a single hexadecimal digit that will be part of the virtual port’s WWPN (second field, byte 1).
3–Interactive Commands Virtual Menu (Command Line Option -vp) In addition, the following notes apply: The maximum number of virtual adapters that can be created of a physical adapter is 15. vPort means virtual port in all the displays. In command line mode, you must use the WWPN instead of adapter instance number to select a virtual port. After you create or delete a virtual adapter, you should refresh the configuration to see the changes.
3–Interactive Commands Virtual Menu (Command Line Option -vp) Create Virtual Port(s) 14: Virtual 1: Virtual Menu 3: Create a Virtual Port NOTE: For Solaris 11, this option is not supported for the QLC driver.
3–Interactive Commands QoS Menu (Command Line Option -qos) Enter Hex Pattern (xx) : Type two hex digits. The system creates the new virtual port, for example: (Create Virtual Port Menu) Enter Selection: 2 Enter Hex Pattern : EF The system returns the following: Virtual Port 21-EF-00-8B-14-5A-CF created successfully on HBA instance 4. Note that the entered hex digits, EF, now appear in byte 1 of the new virtual port WWPN.
3–Interactive Commands QoS Menu (Command Line Option -qos) Setting the QoS by priority (the default for newly created virtual ports) lets you set the priority level for each of the defined virtual ports. This enables to you give preference to data transmissions for one virtual port over others by giving it a higher priority than the others, which in turn translates to IOPS. You can set the priority level on any virtual port, regardless of the settings applied to other virtual ports.
3–Interactive Commands QoS Menu (Command Line Option -qos) CAUTION! If you change QoS type from QoS Priority to QoS Bandwidth, or QoS Bandwidth to QoS Priority, the QoS settings of all virtual ports revert to the default settings. QoS Priority Menu 15: QoS n: Port number 1: QoS Priority Setting the QoS by priority lets you set the priority level for each of the defined virtual ports.
3–Interactive Commands QoS Menu (Command Line Option -qos) 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2 The QoS Priority Menu reappears and lists all the virtual ports. 5. Verify that the priority level is correct for the virtual port that you changed. 6. (Optional) To prevent further changes to the virtual port, set the mode to Locked. 7. (Optional) To change the priority for additional virtual ports, repeat the previous steps. 8.
3–Interactive Commands QoS Menu (Command Line Option -qos) Desc: QMH2562 PCI-E to 8Gb FC Dual Channel Mezz HBA 1: 2: 3: Bandwidth Speed Bandwidth Percentage Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1 When deciding how much bandwidth to assign to a virtual port, consider the bandwidth required to run the application, and then set it in the range of +5% of given bandwidth.
3–Interactive Commands QoS Menu (Command Line Option -qos) 2. If the virtual port is already enabled and unlocked, proceed to Step 3. Otherwise: a. The virtual port must be Enabled to set the bandwidth. To enable a currently disabled vPort, enter 1 for the Enable/Disable QoS Settings option and then 1 again to Enable the vPort. b. The virtual port must be Unlocked to set the bandwidth.
3–Interactive Commands QoS Menu (Command Line Option -qos) QoS Bandwidth Percentage Menu 15: QoS n: Port number 2: QoS Bandwidth 2: Bandwidth Percentage To set the bandwidth percentage for a virtual port: 1. From the QoS Bandwidth Percentage Menu, type the number corresponding to the virtual port that you want to change. Take note of whether or not that virtual port is currently Enabled and Unlocked, and then press ENTER. 2. If the virtual port is already enabled and unlocked, proceed to Step 3.
3–Interactive Commands FCoE Menu (Command Line Option -cna) Hit to continue: FCoE Menu (Command Line Option -cna) 16: FCoE Fibre Channel over Ethernet (FCoE) is a new technology that allows FC storage traffic to travel over an Ethernet fabric. This promotes I/O consolidation, whereby data (TCP/IP) and storage (FCoE) traffic can travel over the same shared Ethernet medium.
3–Interactive Commands FCoE Menu (Command Line Option -cna) Update Firmware 16: FCoE 1: Update Firmware Use this option to update the firmware on the adapter’s ASIC chip. When you select the Update Firmware option from the FCoE Utility menu, SANsurfer FC/CNA HBA CLI prompts you to enter the file name (usually a .bin file) for the firmware to update. After the firmware update is complete, the utility shows a message if it succeeded or failed.
3–Interactive Commands FCoE Menu (Command Line Option -cna) Number of Transmitted 802.
3–Interactive Commands FCoE Menu (Command Line Option -cna) scli -fcoe ( | ) --log --list To show a specific log entry by Log ID, enter the following command: scli -fcoe ( | ) --log --id Link Events 16: FCoE 3: Logs: 1: Link Events Select the Link Events option to show information similar to the following example: --------------------------------------LogID=8 LogName=Link Events --------------------------------------000:00:01:58:480 Host fibr
3–Interactive Commands FCoE Menu (Command Line Option -cna) 1: 2: 3: 4: 5: Information Data Center Bridging DCE Statistics TLV Return to Previous Menu The following sections explain each of these menu options: “Information” on page 3-112 “Data Center Bridging” on page 3-112 “DCE Statistics” on page 3-114 “TLV” on page 3-118 Information 16: FCoE 1: Information When you select the Information option from the FCoE Utilities Menu for QLE81xx/QMI81xx adapters, general information for the adapter i
3–Interactive Commands FCoE Menu (Command Line Option -cna) ---------------------------DCBX Enable Willing Port Pause Type SAN Priority COS ---------------------------ETS ---------------------------Priority Txt Mode SAN Bandwidth Percent SAN Unused Bw To LAN LAN Unused Bw To SAN : : : : Enabled Enabled Per Priority Pause 3 : : : : Bandwidth 50 Enabled Disabled Table 3-13 provides descriptions of the DCBX and enhanced transmission selection (ETS) settings shown in the preceding example. Table 3-13.
3–Interactive Commands FCoE Menu (Command Line Option -cna) Table 3-13. DCBX and ETS Configuration Parameters (Continued) Parameter Description SAN Priority CoS CoS provides eight levels to accommodate more than one traffic class of SAN, LAN, and IPC, with one of the classes used for SAN traffic. This setting shows the persistent value for priority-encoded port packets: 0–7. The default value is 5. The SAN CoS setting affects the connection only when connected to a peer that is not configured with DCBX.
3–Interactive Commands FCoE Menu (Command Line Option -cna) Display Settings 16: FCoE 3: DCE Statistics 1: Display Settings Select the Display Settings option to show the current DCE statistics settings for the selected adapter, for example: --------------------------------------DCE Statistics Settings --------------------------------------AutoPoll (AP): 10 SetRate (SR): 5 LogToFile (LF): N/A Details (DT): 0 Auto Polling 16: FCoE 3: DCE Statistics 2: Auto Polling Select the Auto Polling option to op
3–Interactive Commands FCoE Menu (Command Line Option -cna) ------------------------------------------------------------DCE Statistics Details for CNA Instance 0 - QLE8142 ------------------------------------------------------------Transmit Packets: 143885 Transmit Octets: 17373502 Transmit Multicast Packets: 20036 Transmit Broadcast Packets: 0 Transmit Unicast Packets: 123849 Transmit Control Packets: 0 Transmit Pause Packets: 0 Transmit Packets 64 Octets: 2 Transmit Packets 65to127 Octets: 113380 Transmi
3–Interactive Commands FCoE Menu (Command Line Option -cna) Receive Receive Receive Receive Receive Receive Receive Receive CBFC Pause Frames 0: 0 CBFC Pause Frames 1: 0 CBFC Pause Frames 2: 0 CBFC Pause Frames 3: 0 CBFC Pause Frames 4: 0 CBFC Pause Frames 5: 0 CBFC Pause Frames 6: 0 CBFC Pause Frames 7: 0 Receive FCoE Packets: 337914 Receive Mgmt Packets: 20479 Receive Packets Priority 0: 0 Receive Packets Priority 1: 0 Receive Packets Priority 2: 0 Receive Packets Priority 3: 337937 Receive Packets Prio
3–Interactive Commands FCoE Menu (Command Line Option -cna) NOTE: While the DCE statistics are running, you can change the viewing options by pressing the keys listed above: A, R, B, C, [, ], {, }, and ENTER. The C key (Clear Baseline) option is available only in Baseline mode. TLV 16: FCoE 4: TLV When you select the TLV option from the FCoE Utilities Menu for QLE81xx/QMI81xx adapters, a submenu menu prompts you to view either Details or Raw type-length-value (TLV) data for DCBX.
3–Interactive Commands FCoE Menu (Command Line Option -cna) Priority Group ID of Priority 7: 0 Priority Group ID of Priority 6: 0 Priority Priority Priority Priority Priority Priority Priority Priority Group Group Group Group Group Group Group Group 0 1 2 3 4 5 6 7 Percentage: Percentage: Percentage: Percentage: Percentage: Percentage: Percentage: Percentage: 50 50 0 0 0 0 0 0 Number of Traffic Classes Supported: 2 DCBX Parameter Information Parameter Type: Remote Pad Byte Present: Yes DCBX Parameter
3–Interactive Commands Help Menu (Command Line Option -h) PFC PFC PFC PFC PFC PFC PFC PFC Enabled Enabled Enabled Enabled Enabled Enabled Enabled Enabled on on on on on on on on Priority Priority Priority Priority Priority Priority Priority Priority 0: 1: 2: 3: 4: 5: 6: 7: No No No Yes No No No No Number of Traffic Classes Supported: 8 . . .
3–Interactive Commands Help Menu (Command Line Option -h) To view help for FCoE using the command line option, enter the following command: scli -fcoe Contents 14 (or 15): Help 1: Contents When you select the Contents option, SANsurfer FC/CNA HBA CLI shows the entire Help menu. You can see the help menu options rearranged into alphabetical order in Appendix D. Exit Codes 14 (or 15): Help 2: Exit Codes When you select the Exit Codes option, SANsurfer FC/CNA HBA CLI shows the entire list of exit codes.
3–Interactive Commands Help Menu (Command Line Option -h) Notes 3-122 SN0054614-00 K
4 Non-Interactive Commands This chapter contains the information in the help (to view help, enter the command -h), plus additional explanation and examples. Each command line option is listed, followed by a command description and examples of the command in use and typical responses from the system.
4–Non-Interactive Commands Display System Information (Command Line Options -g, -z, and -tp) SAN target management (SDM) API version List of adapters: adapter model, port number, WWPN, serial number (SN), adapter number (adapter 0–n), and status (online/offline) Total number of QLogic FC adapters detected NOTE: The failover and SAN device management APIs are QLogic-specific libraries required for SANsurfer FC/CNA HBA CLI. The versions of these libraries are useful for debugging purposes.
4–Non-Interactive Commands Display System Information (Command Line Options -g, -z, and -tp) Host Topology (Command Line Option -tp) NOTE: Under Linux, host topology (-tp) is disabled if you are using the IOCTL or sysfs (inbox) driver.
4–Non-Interactive Commands Display System Information (Command Line Options -g, -z, and -tp) Port Type Port State Port Information Physical Port Number (switch port number), including: Port state Port type TX port type Port module type Attached Port (QLogic adapter, tape device, or disk device connected to the switch physical port), including: Target/initiator Node name Port name Vendor ID Product ID (if applicable) Product revision (if applicable) P
4–Non-Interactive Commands Command Summary Table 4-1.
4–Non-Interactive Commands Command Summary You cannot combine the command -f with any other options: -f = Input Parameter Options from a Text File (see “-f (Input Parameter Options from a Text File)” on page 4-13). For example: # scli -f command.txt In addition, the following general rules for commands apply: Only one command line option per input file is valid. You can use either the hyphen (-) character or the forward slash (/) character.
4–Non-Interactive Commands Command Summary NOTE: Adapter must not be in silent mode. See “-s (Silent Mode)” on page 4-45 to issue a response to this command. The -a feature is not supported on QLA22xx adapters or QLE8042 adapter. To view the adapter port’s LED beacon state, type: # scli -a ( | )(view | ?) When the adapter’s LED is flashing, the following message appears: HBA Port x - LED Flashing is ON.
4–Non-Interactive Commands Command Summary To update one or all adapter’s Flash with new BIOS or FCode, type: # scli -b (all | | ) [(<-rg> | all)] Where: all = All adapters of the same type in the system are updated with the new BIOS/FCode hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name -rg = Flash region update mode (4GB adapters onlya) all Update all regions (BIOS/FCode/EFI) depending on the Flash BIOS/FCode File = Na
4–Non-Interactive Commands Command Summary The -cna command line options use the following variables: hba instance = Adapter instance number of a converged network adapter port hba wwpn = World wide port name of a converged network adapter port mpi file = MPI configuration .
4–Non-Interactive Commands Command Summary Table 4-3.
4–Non-Interactive Commands Command Summary # scli -dm ( | | all)details | det Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter all = All adapters in the system -e (Boot Device View | Select | Disable) Use the -e command to: Show the current boot-device selection for all adapters. Show the current boot-device selection for a specific adapter. Set a target device as the boot device for an adapter.
4–Non-Interactive Commands Command Summary If the system does not have an adapter with a boot device selected, the following message appears: There is no boot device selected for any HBA in the system. Following is an example of the boot device option when viewing the boot device for a single adapter. In this example, no boot device is configured (selectable boot is disabled; the boot port name is all zeroes).
4–Non-Interactive Commands Command Summary In Solaris SPARC, setting the target ID to the target of the boot-selected LUN is equivalent to persistently binding the target (see “-p (Display Persistent Target Binding Info)” on page 4-38). Therefore, if the target is persistently bound, its boot device entry must have the same target ID.
4–Non-Interactive Commands Command Summary The file must contain a single line. The file must contain only parameters. The file cannot contain another -f option. The following example shows how to set the connection option of an adapter to default (loop preferred, otherwise point-to-point) and the data rate to auto through a command file that is invoked by the -f option: 1. Create a text file (for example, setadapter0.txt) and enter the following command in the text file: -n 0 co 2 dr 2 2.
4–Non-Interactive Commands Command Summary In the previous commands, the variables indicate the following (see also Table 4-4: hba instance = Adapter instance number (use -g command to find) hba wwpn = World wide port name of the adapter param name = Name of the parameter param alias = Alias of the parameter param value = New value of the parameter -port0 = FCoE access port 0 -port1 = FCoE access port 1 Table 4-4.
4–Non-Interactive Commands Command Summary Network Interface Statistics Commands To show the FCoE network interface statistics, issue the following command: # scli -fcoe ( | ) --mon --nsl --portn FCoE Log Commands To show the FCoE available logs, issue the following commands: To list available log IDs: # scli -fcoe ( | ) --log --list To show a specific log by log ID: # scli -fcoe ( | ) --log --id In the previous comman
4–Non-Interactive Commands Command Summary Where: hba instance = Adapter instance number of an adapter port (use -g command to find) hba wwpn = World wide port name of the adapter param name = Name of the parameters param alias = Alias of the parameters param value = New value of the parameters The pairs and can be repeated to set multiple parameters in a single command. Table 4-5 lists the driver configuration parameter names and aliases. Table 4-5.
4–Non-Interactive Commands Command Summary -g (Display System Information) To view system information, type: # scli -g For details of this command, see “Display System Information (Command Line Options -g, -z, and -tp)” on page 4-1.
4–Non-Interactive Commands Command Summary -h (Help) Type the following text to view the help file: # scli (-h | ?) Type the following text to view help information for an individual command: # scli (-h | ?) For example, typing scli -l -h shows: SANsurfer FC/CNA HBA CLI v1.x.x Build x Copyright 2003-2009 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters scli -l ( | ) - shows LUN information for all HBAs.
4–Non-Interactive Commands Command Summary Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter alias = Symbolic adapter name.
4–Non-Interactive Commands Command Summary # scli -kl ( | ) To do a loopback test with customized parameters, type: # scli -kl ( | ) [( | ) ] Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter -ex or -exclude = World wide port name of the target device to be excluded from the read/write test param name = One of the following: DataPattern (see “DataPattern (DP)
4–Non-Interactive Commands Command Summary The data pattern must be in a two-character hexadecimal pattern in the range of 00–FF. The hexadecimal letters can be uppercase or lowercase.
4–Non-Interactive Commands Command Summary DataSize (DS) For the loopback test, the data size specifies the data (frame payload) size in bytes. The data size is the actual data that is transferred during any given pass of the test. DS DataSize The valid data sizes are as follows: Read/write buffer test. The data size can be 8, 16, 32, 64, or 128 bytes. The default value is 128 bytes. Echo test. The data size can be 8, 16, 32, 64, 128, 256, 512, 1024, or 2048.
4–Non-Interactive Commands Command Summary 12 (Windows) 25 (Solaris) 2 (Linux and Macintosh) The default test increment is 1. The test increment cannot be larger than the number of tests run (see “TestCount (TC)” on page 4-23). OnError (OE) For the loopback test, OnError is either: OE OnError This parameter determines how errors are handled if they occur during any given pass. Table 4-8 lists the valid values. Table 4-8.
4–Non-Interactive Commands Command Summary NOTE: The loopback test is disabled if you are using the drivers from the OS installation and not functional on the QLE8042 adapter. NOTE: Run an echo test instead of a loopback test under the following conditions: You have a QLA23xx, QLA24xx, QLE23xx, or QLE24xx adapter that is connected to the fabric through a point-to-point connection (F_Port). The adapter is connected to a switch.
4–Non-Interactive Commands Command Summary # scli -kl DP FF DS 8 TC 500 TI 10 OE 1 You do not have to set each parameter for the loopback test. If you do not specify a parameter in the command line, the current parameter value is used. For example, the following command sets the data pattern to FFh and uses the current values for the other parameters: # scli -kl DP FF The following example sets the data size to 16 bytes and has the test loop if an error occurs.
4–Non-Interactive Commands Command Summary -kl ( | ) [{( | ) }] -kl (Run HBA Diagnostics Loopback Test) NOTE: Under Solaris, this feature is disabled if you are using the driver from the OS installation CDs (QLC driver). The , , and options are described in Table 4-11.
4–Non-Interactive Commands Command Summary Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter -ex or -exclude = World wide port name of the target device that is excluded from the read/write test param name = One of the following: DataPattern (see “DataPattern (DP)” on page 4-21) DataSize (see “DataSize (DS)” on page 4-23) TestCount (see “TestCount (TC)” on page 4-23) TestIncrement (see “TestIncrement (TI)” on page 4-23) OnError (see “OnEr
4–Non-Interactive Commands Command Summary To do a read/write buffer test using the current parameters, type: # scli -kr ( | ) To exclude a device or devices on the selected adapter port, type: # scli -kr (|) [(-EX | -EXCLUDE) ] [( | ) ] The following examples do 500 read/write buffer tests with a test increment of 10, a data pattern of FFh, and a data size of 8 bytes. The test stops if an error occurs.
4–Non-Interactive Commands Command Summary Run Adapter Diagnostics Read-write Buffer Test The {(-ex | exclude) } parameters specify a device that will be excluded from the read/write buffer test. The system shows the following information after a read/write buffer test completes: Loop ID/status Data miscompare Link failure Loss of sync Loss of signal Invalid CRC Table 4-11 lists the , , and options. Table 4-11.
4–Non-Interactive Commands Command Summary c Compliant jitter tolerance pattern in a FC frame, as defined by the ASIC document listed above. d Compliant supply noise test sequence in a valid FC frame, as defined by the ASIC document listed above. e For read/write buffer test, the maximum size is 128; this is also the default. For an echo test, the maximum size is 2048; the default size is 512.
4–Non-Interactive Commands Command Summary Link Failure—Number of link failures Loss of sync—Number of sync loss errors Loss of signal—Number of signal loss errors Invalid CRC—Number of invalid CRCs -l (Display LUN Info) This command shows LUN information for: All adapters A specific target A specific LUN on a specific target To show the LUN information for all target devices for a specific adapter Instance, type: # scli -l ( | ) To show the LUN information
4–Non-Interactive Commands Command Summary Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter param name = Name of the parameter (see Table 4-13) param alias = Alias of the parameter (see Table 4-13) param value = New value of the parameter (see Table 4-13) Table 4-13 defines the link status parameter names, aliases, and values. Table 4-13.
4–Non-Interactive Commands Command Summary Use the -m command to: View all selective LUNs for all adapter ports View an adapter’s selective LUN list View the current selective state of a LUN on a specific target Enable (select) a LUN on a specific target on a specific adapter Disable (deselect) a LUN on a specific target on a specific adapter Enable all LUNs on a specific target on a specific adapter Disable (deselect) all LUNs on a specific target on a specific adapter Enable (select) a
4–Non-Interactive Commands Command Summary NOTE: You can repeat the sequence 1 to select multiple LUNs in the same command.
4–Non-Interactive Commands Command Summary param alias = Alias of the parameters param value = New value of the parameters The pairs and can be repeated to set multiple parameters with a single command. Table 4-14 lists the adapter parameter names and aliases. . Table 4-14.
4–Non-Interactive Commands Command Summary a Connection Options: 0 = Loop only 1 = Point-to-point only 2 = Loop preferred, otherwise point-to-point 3 = Point-to-point preferred, otherwise loop (QLA22xx adapters only) b Data Rate (QLA23xx/QLA24xx/QLE23xx/QLE24xx and 8Gb adapters): 0 = 1 Gb 1 = 2Gbs 2 = Auto 3 = 4 Gbs 4 = 8 Gbs c EnableBIOS option not available on 4Gb adapter. d EnableExtendedLogging option not available on PPC64 or SPARC.
4–Non-Interactive Commands Command Summary Where the file name is systemLUNinfo, all messages are located in the directory indicated for the system platform: Windows: syslog.log in the current directory Linux: /var/log/messages Macintosh: /var/log/system.
4–Non-Interactive Commands Command Summary The following example is a typical SANsurfer FC/CNA HBA CLI output showing all targets currently bound to an adapter: -------------------------------------------------------------------------HBA 0: QLA2462 Port 1 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 11-06-EF -------------------------------------------------------------------------Bind Type Device Node Name Device Port Name Port ID ID ---- ---- -------------------------------------No Disk xx-xx-xx-xx-xx-xx-xx-xx xx
4–Non-Interactive Commands Command Summary Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter target wwnn = World wide node name of the target To unbind all targets on a specific adapter port or on all adapter ports, type: # scli -p ( | | all) (remove all | unbind all) Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter -pa (Define Port Alias) With this command yo
4–Non-Interactive Commands Command Summary -pl (Show, Add, and Delete Persistent Names) This option provides persistent device names for storage devices. NOTE: The -pl option is available only on Linux (RHEL 5.x) systems; this option is not supported for SLES 11.
4–Non-Interactive Commands Command Summary -q (View or Set Target Link Speed) NOTE: The -q option is supported only on 4GB adapters.
4–Non-Interactive Commands Command Summary To set the link speed of selected target(s) attached to one adapter to the designated speed, type the following command: # scli -q ( | | ) Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter all = Reports link speed for all targets on all adapters in the system target wwpn = World wide port name of the target speed = Link speed -qos (QoS Menu) SANsurfer
4–Non-Interactive Commands Command Summary You can specify the QoS of the virtual port based on either priority, bandwidth speed, or bandwidth percentage, where: --pri = Priority to assign to the virtual port priority = Priority value: low, medium, or high --bwspd = Bandwidth speed to assign to the virtual port speed = Value of bandwidth speed --bwper = Bandwidth percentage to assign to the virtual port percent = Value of bandwidth percent You can change the lock and enable properties of the virtual port
4–Non-Interactive Commands Command Summary -s (Silent Mode) NOTE: The -s option is valid only in non-interactive mode. You can use this option with all non-interactive mode options that have a corresponding interactive mode option (see Table 4-1). This option must be the first or last command in the command line. In non-interactive mode, the system shows result and status messages generated by SANsurfer FC/CNA HBA CLI (by default) unless suppressed by silent mode.
4–Non-Interactive Commands Command Summary To show the target information for a specific target on a specific adapter, type: -t ( | ) ( | ) iiDMA (intelligent interleaved direct memory access) settings include: —targets | –t applies to all targets. indicates the supported intelligent interleave factor: 1, 2, 4, or 8 Gbps.
4–Non-Interactive Commands Command Summary To save the current adapter firmware preload table to a DAT file, enter the following command: # scli -u ( | ) save Where: is the adapter instance number of an adapter port. is the world wide port name (WWPN) of an adapter port. is the name of the firmware preload table DAT file. -v (Display Version) NOTE: This option is valid only in non-interactive mode.
4–Non-Interactive Commands Command Summary # scli -vp ( : ) list To create a virtual port with an automatic WWPN, type: # scli -vp ( : ) create auto To create a virtual port with a specific WWPN, type: # scli -vp ( : ) create When prompted, enter two hexadecimal digits. The system checks these digits to be sure they are unique and, if they are, puts them into byte 1 of the WWPN.
4–Non-Interactive Commands Command Summary You can use this option with all non-interactive mode options that have a corresponding interactive mode option (see Table 4-1). This option must be the first or last command in the command line. When you use this option, the system shows all result and status messages in XML format 2, standard XML format. These formats are described in Appendix B.
4–Non-Interactive Commands Command Summary Notes 4-50 SN0054614-00 K
A XML Format 1 NOTE: XML files created using the -x1 command line option do not match standard output. They are designed for backward compatibility with customized legacy scripts. For new scripts, we strongly recommend using the -x2 command line option, which generates XML files compatible with standard output (see Appendix B). Output Parts The -x1 command line option (see “-x (Output in XML Format 1)” on page 4-48) shows all output in XML format 1.
A–XML Format 1 XML Format 1 Tags for Each Option Status Message Before the closing main tag , SANsurfer FC/CNA HBA CLI shows returning status from the execution of the command line parameters and the error messages.
A–XML Format 1 XML Format 1 Tags for Each Option “Display Device List (Command Line Option -t)” on page A-7 “Display LUN List (Command Line Option -l)” on page A-7 “Target Persistent Binding (Command Line Option -p)” on page A-8 “Selective LUNs (Command Line Option -m)” on page A-8 “Boot Device (Command Line Option -e)” on page A-9 “Diagnostics Results—Loopback Test (Command Line Option -kl)” on page A-9 “Diagnostics Results—Read/Write Buffer Test (Command Line Option -kr)” on pa
A–XML Format 1 XML Format 1 Tags for Each Option OS Version (and patches) Number of QLogic FC HBA(s) 0 0 The parameter repeats for each adapter in the system. Display Adapter Settings (Command Line Option -c) The XML Format 1 for adapter settings information is as follows:
A–XML Format 1 XML Format 1 Tags for Each Option For multiple adapters, repeat the preceding sequence with the ID number (ID Number="value") of the next adapter. Display HBA Information (Command Line Option -i) NOTE: 4G adapters include VPD information as an option to the -i command. The XML Format 1 for adapter general information is as follows: SANsurfer FC/CNA HBA CLI vn.nn.
A–XML Format 1 XML Format 1 Tags for Each Option
A–XML Format 1 XML Format 1 Tags for Each Option 0 0 Display Device List (Command Line Option -t) The XML Format 1 for adapter device information is as follows: SANsurfer FC/CNA HBA CLI vn.nn.
A–XML Format 1 XML Format 1 Tags for Each Option Type="value" /> 0 0 The sequence is repeated for each LUN attached to the target. The LUN list is listed under the target, not the adapter. The ... sequence is repeated for each LUN attached to the target.
A–XML Format 1 XML Format 1 Tags for Each Option Target WWNN Target WWPN 0 0 The … sequence repeats for each adapter. The … sequence repeats for each Target. The sequence repeats for each enabled LUN under the target.
A–XML Format 1 XML Format 1 Tags for Each Option CRCError="value" DisparityError="value" FrameLengthError="value" Result="value"/> 0 0 Diagnostics Results—Read/Write Buffer Test (Command Line Option -kr) The XML Format 1 for the read/write buffer test results is as follows: SANsurfer FC/CNA HBA CLI vn.nn.
A–XML Format 1 XML Format 1 Tags for Each Option BindbyPortID="value" /> /DriverSettings> 0 0 Display All Information for One or All Adapters (Command Line Option -z) The XML Format 1 for all adapter information is more complicated than its non-XML counterpart because the tags cannot be repeated. In non-XML mode, SANsurfer FC/CNA HBA CLI sequentially calls all the options in Table A-1, and each option is shown in its standard output format.
A–XML Format 1 XML Format 1 Tags for Each Option Host Name OS Type OS Version (and patches where applicable) Number of QLogic Fibre Channel HBA(s) detected
A–XML Format 1 XML Format 1 Tags for Each Option EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="value" /> Target WWNN Target WWPN
A–XML Format 1 XML Format 1 Tags for Each Option NOTE: The … sequence is repeated for each adapter. The … sequence is repeated for each target. The parameter is repeated for each LUN. The parameter is repeated for each enabled LUN. The parameter is repeated for each target persistent binding entry. The parameter is repeated for each boot device selection entry.
A–XML Format 1 XML Format 1 Tags for Each Option DeviceError="value" Reset="value" IOCount="value" IOPS="value" BPS="value" TimeStamp="value" /> 0 0 HBA Alias (Command Line Option -ha) The XML Format 1 for the adapter alias option is as follows: SANsurfer FC/CNA HBA CLI vn.nn.
A–XML Format 1 XML Format 1 Tags for Each Option HBA Transceiver Details (Command Line Option -dm) The XML Format 1 for adapter transceiver details (general information) is as follows: SANsurfer FC/CNA HBA CLI vn.nn.
A–XML Format 1 XML Format 1 Tags for Each Option (mW) "value" "value" "value" "value" "value" "value" (mW) "value" "value" "value" "value" "value" "value"
A–XML Format 1 XML Format 1 Tags for Each Option "value" "value"
A–XML Format 1 XML Format 1 Tags for Each Option "value" "value" "value" "value" "value" "value" "value" "value" "value" "value" "value"
A–XML Format 1 XML Format 1 Tags for Each Option "value" "value" "value" "value" "value" "value" "value" "value" "value" "value"
A–XML Format 1 XML Format 1 Tags for Each Option WWPN="value" VendorId="value" Model="value" SerialNumber="value" Alias="value" PortAlias="value" DriverVersion="value" FirmwareVersion="value" Host="value" TotalNumberOfDevices="value" NumberofPort="value" BeaconStatus="value" PortType="value" PortState="value"/> 0 0 The XML Format 1 for a switch type interconnect element is as follows:
A–XML Format 1 XML Format 1 Tags for Each Option ... ... ... ...
A–XML Format 1 XML Format 1 Tags for Each Option SANsurfer FC/CNA HBA CLI 1.7.1.23 0 0 Display FCoE Parameters The XML Format 1 for FCoE parameter output is as follows:
A–XML Format 1 XML Format 1 Tags for Each Option SANsurfer FC/CNA HBA CLI 1.7.1.
A–XML Format 1 XML Format 1 Tags for Each Option 0 0 Display FCoE DCBX The XML Format 1 for FCoE DCBX output is as follows: SANsurfer FC/CNA HBA CLI 1.7.1.23
A–XML Format 1 XML Format 1 Tags for Each Option Info="No Data"/> 0 0 Displ
A–XML Format 1 XML Format 1 Tags for Each Option 0 0 0 0
A–XML Format 1 XML Format 1 Tags for Each Option 0 0 0 0 0 0
A–XML Format 1 XML Format 1 Tags for Each Option 0 0 0 0 0
A–XML Format 1 XML Format 1 Tags for Each Option 0 0 0 0 0 0
A–XML Format 1 XML Format 1 Tags for Each Option 0 0 SN0054614-00 K A-31
A–XML Format 1 XML Format 1 Tags for Each Option Notes A-32 SN0054614-00 K
B XML Format 2 This appendix provides the following information: “Output Parts” on page B-1 explains the output of XML format 2. “XML Format 2 Tags for Each Option” on page B-3 lists the XML format 2 tags for each option. NOTE: XML files created using the -x2 command line option match standard output. They do not match the X1 files (see Appendix A), which are designed for backward compatibility with customized legacy scripts.
B–XML Format 2 Output Parts Utility Header The following header information is shown after the main tag: SANsurfer FC/CNA HBA CLI X.YY.ZZ Build XX X.YY Status Message Before the closing main tag , SANsurfer FC/CNA HBA CLI shows any returning status from the execution of the command line parameters and the error messages.
B–XML Format 2 XML Format 2 Tags for Each Option XML Format 2 Tags for Each Option The following sections describe the XML Format 2 for each command line option: “Display System Information (Command Line Option -g)” on page B-4 “Display Adapter Settings (Command Line Option -c)” on page B-4 “Display HBA Information (Command Line Option -I)” on page B-5 “Display Device List (Command Line Option -t)” on page B-7 “Display LUN List (Command Line Option -l)” on page B-8 “Target Persistent
B–XML Format 2 XML Format 2 Tags for Each Option Display System Information (Command Line Option -g) The command format is: scli -g -x2 The XML Format 2 for system information output is as follows: SANsurfer FC/CNA HBA CLISANsurfer FC/CNA HBA CLI vn.n.nn Build nnn.
B–XML Format 2 XML Format 2 Tags for Each Option FrameSize="value" HardLoopId="value" LoopResetDelay="value" EnableHostAdapterBIOS="value" EnableHardLoopId="value" FibreChannelTapeSupport="value" OperationMode="value" IntDelayTimer="value" ExecutionThrottle="value" LoginRetryCount="value" EnableLipReset="value" PortDownRetryCount="value" EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="value" /> n n /Reboot> The
B–XML Format 2 XML Format 2 Tags for Each Option HBAPort="value" PortAlias="value" WWNN="value" WWPN="value" PortID="value" SerialNumber="value" DriverVersion="value" BIOSVersion="value" FirmwareVersion="value" PCIbus="value" PCIDevice="value" ActualConnectionMode="value" ActualDataRate="value" TargetCount="value" PortType="value" Status="value" n n /Reboot> The XML Format 2 for 4G adapters is as follows:
B–XML Format 2 XML Format 2 Tags for Each Option PortType="value" Status="value" 0 0 Here is the VPD information: SANsurfer FC/CNA HBA CLI vn.nn.nn Build n.
B–XML Format 2 XML Format 2 Tags for Each Option Target WWNN Target WWPN n n /Reboot> The … sequence repeats for each target. The … sequence repeats for each adapter.
B–XML Format 2 XML Format 2 Tags for Each Option n n /Reboot> The sequence repeats for each LUN attached to the target. The LUN list is listed under the target, not under the adapter.
B–XML Format 2 XML Format 2 Tags for Each Option Target WWNN Target WWPN n n /Reboot> The … sequence repeats for each enabled LUN on the target.
B–XML Format 2 XML Format 2 Tags for Each Option n "message" n /Reboot> The … sequence repeats for each adapter.
B–XML Format 2 XML Format 2 Tags for Each Option n n /Reboot> Diagnostics Results—Read/Write Buffer Test (Command Line Option -kr) The command format is: scli -kr ( | ) [(-EX | -EXCLUDE) ] ( | ) -x2 The XML Format 2 for the read/write buffer test results is as follows: SANsurfer FC/CNA HBA CLI vn.n.
B–XML Format 2 XML Format 2 Tags for Each Option n "message" n /Reboot> Display All Information for One or All Adapters (Command Line Option -z) The XML Format 2 for all adapter information is more complicated than it
B–XML Format 2 XML Format 2 Tags for Each Option Table B-1. Options Shown by -z (Continued) Noninteractive Option -e Description Boot device See User Guide Section “-e (Boot Device View | Select | Disable)” on page 4-11 The command format is: scli -z ( | | all) -x2 The XML Format 2 for all adapter information is as follows: SANsurfer FC/CNA HBA CLI vn.n.nn Build nnn.
B–XML Format 2 XML Format 2 Tags for Each Option PortType="value" Status="value" />
B–XML Format 2 XML Format 2 Tags for Each Option > > n n /Reboot> NOTE: The … sequence repeats for
B–XML Format 2 XML Format 2 Tags for Each Option n n /Reboot> The … sequence repeats for each adapter. The parameter repeats for each link.
B–XML Format 2 XML Format 2 Tags for Each Option HBA Alias (Command Line Option -ha) The command format is: scli -ha ( | ) view | ? -x2 The XML Format 2 for the adapter alias option is as follows: SANsurfer FC/CNA HBA CLI vn.n.nn Build nnn.
B–XML Format 2 XML Format 2 Tags for Each Option The XML Format 2 for adapter transceiver details (detailed information) is as follows: SANsurfer FC/CNA HBA CLI v1.7.0 Build 15 2.
B–XML Format 2 XML Format 2 Tags for Each Option "value" "value" "value" "value" "value" "value" (mW) "value" "value" "value" "value" "value" "value"
B–XML Format 2 XML Format 2 Tags for Each Option (C) "value" "value" "value" "value" "value" "value" (V) "value" "value" "value" "value" "value"
B–XML Format 2 XML Format 2 Tags for Each Option The XML Format 2 for adapter transceiver details (general information) is as follows: # scli -dm ( | | all) (details | det) -x2 The XML Format 2 for adapter transceiver details (detailed information) is as follows: SANsurfer FC/CNA HBA CLI vn.n.nn Build nnn.
B–XML Format 2 XML Format 2 Tags for Each Option "value" "value" "value" "value" "value" "value" "value" "value" "value"
B–XML Format 2 XML Format 2 Tags for Each Option "value" "value" "value" "value" "value" "value" "value" "value" "value" "value" "value" "value" "value" "value" "va
B–XML Format 2 XML Format 2 Tags for Each Option "value" "value" "value" "value" "value" "value" "value" "value" "value" "value"
B–XML Format 2 XML Format 2 Tags for Each Option BeaconStatus="value" ...
B–XML Format 2 XML Format 2 Tags for Each Option Display FCoE Information The XML Format 2 for FCoE information output is as follows: SANsurfer FC/CNA HBA CLI 1.7.1.23 PAGE 284B–XML Format 2 XML Format 2 Tags for Each Option SANsurfer FC/CNA HBA CLI 1.7.1.23 SANsurfer FC/CNA HBA CLI 1.7.1.
B–XML Format 2 XML Format 2 Tags for Each Option 0 0 Display FCoE DCBX The XML Format 2 for FCoE DCBX output is as follows: SANsurfer FC/CNA HBA CLI 1.7.1.
B–XML Format 2 XML Format 2 Tags for Each Option Info="No Data"/> 0
B–XML Format 2 XML Format 2 Tags for Each Option 0 0 0 0
B–XML Format 2 XML Format 2 Tags for Each Option 0 0 0 0 0 0
B–XML Format 2 XML Format 2 Tags for Each Option 0 0 0 0 0
B–XML Format 2 XML Format 2 Tags for Each Option 0 0 0 0 0 0
B–XML Format 2 XML Format 2 Tags for Each Option 0 0 0 SN0054614-00 K B-35
B–XML Format 2 XML Format 2 Tags for Each Option Notes B-36 SN0054614-00 K
C Error/Exit Return Codes To list the error/exit return codes while running SANsurfer FC/CNA HBA CLI in interactive mode: 1. From the Main Menu, select the Help option, and then press ENTER. 2. On the Help Menu, select Exit Codes, and then press ENTER. To list the SANsurfer FC/CNA HBA CLI non-interactive error/exit codes from the command line, type: scli -ei SANsurfer FC/CNA HBA CLI lists the error/exit return code numbers, names, and descriptions as shown in Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
C–Error/Exit Return Codes Table C-1.
D Help Commands Table D-2 is an alphabetic listing of the Help commands. Unless otherwise noted, only one command line option per input file is valid. The hyphen (-) and slash (/) characters are equivalent. For example, scli -g and scli /g are both valid commands. Table D-1 describes each variable used in the command line arguments shown in Table D-2. Table D-1. Variables Used in Arguments Variable Description
IP address. Adapter instance number of an adapter port.D–Help Commands Table D-1. Variables Used in Arguments (Continued) Variable Description World wide port name of a target device. (xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx). World wide port name of the virtual port with the two hexadecimal digits in byte three supplied by the user. World wide port name of a virtual port. Table D-2. Help Commands Command Line Action Arguments Function [ int ] Starts interactive mode.
D–Help Commands Table D-2. Help Commands (Continued) Command Line Action Arguments Function Performs a driver update to the adapters. is the full path of the driver file in inf/zip or exe format. –dm ( | | ) general | gen | details | det Runs a transceiver (SFF/SFP) diagnostics on an adapter port and shows the result in general or detail view. This feature is supported only with 4Gb adapter or latest.
D–Help Commands Table D-2. Help Commands (Continued) Command Line Action –e Arguments ( | [ prim | alt1 | alt2 | alt3] Function Configures the operating system to boot from a specific target: prim: Primary Boot Port Name alt1: Alternate 1 Boot Port Name alt2: Alternate 2 Boot Port Name alt3: Alternate 3 Boot Port Name –e ( view | ? ) Shows the current boot device information on all adapters.
D–Help Commands Table D-2. Help Commands (Continued) Command Line Action Arguments Function –fs ( | ) { ( | ) } Configures the driver settings. –gs ( | ) { ( | ) } Shows the current statistics on an adapter port. – Lists all the command options and syntax. Option –h can be combined with a command line option to show the usage of that individual command.
D–Help Commands Table D-2. Help Commands (Continued) Command Line Action D-6 Arguments Function –ls ( | ) { ( | ) } Shows the current link status on an adapter port. –m ( | ) ( view | ? ) Views selective LUN information of all devices attached to an adapter port.
D–Help Commands Table D-2. Help Commands (Continued) Command Line Action Arguments Function –p ( | ) { } Binds the selected device(s) attached to an adapter port. –p ( | ) remove | unbind Unbinds a specific device attached to an adapter port.
D–Help Commands Table D-2. Help Commands (Continued) Command Line Action Arguments Function –q ( | | ) [ –targets | –t ] Shows the current iiDMA settings of all targets on an adapter port or all adapters. -qos | info --vp [--spd|--per] Shows current QoS settings for all virtual ports on a physical adapter port.
D–Help Commands Table D-2. Help Commands (Continued) Command Line Action Arguments Function -u ( | ) save Saves the current adapter firmware preload area to a DAT file. –v — Shows the current version. –vp ( | ) create Creates a virtual port with your own WWPN. –vp ( | ) create auto Creates a virtual port with default WWPN (auto generate).
D–Help Commands Notes D-10 SN0054614-00 K
Glossary adapter The board that interfaces between the host system and the target devices. Adapter is synonymous with host bus adapter (HBA), host channel adapter (HCA), host adapter, and adapter board. adapter alias A user-defined name for an adapter. adapter port A port on the adapter board. adapter port alias A user-defined name for an adapter port. adapter port beacon An LED on the adapter. Flashing it enables you to locate the adapter. AL Arbitrated loop.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters boot device The device, usually the hard disk, that contains the operating system the BIOS uses to boot from when the computer is started. cache A temporary high-speed storage (memory) area where recently used or frequently accessed data is stored for rapid access, thus increasing the efficiency of processor operations. Cache contents duplicate recently-used values stored on disk or elsewhere.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters DCB Data center bridging. Provides enhancements to existing 802.1 bridge specifications to satisfy the requirements of protocols and applications in the data center.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters fabric loop port See FL_Port. fabric port See F_Port. fabric switch Also, switched fabric. A fabric switch connects multiple devices from independent FC-arbitrated loops (FC-ALs) and point-to-point topologies into a fabric using FC switches. Fast!UTIL QLogic Fast!UTIL FC adapter BIOS utility.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters input/output control See IOCTL. intelligent interleaved direct memory access See iiDMA. inter-switch link See ISL. IOCTL Input/output control. A system call in UNIX/Linux systems. Allows an application to control or communicate with a device driver outside usual read/write operations.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Using LUNs, the FC host can address multiple peripheral devices that may share a common controller. LUN masking A software feature that assigns LUNs to specific servers or hides LUNs from specific servers for maximum access and availability control. media Physical-layer information carriers. FC supports several different physical media: copper, multimode optical, and single-mode optical.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters other NL_Ports in virtual point-to-point links through an FC_AL open loop circuit often through FC_AL (arbitrated loop) open loop circuit often through FC-AL hub or loop switch devices. See: E_Port, F_Port, FL_Port, G_Port, N_Port. node loop port See NL_Port. node port See N_Port. non-volatile random access memory See NVRAM. NPIV N_Port ID virtualization.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters port instance The number of the port in the system. Each adapter may have one or multiple ports, identified with regard to the adapter as port 0, port 1 and so forth. to avoid confusion when dealing with a system containing numerous ports, each port is assigned a port instance number when the system boots up.
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters TLV Type-length-value (TLV) is optional information that may be encoded as an element inside the protocol. The type and length fields are fixed in size (typically 1 to 4 bytes), and the value field is of variable size. These fields are used as follows: Type: A numeric code that indicates the kind of field that this part of the message represents. Length: The size of the value field (typically in bytes).
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Notes Glossary-10 SN0054614-00 K
Index Numerics 1 bit serial loopback test 3-82 10 bit internal loopback test 3-82 A -a 3-75, 4-6 abort changes to adapter parameters 3-32 about the product 3-121 adapter alias defining 4-6, A-15, B-18 definition of Glossary-1 setting and deleting 4-19 showing 3-21 adapter information viewing 3-19, 3-21, 4-2, 4-20, A-5, A-11, B-5, B-13 viewing all 4-49 viewing by port number 3-20 viewing for FCoE 3-112 adapter parameters aborting changes to 3-32 configuring 3-26 configuring (FCoE engine) 3-33 defaults, rest
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters AL_PA definition of Glossary-1 in adapter parameter template 3-66 AL, definition of Glossary-1 alias adapter information 3-21 adapter port 3-22 adapter, defining 4-6, A-15 API library, SDM 3-5 arbitrated loop, definition of Glossary-1 arbitrated loop_physical address, See AL_PA ASIC chip, updating firmware 3-109 attached port definition of 3-6 viewing details 3-7 attaching loopback connector 3-79 audience for guide
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters commands (continued) -a 3-75, 4-6 -b 3-10, 3-65, 4-7 -c 3-21, 3-26, 4-8, A-4, B-4 -cna 3-108, 4-8 -d 3-69, 4-10 -dm 3-76, 3-85, 4-10, A-16, B-20 -e 3-60, 4-11, A-9, B-10 -ei 4-13, C-1 -f 4-13 -fcoe 4-14 -fg 3-62, 4-16, A-10, B-12 -fs 4-16 -g 3-4, 4-1, A-3, B-4 -gs 3-89, 4-18, A-14, B-17 -h 3-120, 4-19 -ha 3-21, 4-19, A-15, B-18 -i 3-19, 3-21, 4-20, A-5, B-5 -kl 3-76, 3-77, 4-20, 4-24, A-9, B-11 -kr 3-76, 3-83, 4-27
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters current settings adapter statistics 3-91 link status 3-94 customer support xviii D -d 3-69, 4-10 data pattern parameter 4-21 size parameter 4-23 vital product (VPD) 3-23 data center bridging, See DCB data center bridging exchange protocol, See DCBX data center Ethernet, See DCE data rate 3-26, 3-29, 4-36 DataPattern (DP) parameter 4-21, 4-30, 4-31 DataRate (DR) parameter 4-36 DataSize (DS) parameter 4-23, 4-30 DCB
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters -dm 3-76, 3-85, 4-10, A-16, B-20 documentation conventions used in guide xvi related xvii revision history ii DP parameter 4-21, 4-30 driver definition of Glossary-3 IOCTL 3-5 rescanning 3-72 settings, configuring 3-62, 4-16 settings, viewing 4-16, A-10, B-12 sysfs 3-5 updating 3-69 updating for device 4-10 DS parameter 4-23, 4-30 E -e 3-60, 4-4, 4-11, A-9, B-10 E_Port (expansion port), definition of Glossary-3 ec
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters FCoE adapter information 3-112 data center bridging 3-112 TLV, viewing 3-118 Utilities menu for QLE80xx 3-108 Utilities menu for QLx81xx 3-111 -fcoe 4-14 FCoE, definition of Glossary-4 FCoE engine adapter parameters 3-33 adapter parameters, configuring 3-33 adapter parameters, displaying A-23, B-27 adapter parameters, viewing 3-33 CoS, configuring 3-35 firmware, updating 3-109 information, viewing A-22, B-27 logs 3
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters hard loop ID configuring 3-26 enabling 4-36 specifying 3-29 HardLoopID parameter 4-36 hardware requirements 1-4 HBA, See adapter help about the product 3-121 file, viewing 4-19 Help Menu 3-120 host configuration, refreshing 3-19 configuration, viewing 4-4 information, viewing 3-6, 4-1 topology 3-5 saving as text file 3-10 viewing 3-5, 4-3, 4-46 host bus adapter, See adapter I -i 3-19, 3-21, 4-5, 4-20, A-5, B-5 ID,
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters J JBOD (just a bunch of disks), definition of Glossary-5 K -kl 3-76, 3-77, 4-20, 4-24, A-9, B-11 -kr 3-76, 3-83, 4-27, 4-28, A-10, B-12 L -l 3-21, 3-36, 4-5, 4-32, A-7, B-8 L_Port, definition of Glossary-5 L1 cache Glossary-2 L2 cache Glossary-2 LED adapter, locating 3-75 selected target, locating 3-76 target, locating 3-75 toggling 4-6 library, SDM API 3-5 license agreements xvii link down timeout 3-27, 3-31 eve
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters LoopbackType parameter 4-24 loop-only connection 3-28 -ls 3-89, 3-93, 4-32, A-14, B-16 LT parameter 4-24 LUN masking, definition of Glossary-6 LUNs configuration, displaying 3-58 configuring automatically 3-59 configuring manually 3-59 definition of Glossary-5 enabling and disabling 4-33 ID 4-6 information, viewing 4-32 list, viewing A-7, B-8 maximum per target 4-36 per target 3-27, 3-31 persistent names, adding an
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters non-interactive mode (continued) starting 2-4 non-volatile random access memory, definition of Glossary-7 NPIV definition of Glossary-7 Virtual Menu option 3-97 number of tests parameter 4-23, 4-30 NVRAM, definition of Glossary-7 O -o 4-5, 4-37 OE parameter 4-24, 4-30 ONC, definition of Glossary-7 one bit serial loopback test 3-82 OnError parameter 4-24, 4-30 open network computing, definition of Glossary-7 operat
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters port (continued) listing 3-99 quality of service 4-43 user-generated 3-100 port alias creating, editing, deleting 3-22, 4-40 XML Format 1 A-15 port down retry count 3-26, 3-31 PortDownRetryCount parameter 4-36 preface to guide xv preload table (firmware) saving 3-70 updating 3-69 priority, QoS 3-103 Q -q 3-47, 4-42 QLA/QLE/QEM adapters supported by 1-2 QLA23xx 3-27, 4-25 QLA24xx 4-25 QLA24xx adapter, VPD 3-23 QLE2
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters SANsurfer FC HBA CLI (continued) software requirements 1-5 supported QLogic adapters 1-2 saving adapter parameters 3-66 configuration 3-62 Fcode 4-7 firmware area 3-74, 4-46 firmware preload table 3-70 Flash BIOS 4-7 Flash file 3-65 MPI config table 3-71 qos settings 3-104, 3-106, 3-107 topology as text file 3-10 saving as XML file 3-10 XML Format 1 3-10 XML Format 2 3-10 SCSI, definition of Glossary-8 SDM API libr
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters target beacon, starting and stopping 4-46 binding 3-57 binding info, viewing 4-38 binding, definition of Glossary-8 definition of Glossary-8 ID 4-6 ID, Solaris 4-12 link speed, setting and viewing 4-42 list 3-37 locating (beacon LED) 3-75 locating selected (beacon LED) 3-76 LUN list 3-36 LUNs 3-27 persistent binding A-8, B-9 port ID 4-6 reset, enabling 3-27, 3-31, 4-36 unbinding 3-57 WWNN 4-6 WWPN 4-6 Target Link S
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters uninstall Linux 1-22 Macintosh 1-24 Solaris SPARC 8, 9, and 10 1-22 Solaris x86 8, 9, and 10 1-23 VMware 1-24 Windows 1-21 unknown adapter types 1-2 unsupported adapters 1-2 unsupported features 1-5 updating adapter parameter templates 3-66 adapter parameters 3-65, 4-44 device driver 4-10 driver 3-69 FCode 4-7 firmware area 3-72, 4-46 firmware preload table 3-69 firmware, ASIC chip 3-109 Flash 3-65 Flash BIOS 4-7 M
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters world wide node name, See WWNN world wide port name, See WWPN WWNN definition of Glossary-9 notation for 2-4 WWPN bind by WWPN parameter 4-17 definition of Glossary-9 notation for 2-4 X -x 3-10, 4-5, 4-48 -x1 A-1 -x2 3-10, 4-48 XML file, saving as 3-10 Format 1 3-10, 4-48, A-1 Format 2 3-10, 4-48, B-1 .
Corporate Headquarters QLogic Corporation 26650 Aliso Viejo Parkway Aliso Viejo, CA 92656 949.389.6000 Europe Headquarters QLogic (UK) LTD. Quatro House Lyon Way, Frimley Camberley Surrey, GU16 7ER UK www.qlogic.com +44 (0) 1276 804 670 © 2004–2009 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLogic, the QLogic logo, QLA, and SANsurfer are registered trademarks of QLogic Corporation.
