Instruction/ maintenance manual of the product FC0E Q-Logic
Go to page of 348
SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’ s Guide Command Line Interface for QLogic FC and FCoE Adapters.
ii SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Information fu rnished in this manual is believed to be accurate and reliab le.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters SN0054614-00 K iii Added new FCoE menu option to Interactive Com- mands chapter . 3 Interactive Comman ds Added Flash Imag e V e rsion to list of actual VPD information.
iv SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Notes.
SN0054614-00 K v T able of Content s Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Uninstalling SANsu rfer FC/CNA HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 Windows Uninst all . . . . . . . . . . .
SN0054614-00 K vii SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters HBA Parameters Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24 HBA Parameters (Per Adapter Po rt) .
viii SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters T arget Persistent Binding (All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . 3-57 Display T arget Persistent Binding . .
SN0054614-00 K ix SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters Diagnostics Menu (Command Line Options -kl, -kr , and -dm) . . . . . . . . . . . 3-76 Diagnostics Loopback T est (Command Line Option -kl) .
x SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters FCoE Utilities Menu for QLx81 xx Adapters (Command Line Option -cna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SN0054614-00 K xi SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters T estIncrement (TI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23 OnError (OE) . . . . . . . . . . . . . . .
xii SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Display HBA Information (Command Line Option -i) . . . . . . . . . . . . . . A-5 Display Device List (Command Line Option -t) . . . . .
SN0054614-00 K xiii SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters Boot Device (Command Line Opt ion -e) . . . . . . . . . . . . . . . . . . . . . . . B-10 Diagnostics Result s— Loopback T est (Command Line Option -kl) .
xiv SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters List of T ables 1-1 Windows Command Line Inst allation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 2-1 Non-interactive Mode Options .
SN0054614-00 K xv Preface The SANsurfer ® FC/CNA HBA CLI tool provides a command line inte rface (CLI) that lets you easily install, configure, an d deploy QLogic ® Fibre Channel (FC) adapters, as well as QLogic Fibre C hannel over Ethernet (FCoE) converged network adapters (CNAs).
Preface What’s in This Guide xvi SN0054614-00 K The remainder of this guide is org anized into the following chapters and appendices: 1 Installatio n and Removal lists the supporte d QLogic adap.
Preface License Agreeme nts SN0054614-00 K xvii Te x t i n ALL CAPIT ALS indicates the name of a key that you press on the keyboard. For example: T ype the number for Host Information and then press ENTER . Italicized text indicates either a document reference, glossary t erm, or emphasis.
Preface T echnical Suppor t xviii SN0054614-00 K T echnical Support Customers should cont act their authorized maintenance provider for technical support of their QLogic switch product s. QLogic-direct customers may contact QLogic T echnical Support; others will be redirected to their authorized maintenance provider .
SN0054614-00 K 1- 1 1 Inst allation and Removal This chapter lists the supported QLogic adapter s and system requirements, provides procedures for d ownloading and inst alling SANsurfer FC/CNA HBA CLI, and instructions for removing the product.
1–Installation and Removal Supported QLogic Adapters 1-2 SN0054614-00 K Supported QLogic Adapters SANsurfer FC/CNA HBA CLI is supporte d for the following QLog ic adapters: QLA2 xx QLA234 x .
1–Installation and Removal Supported Operating Systems SN0054614-00 K 1-3 Supported Operating Systems SANsurfer FC/CNA HBA CLI is supported on the following operating systems: Microsof t ® Wind.
1–Installation and Removal System Requirement s 1-4 SN0054614-00 K System Requirement s The system requirement s for SANsurfer FC/CNA HBA CLI are described in the following sections: “Hardware.
1–Installation and Removal System Requirements SN0054614-00 K 1-5 256 MB physical RAM are required to run SANsurfer FC/CNA HBA CLI; running with less memory can caus e disk swapping (“paging” or “p aging out”), which severely af fects performance.
1–Installation and Removal Downloading the Installa tion Package 1-6 SN0054614-00 K Features Not A vailable When Running Linux with Converged Network Adapte rs When running Linux OS with con verged .
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-7 Figure 1-1 shows an example. Figure 1-1 Selecting Adapter Model (Example) The resources p age for the selected mode l appears. 3. Under Mana gement T ools , click SANsurfer CLI.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-8 SN0054614-00 K Windows Inst allation T o install SANsurfer FC/CNA HBA CLI on Windows, fo llow either the GUI or command line instal.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-9 After the inst all package is loaded, the W elcome dialog box appears as shown in Figure 1-3 . Figure 1-3 Welcome Dialog Box 2. Read the informa tion, and then click Next .
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-10 SN0054614-00 K The Choose Destination Location dialog box a ppears as shown in Figure 1-4 .
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-1 1 The Ready to Install th e Program dialog box appears as shown in Figure 1-5 . Figure 1-5 Ready to Inst all the Program Dialog Box 4. Read the informa tion, and then click Inst all .
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-12 SN0054614-00 K If you want to stop the installation, click Cancel . The InstallShie ld Wizard Complete dialog box appea rs as shown in Figure 1-7 . Figure 1-7 InstallShield Wi zard Compl ete DIalog Box 5.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-13 St andard Command Line Inst allation T ype the following text for a standard inst allation of SANsurfer FC/CNA HBA CLI on a Windows operating system, where xx indicates the version of SANsurfer FC/CNA HBA CLI: scli-1.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-14 SN0054614-00 K T o create a response file for a silent insta llation of SANsurfer FC/CNA HBA CL I, enter the following: scli-1. x . x - xx .windows.exe /r /f1"C:Tempinstall_1.iss" T o run the installation in silent mo de with a log file, enter the following: scli-1.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-15 2. Decompress the file with the following command: gunzip < file name > 3.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-16 SN0054614-00 K 2. T o see the available package file, type the following: # ls The available p ackages appear . For example: # scli-x.xx.xx-xx.sparc.Solaris.pkg 3. T o install SANsurfer FC/CNA HBA CLI, type the following: # pkgadd -d scli- x.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-17 /opt/QLogic_Corporation/SANsurferCLI/libs/libqlsdm.so /opt/QLogic_Corporation/SANsurferCLI/menu.properties /opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2 2.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-18 SN0054614-00 K Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]: q Enter 1 to proceed the installation. 6. T ype the number that corresponds to your operating system, and then press ENTER .
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-19 3. When the download has finished, S tuffIt ® expands the zip file to a tar file onto the desktop. 4. Double-click the SCL I tar file icon to create the SCLI pkg file.
1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-20 SN0054614-00 K If this is the first time you are inst alling SANsurfer FC/CNA HBA CLI, the system shows the following messages: qlogic:~ root# installer -pkg scli- x.x.x-x .pkg -target / installer: Package name is SANsurfer FC/CNA HBA CLI x.
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-21 Uninst alling SANsurfer FC/CNA HBA CLI Refer to the following sections for the approp riate procedure to uninst a.
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI 1-22 SN0054614-00 K Linux Uninst all T o uninstall SANsurfer FC/CNA HBA CLI on a Linux system, go to the comman d line and type one of the following co mmands, where x.xx.xx is the current version of CLI: rpm -e scli- x.
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-23 ## Verifying package dependencies. ## Processing package information. ... /opt/QLogic_Corporation/SANsurferCLI/adapters.properties /opt/QLogic_Corporation/SANsurferCLI ## Executing postremove script.
1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI 1-24 SN0054614-00 K SCLI property file removed. ## Updating system information. Removal of <QLSclix> was successful.
SN0054614-00 K 2- 1 2 Getting S t arted This chapter provides the following sect ions to help yo u get st arted using SANsurfer FC/CNA HBA CLI: “S tarting Interactive Mo de” on pa ge 2-1 .
2–Getting S tarted S tarting Interactive Mode 2-2 SN0054614-00 K For Mac OS X, follow these step s: 1. Double-click the SANsurfer FC/CNA HBA CLI (SCLI) icon. 2. A terminal window opens. SCLI (in t eractive mode) scans the host fo r QLogic adapters and SAN storage.
2–Getting S tarted S tarting Interactive Mode SN0054614-00 K 2-3 Depending on which menu you select, may prompt you for more input. For example, if you select HBA Parameters , SANsurfer FC/CNA HBA CLI prompt s you for the port number that corre sponds to the adapter model you want to view .
2–Getting S tarted S tarting Non-Interactive Mode 2-4 SN0054614-00 K S t arting Non-Interactive Mode T o start SANsurfer FC/CNA HBA CLI in non-interactive mode, type th e following in a command window: scli < parameters > SANsurfer FC/CNA HBA CLI executes the comma nd options, and then terminates.
2–Getting S tarted S tarting Non-Inte ractive Mode SN0054614-00 K 2-5 -b 10 10 — Save/update BIOS/FCode a b “-b (Sav e or Update the F lash BIOS or FCode)” on page 4- 7 -c 2 2 2 Show adapter s.
2–Getting S tarted S tarting Non-Interactive Mode 2-6 SN0054614-00 K -g 1 1 1 Show system infor- mation “-g (Display Sys- tem Informat ion)” on page 4- 18 -gs 13 13 13 Adapter statistics “-gs .
2–Getting S tarted S tarting Non-Inte ractive Mode SN0054614-00 K 2-7 -n 3 3 3 Configure adap ter settings “-n (Set Selected HBA Parameter)” on page 4- 35 -o 1 1 1 Output to a file “-o (Output.
2–Getting S tarted S tarting Non-Interactive Mode 2-8 SN0054614-00 K Options that have a corresponding menu selection cannot be combined. That is, only one option is allowed in a single command. If multiple options are specified in a command, only the first one is proc essed.
2–Getting S tarted T erminology SN0054614-00 K 2-9 For all command line options, SANsurfer FC/CNA HBA CLI shows the following when there are errors in the command line input: Error < error message > SANsurfer FC/CNA HBA CLI v1.x.x Build xx Copyright 2003-2009 QLogic Corp.
2–Getting S tarted Advanced Features 2-10 SN0054614-00 K Advanced Features SANsurfer FC/CNA HBA CLI adds the following adva nced features to it s toolset: N_Port ID virtualization (NPIV). NPIV (N_Port ID virtualizatio n) allows you to make the most of your server and Fibre Channel fabric.
SN0054614-00 K 3- 1 3 Interactive Commands This chapter describes the interactive m ode command line options for specific QLogic FC adapters. The interactive mode us es a series of menus from which you select the option you want and enter the number for that option.
3–Interactive Commands 3-2 SN0054614-00 K St arting Interactive Mode T o start the interactive mode, type one of the follo wing: [ scli ] [ scli int] (on some Solaris inst allations) When you st art.
3–Interactiv e Commands SN0054614-00 K 3-3 Selections from the Main Menu open new menus. For example, if yo u enter option 1 ( General Information ) on th e main interactive menu, the system shows a new menu, the General Information Menu . From this menu you have several choices including 1: Host Information , 2: Host Topology , and so forth.
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-4 SN0054614-00 K 1: General Information 2: Host T opology 2: Save As Txt File General Information Menu (Command Line Option -g) 1: General Information This option shows you general in formation for the adapter .
3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-5 T otal number of QLogic adapters detect ed ------------------------------------------------------------------------------ Host Name : BRAGI OS Type : Microsoft Windows Svr 2003 Enterprise Ed.
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-6 SN0054614-00 K Save As Txt file Save As XML File Display (Host T opology) ( Command Line Option -tp | -topology).
3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-7 Number of Port Beacon S tatus Port T ype Port S tate Port Information (repeat s for .
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-8 SN0054614-00 K Host : BRAGI Number of Port : 1 Beacon status : Unsupported Port Type : L_Port Port State : Online ======.
3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-9 Product Serial Number : LT06464600001011HGGH Target/Initiator : Target Node Name : 20-00-00-20-37-11-FF-.
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-10 SN0054614-00 K Beacon status : Off Port Type : Unknown Port State : LinkDown Hit <RETURN> to continue: Save As Txt File (Command Line Option -b) 1.
3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-1 1 Adapter Model Port Number Port WWPN Port S tatus Generate Report (Per Adapter Port) 1:.
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-12 SN0054614-00 K Actual Connection Mode Actual Data Rate PortT ype (T opology) T arget Count PCI Bus .
3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-13 Interrupt Delay T imer Execution Throttle Login Retry Count Port Down Retry Count E.
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-14 SN0054614-00 K St a t u s LUN N (Repeats for each LUN) Product V endor Product ID Product revision .
3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-15 Host Name : BRAGI OS Type : Microsoft Windows Server 2003 Enterprise Edition x86 OS Version : Service Pack 1 (Build 3790) SDM API Version : 1.28.0.50 QLSDM.
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-16 SN0054614-00 K HBA VPD Information ------------------------------------------------------------------------------ Featu.
3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-17 ------------------------------------------------------------------------------ HBA Instance 1: 2200 Por.
3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-18 SN0054614-00 K Product Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Revision : SG1D LUN : 0 Size : 16.
3–Interactiv e Commands HBA Information Menu ( Command Line Option -i) SN0054614-00 K 3-19 ---------------------------- ------ 00-00-00-00-00-00-00-00 0 ---------------------------- ------ (Alternat.
3–Interactive Commands HBA Information Menu (Command Line Option -i) 3-20 SN0054614-00 K Additional adapters (as appropriate) All adapters Here is an example of a typical HBA Information Menu .
3–Interactiv e Commands HBA Information Menu ( Command Line Option -i) SN0054614-00 K 3-21 If you select a number correspon ding to an FCoE engin e rather than a port, the following general informat.
3–Interactive Commands HBA Information Menu (Command Line Option -i) 3-22 SN0054614-00 K T o create, modify , or delete an adapter alias: 1. From the Main Menu , type the number for the HBA Information option, a nd then press ENTER . 2. T ype the number for the adapter you want to configu re, and then press ENTER .
3–Interactiv e Commands HBA Information Menu ( Command Line Option -i) SN0054614-00 K 3-23 T o create, modify , or delete an adapter port alias: 1. From the Main Menu , type the number for the HBA Information option, a nd then press ENTER . 2. T ype the number for the HBA Port for which you want to change the Port Alias, and then press ENTER .
3–Interactive Commands HBA Parameters Menu 3-24 SN0054614-00 K BIOS V ersion (Windows and Linux) FCode V ersion (Solaris) Flash Image V ersion (QLE81 xx adapters only) If the adapter doe.
3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-25 All adapters Here is an example of an HBA Parameters Menu . In this example, the h ost includes three adapters with two ports each a nd one adapter with a single p ort (see HBA Parameters (Per Adapter Port) and HBA Parameters (All HBAs) ): HBA Model QLA2342: 1.
3–Interactive Commands HBA Parameters Menu 3-26 SN0054614-00 K Display HBA Parameters (Command Line Option -c#) 3: HBA Parameters n: Port Instance 1: Display HBA Par ameters When you select .
3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-27 Enable LIP Full Login (QLA/QLE23 xx adapters) Link Down T imeout (seconds) Enable T arget Reset LUNs per T arget E.
3–Interactive Commands HBA Parameters Menu 3-28 SN0054614-00 K 1. Connection Options (re ad-only on QLE8042, QLE/QMI81 xx , and SMB adapters): 0 = Loop Only 1 = Point-to-point Only 2 = Loop preferred, ot herwise Point-to-Point 3 = Point-to-Point, otherwise Loop (QLA22xx Only) 2.
3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-29 Dat a Rate 3: HBA Parameters N: Por t Number 2: Configu re HBA Parame ters n. Data Rate This option shows the Data Rate menu. (Note that da ta rate configuratio n is not available for all adapter port inst an ces.
3–Interactive Commands HBA Parameters Menu 3-30 SN0054614-00 K 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 set ting. When this setting is disabled, the ROM BIOS on th e adapter is disabled.
3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-31 Login Retry Count 3: HBA Parameters N: Port Number 2: Configure HBA Parame ters n. Login Ret ry Count This choice gives you the option to set the Login Retry Count to a value from 0 to 255.
3–Interactive Commands HBA Parameters Menu 3-32 SN0054614-00 K Commit Changes 3: HBA Parameters N: Por t Number 2: Co nfigure HBA Parameters n.
3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-33 HBA Parameters (Per FCoE Engine) 3: HBA Parameters n: FCoE Engine The FCoE Parameters menu appears only fo r the QLE8042 adapter a.
3–Interactive Commands HBA Parameters Menu 3-34 SN0054614-00 K FCoE Parameters Menu FCoE Engine (QLE8042) Port 0 Desc: QLE8042 Mercury CNA 1: Port Type 2: Pause Type 3: FCoE COS 4: Save Changes 5: R.
3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-35 Priority Flow Control enables you to manage p auses in traffic according to assigned priorities to class of service (CoS ) frames; that is, on per-flow basis.
3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-36 SN0054614-00 K The priority p ause mask is a bitmap of CoS values for which p ause is being enabled.
3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-37 T arget/LUN List (Per Adapter Port) 4: Target/LUN List 1 - n T arget List Menu - Port n When you select an HBA port inst ance from the Target/LUN List , a list of LUNs (disks) attached to that port instance appears.
3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-38 SN0054614-00 K 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.
3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-39 Desc: QLE2462 PCI Express to 4Gb FC Dual Channel 1: Information 2: Persistent Names 3: Return to Pr.
3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-40 SN0054614-00 K When you select Persistent Names from the previous menu , the following Persistent Names Menu for that LUN a ppears. This menu provides options to view , add, and delete persistent names for the LUN.
3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-41 3. Delete T o delete persistent binding for the LUN, select 3 on the Persis tent Names Menu .
3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-42 SN0054614-00 K Here is an example of the LUN information. Product Vendor : SEAGATE Product ID : ST318453FC Product Revision : 0006 LUN : 0 Size : SBC-2 Direct Access block device (e.
3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-43 1: Disk 1 on QLA2462 (HBA Instance 0) Vendor : SEAGATE Product ID : ST336607FC Product Rev : 0006 Serial Number : 3JA9TN7600007517FK7W Port Name : 22-00-00-11-C6-2D-5A-B8 Port ID : 02-0A-EO And so on.
3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-44 SN0054614-00 K Product V endor Product ID Port Name Port ID LUN ID OS LUN Name (on Solaris and Linux) Here is an example of the LUN information: Product Vendor : SEAGATE Product ID : ST336607FC Product Revision : 0006 LUN : 0 Size : 34.
3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-45 Here is an example of the All Targets option. Note: 0 to return to Main Menu Enter Selection: 3 ---.
3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-46 SN0054614-00 K ------------------------------------------------------------- HBA Instance 0: QLA2462 Port 1 WW.
3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-47 T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) 5: Target Link Spe.
3–Interactive Commands T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 3-48 SN0054614-00 K Configuring the iiDMA Settings Use the intelligent interleaved direct memory access (iiDMA) menu to sele ct the intelligent interleave factor settings per adap ter type and device.
3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-49 iiDMA settings have been saved to selected target(s) on HBA instance n . To e x i t iiDMA Settings without making any changes, select No .
3–Interactive Commands T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 3-50 SN0054614-00 K HBA Instance 0 (QLA2463 Port 1) : Online Desc: QLA2462 PCI-X 2.
3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-51 Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Rev : SG1D Serial Number : LP602.
3–Interactive Commands T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 3-52 SN0054614-00 K T arget Link Speed: All HBA s, Basic Configuration 5: Target Link Speed 2: All HBAs 1: Basic Con figuration When you select this option, th e T arget Link S peed Menu (Basic) for All HBAs appears.
3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-53 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 .
3–Interactive Commands T arget Pe rsistent Bin dings Menu ( Command L ine Option -p) 3-54 SN0054614-00 K New iiDMA setting has been saved to seleted target(s) on HBA instance 0.
3–Interactiv e Commands T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 K 3-55 T arget Persistent Bindings (Per Adapter Port) (Command Line Option -p) 6: Target Persistent Bin.
3–Interactive Commands T arget Pe rsistent Bin dings Menu ( Command L ine Option -p) 3-56 SN0054614-00 K Here is an example of the T arget Persistent Binding Me nu for HBA Inst ance n : Target Persi.
3–Interactiv e Commands T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 K 3-57 T ype the number for the option you want, and then press ENTER .
3–Interactive Commands Selective LUNs Menu ( Command Line Option -m) 3-58 SN0054614-00 K Selective LUNs Menu (Command Line Option -m) 7: Selective LUNs When you select this option, SAN surfer FC/CNA HBA CLI shows the Selective LUNs Menu (see ), allowing you to select an individual a dapter port or All HBAs .
3–Interactiv e Commands Selective LUN s Menu (Co mmand Line Option -m ) SN0054614-00 K 3-59 1: Disk Vendor : SEAGATE Product ID : ST136403FC Port Name : 21-00-00-20-37-1A-6B-CF Port ID : 11-01-E4 Bi.
3–Interactive Commands Boot Device M enu (Comma nd Line Op tion -e) 3-60 SN0054614-00 K Please reboot the system for the saved configuration to become effective.
3–Interactiv e Commands Boot Device Menu (Command Line Option -e) SN0054614-00 K 3-61 ------------------------------------------------------------------------------ HBA Instance 0: 2200 Port 1 WWPN .
3–Interactive Commands Driver Settings Menu (Command Line Option -fg) 3-62 SN0054614-00 K LUN List Menu 8: Boot Device n: Port Nu mber 2: Config ure Boot Device 2: Bo ot Device Se ttings.
3–Interactiv e Commands Driver Settings Menu ( Command Line Option -fg) SN0054614-00 K 3-63 The current settings for t he Present persistently bound target(s)... and Bind by... are indicated by the word Current in p arentheses af ter the selection. T o change these settings, select the menu number corresponding to the other option.
3–Interactive Commands Utilities Menu 3-64 SN0054614-00 K Utilities Menu 10: Utilities The Utilities Menu provides optio ns for saving and restoring Flash and ada pter parameters. Y ou can save adapter p arameters in either a generic file or in a server manufacturer template such as QL ogic, HP , IBM, EMC, and so on.
3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-65 Up date Flash (Per Adap ter Port or All HBAs) (Command Line Option -b) 10: Utilities 1: Update Flash When you select Update Flash , you are promp ted to select either o ne of your adapter port inst ances or All HBAs to update.
3–Interactive Commands Utilities Menu 3-66 SN0054614-00 K Warning: Please update the HBA parameters with extreme care. Incorrectly updating the HBA parameters may render the HBA inoperable. If you currently have boot device information set up in the HBA parameters, updating the HBA parameters from a file may result in changing that information.
3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-67 Maximum LUNs Per T arget specifies the maximum number of L UNs per target. Multiple LUN sup port is typically for RAID boxes that use LUNs to map drives.
3–Interactive Commands Utilities Menu 3-68 SN0054614-00 K When you select the HBA Parameters Template option, SANsurfer FC/CNA HBA CLI prompts you to select an adapter port (or All HBAs ), and then .
3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-69 HPQ (HP-specific settings—2Gb HP adapters) IBM (IBM-specific settings) QLGC (QLogic-specific settings) SUN (Sun-specific settings) Select one of the t emplates to apply it immediately to t he adapter port inst ance (or All HBAs .
3–Interactive Commands Utilities Menu 3-70 SN0054614-00 K 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 O.
3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-71 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.
3–Interactive Commands Utilities Menu 3-72 SN0054614-00 K 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.
3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-73 2. Select the number corresponding to the QLE25 6 x adapter port for which you want to update firmware, or select the option fo r All HBAs . SANsurfer FC/CNA HBA CLI shows the following wa rning: Warning: Please update the HBA firmware area with extreme care.
3–Interactive Commands Utilities Menu 3-74 SN0054614-00 K ; ; FW Area data file for standard card ;************************************************************************** ; !!!!! DO NOT CHANGE TH.
3–Interactiv e Commands Beacon Menu SN0054614-00 K 3-75 Beacon Menu 11: Beacon The Beacon menu provides options for beaconing : a process by which an LED on a device (adapter or t arget) is flashed or blinked to locate it. Use the Locate HBA option to beacon a specified adapter .
3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-76 SN0054614-00 K 2: Disk Vendor : SEAGATE Product ID : ST118273 CLAR18 Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8 Beacon : No 3: Beacon Selected Target(s) 4: Return to Previous Menu Y ou can select a disk number to blink the LED on that target.
3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-77 When you select this option from the Main Menu , S ANsurfer FC/CNA HBA CLI shows Diagnostics Menu with the st andard list of adapter ports. T ype the number for the port on which you want to run diagnostic tests and the n press ENTER .
3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-78 SN0054614-00 K Display T est Parameters Reset T est Parameters Configure T est Parameters S tart Diagn ostic T est Diagnostic test s interrupt normal adapter operations.
3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-79 If the adapter port is not connected to the fa bric through a point-to-point connection (F-port) and is not connected to a swit ch, change the setting to loop only , if not currently set to this option.
3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-80 SN0054614-00 K Data Size (Bytes) : 512 Number of test(s)(1-65535) : 65535 Test Increment(1-65535) : 1 On Error.
3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-81 T able 3-10. Adapter Diagnostics Configuration Se ttings Parameter Name <p aram name> .
3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-82 SN0054614-00 K Selecting the Loopback Type option (ava ilable only for 8Gb adapt ers) shows the currently type.
3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-83 Finished 6376 iterations in 1 second(s)... Diagnostics Read/W rite Buffer T est 12: Diagnost.
3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-84 SN0054614-00 K 1 = Loopback T est 2 = Read/W rite Buf fer T est 4. The Read/Write Buffe r Test Menu appears. Se lect one of the following options: 1. Display Test Parameters.
3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-85 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 T ype 1 to proceed or 2 to cancel the operation.
3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-86 SN0054614-00 K T ransceiver Details: General Select the General option o n the Transceiver De tails menu to view general information for the selected adapt er port.
3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-87 Address A0 Identifier: SFP Ext. Identifier: GBIC/SFP defined by serial ID only Connector: LC.
3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-88 SN0054614-00 K 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Address A2 Temp High Alarm: 0x4e00 Temp Low Alarm: 0x0c.
3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-89 Reserved MSB: 0x00 Reserved LSB: 0x00 Status/Control Bits:-Data_Ready_Bar: 0x0 -LOS: 0x0 -TX Fault: 0x.
3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-90 SN0054614-00 K HBA S t atistics: Monitoring (Command Line Option -gs) 13: Statistics 1: HBA Statistics When you se.
3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-91 LogToFile (LF): null.csv 5. T o restore the adapter default s, select Restore Default , and then press ENTER . The following message appears: Resetting to default settings.
3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-92 SN0054614-00 K Resetting to default settings..., done. Auto Poll 13: Statistics 1: HBA Statistics 1 : Configur.
3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-93 The file name extension .csv indicates a comma separated value file t ype. Show HBA St atistics 13: Statistics 1: HBA Statistics 1 : Show HBA Statistics T o view the adapter port st atistics: 1.
3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-94 SN0054614-00 K “Configuration” on page 3-9 4 “Show Link S tatus” on p age 3-96 Configuration 13: Stati.
3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-95 Resetting to default settings..., done. Auto Poll Menu 13: Statistics 2: Link Status 1: Config.
3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-96 SN0054614-00 K The file name extension .csv indicates a comma separated value file t ype.
3–Interactiv e Commands Virtual Menu (Com mand Li ne Option -vp) SN0054614-00 K 3-97 V irtual Menu (Command Line Option -vp) 14: Virtual Menu QLogic's SANsurfer FC/CNA HBA CLI for Windows and Solaris works in conjunction with QLogic's N_Port ID virt ua lization (NPIV)-cap abl e driver .
3–Interactive Commands Virtual Menu (Com mand Line Option - vp) 3-98 SN0054614-00 K When you select the Virtual Menu option from the main menu, the Virtual Menu appears, showing: Adapter Model .
3–Interactiv e Commands Virtual Menu (Com mand Li ne Option -vp) SN0054614-00 K 3-99 In addition, the following notes app ly: The maximum number of virtual adapters t hat can be created of a physical adapter is 15. vPort means virtual port in all the displays.
3–Interactive Commands Virtual Menu (Com mand Line Option - vp) 3-100 SN0054614-00 K Create Virtual Port(s) 14: Virtual 1: Virtual Menu 3: Create a V irtual Port When you select this option,.
3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-101 Enter Hex Pattern (xx) : T ype two hex digits. The system creates the new virtual port, for exa mple: (Create Virtual.
3–Interactive Commands QoS Menu (Command Line Option -qos) 3-102 SN0054614-00 K Setting the QoS by priority (the default for newly created virtual port s) lets you set the priority level for e ach of the defined virtua l ports.
3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-103 QoS Priority Menu 15: QoS n : Port number 1: QoS Priority Setting the QoS by priority let s you set the priority level for each of the defined virtual ports.
3–Interactive Commands QoS Menu (Command Line Option -qos) 3-104 SN0054614-00 K 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2 The QoS Priority Menu reappears and list s all the virtual ports. 5. V erify that the priority level is correct for the virtual port that you change d.
3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-105 Desc: QMH2562 PCI-E to 8Gb FC Dual Channel Mezz HBA 1: Bandwidth Speed 2: Bandwidth Percentage 3: Return to Previous .
3–Interactive Commands QoS Menu (Command Line Option -qos) 3-106 SN0054614-00 K 2. If the virtual port is already enab led and unlocked, proceed to St e p 3 .
3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-107 QoS Bandwid th Percentage Menu 15: QoS n : Port number 2: QoS Bandwidth 2: Bandwidth Perce ntage T o set the bandwid th percentage for a virtua l port: 1.
3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-108 SN0054614-00 K Hit <RETURN> to continue: FCoE Menu (Command Line Option -cna) 16: FCoE Fibre Channel over Ethernet (FCoE) is a new technolo gy that allows FC storage traffic to tra vel over an Ethernet fabric.
3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-109 Up date Firmware 16: FCoE 1: Update Firmware Use this option to update the firmware on the a dapter ’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 .
3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 10 SN0054614-00 K Number of Transmitted 802.3x Pause Control Packets: 0 Number of Transmitted Per-Priority Pause Packets: 0 Number of.
3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3 - 111 scli -fcoe ( < hba instance > | < hba wwpn > ) --log --list T o show a specific log entry by Log ID, e.
3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 12 SN0054614-00 K 1: Information 2: Data Center Bridging 3: DCE Statistics 4: TLV 5: Return to Previous Menu The following sections e.
3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 13 ---------------------------- DCBX Enable : Enabled Willing : Enabled Port Pause Type : Per Priority Pause SAN Prior.
3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 14 SN0054614-00 K DCE St atistics 16: FCoE 3: DCE Statistics When you select the DCE Statistics option from the FCoE Utilities Me.
3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 15 Display Settings 16: FCoE 3: DCE Statistics 1: Display Sett ings Select the Display Settings option to show.
3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 16 SN0054614-00 K ------------------------------------------------------------- DCE Statistics Details for CNA Instance 0 - QLE8142 -.
3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 17 Receive CBFC Pause Frames 0: 0 Receive CBFC Pause Frames 1: 0 Receive CBFC Pause Frames 2: 0 Receive CBFC Pause Fra.
3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 18 SN0054614-00 K TL V 16: FCoE 4: TL V When you select the TLV option from the FCoE Utilities Me nu for QLE81 xx /QMI81 xx adapters, a submenu menu promp ts you to view either Details or Raw type-length-value (TL V) data for DCBX.
3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 19 Priority Group ID of Priority 7: 0 Priority Group ID of Priority 6: 0 Priority Group 0 Percentage: 50 Priority Grou.
3–Interactive Commands Help Menu (Comm and Line Option -h) 3-120 SN0054614-00 K PFC Enabled on Priority 0: No PFC Enabled on Priority 1: No PFC Enabled on Priority 2: No PFC Enabled on Priority 3: Y.
3–Interactiv e Commands Help Menu (Command Line Option -h) SN0054614-00 K 3-121 T o view help for FCoE using the co mmand line option, enter the following command: scli -fcoe Content s 14 (or 15): Help 1: Contents When you select the Contents option, SANsurfer FC/CNA HBA CLI shows the entire Help menu.
3–Interactive Commands Help Menu (Comm and Line Option -h) 3-122 SN0054614-00 K Notes.
SN0054614-00 K 4- 1 4 Non-Interactive Commands This chapter contains the info rmation in the help (to view help, ente r the command -h ), plus additional explanation and ex amples. Each command line option is listed, followed by a command description a nd examples of the command in u se and typical responses from the system.
4–Non-Interactive Commands Display System Information (Comm and Line Options -g, -z, and -tp) 4-2 SN0054614-00 K SAN target management (SDM) API version List of adapters: adapter mode l, por.
4–Non-Inte ractive Comma nds Display System Information (Comm and Line Options -g, -z, and -tp) SN0054614-00 K 4-3 Host T opology (Command Line Option -tp) The command format for Host T opology is: .
4–Non-Interactive Commands Display System Information (Comm and Line Options -g, -z, and -tp) 4-4 SN0054614-00 K Port T ype Port S tate Port Information Physical Port Number (switch .
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-5 Command Summary The command format for non-interactive mode is: # scli -(Cmd) (< hba instance > | < hba wwpn >) (view | ?) Where: Y ou can combine the commands -o , -s an d -x with other options.
4–Non-Interactive Commands Command Summary 4-6 SN0054614-00 K Y ou cannot combine the command -f with any other options: -f = Input Parameter Op tions from a T ext File (see “-f (Input Parameter Options from a T ext File)” on page 4-13 ). For example: # scli -f command.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-7 T o view the adapter port’s LED beacon st ate, type: # scli -a (< hba instance > | < hba wwpn >)(view | ?) When the adapter’s LED is flashing, the following message appears: HBA Port x - LED Flashing is ON.
4–Non-Interactive Commands Command Summary 4-8 SN0054614-00 K T o update one or all adapter ’s Flash with new BIOS or FCode, type: # scli -b (all | < hba instance > | < hba wwpn >) [(&.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-9 The -cna command line options use t he following variables: T o view general information for the adapter , issue the following command.
4–Non-Interactive Commands Command Summary 4-10 SN0054614-00 K -d (Up date Device Driver) Use the -d command to update the adap ter ’s device driver: scli -d < file name > Where: -dm (Display Diagnostics Monitoring Info) This option allows you to show general o r detailed Digital Diagnost ic Monitoring Interface for optica l transceivers.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-1 1 # scli -dm (< hba instance > | < hba wwpn > | all)details | det Where: -e (Boot Device View | Select | Disable) Use the -e command to: Show the current boot-device selection for all adapters.
4–Non-Interactive Commands Command Summary 4-12 SN0054614-00 K < hba instance > < hba wwpn > < target wwnn > < target wwpn > < target id > < lun id > If the system does not have an a dapter with a boot device selected, th e following message appears: There is no boot device selected for any HBA in the system.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-13 In Solaris SP ARC, setting the t arget ID to the target of the boot -selected LUN is equivalent to persistently binding the t arget (see “-p (Display Persistent T arget Binding Info)” on p age 4-38 ).
4–Non-Interactive Commands Command Summary 4-14 SN0054614-00 K The file must contain a single line. The file must contain o nly paramet ers. The file cannot cont ain another -f option.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-15 In the previous commands, the variables in dicate the following (see also T able 4-4 : Firmware Up date Commands T o update the firmw.
4–Non-Interactive Commands Command Summary 4-16 SN0054614-00 K Network Interface St atistics Commands T o show the FCoE network interface statistics, issue the followin g command: # scli -fcoe ( <.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-17 Where: The pairs < p aram name > < para m v al ue > and < par am ali as > < par a m v a lu e > can be repeated to set multiple p arameters in a single command. T able 4-5 lists the driver configuration parameter names and aliases.
4–Non-Interactive Commands Command Summary 4-18 SN0054614-00 K -g (Display System Information) T o view system information, type: # scli -g For details of t his command, see “Display System Information (Command Line Options -g, -z, and -tp)” on p age 4-1 .
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-19 -h (Help) T ype the following text to view the help file: # scli (-h | ?) T ype the following text to view hel p information for an individua l command: # scli < Command Line Parameter > (-h | ?) For example, typing scli -l -h shows: SANsurfer FC/CNA HBA CLI v1.
4–Non-Interactive Commands Command Summary 4-20 SN0054614-00 K Where: T o set an alias for the selected adapter: # scli -ha (< hba instance > | < hba wwpn >) < alias > T o delete t.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-21 # scli -kl (< hba instance > | < hba wwpn >) T o do a loopback test with customized parameters, type: # scli -kl (< hb.
4–Non-Interactive Commands Command Summary 4-22 SN0054614-00 K The data p attern must be in a two-character hexadecimal pattern in the range of 00–FF .
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-23 Dat aS ize (DS) For the loopback test, the dat a size specifies the data (frame payload) size in bytes. The data size is the actual dat a t hat is transferred during any given pass of the test.
4–Non-Interactive Commands Command Summary 4-24 SN0054614-00 K 12 (Windows) 25 (Solaris) 2 (Linux and Macintosh) The default test increment is 1. The test in crement cannot be larger than the number of tests run (see “T estCount (TC)” on pag e 4-23 ).
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-25 T able 4-10 lists the operating system driver versions that do not require a loopback connector .
4–Non-Interactive Commands Command Summary 4-26 SN0054614-00 K # scli - kl < hba instance > DP FF DS 8 TC 500 TI 10 OE 1 Y ou do not have to set each parameter for the loopback test. If you do not specify a paramete r in the command line, the current p arameter value is used.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-27 -kl ( < hba instance > | < hba wwpn >) [{(< param name > | < param alias >) < param value >}] -kl (Run .
4–Non-Interactive Commands Command Summary 4-28 SN0054614-00 K Where: Sections “DataPattern (DP)” o n page 4- 21 through “OnError (OE)” on page 4-24 describe how to change th e default p arameters for both of these test s. “Run a Loopback T est” on page 4-24 cont ains command line examples and test results for a loopback test.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-29 T o do a read/write buffer test using the cu rrent parameters, type: # scli -kr (< hba instance > | < hba wwpn >) T o exc.
4–Non-Interactive Commands Command Summary 4-30 SN0054614-00 K Run Adapter Diagnostics R ead-write Buffer T est The {(-ex | exclude) < target wwpn >} parameters specify a de vice that will be excluded from the read/write buf fer test.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-31 If the read/write buf fer test fails, the system shows the following information : Loop/port ID (the loop ID of the adapter whe n operating in loop mode). Stat us : Success —The test passed.
4–Non-Interactive Commands Command Summary 4-32 SN0054614-00 K Link Failure —Number of link failures Loss of sync —Number of sync loss errors Loss of signal —Number of signal loss .
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-33 Where: T able 4-13 defines the link status p arameter names, aliases, and values. -m (View , En able, or Disable LUNs) hba instan ce .
4–Non-Interactive Commands Command Summary 4-34 SN0054614-00 K Use the -m command to: View all selective L UNs for all adapter ports View an ad apter ’s selective LUN list View the cur.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-35 T o disable (deselect) a LUN on a specific target on a specific a dapter , type: # scli -m (< hba instance > | < hba wwpn &g.
4–Non-Interactive Commands Command Summary 4-36 SN0054614-00 K The pairs < p aram name > < para m v al ue > and < par am ali as > < par a m v a lu e > can be repeated to set multiple p arameters with a single command. T able 4-14 lists the adapter para meter names and aliases.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-37 -o (Output to a File) T o output result and status messages into a file, type -o , followed by the file name.
4–Non-Interactive Commands Command Summary 4-38 SN0054614-00 K Where the file name is systemLUNinfo , all message s are located in the directory indicated for the system plat form: -p (Display Persi.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-39 The following example is a typical SANsurf er FC/CNA HBA CLI output showing all target s currently bound to an adapter: -------------.
4–Non-Interactive Commands Command Summary 4-40 SN0054614-00 K Where: T o unbind all targets on a specific adapter port or on all adapter ports, type: # scli -p (< hba instance > | < hba ww.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-41 -pl (Show , Add, and Delete Persistent Names) This option provides persistent device names for sto rage devices.
4–Non-Interactive Commands Command Summary 4-42 SN0054614-00 K -q (View or Set T arget Link Speed) T ype the following command to view the link speed of all ta rgets att ached to one adapter or all .
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-43 T o set the link speed of selected target(s) a ttached to one adapter to the designated speed, type the f ollowing command: # scli -q.
4–Non-Interactive Commands Command Summary 4-44 SN0054614-00 K Y ou can specify the QoS of the virtual port based on either prio rity , bandwidth speed, or bandwid th percentage, wh ere: Y ou can ch.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-45 -s (Silent Mode) In non-interactive mode, the system shows result and st atus messages generated by SANsurfer FC/CNA HBA CLI (by default) unless suppressed by silen t mode.
4–Non-Interactive Commands Command Summary 4-46 SN0054614-00 K T o show the target information for a spe cific target on a specific ada pter , type: -t (< hba instance > | < hba wwpn >) .
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-47 T o save the current adapter firmware preload t able to a DAT file, enter the following command: # scli -u ( < hba instance > | < hba wwpn > ) save < file name > Where: < hba instance > is the adapter inst ance number of an adapter port.
4–Non-Interactive Commands Command Summary 4-48 SN0054614-00 K # scli -vp (< hba instance > : < hba wwpn >) list <vport wwpn> T o create a virtual port with an automatic WWPN, type.
4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-49 Y ou can use this option with all no n-interactive mode options th at have a corresponding interactive mode option (see T able 4-1 ). This option must be the first or last command in the command line.
4–Non-Interactive Commands Command Summary 4-50 SN0054614-00 K Notes.
SN0054614-00 K A-1 A XML Format 1 Output Part s The -x1 command line option (see “-x (Outpu t in XML Format 1)” on p age 4-48 ) shows all output in XML format 1.
A–XML Format 1 XML Format 1 T ags for Each Option A-2 SN0054614-00 K S t atus Message Before the closing main t ag </QLogic> , SANsurfer FC/CNA HBA CLI shows returning st atus from the execution of the command lin e parameters and the error messages.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-3 “Display Device List (Comm and Line Option -t)” on page A-7 “Display LUN List (Command Line Option -l)” on p age .
A–XML Format 1 XML Format 1 T ags for Each Option A-4 SN0054614-00 K <OSVersion> OS Version (and patches) </OSVersion> <HBA Port="value" WWNN="value" WWPN="va.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-5 For multiple adapters, repeat the preceding sequen ce with the ID number (ID Number="value") of the next adapter . Display HBA Information (Command Line Option -i) The XML Format 1 for adapter g eneral information is as follows: <?xml version="1.
A–XML Format 1 XML Format 1 T ags for Each Option A-6 SN0054614-00 K <GeneralInfo Port="value" Model="value" HBAID="value" HBAALias="" HBAPort="".
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-7 </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Display Device List (Command Line Option -t) The XML Format 1 for adapter d evice information is as follows: <?xml version="1.
A–XML Format 1 XML Format 1 T ags for Each Option A-8 SN0054614-00 K <LUN ID="value" WWULN="value" Vendor ="value" Product ="value" Revision ="value&q.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-9 <HBA> <HBA Port="value" WWNN="value" WWPN="value" /> <Target> <WWNN> Target.
A–XML Format 1 XML Format 1 T ags for Each Option A-10 SN0054614-00 K CRCError="value" DisparityError="value" FrameLengthError="value" Result="value"/> <.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-1 1 BindbyPortID="value" /> /DriverSettings> </HBA> <Status> 0 </Status> <Reboot> 0 </Re.
A–XML Format 1 XML Format 1 T ags for Each Option A-12 SN0054614-00 K <Host> <Name> Host Name </Name> <OSType> OS Type </OSType> <OSVersion> OS Version (and patch.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-13 EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="v.
A–XML Format 1 XML Format 1 T ags for Each Option A-14 SN0054614-00 K Link S t atistics (Command Line Option -ls ) The XML Format 1 for the lin k st atistics option is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-15 DeviceError="value" Reset="value" IOCount="value" IOPS="value" BPS="value" Tim.
A–XML Format 1 XML Format 1 T ags for Each Option A-16 SN0054614-00 K HBA T ransceiver Det ails (Command Line Option -dm) The XML Format 1 for adapter tra nsceiver details (general information) is as follows: <?xml version="1.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-17 <MeasuredTxPowerUnit>(mW)</MeasuredTxPowerUnit> <Value>"value"</Value> <Status>"val.
A–XML Format 1 XML Format 1 T ags for Each Option A-18 SN0054614-00 K <Length-50um> "value" </Length-50um> <Length-62.5um> "value" </Length-62.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-19 <TempHighWarning>"value"</TempHighWarning> <TempLowWarning>"value" </TempLowWarning>.
A–XML Format 1 XML Format 1 T ags for Each Option A-20 SN0054614-00 K <SoftRXRateSelect> "value" </SoftRXRateSelect> <RXRateSelectState> "value" </RXRateSele.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-21 WWPN="value" VendorId="value" Model="value" SerialNumber="value" Alias="value".
A–XML Format 1 XML Format 1 T ags for Each Option A-22 SN0054614-00 K <HBA PortName="value" Host="DataUnavailable"/> </AttachedPort> </PhysicalPort> .
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-23 <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.
A–XML Format 1 XML Format 1 T ags for Each Option A-24 SN0054614-00 K <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.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-25 <Entry No="18" Info="No Data"/> <Entry No="19" Info="No Data"/> </FCoELog.
A–XML Format 1 XML Format 1 T ags for Each Option A-26 SN0054614-00 K Info="No Data"/> <Entry No="9" Info="No Data"/> <Entry No="10" Info="No.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-27 </NumberofTransmittedPacketsEqual64bytes> <NumberofTransmittedPacketsLessThanOrEqual127bytes> 0 </NumberofTransmi.
A–XML Format 1 XML Format 1 T ags for Each Option A-28 SN0054614-00 K <NumberofTransmittedGoodPackets> 0 </NumberofTransmittedGoodPackets> <NumberofTransmittedUnicastPackets> 0 <.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-29 <NumberofReceivedPacketsLessThanOrEqual511bytes> 0 </NumberofReceivedPacketsLessThanOrEqual511bytes> <NumberofRec.
A–XML Format 1 XML Format 1 T ags for Each Option A-30 SN0054614-00 K 0 </NumberofReceivedMulticastPackets> <NumberofReceivedBroadcastPackets> 0 </NumberofReceivedBroadcastPackets>.
A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-31 </NumberofReceivedPer-PriorityPausePackets> </NSLPortStatistics> </HBA> <Status> 0 </Status> <R.
A–XML Format 1 XML Format 1 T ags for Each Option A-32 SN0054614-00 K Notes.
SN0054614-00 K B-1 B XML Format 2 This appendix provides the following info rmation: “Output Parts” on p age B-1 explains the output of XML format 2. “XML Format 2 T ags for Each Option” on p age B-3 lists the XML format 2 tags for each option.
B–XML Format 2 Output Parts B-2 SN0054614-00 K Utility Header The following header information is shown af ter the main tag: <AppName> SANsurfer FC/CNA HBA CLI </AppName> <AppVersion> X.YY.ZZ Build XX</AppVersion> <AppXMLVersion> X.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-3 XML Format 2 T ags for Each Option The following sections describe the XML Format 2 for each command line option: “Display .
B–XML Format 2 XML Format 2 T ags for Each Option B-4 SN0054614-00 K Display System Information (Command Line Option -g) The command format is: scli -g -x2 The XML Format 2 for system information ou.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-5 FrameSize="value" HardLoopId="value" LoopResetDelay="value" EnableHostAdapterBIOS="value".
B–XML Format 2 XML Format 2 T ags for Each Option B-6 SN0054614-00 K HBAPort="value" PortAlias="value" WWNN="value" WWPN="value" PortID="value" Seri.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-7 PortType="value" Status="value" </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Here is the VPD information: <?xml version="1.
B–XML Format 2 XML Format 2 T ags for Each Option B-8 SN0054614-00 K <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <Info Path="value" ID="value".
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-9 </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <Target> sequence repeat s for each LUN attached to the t arget. The LUN list is listed under the targ et, not under the adapter .
B–XML Format 2 XML Format 2 T ags for Each Option B-10 SN0054614-00 K <HBA> <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN=.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-1 1 </HBA> <Status> n </Status> <?ErrorMsg> "message" </ErrorMsg?> <Reboot> n /Reboot> </QLogic> The <HBA> …< /HBA> sequen ce repeat s for each adapter .
B–XML Format 2 XML Format 2 T ags for Each Option B-12 SN0054614-00 K <Status> n </Status> <Reboot> n /Reboot> </QLogic> Diagnostics Result s—Read/Write Buffer T est (Co.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-13 <HBA> <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN=.
B–XML Format 2 XML Format 2 T ags for Each Option B-14 SN0054614-00 K The command format is: scli -z (< hba instance > | < hba wwpn > | all) -x2 The XML Format 2 for all adapter informat.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-15 PortType="value" Status="value" /> <Param ConnectionOption="value" <VPD> <VPD Produ.
B–XML Format 2 XML Format 2 T ags for Each Option B-16 SN0054614-00 K <TargetBinding TargetWWNN="value" TargetWWPN="value" TargetPortID="value" TargetID="value&.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-17 <HBA> <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN=.
B–XML Format 2 XML Format 2 T ags for Each Option B-18 SN0054614-00 K HBA Alias (Command Line Option -ha) The command format is: scli -ha (< hba instance > | < hba wwpn >) view | ? -x2 T.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-19 The XML Format 2 for adapter tra nsceiver details (detailed inf ormation) is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>v1.
B–XML Format 2 XML Format 2 T ags for Each Option B-20 SN0054614-00 K <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"&l.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-21 <Diagnostics> <Temperature> <MeasuredTemperature>(C)</MeasuredTemperature> <Value>"value".
B–XML Format 2 XML Format 2 T ags for Each Option B-22 SN0054614-00 K The XML Format 2 for adapter tra nsceiver details (general information) is as follows: # scli -dm (< hba instance > | <.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-23 <TX_DisableImplementedAndDisablesSerialOP> "value"</TX_DisableImplementedAndDisablesSerialOP> <RATE_Sel.
B–XML Format 2 XML Format 2 T ags for Each Option B-24 SN0054614-00 K <RXPowerLowWarning>"value"</RXPowerLowWarning> <Rx_PWR-4>"value"</Rx_PWR-4> <Rx_P.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-25 <TXPowerHighWarning> "value" </TXPowerHighWarning> <TXBiasLowWarning> "value" </TXBiasL.
B–XML Format 2 XML Format 2 T ags for Each Option B-26 SN0054614-00 K BeaconStatus="value" <PhysicalPortInformation> <PhysicalPortNumber="value"> <Port WWPN=".
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-27 Display FCoE Information The XML Format 2 for FCoE information outpu t is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.
B–XML Format 2 XML Format 2 T ags for Each Option B-28 SN0054614-00 K <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-29 <Entry No="16" Info="No Data"/> <Entry No="17" Info="No Data"/> <Entry No.
B–XML Format 2 XML Format 2 T ags for Each Option B-30 SN0054614-00 K Info="No Data"/> <Entry No="7" Info="No Data"/> <Entry No="8" Info="No .
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-31 </NumberofTransmittedPacketsLessThan64bytes> <NumberofTransmittedPacketsEqual64bytes> 0 </NumberofTransmittedPack.
B–XML Format 2 XML Format 2 T ags for Each Option B-32 SN0054614-00 K <NumberofTransmittedBytesforGoodPackets> 0 </NumberofTransmittedBytesforGoodPackets> <NumberofTransmittedGoodPack.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-33 <NumberofReceivedPacketsLessThanOrEqual255bytes> 0 </NumberofReceivedPacketsLessThanOrEqual255bytes> <NumberofRec.
B–XML Format 2 XML Format 2 T ags for Each Option B-34 SN0054614-00 K 0 </NumberofReceivedUnicastPackets> <NumberofReceivedMulticastPackets> 0 </NumberofReceivedMulticastPackets> &.
B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-35 </NumberofReceived_802_3x_PauseControlPackets> <NumberofReceivedPer-PriorityPausePackets> 0 </NumberofReceivedPer.
B–XML Format 2 XML Format 2 T ags for Each Option B-36 SN0054614-00 K Notes.
SN0054614-00 K C-1 C Error/Exit Return Codes T o list the error/exit return codes while running SANsurfer FC/CNA HBA CLI in interactive mode: 1. From the Main Menu , select the Help option, and then press ENTER . 2. On the Help Men u , select Exit Codes , and then press ENTER .
C–Error/Exit Return Codes C-2 SN0054614-00 K 8 ERROR_NO_HBA Unable to open the adapter handle 9 ERROR_UNKNOWN_HBA Adapter is unknown to SANsurfer FC/CNA HBA CLI 10 ERROR_INV ALID_SSID Ad apter has i.
C–Error/Exit Return Codes SN0054614-00 K C-3 30 ERROR_INCORRECT_RISC_CODE _FILE Incorrect RISC image 31 ERROR_INCOR RECT_BOOT_CODE_FILE Incorrect BIOS/FCode boot image 32 ERROR_INCORRECT_FULL_IMAGE_.
C–Error/Exit Return Codes C-4 SN0054614-00 K 49 Reserved Not used 50 ERROR_FC_LINK_UNKNOWN_ST A TUS Error getting FC link status 51 ERROR_RESET_LINK_ST A TUS Unable to reset adap ter link sta tus 52.
C–Error/Exit Return Codes SN0054614-00 K C-5 72 ERROR_NO_SP ACE_LEFT Command failed because no space lef t on the drive 73 ERROR_MISSING_TEMPLA TE_FILE Un able to find template file 74 Reserved Not .
C–Error/Exit Return Codes C-6 SN0054614-00 K 94 ERROR_T ARGET_NO_DIRECT_ACCESS Boot device settings failed because the boot target is no t a direct access device 95 ERROR_INV ALID_BOOT_SETTINGS Boot.
C–Error/Exit Return Codes SN0054614-00 K C-7 1 17 ERROR_DELETE_T ARGET_PERSISTENT_ ENTRY Failed to delete tar get persistent binding 11 8 ERROR_LUN_NOT_FOU ND S pecified L UN ID not available 1 19 E.
C–Error/Exit Return Codes C-8 SN0054614-00 K 140 ERROR_UNKNOWN_FILE_FORMA T Unable to determine file format 141 ERROR_READ_DRV_VER _SYS_FILE Failed to read driv er version from sys file 142 ERROR_IN.
C–Error/Exit Return Codes SN0054614-00 K C-9 163 ERROR_NO_SN_VPD Serial numb er is missing in V PD data 164 ERROR_RETRIEVE_VPD_DA T A Failed to read VPD of selected adapter 165 ERROR_UNSUPPORT_VPD_O.
C–Error/Exit Return Codes C-10 SN0054614-00 K 189 IBM Reserved Blocked 190 IBM Reserved Blocked 191 IBM Reserved Blocked 192 IBM Reserved Blocked 193 Reserved Not used 194 Reserved Not used 195 Rese.
C–Error/Exit Return Codes SN0054614-00 K C-1 1 216 ERROR_SET_SWITCH_IP_ADDRESS Failed to set switch IP address 217 ERROR_INV ALID_SWITCH_INP UT Inva lid switch p a rameters settings 218 ERROR_INV AL.
C–Error/Exit Return Codes C-12 SN0054614-00 K 239 Reserved Not used 240 ERROR_NO_T ARGET_S ELECTED Unable to run target beacon be cause no device i s sel ected 241 ERROR_GET_BEACON_ST A TE Unable to.
C–Error/Exit Return Codes SN0054614-00 K C-13 264 Reserved Not used 265 Reserved Not used 266 Reserved Not used 267 Reserved Not used 268 Reserved Not used 269 Reserved Not used 270 ERROR_ADAPTER_PR.
C–Error/Exit Return Codes C-14 SN0054614-00 K 288 Reserved Not used 289 Reserved Not used 290 Reserved Not used 291 ERROR_VIRTUAL _HBA_LO CKED vPort is currently locked 292 ERROR_VPORT_NOT_BELONG_T .
C–Error/Exit Return Codes SN0054614-00 K C-15 312 ERROR_GET_MENLO_ETH_MONITORING Failed to quer y FCoE Ethernet port st atis- tics 313 ERROR_GET_MENLO_FC_MONITORING Failed to query FCoE FC port stat.
C–Error/Exit Return Codes C-16 SN0054614-00 K 335 Reserved Not used 336 Reserved Not used 337 Reserved Not used 338 Reserved Not used 339 Reserved Not used 340 ERROR_GET_UDEV_NAME Unable to query ud.
C–Error/Exit Return Codes SN0054614-00 K C-17 356 Reserved Not used 357 Reserved Not used 358 Reserved Not used 359 Reserved Not used 360 ERROR_FW_SERDES_UPDA TE_F AILURE Unable to update firmware S.
C–Error/Exit Return Codes C-18 SN0054614-00 K 378 ERROR_QOS_PERCENT AGE_OVERFLOW Failed to apply changes on selected port (QoS bandwidth over flow) 379 ERROR_VPORT_DISABLE_ QOS_SETTING Failed to app.
C–Error/Exit Return Codes SN0054614-00 K C-19 449 Reserved Not used 450 ERROR_IL T_SIGNA TURE_MISMA TCH The image layout tab le (IL T) signature does not match 451 ERROR_INCORRECT_FCOE_FLASH_ IMAGE .
C–Error/Exit Return Codes C-20 SN0054614-00 K 473 Reserved Not used 474 Reserved Not used 475 Reserved Not used 476 Reserved Not used 477 Reserved Not used 478 Reserved Not used 479 Reserved Not used 480 ERROR_GET_DCBX_P AR AMETERS Failed to get DCBX TL V T able C-1.
SN0054614-00 K D-1 D Help Commands T able 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, scl i -g and scli /g are both valid commands.
D–Help Commands D-2 SN0054614-00 K <target wwpn> World wide port nam e of a target device. ( xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx ). <vport hex> Worl d wide port name of the virt ual po rt with the two hexadeci- mal digits in byte three suppli ed by the user .
D–Help Commands SN0054614-00 K D-3 –d <file n ame > Performs a driver update to the adapters. <file name> is the full path o f the driver file in inf/zip or exe format.
D–Help Commands D-4 SN0054614-00 K –e ( <hba instance> | <hba wwpn> <target wwnn> <target wwpn> <lun id> [ prim | alt1 | alt2 | alt3] Configures the operating system .
D–Help Commands SN0054614-00 K D-5 –fs ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Configures the driver settings.
D–Help Commands D-6 SN0054614-00 K –ls ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Shows the current link status on an adapte r port. –m ( <hba instan ce> | <hba wwpn> ) ( view | ? ) Views selective LUN information of all devices att ached to an adapter port.
D–Help Commands SN0054614-00 K D-7 –p ( <hba instance> | <hba wwpn> ) { <target wwnn> <target wwpn> <target portid> <target id> } Binds the selected device(s) att ached to an adapter port.
D–Help Commands D-8 SN0054614-00 K –q ( <hba instance> | <hba wwpn> | <all> ) [ –targets | –t ] Shows the current iiDMA settings of all t ar- gets on an ad apter port or all adapters.
D–Help Commands SN0054614-00 K D-9 -u ( <hba instan ce> | <hba wwpn> ) save <file name> Saves the current a dapter firmware preload area to a DAT file. –v — Shows the current version. –vp ( <hba instance> | <hba wwpn> ) create <vport hex> Creates a virtual port with your own WWPN.
D–Help Commands D-10 SN0054614-00 K Notes.
SN0054614-00 K Glossary-1 Glossary adapter The board that interfaces between the host system and the t arget devices. Adapter is synonymous with host bus adapter (HBA) , host channel adapter (HCA) , host adapter , and adapter board . adapter alias A user-defined name for an adapter .
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-2 SN0054614-00 K boot device The device, usually the hard disk, that contains the operating system th e BIOS uses to boot from when the computer is started.
SN0054614-00 K Glossary-3 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters DCB Data center bridging. Provides enh ance- ments to existin g 802.1 bridge specifica- tions to satisfy the requiremen ts of protocols and applicatio ns in the dat a center .
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-4 SN0054614-00 K fabric loop port See FL_Port .
SN0054614-00 K Glossary-5 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters input/output control See IOCTL . intelligent interleaved direct memory access See iiDMA . inter-switch link See ISL . IOCTL Input/output control.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-6 SN0054614-00 K Using LUNs, the FC host can address multiple peripheral devices that may share a common controller .
SN0054614-00 K Glossary-7 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters other NL_Ports in virtual point-to-point links through an FC_AL open loop circuit often through FC_AL (arbitrated loop) open loop circuit of ten through FC-AL hub or loop switch devices.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-8 SN0054614-00 K port inst ance The number of the port in the system. Each adapter may have one or multiple ports, identified with regard to the adapter as port 0, port 1 and so forth.
SN0054614-00 K Glossary-9 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters TL V T ype-length-value (TL V) is optional infor- mation that may be encoded as an element inside the protocol. The type and length fields are fixed in size (typically 1 to 4 bytes), and the value field is of variable size.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-10 SN0054614-00 K Notes.
SN0054614-00 K Index-1 Index Numerics 1 bit serial loopback test 3-82 10 bit internal loopback test 3-82 A -a 3-75 , 4-6 abort changes to adapter p arameters 3-32 about the product 3-121 adapter alias.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-2 SN0054614-00 K AL_P A definition of Glossary-1 in adapter parameter templa te 3-66 AL, definit.
SN0054614-00 K In dex-3 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters commands ( continued ) -a 3-75 , 4-6 -b 3-10 , 3-65 , 4-7 -c 3-21 , 3-26 , 4-8 .
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-4 SN0054614-00 K current settings adapter statistics 3-91 link status 3-94 customer support xvii.
SN0054614-00 K In dex-5 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters -dm 3-76 , 3-85 , 4-10 , A-16 , B-20 documentatio n conventions used in guide x.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-6 SN0054614-00 K FCoE adapter information 3-1 12 data center bridging 3-1 12 TL V , viewing 3-1 .
SN0054614-00 K In dex-7 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters hard loop ID configuring 3-26 enabling 4-36 specifying 3-29 HardLoopID paramete.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-8 SN0054614-00 K J JBOD (just a bunch of disks), definition of Glossary-5 K -kl 3-76 , 3-77 , 4-.
SN0054614-00 K In dex-9 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters LoopbackT ype parameter 4-24 loop-only connection 3-28 -ls 3-89 , 3-93 , 4-32 ,.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-10 SN0054614-00 K non-interactive mode ( continued ) starting 2-4 non-volatile random access mem.
SN0054614-00 K Index-1 1 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters port ( continued ) listing 3-99 quality of service 4-43 user-generated 3-100 p.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-12 SN0054614-00 K SANsurfer FC HBA CLI ( continued ) software requireme nts 1-5 supported QLogic.
SN0054614-00 K Index-13 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters target beacon, st arting and stopping 4-46 binding 3-57 binding info, viewing 4.
SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-14 SN0054614-00 K uninstall Linux 1-22 Macintosh 1-24 Solaris SP ARC 8, 9, and 10 1-22 Solaris x.
SN0054614-00 K Index-15 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters world wide node name, See WWNN world wide port name, See WWPN WWNN definition o.
© 2004–2009 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLogic, the QLogic logo, QLA, and SANsurfer are register ed trademarks of QLogic Cor poration. Apple, Finder , Mac OS, Macintosh, Power Mac, Panther , Tiger , and Safari are registe red trademarks of Ap ple, Inc.
An important point after buying a device Q-Logic FC0E (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Q-Logic FC0E yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Q-Logic FC0E - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Q-Logic FC0E you will learn all the available features of the product, as well as information on its operation. The information that you get Q-Logic FC0E will certainly help you make a decision on the purchase.
If you already are a holder of Q-Logic FC0E, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Q-Logic FC0E.
However, one of the most important roles played by the user manual is to help in solving problems with Q-Logic FC0E. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Q-Logic FC0E along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
