Page 1 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters SN0054614-00 K...
Page 2: Document Revision History
QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification.
Page 3 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Added new FCoE menu option to Interactive Com- 3 Interactive Commands mands chapter. Added Flash Image Version to list of actual VPD “Generate Report (Per Adapter Port)” on information.
Page 4 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Notes SN0054614-00 K...
Page 5: Table Of Contents
Supported QLogic Adapters ........
Page 6 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Uninstalling SANsurfer FC/CNA HBA CLI ......
Page 7 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters HBA Parameters Menu ........
Page 8 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Target Persistent Binding (All HBAs) ......
Page 9 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) ... 3-76 Diagnostics Loopback Test (Command Line Option -kl) ...
Page 10 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) ......... . .
Page 11 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters TestIncrement (TI) ........
Page 12 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) ....
Page 13 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Boot Device (Command Line Option -e) ..... . .
Page 14 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters List of Tables Windows Command Line Installation Parameters ......
Page 15: Preface
NOTE: This guide uses interchangeably the terms HBA, CNA, and adapter. Intended Audience This guide is intended for end users responsible for administration of QLogic FC adapters. What’s in This Guide This preface provides a general overview of the product and covers the intended audience, related materials, document conventions, and contact information for technical support.
Page 16: Documentation Conventions
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.
Page 17: Related Materials
For additional information, refer to the SANsurfer FC/CNA HBA CLI ReadMe file and release notes. License Agreements Refer to the QLogic Software End User License Agreement for a complete listing of all license agreements affecting this product. SN0054614-00 K xvii...
Page 18: Technical Support
Fibre Channel products. From the main QLogic Web page, www.qlogic.com, click the Education and Resources tab at the top, and then click the Education & Training tab at the left. The QLogic Global Training Portal offers online courses, certification exams, and scheduling of in-person training.
Page 19: Installation And Removal
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. Refer to the following sections: “Supported QLogic Adapters” on page 1-2 “Supported Operating Systems”...
Page 20: Supported Qlogic Adapters
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.
Page 21: Supported Operating Systems
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...
Page 22: System Requirements
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. System Requirements The system requirements for SANsurfer FC/CNA HBA CLI are described in the following sections: “Hardware Requirements”...
Page 23: Software Requirements
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. Administrative privileges to perform management functions. One of the operating systems listed in “Supported Operating Systems” on page 1-3.
Page 24: Downloading The Installation Package
Follow these steps to download the SANsurfer FC/CNA HBA CLI installation package from the QLogic Web site. To download the installation package: From the QLogic home page (www.qlogic.com), click the Downloads tab. On the Driver Downloads / Manuals page, select Fibre Channel HBAs,...
Page 25: Installing Sansurfer Fc/Cna Hba Cli
If you have a previous version of SANsurfer FC HBA CLI already installed, the installation program (except on Solaris) provides the option to upgrade the previous version to this latest version. However, QLogic recommends that you always uninstall any older version of SANsurfer before installing the new version.
Page 26: Windows Installation
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.
Page 27 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 Read the information, and then click Next. SN0054614-00 K...
Page 28 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 To select a different location: Click Browse.
Page 29 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 Read the information, and then click Install. The Setup Status dialog box appears as shown in Figure 1-6.
Page 30: Command Line Installation
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 (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.
Page 31: Windows Command Line Installation Parameters
Windows operating system, where xx indicates the version of SANsurfer FC/CNA HBA CLI: scli-1.x.x.xx.windows.exe By default, SANsurfer FC/CNA HBA CLI is installed in the following directory: Program files\QLogic Corporation\SANsurferCLI If you want to change the default location, enter the directory in the command line; for example: scli-1.x.x-xx.windows.exe installdir="c:\sansurfercli"...
Page 32: Linux Installation
To install SANsurfer FC/CNA HBA CLI on a Red Hat/SUSE Linux operating system, follow these steps: To install SANsurfer FC/CNA HBA CLI on Linux: From the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to your local machine following file: scli-x.xx.xx-xx.i386.rpm.gz Where x.xx.xx-xx specifies the current version of SANsurfer FC/CNA...
Page 33: Solaris Installation
9, or 10 operating system. To install SANsurfer FC/CNA HBA CLI on Solaris 8, 9, or 10: From the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to a temporary directory (for example, /tmp) on your machine the following file: scli-x.xx.xx-xx.sparc.Solaris.pkg...
Page 34 # pkgadd -d scli-x.xx.xx-xx.sparc.Solaris.pkg 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.xx Build xx Select package(s) you wish to process (or 'all' to process all packages).
Page 35: Solaris X86 9 And 10 Installation
To install SANsurfer FC/CNA HBA CLI on Solaris x86 9 or 10: From the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to a temporary directory (for example, /tmp) on your machine the following file: scli-x.xx.xx-xx.x86.Solaris.pkg...
Page 36: Macintosh Installation
Processing package instance <QLSclix> from </space/chuynh/scli/qlogic/Solaris/pkgs/x> SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (sparc) 1.xx.xx (Build xx Solaris 8-10) QLogic Corporation ## Executing checkinstall script. ## Processing package information. ## Processing system information. 3 package pathnames are already properly installed.
Page 37: Command Line Installation
Download the SCLI install package for Mac OS x (compressed tar file) to a local directory. Decompress the file by typing the following command: tar -zxvf <file>.tgz For example: qlogic:~ root#tar -zxvf scli-x.x.x-x.macos.pkg.tgz ./scli-x.x.x-x.pkg/ ./scli-x.x.x-x.pkg/Contents/ ./scli-x.x.x-x.pkg/Contents/Archive.bom ./scli-x.x.x-x.pkg/Contents/Archive.pax.gz This command extracts the compressed file to a directory named scli-x.x.x-x.pkg.
Page 38: Vmware Installation
Follow these steps to install SANsurfer FC/CNA HBA CLI on a system running VMware ESX 3.5. To install SANsurfer FC/CNA HBA CLI on VMware ESX 3.5: From either the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to your local machine the following file: scli-x.xx.xx-xx.i386.rpm.gz Where x.xx.xx stands for the current version of SANsurfer FC/CNA HBA...
Page 39: Uninstalling Sansurfer Fc/Cna Hba Cli
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”...
Page 40: Linux Uninstall
For example: The following package is currently installed: QLScli QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (sparc) 1.x.x Build xx Do you want to remove this package? Type y and then press ENTER. The program shows a script warning asking whether to continue the uninstall process.
Page 41: Solaris X86 8, 9, And 10 Uninstall
The program shows the package name and a script warning asking whether to continue the uninstall process. For example: The following package is currently installed: QLSclix QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (x86) 1.x.x Build xx Do you want to remove this package? Type y and then press ENTER.
Page 42: Macintosh Uninstall
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI SCLI property file removed. ## Updating system information. Removal of <QLSclix> 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.
Page 43: Getting Started
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).
Page 44 Double-click the SANsurfer FC/CNA HBA CLI (SCLI) icon. A terminal window opens. SCLI (interactive mode) scans the host for QLogic adapters and SAN storage. Run SCLI commands as required. When finished, return to the main menu, and type the indicated number to exit SANsurfer FC/CNA HBA CLI.
Page 45 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.
Page 46: Starting Non-Interactive Mode
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 <parameters> SANsurfer FC/CNA HBA CLI executes the command options, and then terminates. To list all of the available command line parameters and the SANsurfer FC/CNA HBA CLI version, type one of the following: scli -h scli -?
Page 47 2–Getting Started Starting Non-Interactive Mode Table 2-1. Non-interactive Mode Options (Continued) Interactive Menu (Red Interactive Interactive Hat/SUSE See User Guide Menu Menu Description Option Linux, Section (Windows) (Macintosh) Solaris SPARC) — Save/update “-b (Save or Update the Flash BIOS/FCode BIOS or FCode)” on page 4-7 Show adapter set- “-c (Show Parame-...
Page 48 2–Getting Started Starting Non-Interactive Mode Table 2-1. Non-interactive Mode Options (Continued) Interactive Menu (Red Interactive Interactive Hat/SUSE See User Guide Menu Menu Description Option Linux, Section (Windows) (Macintosh) Solaris SPARC) Show system infor- “-g (Display Sys- mation tem Information)” on page 4-18 Adapter statistics “-gs (Show HBA Statistics)”...
Page 49 2–Getting Started Starting Non-Interactive Mode Table 2-1. Non-interactive Mode Options (Continued) Interactive Menu (Red Interactive Interactive Hat/SUSE See User Guide Menu Menu Description Option Linux, Section (Windows) (Macintosh) Solaris SPARC) Configure adapter “-n (Set Selected settings HBA Parameter)” on page 4-35 Output to a file “-o (Output to a File)”...
Page 50 2–Getting Started Starting Non-Interactive Mode Table 2-1. Non-interactive Mode Options (Continued) Interactive Menu (Red Interactive Interactive Hat/SUSE See User Guide Menu Menu Description Option Linux, Section (Windows) (Macintosh) Solaris SPARC) Flash target beacon “-tb (Target Bea- con On/Off)” on page 4-46 Show host topology “-tp (Display Host Topology)”...
Page 51: Terminology
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: <current command use usage> Terminology Some of the terms used in this guide are similar and some have changed slightly as technology changes.
Page 52: Advanced Features
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.
Page 53 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...
Page 54 3–Interactive Commands Starting Interactive Mode To start the interactive mode, type one of the following: [ scli ] (on some Solaris installations) [ scli int] When you start SANsurfer FC/CNA HBA CLI in interactive mode, the Main Menu appears as follows: Main Menu 1: General Information 2: HBA Information...
Page 55 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).
Page 56: General Information Menu (Command Line Option -G)
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.
Page 57: Host Topology (Command Line Option -Tp | -Topology)
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.
Page 58: Display (Host Topology) (Command Line Option -Tp | -Topology)
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. If the interconnect element is a switch:...
Page 59 ================================= Type : HBA World Wide Node Name : 20-00-00-E0-8B-03-55-7C World Wide Port Name : 21-00-00-E0-8B-03-55-7C Vendor Id : QLogic Corporation HBA Model : 2200 HBA Serial Number : C28437 HBA Alias Port Alias Driver Version : SCSI Miniport 8.1.5.15 (W2K IP) Firmware Version : 2.02.03...
Page 60 3–Interactive Commands General Information Menu (Command Line Option -g) Host : BRAGI Number of Port 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...
Page 61 Attached Port ======================== Target/Initiator : ISL Node Name : 20-00-00-E0-8B-03-55-7C Port Name : 21-00-00-E0-8B-03-55-7C Vendor Id : QLogic Corporation HBA Model : 2200 HBA Serial Number : C28437 HBA Alias Port Alias Driver Version : SCSI Miniport 8.1.5.15 (W2K IP) Firmware Version : 2.02.03...
Page 62: Save As Txt File (Command Line Option -B)
3–Interactive Commands General Information Menu (Command Line Option -g) Beacon status : Off Port Type : Unknown Port State : LinkDown Hit <RETURN> 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.
Page 63: Generate Report (Per Adapter Port)
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...
Page 64 3–Interactive Commands General Information Menu (Command Line Option -g) Actual Connection Mode Actual Data Rate PortType (Topology) Target Count PCI Bus Number (Windows and Linux) PCI Device Number (Windows and Linux) Adapter Status (online, offline) Adapter VPD Header (Vital Product Data) Information (for QLA/QLE24xx and QLE81xx only) Adapter Instance Adapter Type...
Page 65 3–Interactive Commands General Information Menu (Command Line Option -g) Interrupt Delay Timer Execution Throttle Login Retry Count Port Down Retry Count Enable LIP Full Login Link Down Timeout (in seconds) Enable Target Reset LUNs Per Target Enable Receive Out Of Order Frame Driver Settings Information Header (Command Line Options -fg) Adapter Instance Adapter Part Number...
Page 66 Alternate 3 Boot Port Address An example follows: SANsurfer FC/CNA HBA CLI vx.x.x Build x Copyright (C) 2003-2009 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters Build Type: Release Build Date: 10/25/2009 5:18:58 PM ------------------------------------------------------------------------------ 3-14...
Page 67 HBA Model QLA2462 (SN FFC0551D59564): Port 1 WWPN 21-00-00-E0-8B-85-8C-7C (HBA instance 4) Loop down Port 2 WWPN 21-01-00-E0-8B-A5-8C-7C (HBA instance 5) Online ------------------------------------------------------------------------------ Total QLogic HBA(s) : 3 Time and date: Tue Nov 20 16:11:43 2009 ------------------------------------------------------------------------------ HBA General Information ------------------------------------------------------------------------------ ------------------------------------------------------------------------------ Host Name...
Page 68 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 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00 ------------------------------------------------------------------------------ Connection Options : 3 - Point-to-Point, Otherwise Loop...
Page 69 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 Target 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...
Page 70 3–Interactive Commands General Information Menu (Command Line Option -g) Product Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Revision : SG1D Size : 16.95 GB Type : SBC-2 Direct access block device (e.g., magnetic disk) WWULN : 20-00-00-20-37-11-FF-EF ------------------------------------------------------------ ------------------------------------------------------------------------------ Target Persistent Binding Information No target persistent binding configuration on HBA instance 1 (WWPN...
Page 71: Generate Report (All Adapters) (Command Line Option -Z)
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)...
Page 72: Hba General Information (Per Adapter Port)
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. In this example, the host includes three adapters with two ports each: HBA Information Menu HBA Model 2200: 1: Port 1: WWPN: 21-00-00-E0-8B-03-55-7C Online...
Page 73: Hba Information (Command Line Option -I)
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.0 (Operational)
Page 74: Hba Port Alias (Command Line Option -Pa)
3–Interactive Commands HBA Information Menu (Command Line Option -i) To create, modify, or delete an adapter alias: From the Main Menu, type the number for the HBA Information option, and then press ENTER. Type the number for the adapter you want to configure, and then press ENTER.
Page 75: Hba Vpd Information (Command Line Option -L And Reserved Word "Vpd")
3–Interactive Commands HBA Information Menu (Command Line Option -i) To create, modify, or delete an adapter port alias: From the Main Menu, type the number for the HBA Information option, and then press ENTER. Type the number for the HBA Port for which you want to change the Port Alias, and then press ENTER.
Page 76: Hba Information (All Hbas)
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...
Page 77: Hba Parameters (Per Adapter Port)
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) HBA Parameters (All HBAs)): HBA Model QLA2342:...
Page 78: Display Hba Parameters (Command Line Option -C#)
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...
Page 79: Adapter Parameters Settings (Nvram)
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.
Page 80: Connection Options
3–Interactive Commands HBA Parameters Menu Table 3-1. Adapter Parameters Settings (NVRAM) (Continued) Parameter Name Alias Value Description 0–255 ResetDelay 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.
Page 81 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...
Page 82 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.
Page 83 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.
Page 84: Restore Defaults
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.
Page 85: Hba Parameters (Per Fcoe Engine)
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...
Page 86 3–Interactive Commands HBA Parameters Menu FCoE Parameters Menu FCoE Engine (QLE8042) Port 0 Desc: QLE8042 Mercury CNA 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.
Page 87 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.
Page 88: Hba Parameters (All Hbas)
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).
Page 89: Target/Lun List (Per Adapter Port)
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Table 3-2. Target/LUN Information Variable Description IP address. <address> Adapter number (adapter instance number). <hba instance> Adapter world wide port name, format xx-xx-xx-xx-xx-xx-xx-xx <hba wwpn> or xxxxxxxx. Logical unit number (0–255). <lun id>...
Page 90: Per Target/Lun
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Vendor SEAGATE Product ID ST318453FC Product Rev 0006 Serial Number 3JA9TN7600007523T6P1 Node Name 20-00-00-11-C6-2D-5B-FA Portname 22-00-00-11-C6-2D-5B-FA Port ID 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.
Page 91 3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Desc: QLE2462 PCI Express to 4Gb FC Dual Channel 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...
Page 92 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...
Page 93: All Targets
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.
Page 94: Target/Lun List (All Adapters)
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Here is an example of the LUN information. Product Vendor : SEAGATE Product ID : ST318453FC Product Revision : 0006 Size : SBC-2 Direct Access block device (e.g. magnetic disk) WWULN : 20-00-00-11-C6-2D-5A-3F ------------------------------------------------------------------...
Page 95: Individual 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.
Page 96: All Target(S)
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.
Page 97: All Lun(S)
3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l) Here is an example of the All Targets option. Note: 0 to return to Main Menu Enter Selection: 3 ------------------------------------------------------------------ HBA Instance 5: QLA2300 Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 PortID 11-05-EF ------------------------------------------------------------------ Path...
Page 98 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 Size : 34.18 GB Type...
Page 99: Target Link Speed Or Iidma Settings Menu (Command Line Option -Q)
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.
Page 100: Configuring The Iidma Settings
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 id> Target world wide port name, format xx-xx-xx or <target portid> xxxxxx. Target World Wide Node Name, format <target wwnn>...
Page 101: Hba Port Instance
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. To exit iiDMA Settings without making any changes, select No. To use Advanced Configuration: Select the adapter. From the device list, select a device (disk) that is currently attached to this adapter.
Page 102: Hba Port
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.0 to 4Gb PC Dual Channel 1: Disk Vendor : SEAGATE Product ID : ST318453FC Product Rev : DF12 Serial Number : 3EV0NYSG000072496DYD...
Page 103: Advanced Configuration
3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Rev : SG1D Serial Number : LP60266900001919HQ1K Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8 Intelligent Interleave Factor: 4 Gbps Apply Changes to selected Target(s) Return to Previous Menu Note: 0 to return to Main Menu...
Page 104: Target Link Speed: All Hbas, Basic Configuration
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.
Page 105 3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q) Vendor : SEAGATE Product ID : ST318453FC Product Rev : 00006 Serial Number : 3JA9AYSG000072496FBJ Port Name : 22-00-00-0C-50-68-1E-9A Port ID : 11-0A-E2 Max Target Link Rate : 4 Gbps Disk 2 on QLA2462 (HBA Instance 1) Vendor : SEAGATE...
Page 106: Iidma Settings: Disk
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. iiDMA Settings: Disk 5: iiDMA Settings 1 - n: HBA Port n n: Disk n When you select a specific disk on the adapter port, the following options are available on the iiDMA Menu (Advanced): 1 Gps 2 Gps...
Page 107: Target Persistent Bindings (Per Adapter Port)
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.
Page 108 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 Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-04-CF-9C-24-CA Port ID : 02-00-E1...
Page 109: Target Persistent Binding: Unbind Targets (Command Line Option -P)
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...
Page 110: Selective Luns Menu (Command Line Option -M)
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. Selective LUNs (Per Adapter Port) 7: Selective LUNs 1: - m: HBA Port Instance...
Page 111: Manual Configure Luns
3–Interactive Commands Selective LUNs Menu (Command Line Option -m) Disk Vendor : SEAGATE Product ID : ST136403FC Port Name : 21-00-00-20-37-1A-6B-CF Port ID : 11-01-E4 Bind : Yes Target ID Disk Vendor : SEAGATE Product ID : ST118273 CLAR18 Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8...
Page 112: Boot Device Menu (Command Line Option -E)
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.
Page 113: Configure Boot Device(S)
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 ---------------------------- ------ 00-00-00-00-00-00-00-00 ---------------------------- ------ (Alternate 1) Boot Port Name ---------------------------- ------ 00-00-00-00-00-00-00-00...
Page 114: Boot Device(S) (All Hbas)
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.
Page 115: Driver Settings
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...
Page 116: Utilities Menu
The Utilities Menu provides options for saving and restoring Flash and adapter parameters. You can save adapter parameters in either a generic file or in a server manufacturer template such as QLogic, HP, IBM, EMC, and so on. Saving parameters in a template provides the advantage of tailored, default settings optimized for best results within the context.
Page 117 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.
Page 118: Save Hba Parameters (Per Adapter Port)
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.
Page 119: Template Supported Parameter Settings For Qla24Xx/Qle24Xx And
Settings that are effected by the template apply only to the ISP 2300/2310/2312 2Gb adapters and the ISP2422/2432 4Gb adapters. Table 3-5. Template Supported Parameter Settings for QLA24xx/QLE24xx and QLE256x Adapters (ISP2422) Setting QLogic Execution Throttle Descending Loop ID Search Maximum LUNs Per Target Port Down Retry Count Link Down Timeout Information not currently available.
Page 120: Template Supported Parameter Settings For Qla23Xx Adapters
3–Interactive Commands Utilities Menu Table 3-7. Template Supported Parameter Settings for QLA23xx Adapters (ISP2300/2310) Setting QLogic Execution Throttle Descending Loop ID Search Maximum LUNs Per Target Port Down Retry Count Link Down Timeout Table 3-8. Template Supported Parameter Settings for QLA23xx Adapters (ISP2312)
Page 121: Update Driver (Command Line Option -D)
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.
Page 122: Save Firmware Preload Table
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.
Page 123: Update Mpi Config Table
3–Interactive Commands Utilities Menu 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: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1 Enter a file name or Hit <RETURN>...
Page 124: Driver Rescan (Command Line Option -Rs)
3–Interactive Commands Utilities Menu Current Version: v1.0 Enter a file name or Hit <RETURN> 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...
Page 125 3–Interactive Commands Utilities Menu 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.
Page 126: Firmware Area Save (Command Line Option -U)
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 Firmware Area Save (Command Line Option -u) 10: Utilities...
Page 127: Beacon Menu
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).
Page 128: Beacon Selected Target(S)
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Disk Vendor : SEAGATE Product ID : ST118273 CLAR18 Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8 Beacon : No Beacon Selected Target(s) Return to Previous Menu 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.
Page 129: Diagnostics Loopback Test (Command Line Option -Kl)
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.
Page 130 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.
Page 131: Display Test Parameters (Loopback)
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.
Page 132: Reset Test Parameters (Loopback)
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) On Error : Ignore Test Continuous : OFF Loopback Type : External Loopback ------------------------------------------------------------------------------ Reset Test Parameters (Loopback) 12: Diagnostics n: Port Number 1: Loopback Test...
Page 133: Adapter Diagnostics Configuration Settings
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Table 3-10. Adapter Diagnostics Configuration Settings Alias Parameter Name <param Value <param value> Description <param name> alias> 00–FF See table note 1 DataPattern CRPAT Loopback test only CSPAT Loopback test only CJTPAT Loopback test only 8, 16, 32, 64, 128, 256,...
Page 134: Start Diagnostic Test (Loopback)
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...
Page 135: Diagnostics Read/Write Buffer Test
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) Finished 6376 iterations in 1 second(s)... Diagnostics Read/Write Buffer Test 12: Diagnostics n: Port Number 2: Read/Write Buffer Test When you select this option, SANsurfer FC/CNA HBA CLI shows the Read/Write Buffer Test Menu containing the following options: Display Test Parameters Reset Test Parameters...
Page 136: Start Diagnostic Test (Read/Write Buffer)
3–Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm) 1 = Loopback Test 2 = Read/Write Buffer Test The Read/Write Buffer Test Menu appears. Select one of the following options: Display Test Parameters. Type 1 to show the current parameter values.
Page 137: Diagnostics Transceiver Details: Dmi (Command Line Option -Dm)
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. If you proceed, the test runs as shown in the following example: -------------------------------------------------------------------------------- HBA Instance 8: QLE8142 Port 1 WWPN 21-00-00-C0-DD-0A-B1-FD PortID C5-02-0D...
Page 138: Transceiver Details: General
HBA Instance 0: QLE8142 Port 1 WWPN 21-00-00-C0-DD-12-0D-ED PortID C5-02-20 ------------------------------------------------------------------------------ ------------------------------------------------------------------------------ Media Information ------------------------------------------------------------------------------ Vendor: FINISAR CORP. Type: 10G Base-SR Part Number: FTLX8572D3BCL Speed: 10 GBytes/Sec Revision: A Serial Number: UDL0019 QLogic SFP Installed: Yes ------------------------------------------------------------------------------ Temperature Voltage Tx Bias Tx Power Rx Power (mA) (mW) (mW) --------------...
Page 139 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...
Page 140 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...
Page 141: Statistics Menu (Command Line Options -Gs And -Ls)
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...
Page 142: Hba Statistics: Monitoring (Command Line Option -Gs)
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).
Page 143: Adapter Port Statistics Options
3–Interactive Commands Statistics Menu (Command Line Options -gs and -ls) LogToFile (LF): null.csv To restore the adapter defaults, select Restore Default, and then press ENTER. The following message appears: Resetting to default settings..., done. 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.
Page 144 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.
Page 145: Show Hba Statistics
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: From the Main Menu, type the number for the Statistics option, and then press ENTER.
Page 146: Configuration
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...
Page 147 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.
Page 148: Show Link Status
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.
Page 149: Virtual Menu (Command Line Option -Vp)
Server 2003, and Solaris 11 provide a virtualization platform that can run guest operating systems in an x86 environment. Use the QLogic NPIV-capable Windows driver with QLogic’s SANsurfer FC/CNA HBA CLI to create, delete, and manage virtual ports. You can deploy and migrate virtual ports in conjunction with virtual machines (VMs) in your Solaris and Windows Virtual Server environment using Microsoft System Center Virtual Machine CLI 2007.
Page 150: Virtual Menu For Adapter Instance
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: <vport wwpn>...
Page 151: List Virtual Port(S)
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.
Page 152: Create Virtual Port(S)
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. When you select this option, the Create Virtual Port Menu for this adapter instance appears showing: HBA Instance n Adapter Model Port Number...
Page 153: Qos Menu (Command Line Option -Qos)
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 <xx>: EF The system returns the following: Virtual Port 21-EF-00-8B-14-5A-CF created successfully on HBA instance 4.
Page 154 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.
Page 155: Qos Priority Menu
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...
Page 156: Qos Bandwidth Menu
3–Interactive Commands QoS Menu (Command Line Option -qos) 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. Verify that the priority level is correct for the virtual port that you changed. (Optional) To prevent further changes to the virtual port, set the mode to Locked.
Page 157: Qos Bandwidth Speed Menu
3–Interactive Commands QoS Menu (Command Line Option -qos) Desc: QMH2562 PCI-E to 8Gb FC Dual Channel Mezz HBA 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.
Page 158 3–Interactive Commands QoS Menu (Command Line Option -qos) If the virtual port is already enabled and unlocked, proceed to Step Otherwise: 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.
Page 159: Qos Bandwidth Percentage Menu
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: From the QoS Bandwidth Percentage Menu, type the number corresponding to the virtual port that you want to change.
Page 160: Fcoe Menu (Command Line Option -Cna)
3–Interactive Commands FCoE Menu (Command Line Option -cna) Hit <RETURN> 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.
Page 161: Update Firmware
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.
Page 162: Logs Menu
3–Interactive Commands FCoE Menu (Command Line Option -cna) Number of Transmitted 802.3x Pause Control Packets: 0 Number of Transmitted Per-Priority Pause Packets: 0 Number of Transmitted Packets with Error: 0 Number of Received Packets < 64 bytes: 0 Number of Received Packets = 64 bytes: 0 Number of Received Packets <= 127 bytes: 0 Number of Received Packets <= 255 bytes: 0 Number of Received Packets <= 511 bytes: 0...
Page 163: Fcoe Utilities Menu For Qlx81Xx Adapters (Command Line Option -Cna)
When you select an online port, the following menu appears: FCoE Utilities Menu HBA Instance 0 (QLE8142 Port 1) : Online ENode MAC Addr: 00:C0:DD:12:0D:ED WWPN : 21-00-00-C0-DD-12-0D-ED Desc : QLE8142 QLogic PCI Express to 10 GbE Dual Channel CNA (FCoE) SN0054614-00 K 3-111...
Page 164: Information
------------------------------------------------------ Data Center Bridging Port 0 Configuration Parameters ------------------------------------------------------ Host Name : BP-WIN2008 HBA Instance HBA Model : QLE8142 HBA Description : QLE8142 QLogic PCI Express to 10 GbE Dual Channel CNA (FCoE) ---------------------------- DCBX 3-112 SN0054614-00 K...
Page 165: Dcbx And Ets Configuration Parameters
3–Interactive Commands FCoE Menu (Command Line Option -cna) ---------------------------- DCBX Enable : Enabled Willing : Enabled Port Pause Type : Per Priority Pause SAN Priority COS ---------------------------- ---------------------------- Priority Txt Mode : Bandwidth SAN Bandwidth Percent : 50 SAN Unused Bw To LAN : Enabled LAN Unused Bw To SAN : Disabled...
Page 166: Dce Statistics
3–Interactive Commands FCoE Menu (Command Line Option -cna) Table 3-13. DCBX and ETS Configuration Parameters (Continued) Parameter Description CoS provides eight levels to accommodate more than one traffic class of SAN Priority CoS SAN, LAN, and IPC, with one of the classes used for SAN traffic. This set- ting shows the persistent value for priority-encoded port packets: 0–7.
Page 167 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...
Page 168 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...
Page 169 3–Interactive Commands FCoE Menu (Command Line Option -cna) Receive CBFC Pause Frames 0: 0 Receive CBFC Pause Frames 1: 0 Receive CBFC Pause Frames 2: 0 Receive CBFC Pause Frames 3: 0 Receive CBFC Pause Frames 4: 0 Receive CBFC Pause Frames 5: 0 Receive CBFC Pause Frames 6: 0 Receive CBFC Pause Frames 7: 0 Receive FCoE Packets: 337914...
Page 170: Tlv
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.
Page 171 3–Interactive Commands FCoE Menu (Command Line Option -cna) Priority Group ID of Priority 7: 0 Priority Group ID of Priority 6: 0 Priority Group 0 Percentage: 50 Priority Group 1 Percentage: 50 Priority Group 2 Percentage: 0 Priority Group 3 Percentage: 0 Priority Group 4 Percentage: 0 Priority Group 5 Percentage: 0 Priority Group 6 Percentage: 0...
Page 172: Help Menu (Command Line Option -H)
3–Interactive Commands Help Menu (Command Line Option -h) PFC Enabled on Priority 0: No PFC Enabled on Priority 1: No PFC Enabled on Priority 2: No PFC Enabled on Priority 3: Yes PFC Enabled on Priority 4: No PFC Enabled on Priority 5: No PFC Enabled on Priority 6: No PFC Enabled on Priority 7: No Number of Traffic Classes Supported: 8...
Page 173: Contents
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.
Page 174 3–Interactive Commands Help Menu (Command Line Option -h) Notes 3-122 SN0054614-00 K...
Page 175: Non-Interactive Commands
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.
Page 176: Host Information (Command Line Option -G)
(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.
Page 177: Host Topology (Command Line Option -Tp)
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. The command format for Host Topology is: # scli -tp When you select this option, SANsurfer FC/CNA HBA CLI shows the information “Host Configuration (Command Line Option -z)”...
Page 178: Host Configuration
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...
Page 179: Options Shown By -Z
4–Non-Interactive Commands Command Summary Table 4-1. Options Shown by -z (Continued) Description See User Guide Section Show system information “-g (Display System Information)” on page 4-18 adapter “-i (Display HBA General Information Show information or VPD Information for One or All HBAs)”...
Page 180: A (View Or Toggle Beacon Status)
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.
Page 181: B (Save Or Update The Flash Bios Or Fcode)
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 (<hba instance>...
Page 182: C (Show Parameter Settings)
4–Non-Interactive Commands Command Summary To update one or all adapter’s Flash with new BIOS or FCode, type: # scli -b (all | <hba instance> | <hba wwpn>) [(<-rg> | all)] <BIOS/FCode File Name> 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...
Page 183 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 .dat file --detail = View detailed format --raw = View raw format param name = Parameter name...
Page 184: D (Update Device Driver)
4–Non-Interactive Commands Command Summary Table 4-3. DCE™ Statistics Parameters Parameter Parameter Parameter Description Name Alias Value AutoPoll Set to auto polling mode 1–256 Set to manual polling mode (iteration) SetRate 5–30 Set the polling interval rate (seconds) Details 0–2 Set the detailed display mode: 0 = Absolute 1 = Rate per second 2 = Baseline...
Page 185: E (Boot Device View | Select | Disable)
4–Non-Interactive Commands Command Summary # scli -dm (<hba instance> | <hba wwpn> | 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 (Boot Device View | Select | Disable) Use the -e command to: Show the current boot-device selection for all adapters.
Page 186 4–Non-Interactive Commands Command Summary <hba instance> <hba wwpn> <target wwnn> <target wwpn> <target id> <lun id> 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.
Page 187: Ei (List Sansurfer Fc/Cna Hba Cli Error Codes)
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.
Page 188: Fcoe (Display And Configure Fcoe Engine Parameters)
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: Create a text file (for example, setadapter0.txt) and enter the following command in the text file:...
Page 189: Fcoe Engine Parameters
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...
Page 190: Fg (Show Driver Settings)
4–Non-Interactive Commands Command Summary Network Interface Statistics Commands To show the FCoE network interface statistics, issue the following command: # scli -fcoe ( <hba instance> | <hba wwpn> ) --mon --nsl --portn FCoE Log Commands To show the FCoE available logs, issue the following commands: To list available log IDs: # scli -fcoe ( <hba instance>...
Page 191: Driver Settings Parameters
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 <param name>...
Page 192: G (Display System Information)
4–Non-Interactive Commands Command Summary (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. (Show HBA Statistics) To view the adapter statistics, type: # scli -gs <hba instance>...
Page 193: H (Help)
Build x Copyright 2003-2009 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters scli -l (<hba no> | <hba wwpn>) - shows LUN information for all HBAs. scli -l (<hba no> | <hba wwpn>) (<target wwpn>| <target portid>)
Page 194: I (Display Hba General Information Or Vpd Information For One Or 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. (100 characters, maximum) To set an alias for the selected adapter: # scli -ha (<hba instance>...
Page 195: Datapattern (Dp)
4–Non-Interactive Commands Command Summary # scli -kl (<hba instance> | <hba wwpn>) To do a loopback test with customized parameters, type: # scli -kl (<hba instance> | <hba wwpn>) [(<param name> | <param alias>) <param value>] 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...
Page 196: Data Pattern Values
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. The default pattern is random, for example: # scli -kl(<hba instance> | <hba wwpn>) DP Random To enter a customized value (in the range of 00–FF), type: # scli -kl (<hba instance>...
Page 197: Datasize (Ds)
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 <param value> DataSize <param value>...
Page 198: Onerror (Oe)
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 <param value>...
Page 199: Driver Versions Not Requiring A Loopback Connector
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).
Page 200 4–Non-Interactive Commands Command Summary # scli - <hba instance> 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...
Page 201: Kl (Run Hba Diagnostics Loopback Test)
4–Non-Interactive Commands Command Summary (<hba instance> | <hba wwpn>) [{(<param name> | <param alias>) <param value>}] (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 <param name>, <param alias>, and <param value>...
Page 202: Run A Read/Write Buffer Test
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)”...
Page 203 4–Non-Interactive Commands Command Summary To do a read/write buffer test using the current parameters, type: # scli -kr (<hba instance> | <hba wwpn>) To exclude a device or devices on the selected adapter port, type: # scli -kr (<hba instance>|<hba wwpn>) [(-EX | -EXCLUDE) <target wwpn>] [(<param name>...
Page 204: Run Adapter Diagnostics Read-Write Buffer Test
4–Non-Interactive Commands Command Summary Run Adapter Diagnostics Read-write Buffer Test The {(-ex | exclude) <target wwpn>} 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...
Page 205: Data Pattern (Dp) Test Patterns
4–Non-Interactive Commands Command Summary Compliant jitter tolerance pattern in a FC frame, as defined by the ASIC document listed above. Compliant supply noise test sequence in a valid FC frame, as defined by the ASIC document listed above. For read/write buffer test, the maximum size is 128; this is also the default. For an echo test, the maximum size is 2048;...
Page 206: L (Display Lun Info)
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 (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:...
Page 207: M (View, Enable, Or Disable Luns)
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...
Page 208 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...
Page 209: N (Set Selected Hba Parameter)
4–Non-Interactive Commands Command Summary NOTE: You can repeat the sequence <target wwnn> <target wwpn> <lun id> 1 to select multiple LUNs in the same command. To disable (deselect) a LUN on a specific target on a specific adapter, type: # scli -m (<hba instance> | <hba wwpn>) {<target wwnn> <target wwpn>...
Page 210 4–Non-Interactive Commands Command Summary param alias = Alias of the parameters param value = New value of the parameters The pairs <param name> <param value> and <param alias> <param value> can be repeated to set multiple parameters with a single command. Table 4-14 lists the adapter parameter names and aliases.
Page 211: O (Output To A File)
4–Non-Interactive Commands Command Summary 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) Data Rate (QLA23xx/QLA24xx/QLE23xx/QLE24xx and 8Gb adapters): 0 = 1 Gb 1 = 2Gbs 2 = Auto 3 = 4 Gbs 4 = 8 Gbs...
Page 212: P (Display Persistent Target Binding Info)
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.log Solaris: /var/adm/messages (Display Persistent Target Binding Info) With this command you can: Show binding information for one or on all adapters Bind a specific target to a selected adapter Bind all targets on a specific adapter or on all adapter...
Page 213 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 ----...
Page 214: Pa (Define Port Alias)
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 (<hba instance>...
Page 215: Pl (Show, Add, And Delete Persistent Names)
4–Non-Interactive Commands Command Summary (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. To display persistent device names for a specific LUN or all LUNs, type: # scli -pl <hba instance>|<hba wwpn>...
Page 216: Q (View Or Set Target Link Speed)
4–Non-Interactive Commands Command Summary (View or Set Target Link Speed) NOTE: The -q option is supported only on 4GB adapters. Type the following command to view the link speed of all targets attached to one adapter or all adapters: # scli -q (<hba instance> | <hba wwpn> | <all>) [-targets | -t ] Where: hba instance = Adapter number (use -g command to find) hba wwpn = World wide port name of the adapter...
Page 217: Qos (Qos Menu)
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 (<hba instance> | <hba wwpn> | <all>) <target wwpn> <speed> 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...
Page 218: R (Update Hba Parameters)
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...
Page 219: S (Silent Mode)
4–Non-Interactive Commands Command Summary (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.
Page 220: Tb (Target Beacon On/Off)
4–Non-Interactive Commands Command Summary To show the target information for a specific target on a specific adapter, type: -t (<hba instance> | <hba wwpn>) (<target wwpn> | <target port id>) iiDMA (intelligent interleaved direct memory access) settings include: —targets | –t applies to all targets. <speed>...
Page 221: Display Version)
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. Build Type: Release Build Date: xx/xx/xxxx xx:xx:xx AM (Virtual Port) To list all virtual ports on a physical adapter port, type: # scli -vp (<hba instance>...
Page 222: Output In Xml Format 1)
4–Non-Interactive Commands Command Summary # scli -vp (<hba instance> : <hba wwpn>) list <vport wwpn> To create a virtual port with an automatic WWPN, type: # scli -vp (<hba instance> : <hba wwpn>) create auto To create a virtual port with a specific WWPN, type: # scli -vp (<hba instance>...
Page 223: Z (Display All Hba Information For One Or All Hbas)
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.
Page 224 4–Non-Interactive Commands Command Summary Notes 4-50 SN0054614-00 K...
Page 225: Xml Format 1
“Error Message” on page A-2 Main Tag When SANsurfer FC/CNA HBA CLI is in XML mode, all outputs are within the main tag: <QLogic> </QLogic> Utility Header The following header information is shown after the main tag: <AppName> SANsurfer Command Line Utility </AppName>...
Page 226: Status Message
Status Message Before the closing main tag , SANsurfer FC/CNA HBA CLI shows </QLogic> returning status from the execution of the command line parameters and the error messages. A return value of 0 indicates success; a return value of 1 indicates...
Page 227: Display System Information (Command Line Option -G)
(command line option -i). Display System Information (Command Line Option -g) The XML format 1 for system information output is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion> <Host> <Name> Host Name </Name>...
Page 228: Display Adapter Settings (Command Line Option -C)
A–XML Format 1 XML Format 1 Tags for Each Option <OSVersion> OS Version (and patches) </OSVersion> <HBA Port="value" WWNN="value" WWPN="value" /> <NumOfHBA> Number of QLogic FC HBA(s) </NumOfHBA> </Host> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> The parameter <HBA…/> repeats for each adapter in the system.
Page 229: Display Hba Information (Command Line Option -I)
(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: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion> <HBA> <GeneralInfo Port="value"...
Page 230 TargetCount="value" PCIBus="value" PCIDevice="value" ActualConnectionMode="value" ActualDataRate="value" PortType="value" Status="value" </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Here is the VPD information: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build n.nn</AppVersion> <HBA> <HBA Port="value" WWNN="value" WWPN="value" /> <VPD> <VPDProductIdentifier="value" VPD-RTAG=""...
Page 231: Display Device List (Command Line Option -T)
A–XML Format 1 XML Format 1 Tags for Each Option </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Display Device List (Command Line Option -t) The XML Format 1 for adapter device information is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic>...
Page 232: Target Persistent Binding (Command Line Option -P)
</HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> The <LUN … /> sequence is repeated for each LUN attached to the target. The LUN list is listed under the target, not the adapter. The <Target>...</Target> sequence is repeated for each LUN attached to the target.
Page 233: Boot Device (Command Line Option -E)
<EnabledLUN ID="value" LUNWWNN="value" LUNWWPN="value"/> </Target> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> The <HBA> … </HBA> sequence repeats for each adapter. The <Target> … </Target> sequence repeats for each Target. The <EnabledLUN… /> sequence repeats for each enabled LUN under the target.
Page 234: View Driver Settings (Command Line Option -Fg)
DisparityError="value" FrameLengthError="value" Result="value"/> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Diagnostics Results—Read/Write Buffer Test (Command Line Option -kr) The XML Format 1 for the read/write buffer test results is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName>...
Page 235 /DriverSettings> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> 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,...
Page 236 <Name> Host Name </Name> <OSType> OS Type </OSType> <OSVersion> OS Version (and patches where applicable) </OSVersion> <HBA Port="value" WWNN="value" WWPN="value" /> <NumOfHBA> Number of QLogic Fibre Channel HBA(s) detected </NumOfHBA> </Host> <HBA> <HBA PortNumber="value" WWNN="value" WWPN="value" /> <GeneralInfo Port ="value"...
Page 237 Revision= "value" Size= "value" Type="value" /> <EnabledLUN ID="value" LUNWWNN="value"LUNWWPN="value" /> </Target> <TargetBinding TargetWWNN="value" TargetWWPN="value" TargetPortID="value" TargetID="value" /> <BootDevice TargetWWNN="value" TargetWWPN="value" LUNID="value" /> <DriverSettings> <Info PersistentPlusNew="value" PersistentOnly="value" BindbyWWPN="value" BindbyPortID="value" /> </DriverSettings> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> SN0054614-00 K A-13...
Page 238: Link Statistics (Command Line Option -Ls)
The <BootDevice…/> parameter is repeated for each boot device selection entry. Link Statistics (Command Line Option -ls The XML Format 1 for the link statistics option is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion> <HBA> <HBA Port="value" WWPN="value" WWNN="value" /> <LinkStatus PortName="value"...
Page 239: Hba Alias (Command Line Option -Ha)
IOCount="value" IOPS="value" BPS="value" TimeStamp="value" /> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> HBA Alias (Command Line Option -ha) The XML Format 1 for the adapter alias option is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion>...
Page 240: Hba Transceiver Details (Command Line Option -Dm)
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: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion> <HBA> <HBA Port="value" WWNN="value" WWPN="value" /> <MediaInformation>...
Page 241 <HighWarning>"value"</HighWarning> <LowWarning>"value"</LowWarning> <LowAlarm>"value"</LowAlarm> </RxPower> </Diagnostics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> The XML Format 1 for adapter transceiver details (detailed information) is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion> <HBA> <HBA Port="value" WWNN="value" WWPN="value" />...
Page 242 A–XML Format 1 XML Format 1 Tags for Each Option <Length-50um> "value" </Length-50um> <Length-62.5um> "value" </Length-62.5um> <Length-Copper> "value" </Length-Copper> <VendorName>"value"</VendorName> <VendorOUI> "value" </VendorOUI> <VendorPN>"value" </VendorPN> <VendorRev>"value" </VendorRev> <WaveLength>"value" </WaveLength> <CC_BASE> "value" </CC_BASE> <Options> <SignalLossAsDefinedInSFPMSA> "value" </SignalLossAsDefinedInSFPMSA> <SignalLossInvertedFromSFPMSA>"value" </SignalLossInvertedFromSFPMSA> <TX_Fault_SignalImplemented> "value" </TX_Fault_SignalImplemented>...
Page 243 A–XML Format 1 XML Format 1 Tags for Each Option <TempHighWarning>"value"</TempHighWarning> <TempLowWarning>"value" </TempLowWarning> <VoltageHighAlarm>"value"</VoltageHighAlarm> <VoltageLowAlarm>"value"</VoltageLowAlarm> <VoltageHighWarning>"value"</VoltageHighWarning> <VoltageLowWarning>"value" </VoltageLowWarning> <BiasHighAlarm>"value"</BiasHighAlarm> <BiasLowAlarm>"value" </BiasLowAlarm> <BiasHighWarning>"value" </BiasHighWarning> <BiasLowWarning>"value" </BiasLowWarning> <TXPowerHighAlarm>"value" </TXPowerHighAlarm> <TXPowerLowAlarm>"value" </TXPowerLowAlarm> <TXPowerHighWarning>"value"</TXPowerHighWarning> <TXPowerLowWarning>"value"</TXPowerLowWarning> <RXPowerHighAlarm>"value" </RXPowerHighAlarm> <RXPowerLowAlarm>"value" </RXPowerLowAlarm> <RXPowerHighWarning>"value"</RXPowerHighWarning> <RXPowerLowWarning>"value"</RXPowerLowWarning> <Rx_PWR-4>"value"</Rx_PWR-4> <Rx_PWR-3>"value"</Rx_PWR-3> <Rx_PWR-2>"value"</Rx_PWR-2> <Rx_PWR-1>"value"</Rx_PWR-1>...
Page 244: Host Topology (Command Line Option -Tp)
<RXPowerLowWarning> "value" </RXPowerLowWarning> <VendorSpecific> "value" </VendorSpecific> </Address_A2> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Host Topology (Command Line Option -tp) The XML Format 1 for an adapter type interconnect element is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName>...
Page 245 Host="value" TotalNumberOfDevices="value" NumberofPort="value" BeaconStatus="value" PortType="value" PortState="value"/> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> The XML Format 1 for a switch type interconnect element is as follows: <InterConnectElement Type="Switch"> <Switch WWPN="value" DomainID="value" ManagementID="value" IPAddress="value" Model="value" SymbolicName="value" SerialNumber="value" MACAddress="value" FirmwareVersion="value" PortCount="value" BeaconStatus="value"/>...
Page 246: Display Fcoe Information
<AttachedPort Type="Target"> <Target NodeName="value" PortName="value" VendorId="value" ProductId="value" ProductRevision="value" ProductSerialNumber="value"/> </AttachedPort> </PhysicalPort> </PhysicalPortInformation> </InterConnectElement> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Display FCoE Information The XML Format 1 for FCoE information output is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> A-22 SN0054614-00 K...
Page 247: Display Fcoe Parameters
A–XML Format 1 XML Format 1 Tags for Each Option <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <HBA> <Menlo> <GeneralInfo HostName="TARGET3" Model="QLE8000" Description="QLE8042 Mercury CNA" FirmwareVersion="1.1.0 (Operational)" /> </Menlo> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Display FCoE Parameters The XML Format 1 for FCoE parameter output is as follows: <?xml version="1.0"...
Page 248 A–XML Format 1 XML Format 1 Tags for Each Option <HBA> <HBA Port="3" WWNN="20-00-00-E0-8B-80-5F-0F" WWPN="21-00-00-E0-8B-80-5F-0F" /> <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <HBA> <FCoELogs> <LogID ID="8" LogName="Link Events"/> <Entry No="0" Info="000:00:02:03:120 Host fibre channel port 0, physical link up"/>...
Page 249: Display Fcoe Dcbx
Info="No Data"/> <Entry No="19" Info="No Data"/> </FCoELogs> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> </HBA> </QLogic> Display FCoE DCBX The XML Format 1 for FCoE DCBX output is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion>...
Page 250: Display Fcoe Network Interface Statistics
<Entry No="19" Info="No Data"/> </FCoELogs> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> </HBA> </QLogic> Display FCoE Network Interface Statistics The XML Format 1 for FCoE network interface statistics output is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName>...
Page 251 A–XML Format 1 XML Format 1 Tags for Each Option </NumberofTransmittedPacketsEqual64bytes> <NumberofTransmittedPacketsLessThanOrEqual127bytes> </NumberofTransmittedPacketsLessThanOrEqual127bytes> <NumberofTransmittedPacketsLessThanOrEqual256bytes> </NumberofTransmittedPacketsLessThanOrEqual256bytes> <NumberofTransmittedPacketsLessThanOrEqual512bytes> </NumberofTransmittedPacketsLessThanOrEqual512bytes> <NumberofTransmittedPacketsLessThanOrEqual1024bytes> </NumberofTransmittedPacketsLessThanOrEqual1024bytes> <NumberofTransmittedPacketsLessThanOrEqual1518bytes> </NumberofTransmittedPacketsLessThanOrEqual1518bytes> <NumberofTransmittedPacketsLessThanOrEqual2047bytes> </NumberofTransmittedPacketsLessThanOrEqual2047bytes> <NumberofTransmittedPacketsLessThanOrEqual4095bytes> </NumberofTransmittedPacketsLessThanOrEqual4095bytes> <NumberofTransmittedPacketsLessThanOrEqual8191bytes> </NumberofTransmittedPacketsLessThanOrEqual8191bytes> <NumberofTransmittedPacketsLessThanOrEqual9215bytes> </NumberofTransmittedPacketsLessThanOrEqual9215bytes> <NumberofTransmittedPacketsLessThanOrEqual9216bytes> </NumberofTransmittedPacketsLessThanOrEqual9216bytes> <TotalNumberofTransmittedPackets_IncludingThoseWithError> </TotalNumberofTransmittedPackets_IncludingThoseWithError> <NumberofTransmittedBytesforGoodPackets> </NumberofTransmittedBytesforGoodPackets> SN0054614-00 K A-27...
Page 252 A–XML Format 1 XML Format 1 Tags for Each Option <NumberofTransmittedGoodPackets> </NumberofTransmittedGoodPackets> <NumberofTransmittedUnicastPackets> </NumberofTransmittedUnicastPackets> <NumberofTransmittedMulticastPackets> </NumberofTransmittedMulticastPackets> <NumberofTransmittedBroadcastPackets> </NumberofTransmittedBroadcastPackets> <NumberofTransmittedPacketswithVLANtag> </NumberofTransmittedPacketswithVLANtag> <NumberofTransmitted_802_3x_PauseControlPackets> </NumberofTransmitted_802_3x_PauseControlPackets> <NumberofTransmittedPer-PriorityPausePackets> </NumberofTransmittedPer-PriorityPausePackets> <NumberofTransmittedPacketswithError> </NumberofTransmittedPacketswithError> <NumberofReceivedPacketsLessThan64bytes> </NumberofReceivedPacketsLessThan64bytes> <NumberofReceivedPacketsEqual64bytes> </NumberofReceivedPacketsEqual64bytes> <NumberofReceivedPacketsLessThanOrEqual127bytes> </NumberofReceivedPacketsLessThanOrEqual127bytes> <NumberofReceivedPacketsLessThanOrEqual255bytes> </NumberofReceivedPacketsLessThanOrEqual255bytes> A-28 SN0054614-00 K...
Page 253 A–XML Format 1 XML Format 1 Tags for Each Option <NumberofReceivedPacketsLessThanOrEqual511bytes> </NumberofReceivedPacketsLessThanOrEqual511bytes> <NumberofReceivedPacketsLessThanOrEqual1023bytes> </NumberofReceivedPacketsLessThanOrEqual1023bytes> <NumberofReceivedPacketsLessThanOrEqual1518bytes> </NumberofReceivedPacketsLessThanOrEqual1518bytes> <NumberofReceivedPacketsLessThanOrEqual2047bytes> </NumberofReceivedPacketsLessThanOrEqual2047bytes> <NumberofReceivedPacketsLessThanOrEqual4095bytes> </NumberofReceivedPacketsLessThanOrEqual4095bytes> <NumberofReceivedPacketsLessThanOrEqual8191bytes> </NumberofReceivedPacketsLessThanOrEqual8191bytes> <NumberofReceivedPacketsLessThanOrEqual9215bytes> </NumberofReceivedPacketsLessThanOrEqual9215bytes> <NumberofReceivedPacketsLessThanOrEqual9216bytes> </NumberofReceivedPacketsLessThanOrEqual9216bytes> <TotalNumberofReceivedPackets_IncludingThoseWithError> </TotalNumberofReceivedPackets_IncludingThoseWithError> <NumberofReceivedBytesforGoodPackets> </NumberofReceivedBytesforGoodPackets> <NumberofReceivedGoodPackets> </NumberofReceivedGoodPackets> <NumberofReceivedUnicastPackets> </NumberofReceivedUnicastPackets> <NumberofReceivedMulticastPackets> SN0054614-00 K A-29...
Page 254 A–XML Format 1 XML Format 1 Tags for Each Option </NumberofReceivedMulticastPackets> <NumberofReceivedBroadcastPackets> </NumberofReceivedBroadcastPackets> <NumberofReceivedPacketsWithVLANtag> </NumberofReceivedPacketsWithVLANtag> <NumberofReceivedOversizedPacketsWithGoodCRC> </NumberofReceivedOversizedPacketsWithGoodCRC> <NumberofReceivedOversizedPackets> </NumberofReceivedOversizedPackets> <NumberofReceivedPacketsDiscardedbytheMAC> </NumberofReceivedPacketsDiscardedbytheMAC> <NumberofReceivedUndersizedPacketsWithGoodCRC> </NumberofReceivedUndersizedPacketsWithGoodCRC> <NumberofReceivedUndersizedPacketsWithBadCRC> </NumberofReceivedUndersizedPacketsWithBadCRC> <NumberofReceivedPacketsWithCRCError> </NumberofReceivedPacketsWithCRCError> <NumberofReceivedPacketsWithLengthError> </NumberofReceivedPacketsWithLengthError> <NumberofReceivedOversizedPacketsWithBadCRC> </NumberofReceivedOversizedPacketsWithBadCRC> <NumberofReceived_802_3x_PauseControlPackets> </NumberofReceived_802_3x_PauseControlPackets> <NumberofReceivedPer-PriorityPausePackets> A-30 SN0054614-00 K...
Page 255 A–XML Format 1 XML Format 1 Tags for Each Option </NumberofReceivedPer-PriorityPausePackets> </NSLPortStatistics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> SN0054614-00 K A-31...
Page 256 A–XML Format 1 XML Format 1 Tags for Each Option Notes A-32 SN0054614-00 K...
Page 257: B Xml Format
“Utility Header” on page B-2 “Status Message” on page B-2 “Reboot Message” on page B-2 “Error Message” on page B-2 Main Tag When SANsurfer FC/CNA HBA CLI is in XML2 mode, all outputs are between the main tags: <QLogic> </QLogic> SN0054614-00 K...
Page 258 Status Message Before the closing main tag , SANsurfer FC/CNA HBA CLI shows any </QLogic> returning status from the execution of the command line parameters and the error messages. When the execution of the command line parameters is successful, the following status is shown: <Status>...
Page 259: Display System Information (Command Line Option -G)
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)”...
Page 260: Display System Information (Command Line Option -G
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: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLISANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.n.nn Build nn</AppVersion <AppXmlVersion>n.nn</AppXmlVersion> <Host>...
Page 261 LUNsPerTarget="value" /> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <HBA> …</HBA> sequence repeats for each adapter Each parameter is listed on a separate line for clarity; however, multiple parameters can be on the same line. For multiple adapters, repeat the preceding sequence with the ID number of the next adapter.
Page 262 PCIDevice="value" ActualConnectionMode="value" ActualDataRate="value" TargetCount="value" PortType="value" Status="value" </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The XML Format 2 for 4G adapters is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.n.n Build n</AppVersion> <AppXmlVersion>2.0</AppXmlVersion> <HBA> <GeneralInfo Instance="value" HBAModel="value"...
Page 263 B–XML Format 2 XML Format 2 Tags for Each Option PortType="value" Status="value" </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Here is the VPD information: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn Build n.nn</AppVersion> <HBA> <HBAInstance="value" HBAModel="value"HBAPort="value" WWNN="value" WWPN="value" />...
Page 264 Type= "value" DeviceStatus= "value" /> </Target> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <Target>…</Target> sequence repeats for each target. The <HBA>…</HBA> sequence repeats for each adapter. Display LUN List (Command Line Option -l) The command format is: scli -l <hba instance> | <hba wwpn> -x2 The XML Format 2 for the adapter LUN list information is as follows: <?xml version="value"...
Page 265: Target Persistent Binding
XML Format 2 Tags for Each Option </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <Target> sequence repeats for each LUN attached to the target. The LUN list is listed under the target, not under the adapter. Target Persistent Binding...
Page 266: Boot Device (Command Line Option -E
<WWPN> Target WWPN </WWPN> <EnabledLUN ID="value" LUNWWNN="value" LUNWWPN="value"/> </Target> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <Target> … </Target> sequence repeats for each enabled LUN on the target. Boot Device (Command Line Option -e) The command format for all adapters is:...
Page 267: Diagnostics Results-Loopback Test (Command Line Option -Kl
XML Format 2 Tags for Each Option </HBA> <Status> n </Status> <?ErrorMsg> "message" </ErrorMsg?> <Reboot> n /Reboot> </QLogic> The <HBA> …</HBA> sequence repeats for each adapter. NOTE: If EnableSelectableBoot is set to 1 in the BootParam EnableSelectable Boot tag, it does not appear in the BootDevice TargetWWPN tag: <BootParam EnableSelectableBoot="1"...
Page 268: Diagnostics Results-Read/Write Buffer Test (Command Line Option -Kr
B–XML Format 2 XML Format 2 Tags for Each Option <Status> n </Status> <Reboot> n /Reboot> </QLogic> Diagnostics Results—Read/Write Buffer Test (Command Line Option -kr) The command format is: scli -kr (<hba instance> | <hba wwpn>) [(-EX | -EXCLUDE) <target wwpn>] (<param name> | <param alias>) <param value>...
Page 269: Display All Information For One Or All Adapters
</HBA> <Status> n </Status> <?ErrorMsg> "message" </ErrorMsg?> <Reboot> n /Reboot> </QLogic> Display All Information for One or All Adapters (Command Line Option -z) The XML Format 2 for all adapter information is more complicated than its non-XML counterpart because the tags cannot be repeated. In non-XML mode,...
Page 270 4-11 The command format is: scli -z (<hba instance> | <hba wwpn> | all) -x2 The XML Format 2 for all adapter information is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.n.nn Build nn</AppVersion <AppXmlVersion>n.nn</AppXmlVersion> <Host>...
Page 271 B–XML Format 2 XML Format 2 Tags for Each Option PortType="value" Status="value" /> <Param ConnectionOption="value" <VPD> <VPD ProductIdentifier=""/> </VPD> <Param ConnectionOption="value" DataRate="value" 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" /> <Target> <WWNN>...
Page 272: Link Statistics (Command Line Option -Ls
BindbyWWPN="value" BindbyPortID="value" /> </DriverSettings> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> NOTE: The <HBA>…</HBA> sequence repeats for each adapter. The <DriverSettings…/> sequence repeats for each adapter. The <VPD Product Identifier…/> sequence repeats for each adapter. The <Target>…</Target> sequence repeats for each target.
Page 273: Hba Statistics (Command Line Option -Gs
SignalLoss="value" InvalidCRC="value" TimeStamp="value"/> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <HBA>…</HBA> sequence repeats for each adapter. The <LinkStatus…/> parameter repeats for each link. HBA Statistics (Command Line Option -gs) The command format is: scli -gs (<hba instance> | <hba wwpn>) [(<param name> | <param alias>) <param value>] -x2...
Page 274: Hba Alias (Command Line Option -Ha
The command format is: scli -ha (<hba instance> | <hba wwpn>) view | ? -x2 The XML Format 2 for the adapter alias option is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.n.nn Build nn</AppVersion <AppXmlVersion>n.nn</AppXmlVersion> <HBA>...
Page 275 B–XML Format 2 XML Format 2 Tags for Each Option The XML Format 2 for adapter transceiver details (detailed information) is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>v1.7.0 Build 15</AppVersion> <AppXmlVersion>2.0</AppXmlVersion> <HBA> <HBA Instance="value" HBAModel="value" HBAPort="value"...
Page 276: Hba Transceiver Details (Command Line Option -Dm
</RxPower> </Diagnostics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> HBA Transceiver Details (Command Line Option -dm) The XML Format 2 for adapter transceiver details (general information) is as follows: # scli -dm (<hba instance> | <hba wwpn> | <all>) (general |...
Page 277 B–XML Format 2 XML Format 2 Tags for Each Option <Diagnostics> <Temperature> <MeasuredTemperature>(C)</MeasuredTemperature> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning>"value"</LowWarning> <LowAlarm>"value"</LowAlarm> </Temperature> <Voltage> <MeasuredVoltage>(V)</MeasuredVoltage> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning>"value"</LowWarning> <LowAlarm>"value"</LowAlarm> </Voltage> <TxBias> <MeasuredTxBiasUnit>(mA)</MeasuredTxBiasUnit> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning>"value"</LowWarning> <LowAlarm>"value"</LowAlarm> </TxBias> <TxPower> <MeasuredTxPowerUnit>(mW)</MeasuredTxPowerUnit> <Value>"value"</Value>...
Page 278 # scli -dm (<hba instance> | <hba wwpn> | all) (details | det) -x2 The XML Format 2 for adapter transceiver details (detailed information) is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.n.nn Build nn</AppVersion <AppXmlVersion>n.nn</AppXmlVersion> <HBA>...
Page 279 B–XML Format 2 XML Format 2 Tags for Each Option <TX_DisableImplementedAndDisablesSerialOP> "value"</TX_DisableImplementedAndDisablesSerialOP> <RATE_SelectImplemented> "value" </RATE_SelectImplemented> </Options> <BR-Max> "value" </BR-Max> <BR-Min> "value" </BR-Min> <VendorSN>"value" </VendorSN> <DateCode>"value" </DateCode> <DiagMonitoringType> <AddressChangeRequired> "value" </AddressChangeRequired> <PowerMeasurement> "value" </PowerMeasurement> <ExternallyCalibrated> "value" </ExternallyCalibrated> <InternallyCalibrated> "value" </InternallyCalibrated> <DigitalDiagMonitoring> "value" </DigitalDiagMonitoring> <LegacyDiagnostic>...
Page 280 B–XML Format 2 XML Format 2 Tags for Each Option <RXPowerLowWarning>"value"</RXPowerLowWarning> <Rx_PWR-4>"value"</Rx_PWR-4> <Rx_PWR-3>"value"</Rx_PWR-3> <Rx_PWR-2>"value"</Rx_PWR-2> <Rx_PWR-1>"value"</Rx_PWR-1> <Rx_PWR-0>"value"</Rx_PWR-0> <Tx_I_Slope>"value"</Tx_I_Slope> <Tx_I_Offset>"value"</Tx_I_Offset> <Tx_PWR_Slope>"value"</Tx_PWR_Slope> <Tx_PWR_Offset>"value"</Tx_PWR_Offset> <T_Slope>"value"</T_Slope> <T_Offset>"value"</T_Offset> <V_Slope>"value"</V_Slope> <V_Offset>"value"</V_Offset> <Checksum> "value" </Checksum> <Temperature_MSB> "value" </Temperature_MSB> <Temperature_LSB> "value" </Temperature_LSB> <Vcc_MSB> "value"</Vcc_MSB> <Vcc_LSB> "value"</Vcc_LSB> <TX_Bias_MSB> "value" </TX_Bias_MSB> <TX_Bias_LSB>...
Page 281: Host Topology (Command Line Option -Tp
<VendorSpecific> "value" </VendorSpecific> </Address_A2> </HBA> <Status> n </Status> <?ErrorMsg> "message" </ErrorMsg?> <Reboot> n /Reboot> </QLogic> Host Topology (Command Line Option -tp) The command format is: scli -tp -x2 The XML Format 2 for an adapter type interconnect element is as follows (this example shows a switch): <?xml version="value"...
Page 282 </AttachPort> </PhysicalPort> </PhysicalPortInformation> </InterconnectElements> <InterconnectElementType="HBA"> <HBA WWNN="value" 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"/> </InterconnectElement> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <InterconnectElement>…</InterconnectElement> sequence repeats for each interconnect element. B-26 SN0054614-00 K...
Page 283: Display Fcoe Information
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: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <HBA> <Menlo> <GeneralInfo HostName="TARGET3" Model="QLE8000" Description="QLE8042 Mercury CNA"...
Page 284 B–XML Format 2 XML Format 2 Tags for Each Option <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <HBA> <HBA Instance="3" HBAModel="QLE8402" HBAPort="1" WWNN="20-00-00-E0-8B-80-5F-0F" WWPN="21-00-00-E0-8B-80-5F-0F" /> <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <HBA> <FCoELogs> <LogID ID="8"...
Page 285: Display Fcoe Dcbx
Info="No Data"/> <Entry No="19" Info="No Data"/> </FCoELogs> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> </HBA> </QLogic> Display FCoE DCBX The XML Format 2 for FCoE DCBX output is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion>...
Page 286: Display Fcoe Network Interface Statistics
<Entry No="19" Info="No Data"/> </FCoELogs> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> </HBA> </QLogic> Display FCoE Network Interface Statistics The XML Format 2 for FCoE network interface statistics output is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName>...
Page 287 B–XML Format 2 XML Format 2 Tags for Each Option </NumberofTransmittedPacketsLessThan64bytes> <NumberofTransmittedPacketsEqual64bytes> </NumberofTransmittedPacketsEqual64bytes> <NumberofTransmittedPacketsLessThanOrEqual127bytes> </NumberofTransmittedPacketsLessThanOrEqual127bytes> <NumberofTransmittedPacketsLessThanOrEqual256bytes> </NumberofTransmittedPacketsLessThanOrEqual256bytes> <NumberofTransmittedPacketsLessThanOrEqual512bytes> </NumberofTransmittedPacketsLessThanOrEqual512bytes> <NumberofTransmittedPacketsLessThanOrEqual1024bytes> </NumberofTransmittedPacketsLessThanOrEqual1024bytes> <NumberofTransmittedPacketsLessThanOrEqual1518bytes> </NumberofTransmittedPacketsLessThanOrEqual1518bytes> <NumberofTransmittedPacketsLessThanOrEqual2047bytes> </NumberofTransmittedPacketsLessThanOrEqual2047bytes> <NumberofTransmittedPacketsLessThanOrEqual4095bytes> </NumberofTransmittedPacketsLessThanOrEqual4095bytes> <NumberofTransmittedPacketsLessThanOrEqual8191bytes> </NumberofTransmittedPacketsLessThanOrEqual8191bytes> <NumberofTransmittedPacketsLessThanOrEqual9215bytes> </NumberofTransmittedPacketsLessThanOrEqual9215bytes> <NumberofTransmittedPacketsLessThanOrEqual9216bytes> </NumberofTransmittedPacketsLessThanOrEqual9216bytes> <TotalNumberofTransmittedPackets_IncludingThoseWithError> </TotalNumberofTransmittedPackets_IncludingThoseWithError> SN0054614-00 K B-31...
Page 288 B–XML Format 2 XML Format 2 Tags for Each Option <NumberofTransmittedBytesforGoodPackets> </NumberofTransmittedBytesforGoodPackets> <NumberofTransmittedGoodPackets> </NumberofTransmittedGoodPackets> <NumberofTransmittedUnicastPackets> </NumberofTransmittedUnicastPackets> <NumberofTransmittedMulticastPackets> </NumberofTransmittedMulticastPackets> <NumberofTransmittedBroadcastPackets> </NumberofTransmittedBroadcastPackets> <NumberofTransmittedPacketswithVLANtag> </NumberofTransmittedPacketswithVLANtag> <NumberofTransmitted_802_3x_PauseControlPackets> </NumberofTransmitted_802_3x_PauseControlPackets> <NumberofTransmittedPer-PriorityPausePackets> </NumberofTransmittedPer-PriorityPausePackets> <NumberofTransmittedPacketswithError> </NumberofTransmittedPacketswithError> <NumberofReceivedPacketsLessThan64bytes> </NumberofReceivedPacketsLessThan64bytes> <NumberofReceivedPacketsEqual64bytes> </NumberofReceivedPacketsEqual64bytes> <NumberofReceivedPacketsLessThanOrEqual127bytes> </NumberofReceivedPacketsLessThanOrEqual127bytes> B-32 SN0054614-00 K...
Page 289 B–XML Format 2 XML Format 2 Tags for Each Option <NumberofReceivedPacketsLessThanOrEqual255bytes> </NumberofReceivedPacketsLessThanOrEqual255bytes> <NumberofReceivedPacketsLessThanOrEqual511bytes> </NumberofReceivedPacketsLessThanOrEqual511bytes> <NumberofReceivedPacketsLessThanOrEqual1023bytes> </NumberofReceivedPacketsLessThanOrEqual1023bytes> <NumberofReceivedPacketsLessThanOrEqual1518bytes> </NumberofReceivedPacketsLessThanOrEqual1518bytes> <NumberofReceivedPacketsLessThanOrEqual2047bytes> </NumberofReceivedPacketsLessThanOrEqual2047bytes> <NumberofReceivedPacketsLessThanOrEqual4095bytes> </NumberofReceivedPacketsLessThanOrEqual4095bytes> <NumberofReceivedPacketsLessThanOrEqual8191bytes> </NumberofReceivedPacketsLessThanOrEqual8191bytes> <NumberofReceivedPacketsLessThanOrEqual9215bytes> </NumberofReceivedPacketsLessThanOrEqual9215bytes> <NumberofReceivedPacketsLessThanOrEqual9216bytes> </NumberofReceivedPacketsLessThanOrEqual9216bytes> <TotalNumberofReceivedPackets_IncludingThoseWithError> </TotalNumberofReceivedPackets_IncludingThoseWithError> <NumberofReceivedBytesforGoodPackets> </NumberofReceivedBytesforGoodPackets> <NumberofReceivedGoodPackets> </NumberofReceivedGoodPackets> <NumberofReceivedUnicastPackets> SN0054614-00 K B-33...
Page 290 B–XML Format 2 XML Format 2 Tags for Each Option </NumberofReceivedUnicastPackets> <NumberofReceivedMulticastPackets> </NumberofReceivedMulticastPackets> <NumberofReceivedBroadcastPackets> </NumberofReceivedBroadcastPackets> <NumberofReceivedPacketsWithVLANtag> </NumberofReceivedPacketsWithVLANtag> <NumberofReceivedOversizedPacketsWithGoodCRC> </NumberofReceivedOversizedPacketsWithGoodCRC> <NumberofReceivedOversizedPackets> </NumberofReceivedOversizedPackets> <NumberofReceivedPacketsDiscardedbytheMAC> </NumberofReceivedPacketsDiscardedbytheMAC> <NumberofReceivedUndersizedPacketsWithGoodCRC> </NumberofReceivedUndersizedPacketsWithGoodCRC> <NumberofReceivedUndersizedPacketsWithBadCRC> </NumberofReceivedUndersizedPacketsWithBadCRC> <NumberofReceivedPacketsWithCRCError> </NumberofReceivedPacketsWithCRCError> <NumberofReceivedPacketsWithLengthError> </NumberofReceivedPacketsWithLengthError> <NumberofReceivedOversizedPacketsWithBadCRC> </NumberofReceivedOversizedPacketsWithBadCRC> <NumberofReceived_802_3x_PauseControlPackets> B-34 SN0054614-00 K...
Page 291 B–XML Format 2 XML Format 2 Tags for Each Option </NumberofReceived_802_3x_PauseControlPackets> <NumberofReceivedPer-PriorityPausePackets> </NumberofReceivedPer-PriorityPausePackets> </NSLPortStatistics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> SN0054614-00 K B-35...
Page 292 B–XML Format 2 XML Format 2 Tags for Each Option Notes B-36 SN0054614-00 K...
Page 293: Error/Exit Return Codes
Error/Exit Return Codes To list the error/exit return codes while running SANsurfer FC/CNA HBA CLI in interactive mode: From the Main Menu, select the Help option, and then press ENTER. 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...
Page 294 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_NO_HBA Unable to open the adapter handle ERROR_UNKNOWN_HBA Adapter is unknown to SANsurfer FC/CNA HBA CLI ERROR_INVALID_SSID Adapter has invalid SSDID/SSVID ERROR_MISMATCH_SSID The specified Flash/NVRAM file does not have the SSDID/SSVID that match the adapter ERROR_MISMATCH_CHECKSUM...
Page 295 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_INCORRECT_RISC_CODE_FILE Incorrect RISC image ERROR_INCORRECT_BOOT_CODE_FILE Incorrect BIOS/FCode boot image ERROR_INCORRECT_FULL_IMAGE_FILE Incorrect 1M Flash image ERROR_CORRUPTED_FLASH_IMAGE_ Flash image file is corrupted FILE ERROR_FLASH_UPDATE_FAILURE Failed to update Flash ERROR_FLASH_INVALID_REGION_ Incorrect Flash image file SIGNATURE ERROR_FLASH_GET_REGION_FAILURE...
Page 296 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used ERROR_FC_LINK_UNKNOWN_STATUS Error getting FC link status ERROR_RESET_LINK_STATUS Unable to reset adapter link status ERROR_INVALIDE_STATISTICS_PARAMS Invalid link status/statistics parameter set- tings Reserved Not used Reserved Not used Reserved Not used...
Page 297 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_NO_SPACE_LEFT Command failed because no space left on the drive ERROR_MISSING_TEMPLATE_FILE Unable to find template file Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved...
Page 298 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_TARGET_NO_DIRECT_ACCESS Boot device settings failed because the boot target is not a direct access device ERROR_INVALID_BOOT_SETTINGS Boot device parameter is invalid/incorrect ERROR_UNSUPPORTED_BOOT_ Unsupported boot device settings SETTINGS Reserved Not used Reserved...
Page 299 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_DELETE_TARGET_PERSISTENT_ Failed to delete target persistent binding ENTRY ERROR_LUN_NOT_FOUND Specified LUN ID not available ERROR_NO_DEVICE_FOUND Adapter does not have attached devices ERROR_OPTION_UNSUPPORTED_DRV Option is not available with running driver ERROR_OPTION_UNSUPPORTED_HBA Option is not available with adapter ERROR_OPTION_UNSUPPORTED_OS...
Page 300 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_UNKNOWN_FILE_FORMAT Unable to determine file format ERROR_READ_DRV_VER_SYS_FILE Failed to read driver version from sys file ERROR_INIT_SECURITY_DESCRIPTOR Failed to initialize security descriptor during driver update ERROR_SET_SECURITY_DESCRIPTOR Failed to set security descriptor during driver update ERROR_FAIL_UPDATE_DRIVER Failed to update driver...
Page 301 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_NO_SN_VPD Serial number is missing in VPD data ERROR_RETRIEVE_VPD_DATA Failed to read VPD of selected adapter ERROR_UNSUPPORT_VPD_OPT Option is not supported with selected adapter Reserved Internal used Reserved Not used Reserved...
Page 302 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code IBM Reserved Blocked IBM Reserved Blocked IBM Reserved Blocked IBM Reserved Blocked Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved...
Page 303 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_SET_SWITCH_IP_ADDRESS Failed to set switch IP address ERROR_INVALID_SWITCH_INPUT Invalid switch parameters settings ERROR_INVALID_ADMIN_ACCOUNT Admin account is required ERROR_INVALID_ADMIN_PASSWORD Admin password is incorrect ERROR_INVALID_OPTION Switch input is invalid Reserved Not used Reserved...
Page 304 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used ERROR_NO_TARGET_SELECTED Unable to run target beacon because no device is selected ERROR_GET_BEACON_STATE Unable to get the beacon status ERROR_SET_BEACON_STATE Unable to set the beacon status ERROR_BEACON_UNSUPPORTED Beacon operation is unsupported ERROR_INVALID_BEACON_PARAMETERS...
Page 305 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used ERROR_ADAPTER_PROP_MISSING Adapter property file is missing Reserved Not used Reserved Not used Reserved...
Page 306 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used Reserved Not used Reserved Not used ERROR_VIRTUAL _HBA_LOCKED vPort is currently locked ERROR_VPORT_NOT_BELONG_TO_ vPort does not belong to the physical port PPORT ERROR_DUPLICATE_WWPN_VIRTUAL_ Found duplicate vPort WWPN Reserved Not used Reserved...
Page 307 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_GET_MENLO_ETH_MONITORING Failed to query FCoE Ethernet port statis- tics ERROR_GET_MENLO_FC_MONITORING Failed to query FCoE FC port statistics ERROR_GET_MENLO_NSL_MONITORING Failed to query FCoE NSL port statistics ERROR_CORRUPTED_LOG_DATA FCoE log data seems to be corrupted ERROR_NO_MATCHING_LOG_ID Unable to find the specified log that matched with the log ID...
Page 308 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used ERROR_GET_UDEV_NAME Unable to query udev persistent device name ERROR_DISPLAY_LUN_PERSISTENT_ Error displaying udev persistent device NAME name of the specified LUN ERROR_SET_LUN_PERSISTENT_NAME...
Page 309 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used Reserved Not used Reserved Not used Reserved Not used ERROR_FW_SERDES_UPDATE_FAILURE Unable to update firmware SerDes table on the specified adapter ERROR_FW_SERDES_SAVE_FAILURE Unable to save current adapter firmware serdes table to a DAT file Reserved Not used...
Page 310 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code ERROR_QOS_PERCENTAGE_OVERFLOW Failed to apply changes on selected port (QoS bandwidth overflow) ERROR_VPORT_DISABLE_QOS_SETTING Failed to apply changes on selected port (QoS settings is currently disabled) ERROR_VPORT_LOCK_QOS_SETTING Failed to apply changes on selected port (QoS settings is currently locked) ERROR_UPDATE_VPORT_QOS_SETTING Failed to update QoS settings...
Page 311 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used ERROR_ILT_SIGNATURE_MISMATCH The image layout table (ILT) signature does not match ERROR_INCORRECT_FCOE_FLASH_ Unable to find an adapter that matches with IMAGE the Flash image ERROR_VALIDATE_FCOE_FLASH_IMAGE Failed to verify Flash image ERROR_MODIFY_FCOE_FLASH_IMAGE Failed to modify Flash image...
Page 312 C–Error/Exit Return Codes Table C-1. Error/Exit Return Codes (Continued) Return Name Description Code Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used Reserved Not used ERROR_GET_DCBX_PARAMETERS Failed to get DCBX TLV C-20 SN0054614-00 K...
Page 313: Variables Used In Arguments
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.
Page 314 D–Help Commands Table D-1. Variables Used in Arguments (Continued) Variable Description World wide port name of a target device. <target wwpn> (xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx). World wide port name of the virtual port with the two hexadeci- <vport hex> mal digits in byte three supplied by the user. World wide port name of a virtual port.
Page 315 D–Help Commands Table D-2. Help Commands (Continued) Command Arguments Function Line Action Performs a driver update to the adapters. –d <file name > <file name> is the full path of the driver file in inf/zip or exe format. Runs a transceiver (SFF/SFP) diagnostics –dm ( <hba instance>...
Page 316 D–Help Commands Table D-2. Help Commands (Continued) Command Arguments Function Line Action Configures the operating system to boot –e ( <hba instance> | <hba wwpn> from a specific target: <target wwnn> <target wwpn> <lun id> [ prim | alt1 | alt2 | prim: Primary Boot Port Name alt3] alt1: Alternate 1 Boot Port Name...
Page 317 D–Help Commands Table D-2. Help Commands (Continued) Command Arguments Function Line Action Configures the driver settings. –fs ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Shows the current statistics on an adapter –gs ( <hba instance>...
Page 318 D–Help Commands Table D-2. Help Commands (Continued) Command Arguments Function Line Action Shows the current link status on an adapter –ls ( <hba instance> | <hba wwpn> ) port. { ( <param name> | <param alias> ) <param value> } Views selective LUN information of all –m ( <hba instance>...
Page 319 D–Help Commands Table D-2. Help Commands (Continued) Command Arguments Function Line Action Binds the selected device(s) attached to an –p ( <hba instance> | <hba wwpn> ) adapter port. { <target wwnn> <target wwpn> <target portid> <target id> } Unbinds a specific device attached to an –p ( <hba instance>...
Page 320 D–Help Commands Table D-2. Help Commands (Continued) Command Arguments Function Line Action Shows the current iiDMA settings of all tar- –q ( <hba instance> | <hba wwpn> | gets on an adapter port or all adapters. <all> ) [ –targets | –t ] Shows current QoS settings for all virtual -qos <hba instance>|<hba wwpn>...
Page 321 D–Help Commands Table D-2. Help Commands (Continued) Command Arguments Function Line Action Saves the current adapter firmware preload ( <hba instance> | <hba wwpn> ) area to a DAT file. save <file name> Shows the current version. –v — Creates a virtual port with your own –vp ( <hba instance>...
Page 322 D–Help Commands Notes D-10 SN0054614-00 K...
Page 323 Arbitrated loop. A circular (ring) topology Boot code for QLogic FC adapters is (versus point-to-point) where two or more required if the computer system is booting ports can be interconnected, but only two from a storage device (disk drive) attached ports can communicate at a time.
Page 324 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 Class of service (CoS) is a 3-bit field within contains the operating system the BIOS a layer two Ethernet frame header when uses to boot from when the computer is using IEEE 802.1Q.
Page 325 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters echo diagnostic test Data center bridging. Provides enhance- Transmits a received signal back to the ments to existing 802.1 bridge specifica- sender to verify the integrity of the device.
Page 326 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters fabric loop port FL_Port See FL_Port. Fabric loop port. In FC, the fabric switch is capable of FC arbitrated loop operations fabric port and is connected to one or more NL_Ports See F_Port.
Page 327 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters input/output control See IOCTL. Loop initialization process. The initializa- tion process in an arbitrated loop that intelligent interleaved direct memory occurs when the loop is powered up or a access new device is added.
Page 328 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Using LUNs, the FC host can address N_Port multiple peripheral devices that may share Node port. A port that connects by a a common controller.
Page 329 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 path links through an FC_AL open loop circuit A path to a device is a combination of a often through FC_AL (arbitrated loop)
Page 330 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters port instance small computer system interface The number of the port in the system. See SCSI. Each adapter may have one or multiple ports, identified with regard to the adapter as port 0, port 1 and so forth.
Page 331 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters VLAN Type-length-value (TLV) is optional infor- Virtual logical area network (LAN). A group mation that may be encoded as an of hosts with a common set of require- element inside the protocol.
Page 332 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Notes Glossary-10 SN0054614-00 K...
Page 333 3-54 configuring (FCoE engine) 3-33 instance of defaults, restoring 3-32 locating (beacon LED) 3-75 file, saving to 3-66 QLogic supported names and aliases 4-36 sampling rate, setting 3-92 per FCoE engine 3-33 settings, viewing A-4, templates, using 3-66 template supported parameters...
Page 334 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters AL_PA binding information, viewing persistent target 4-38 definition of Glossary-1 BIOS in adapter parameter template 3-66 adapter port, enabling 3-26 AL, definition of Glossary-1 definition of...
Page 335 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters commands (continued) config table, MPI -a 3-75, saving 3-71 -b 3-10, 3-65, updating 3-71 -c 3-21, 3-26, 4-8, A-4, configuration, saving 3-62 -cna 3-108, configuring...
Page 336 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters current settings delay, loop reset 3-26 adapter statistics 3-91 deleting virtual port 3-99 link status 3-94 device customer support xviii configuring boot 3-61 definition of...
Page 337 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 end user license agreement xvii documentation Enhanced Ethernet, definition of Glossary-3 conventions used in guide enhanced transmission selection, See ETS...
Page 338 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters FCoE Flash adapter information 3-112 definition of Glossary-4 data center bridging 3-112 image version 3-12 TLV, viewing 3-118 saving file 3-65 Utilities menu for QLE80xx...
Page 339 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters hard loop ID installation configuring 3-26 downloading package enabling 4-36 Linux 1-14 specifying 3-29 Macintosh 1-18 HardLoopID parameter 4-36 package, downloading hardware requirements prerequisites of...
Page 340 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters definition of Glossary-5 JBOD (just a bunch of disks), definition full login, enabling 3-27, 3-31, 4-36 Glossary-5 reset, enabling 3-26, 4-36 listing error codes 4-13...
Page 341 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters LoopbackType parameter 4-24 Microsoft’s Windows Virtual Server 2005 3-97 loop-only connection 3-28 mode -ls 3-89, 3-93, 4-32, A-14, B-16 interactive, definition of LT parameter 4-24...
Page 342 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters non-interactive mode (continued) parameters (continued) starting defaults, restoring 3-32 non-volatile random access memory, definition diagnostic 4-30 Glossary-7 FCoE engine A-23, B-27 NPIV FCoE, configuring 3-33...
Page 343 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters port (continued) listing 3-99 -r 3-65, 3-66, 4-44 quality of service 4-43 rate, data 3-29 user-generated 3-100 port alias read/write buffer test 3-83 results A-10,...
Page 344 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters SANsurfer FC HBA CLI (continued) Solaris software requirements installing on 1-15 supported QLogic adapters NPIV, supported 3-97 saving operating systems supported adapter parameters 3-66 target ID...
Page 345 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters target test beacon, starting and stopping 4-46 count parameter 4-23 binding 3-57 diagnostics loopback 3-77 binding info, viewing 4-38 increment parameter 4-23 binding, definition of...
Page 346 SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters uninstall viewing (continued) Linux 1-22 parameter settings Macintosh 1-24 system information Solaris SPARC 8, 9, and 10 1-22 target link speed 4-42 Solaris x86 8, 9, and 10...
Page 347 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 WWPN bind by WWPN parameter 4-17 definition of...
Page 348 SPARC International, Inc. in the USA and other countries. StuffIt is a registered trademark of Smith Micro Software, Inc. VMware is a registered trademark of VMware, Inc. All other brand and product names are trademarks or registered trademarks of their respective owners. Information supplied by QLogic Corporation is believed to be accurate and reliable.

This manual is also suitable for:

Qla2 series Qla234 series Qle2 series Qla246 series Qle246 series Qle256 series ... Show all

Qlogic SANsurfer FC/CNA HBA CLI User Manual

Preface

1 Installation and Removal

2 Getting Started

Non-Interactive Commands

XML Format 1

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Qlogic SANsurfer FC/CNA HBA CLI

Summary of Contents for Qlogic SANsurfer FC/CNA HBA CLI