Q-Logic FC HBA CLI manual

Simplify R SN0054614-00 F Page i SANsurfer FC HBA CLI User ’ s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters[...]

Page ii SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters © 2004–2008 QLogic Corporation. All Rights Reserved Worldwide. First Published: March 2004 QLogic Corporation, 26650 Aliso Viejo Parkway , Al iso V iejo, CA 92656, (800) 662-4471 or (94 9 ) 389- 6000 Information fu rni[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page iii A Changed HBA No . to HBA Instance .A l l Changed SFF DMI to HBA transceiver details .A l l Updated supported QLogic HBA list. Section 1.3 Updated supported oper ating system list. Section 1.4 All non-interactive informat[...]

Page iv SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Changed bullet s describing interactive and non-interactive modes. Section 2.2 , Section 2.3 Clarified the note about st arting SANsurfer FC HBA CLI on a Solaris console seri al po rt . Section 2.2 Added Macintosh column [...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page v A Expanded Save/Update Flash section to list which OSs and HBAs save/update fla sh, BIOS, or the option ROM image. Section 4.10 Added desc ription and pr eparation instruc tions for loopback and r ead/write buf fer tests. A[...]

Page vi SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Configure HBA Settings (-n): a dded option to restore the BIOS (QLA/QLE/QEM24 xx HBAs). 4.7.1 , Section 5.3.22 Selective LUNs (command line option -m): adde d ALL option to command line to view all selective LUNs for all [...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page vii A Revision D Changes: Operating systems supported: Windows 2003 Server ™ and Enterpr ise Server: added x64; removed IEM64T an d AMD64. Added Windows ® XP . Red Hat™ Linux ® AS: added x86_64; removed IEM64T and AMD64[...]

Page viii SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters The following options and commands were ch anged in Rev . D: Interactive mode commands : Ch anged instructions and the example text to new port sorting and num- bering scheme. No chan ge to command function. Non-interac[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page ix A Display LUN List (-l): In interactive mode, added t arget type to infor- mation displayed. Removed a sset tag and en d tag from list of VPD information. In example text, changed the first two option names of the Selectiv[...]

Page x SN0054614- 00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Notes[...]

SN0054614-00 F Page xi T able of Content s Section 1 Introduction 1.1 Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.2 Guide Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.2.1 How this Guide is Organized . . . . . . . . . . [...]

Page xii SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S 3.3 Uninstalling SANsu rfer FC HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 3.3.1 Windows Uninst all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13 3.3.1.[...]

SN0054614-00 F Page xiii SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A 4.4 T arget/LUN List Menu (Comma nd Line Options -t and -l) . . . . . . . . . . . . . . 4-30 4.4.1 T arget/LUN List (Per HBA Port) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31 4.4.1.1 Per T arget/LU[...]

Page xiv SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S 4.8 Boot Device Menu (Command Line Op tion -e) . . . . . . . . . . . . . . . . . . . . . . 4-51 4.8.1 HBA Port Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52 4.8.1.1 Boot De[...]

SN0054614-00 F Page xv SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A 4.13.2 Link S tatus (Command Line Option -ls) . . . . . . . . . . . . . . . . . . . . . . . . 4-80 4.13.2.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-80 4.13.2.2 Show L[...]

Page xvi SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S 5.3.16 -kl (Loopback T est) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17 5.3.16.1 DataPattern (DP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18 5.3.16[...]

SN0054614-00 F Page xvii SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A A.2.3 Display HBA Information (Command Line Option -i) . . . . . . . . . . . . . . A-4 A.2.4 Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . A-6 A.2.5 Display LUN List (Command Line Opt[...]

Page xviii SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S B.8.7 Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . B-16 B.8.8 Display All Information for One or All HBAs (Command Line Option -z) . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

SN0054614-00 F Page xix SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A List of Figures Figure Page 3-1 Preparing to I nstall Dialo g Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 3-2 W elcome Dialog Box . . . . . . . . . . . . . . . . . . . . . .[...]

Page xx SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S Notes[...]

SN0054614-00 F PRELIMINARY 1-1 Section 1 Introduction 1.1 Product Overview The SANsurfer ® FC HBA CLI tool provides a command line interface (CLI) that lets you easily inst all, c onfigure, and deploy QLogic ® Fibre Channel (FC) host bus adapters (HBAs). It also provides robust diagnostic and tro ubleshooting capabilities an d useful statistica l[...]

1 – Introduction Guide Overview 1-2 PRELIMINARY SN0054614-00 F S Section 2 Getting St arted : This section describes the two modes used in SANsurfer FC HBA CLI: interactive and non-interactive . It also explains some special terms used in this guide. Section 3 Initial Inst allation : This section provides step-by-step instructions for installing [...]

1 – Introduction Guide Overview SN0054614-00 F PRELIMINARY 1-3 A # scli -z  T ext in ALL CAPIT ALS usually 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. For example: Atta[...]

1 – Introduction Supported QLo gic HBAs 1-4 PRELIMINARY SN0054614-00 F S 1.3 Supported QLogic HBAs SANsurfer FC HBA CLI is supported for the followin g QLogic HBAs:  QLA234 x  QLA2 xx  QLE2 xx  QLE246 x  QLA246 x  QLE256 x 1.4 Supported Operating Systems SANsurfer FC HBA CLI is supported on the fo llowing operating systems:  [...]

1 – Introduction System Requirements SN0054614-00 F PRELIMINARY 1-5 A  Solaris x86 9/10 (with latest p atches)  Apple ® Macintosh ®  Mac OS ® X 10.3.x (PowerPC ® (PPC)), 10.4.x (PPC/Intel), and 1.5.x (PPC/Intel)  VMware ®  VMware ESX Server 3.5 1.5 System Requirement s The hardware and sof tware requirement s for SANsurfer FC [...]

1 – Introduction System Requirement s 1-6 PRELIMINARY SN0054614-00 F S  256 MB physical RAM are required to run SANsurfer FC HBA CLI; running with less memory can caus e disk swapping (“p aging” or “p aging out”), which severely affects performance.  Video car d capable of 256 colors and a screen resolution of 800x 600 pixels.  A[...]

1 – Introduction T echnical Support SN0054614-00 F PRELIMINARY 1-7 A 1.5.2.1.2 Features Not A vailable Wh en Running ioctl Module Driver When running the input/out put control (ioctl) module driver on a Linux OS, the following features are not available:  Persistent binding  Selective LUN  HBA port statistics  Driver settings  Host[...]

1 – Introduction Contact Information 1-8 PRELIMINARY SN0054614-00 F S Visit the QLogic support Web site at: support.qlog ic.com for the latest firmware and product updates. 1.6.1 A vailability QLogic T echnical Support for product s under warranty is available during local standard working hours exclud ing QLogic Observed Holidays. 1.6.2 Tr a i n[...]

1 – Introduction Contact Information SN0054614-00 F PRELIMINARY 1-9 A Europe, Middle East, and Africa Region E-mail emeasupport@qlogic.com Phone Numbers by Languag e +353 1 6924960 – English +353 1 6924961 – Fran çais +353 1 6924962 – Deut sch +353 1 6924963 – Esp añol +353 1 6924964 – Port uguês +353 1 6924965 – It aliano Asia Pac[...]

1 – Introduction Contact Information 1-10 PRELIMINARY SN0054614-00 F S Notes[...]

SN0054614-00 F PRELIMINARY 2-1 Section 2 Getting S t arted 2.1 Introduction SANsurfer FC HBA CLI operates in two mo des:  Interactive (menu-drive n). The CLI st arts, and then waits for and executes input commands until terminated by the user . Use this mode to do multiple operations. Section 4 Interactive Commands covers this interface.  Non[...]

2 – Getting S tarted S tarting Interactive Mode 2-2 PRELIMINARY SN0054614-00 F S 3. Run SCLI commands as required. 4. When finished, return to th e main menu, and type the indicated number to quit SANsurfer FC HBA CLI. 5. Close the terminal window . The Main Menu appears as sh own in the following: SANsurfer FC HBA CLI v1. x.x Build xx Main Menu [...]

2 – Getting S tarted S tarting Non-in teractive Mode SN0054614-00 F PRELIMINARY 2-3 A 2.3 S t arting Non-interactive Mode T o start SANsurfer FC HBA CLI in non-in teractive mode, type the f ollowing in a command window: scli < Parameters > SANsurfer FC HBA CLI executes the command options, t hen terminates. T o list all of the available com[...]

2 – Getting S tarted S tarting Non-inte ractive Mode 2-4 PRELIMINARY SN0054614-00 F S . T able 2-1. Non-interactive Mode Options CLI Option Interactive Menu (Windows) Interactive Me nu (Red Hat/SuSE Linux, Solaris SP ARC) Interactive Menu (Macinto sh) Description Section -a 1 1 1 1 1 1 Flash HBA beacon 5.3.1 -b 10 10 — Save/update BIOS/F Code a[...]

2 – Getting S tarted S tarting Non-in teractive Mode SN0054614-00 F PRELIMINARY 2-5 A 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. These options, however , can be combined with one or m[...]

2 – Getting S tarted Te r m i n o l o g y 2-6 PRELIMINARY SN0054614-00 F S 2.4 T erminology Some of the terms used in this guide are similar and some ha ve changed slightly as technology changes. The following definitions apply: HBA Port HBA Port refers to the actual physical port on a n HBA. For example, a QLA2462 has two port s called HBA port [...]

SN0054614-00 F 3-1 Section 3 Initial Inst allation Before you run SANsurfer FC HBA CLI, ensu re that the following requirements are met:  The HBAs must be installed.  The HBA drivers must be installed . 3.1 Downloading the Inst allation Package T o download the SANsurfer FC HBA CLI installation package fro m the QLogic Web site, fo llow these[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI 3-2 SN0054614-00 F S 3.2 Inst alling SANsurfer FC HBA CLI Follow the installa tion instructions in the section that corresponds to your operating system (OS):  Windows—See section 3.2.1 .  Linux—See section 3.2.2 .  Solaris—See section 3.2.3 .  Macintosh—See sectio n 3.2[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-3 A Figure 3-2 Welcome Dialog Box 2. Read the information, and then click Next . The Choose Destination Location d ialog box appears as shown in Figure 3-3 . Figure 3-3 Choose Destinat ion Location Dialog Box 3. In the Choose Destination Location dia log box, do one of the [...]

3 – Initial Installation Installing SANsurfer FC HBA CLI 3-4 SN0054614-00 F S  T o select a different location: a. Click Browse . b. Select an insta llation location. c. The Choose Destination Location dialog box reappears. Click Next . The Ready to Inst all the Program dialog box appears as shown in Figure 3-4 . Figure 3-4 Ready to Inst all t[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-5 A If you want to stop the installation, click Cancel . The Inst allShield Wizard Complete dialog box appears as shown in Figure 3-6 . Figure 3-6 InstallShield Wi zard Compl ete DIalog Box 5. (Optional.) Select one of the fo llowing:  If you want to see more informat io[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI 3-6 SN0054614-00 F S By default, SANsurfer FC HBA CLI is inst alled in the following directory: Program filesQLogic CorporationSANsurferCLI If you want to change the default location, enter the directory in the command line; for example: scli-1. x . x - xx .windows.exe installdir="c:[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-7 A T o create a response file for a silent installa tion of SANsurfer FC HBA CLI, enter the following: scli-1. x . x - xx .windows.exe /r /f1"C:Tempinstall_1.iss" T o run the installation in silent mode with a log file, enter the following: scli-1. x . x - xx .[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI 3-8 SN0054614-00 F S T o query for the installed SANsurfer FC HBA CLI p ackage name, enter the following text from the command line: rpm -q scli 3.2.3 Solaris Inst allation T o install SANsurfer FC HBA CLI on Solaris, follow the step s in one of these sections:  Solaris SP ARC 8, 9, 10?[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-9 A 5. The pkgadd program does a se ries of checks, and then posts a script warning and asks whether to continue the in stallation. For example: Processing package instance <QLScli> from </space/chuynh/scli/qlogic/Solaris/pkgs/x> QLogic SANsurfer FC CLI (HBA Con[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI 3-10 SN0054614-00 F S 2. T o uncompress the file, type the following: # uncompress scli- x.xx.xx-xx .x86.Solaris.pkg 3. T o see the available package file, type the following: # ls The available p ackages appear . For example: # scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg 4. T o install SANsurfer[...]

3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-1 1 A . [ verifying class <none>] ## Executing postinatall script. Installation of <QLSclix> was successful. 3.2.4 Macintosh Inst allation T o install SANsurfer FC HBA CLI, follow either the standard GUI or command line installation met hod:  S tandard (GUI) [...]

3 – Initial Installation Uninstalling SANsurfer FC HBA CLI 3-12 SN0054614-00 F S tar -zxvf <file>.tgz For example: qlogic:~ root#tar -zxvf scli-x.x.x-x.macos.pkg.tgz ./scli-x.x.x-x.pkg/ ./scli-x.x.x-x.pkg/Contents/ ./scli-x.x.x-x.pkg/Contents/Archive.bom ./scli-x.x.x-x.pkg/Contents/Archive.pax.gz ... ... This command extracts the compressed[...]

3 – Initial Installation Uninstalling SANsurfer FC HBA CLI SN0054614-00 F 3-13 A 3.3.1 Windows Uninst all T o uninstall SANsurfer FC HBA CLI, use either the st andard GUI or command lin e method:  S tandard (GUI) uninst all—See section 3.3.1.1  Command line uninst all—See section 3.3.1.2 3.3.1.1 S t andard (GUI) Uninstall T o uninstall [...]

3 – Initial Installation Uninstalling SANsurfer FC HBA CLI 3-14 SN0054614-00 F S  Solaris SP ARC 8, 9, 10—See sectio n 3.3.3.1 .  Solaris x86 8, 9, 10—See sectio n 3.3.3.2 . 3.3.3.1 Solaris SP ARC 8, 9, and 10 Uninstall Follow these steps t o uninstall SANsurfer FC HBA CLI: 1. T ype the following to remove SANsurfer FC HBA CLI: # pkgrm [...]

3 – Initial Installation Uninstalling SANsurfer FC HBA CLI SN0054614-00 F 3-15 A 2. The program shows the package na me and a script warning asking whether to continue the uninst all process. For example: The following package is currently installed: QLSclix QLogic SANsurfer FC CLI (HBA Configuration Utility) (x86) 1.x.x Build xx Do you want to r[...]

3 – Initial Installation Uninstalling SANsurfer FC HBA CLI 3-16 SN0054614-00 F S Notes[...]

SN0054614-00 F 4-1 Section 4 Interactive Commands This section describes the interactive mode command line optio ns for specific QLogic FC HBAs. The interactive mode us es a serie s of menus from which you select the option you want and enter the n umber for that option. (See Section 5 for non-interactive mode opera tion in which you simply enter a[...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-2 SN0054614-00 F S Selections from the Main Menu open new menus. For example, if you click item 1 ( General Information ) on the main interactive menu, the system shows a new menu, the General Information Menu . From this menu you ha ve several choices includ ing 1: Ho[...]

4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-3 A  OS version (patches where a pplicable)  SDM API version  A list of HBAs including, for each HBA:  HBA model and serial numb er (SN)  Port number  WWPN  HBA Instance number  S tatus (online/of fline)  (Repeats for ea ch [...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-4 SN0054614-00 F S This option shows you the HBA Host T opology menu. From the General Information Men u , type the number for Host Topology , and then press ENTER. When you select this optio n, the following options appear:  Display  Save As Txt file  Save As[...]

4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-5 A  Interconnect element (HBA)  Ty p e  World wide nod e name  World wide port name  V endor ID  HBA Model  HBA Serial Number  HBA Alias  Port Alias  Driver V ersion  Firmware V ersion  T otal Number of Devices [...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-6 SN0054614-00 F S Here is an example: ================================= = InterConnect Element = ================================= 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 H[...]

4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-7 A Port Name : 20-01-00-C0-DD-00-6A-9F Port state : Offline Port Type : Vendor Specific/Reserved Port Type. TX Port Type : Electrical - EL Port Module Type : GBIC ======================== = Attached Port = ======================== Target/Initiator : [...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-8 SN0054614-00 F S ================================= Type : HBA World Wide Node Name : 20-00-00-E0-8B-85-8C-7C World Wide Port Name : 21-00-00-E0-8B-85-8C-7C Vendor Id : QLogic Corporation HBA Model : QLA2462 HBA Serial Number : FFC0551D59564 HBA Alias : Port Alias : D[...]

4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-9 A Topology has been successfully saved to file BRAGI_topology_06152007_093855.xml 4.1.2.3.2 Save to XML File – Format 2 (Command Line Option -x2) 1: General Information  2: Host T opology  3: Save As XML File  2: Save As XML File form at [...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-10 SN0054614-00 F S  HBA General Information  Host Name  HBA Instance  HBA Model  HBA Description  HBA ID  HBA Alias  HBA Port  Port Alias  N ode Name (WWNN)  P ort Name (WWPN)  Port ID  Serial Number  Driver V ersion  BIOS [...]

4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-1 1 A  HBA Parameters Settings Header (Command Line Optio ns -c)  HBA Instance  HBA Part Number  Port Number  WWPN  Port ID  HBA Parameter Settings  Connection Options  Data Rate (QLA23 xx , QLA24 xx , QLE23 xx , and QLE24 x[...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-12 SN0054614-00 F S  HBA Part Number  Port Number  WWPN  PORT ID  Device/LUNs Information (Repeat s for each LUN)  Path  T arget  Device ID  Product V endor  Product ID  Product Revision  Serial number  Node name  Port Name [...]

4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-13 A  Primary Boot Port Address  Alternate 1 Boot Port Name  Alternate 1 Boot Port Address  Alternate 2 Boot Port Name  Alternate 2 Boot Port Address  Alternate 3 Boot Port Name  Alternate 3 Boot Port Address An example follows: S[...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-14 SN0054614-00 F S Port Name : 2 1-01-00-E0-8B-23-55-7C Port ID : 1 1-06-00 Serial Number : C 28437 Driver Version : S CSI Miniport 8.1.5.15 (W2K IP) BIOS Version : 1 .83 Firmware Version : 2 .02.03 Actual Connection Mode : P oint to Point Actual Data Rate : 1 Gbps Po[...]

4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-15 A Present targets that are persistentl y bound Only : Disable -------------------------------- Driver Settings - Group: Binding -------------------------------- Bind by World Wide Port Name : Enable Bind by Port ID : Disable -----------------------[...]

4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-16 SN0054614-00 F S LUN Count(s) : 1 Status : O nline ------------------------------------ ------------------------ ------------------------------------ --- LUN 0 ------------------------------------ --- Product Vendor : S EAGATE Product ID : S T118273 CLAR18 Product R[...]

4 – Interactive Com m a nd s HBA Information Menu ( Co mmand Line Option -i) SN0054614-00 F 4-17 A (Primary ) Boot Port Name LUN ---------------------------- --- --- 00-00-00-00-00-00-00-00 0 ---------------------------- --- --- (Alternate 1) Boot Port Name LUN ---------------------------- --- --- 00-00-00-00-00-00-00-00 0 -----------------------[...]

4 – Interactive Comma nds HBA Information Menu (Command Line Option -i) 4-18 SN0054614-00 F S  [additional port(s) as appropriate]  Additional HBAs (as appropriate)  All HBAs Here is an example of a typical HBA Information Menu screen . In this example, the host includes three HBAs with two ports each: HBA Model 2200: 1: Port 1: WWPN: 21[...]

4 – Interactive Com m a nd s HBA Information Menu ( Co mmand Line Option -i) SN0054614-00 F 4-19 A  HBA Model  WWNN  Serial number  Alias With this option you can create, modify , or delete the symbolic name o r alias , for an HBA. From the Main Menu, follow these step s: 1. T ype the number for the HBA Information option and press EN[...]

4 – Interactive Comma nds HBA Information Menu (Command Line Option -i) 4-20 SN0054614-00 F S The HBA Port Alias option allows you to cr eate, modify , or delete a symbolic name (Alias) for the specified HBA port. Follow these steps t o create, modify , or delete an HBA port alias: 1. From the Main Menu, type the number for the HBA Informati on o[...]

4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-21 A  EFI Driver V ersion  Firmware V ersion  BIOS V ersion (Windows and Linux)  FCode V ersion (Solaris) If the HBA does not support VPD, the following messag e appears: VPD not supported on current HBA 6! 4.2.2 HBA Information (All HBAs) 2: HBA Information  n: All[...]

4 – Interactive Comma nds HBA Parameters Menu 4-22 SN0054614-00 F S  All HBAs Here is an example of an HBA Information Menu screen. In this example, the host includes three HBAs with two port s each and one HBA with a single port: HBA Model QLA2342: 1. Port 1 WWPN 21-00-00-EO-8B-01-43-9B Online 2. Port 2 WWPN 21-01-00-E0-8B-21-43-9B Online HBA[...]

4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-23 A  Execution Throttle  Login Retry Count  Enable LIP Reset  Port Down Retry Count  Enable LIP Full Login  Link Down T imeout (seconds)  Enable T arget Reset  LUNs Per T arget  Enable Receive Out Of Order Frame 4.3.1.2 Configure HBA Parameters (Command[...]

4 – Interactive Comma nds HBA Parameters Menu 4-24 SN0054614-00 F S T able 4-1. HBA Parameters Settings (NVRAM) Parameter Name Alias V alue Description ConnectionOption CO 0–3 See table n ote 1. DataRate DR 0–4 See table n ote 2. EnableBIOS EB 0, 1 See table notes 3, 4. EnableExtendedLogging EL 0, 1 See table notes 3, 4. EnableFCTape EF 0, 1 [...]

4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-25 A 4.3.1.2.1 Connection Options 3: HBA Parameters  1: Port Number  2: Configure HBA Parameters  n. Connectio n Options From this menu, you can conf igure the connection o ptions:  0–Loop Only  1–Point to Point Only  2–Loop Preferred, Otherwise Point-to-Po[...]

4 – Interactive Comma nds HBA Parameters Menu 4-26 SN0054614-00 F S  Frame Size: 512  Frame Size: 1024  Frame Size: 2048 T ype the number for the frame size you want and press ENTER. 4.3.1.2.4 Hard Loop ID 3: HBA Parameters  N: Port Number  2: Configure HBA Parameters  n. Hard Loop ID This option prompts yo u to enter a valid Ha[...]

4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-27 A 4.3.1.2.9 Operation Mode 3: HBA Parameters  N: Port Number  2: Conf igure HBA Parameters  n. Operation Mode This option shows the Operation Mode Menu . From it you can select:  Interrupt for every I/O Completion  Interrupt when Interrupt DelayT imer expires [...]

4 – Interactive Comma nds HBA Parameters Menu 4-28 SN0054614-00 F S This choice gives you the option to set the Port Down Retry Count to a va lue from 0 to 255. 4.3.1.2.15 Enable LIP Full Login 3: HBA Parameters  N: Port Number  2: Configure HBA Parameters  n. Enable LIP Full Login This choice gives you the option to enable or disable LI[...]

4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-29 A 4.3.1.2.20 Abort Changes 3: HBA Parameters  N: Por t Number  2: Configure HBA Parameters  n: Abort chan ges Choose this option to stop with out making any changes. 4.3.1.3 Restore Default s 3: HBA Parameters  n: Port Number  3: Rest ore Default s This option is[...]

4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-30 SN0054614-00 F S 4.4 T arget/LUN List Menu (Command Line Op tions -t and -l) 4: Target/LUN List This option shows the main Target List Menu . which includes a list of all HBAs and port instances detected on the host. Y ou have the option to select:  Each HB[...]

4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-31 A 4.4.1 T arget/LUN List (Per HBA Port) 4: Target/LUN List  1 - n T arget List Menu - Port n When you select an HBA Port in stance from the T arget/LUN List, a list of LUNs (disks) attached to that port instance appears. T echnical informati[...]

4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-32 SN0054614-00 F S  LUN Number  V endor  Product ID  Port Name  Port ID  All LUN(s) Here is an example of the LUN List Menu : 1: LUN 0 Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-11-C6-2D-5B-F9 Port ID : 02-0A-DC And so on. M:[...]

4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-33 A 4.4.1.3 All T argets 4: Target/LUN List  1 - n T arget List Menu Port n  1 - n: T arget  m: All LUNs When you select a particular LUN from th e LUN list, the following information for all LUNs appears:  Product V endor  Product[...]

4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-34 SN0054614-00 F S This choice shows the Target List Menu for All HBAs . Inf ormation for each individual target includes:  (T arget type) on QLAxxxx (HBA Instance n)  V endor  Product ID  Product Revision  Serial Number  Port Name  Port ID [...]

4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-35 A  St a t u s Here is an example of the T arget information: Path : 0 Target : 3 Device ID : 0x87 Product Vendor : SEAGATE Product ID : ST336607FC Product Revision : 0006 Serial Number : 3JA9TN7600007517T6P1 Node Name : 20-00-00-11-C6-2D-5B-[...]

4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-36 SN0054614-00 F S WWULN : 20-00-00-0C-50-68-1E-9A ------------------------------------------------ Hit (RETURN) to continue: 4.4.2.4 All T arget(s) 4: Target/LUN List  n: Port Number  3: All T arget(s) This choice shows informatio n for all t a rgets conn[...]

4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-37 A 4.4.2.5 All LUN(s) 4: Target/LUN List  n: Port Number  3: All LUN(s) When you select this option, SANsurf er FC HBA CLI shows the following information about all LUNs for all HBA Port Inst ances:  Product V endor  Product ID  P[...]

4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-38 SN0054614-00 F S LUN : 0 Size : 68.37 GB Type : SBC-2 Direct access block device (e.g., magnetic disk) WWULN : 20-00-00-00-87-72-85-B2 OS LUN Name : /dev/sda Here is an example of the All LUNs in fo rmation on Solaris with a QLA driver: Product Ve[...]

4 – Interactive Com m a nd s T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 F 4-39 A 8. All HBAs 9. Return to Previous Menu T able 4-3 lists the target link speed settin gs and descriptions. 4.5.1 Configuring the iiDMA Settings Use the Intelligent Interleave Fact or Selection (iiDMA) menu to select the intelligen[...]

4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-40 SN0054614-00 F S 4. T o use Basic Configuration : a. Select the HBA. b. Select the intelligent interleave fact or from the intelligent interlea ve factor speed list ( 1 Gbps , 2 Gbps , 4 Gbps , or 8 Gbp s ) to all attached devices. c. Choose one o[...]

4 – Interactive Com m a nd s T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 F 4-41 A  Product Revision  Serial Number  Port Name  Port ID  Max T arget Link Rate  Next T arget T ype (for example, Disk)  Apply Changes to Selected T argets Here is an example of the Target Link Speed Menu for all[...]

4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-42 SN0054614-00 F S iiDMA Menu HBA Instance 3 (QLA2462 Port 2) : Online WWPN: 21-01-00-E0-8B-A5-8C-7C Desc: QLA2462 PCI-X 2.0 to 4Gb FC Dual Channel 1: Disk Vendor : SEAGATE Product ID : ST136403FC Product Rev : FF5F Serial Number : LT06464600001011H[...]

4 – Interactive Com m a nd s T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 F 4-43 A When you have set the speed for all the links you want, type the number for Apply changes to Selected T arget(s) and then press ENTER. 4.5.4 T arget Link Speed – All HBAs 5: Target Link Speed  2: All HBAs When you select thi[...]

4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-44 SN0054614-00 F S  Apply Changes to Selected T argets Here is an example of the T arget Link Speed Menu (Advanced) for All HBAs : Target Link Speed Menu (Advanced) All HBAs 1: Disk 0 on QLA2462 (HBA Instance 0) Vendor : SEAGATE Product ID : ST31[...]

4 – Interactive Com m a nd s T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 F 4-45 A When you select an HBA to set it s link speed, the T arget Link S peed Menu (Advanced) menu for a p articular HBA instance appears. It shows the lin k speed options you can choose f rom. The options vary according to the HBA in use. For ex[...]

4 – Interactive Comma nds T arget Persistent Bindin gs Menu ( Command Line Option -p) 4-46 SN0054614-00 F S When you select this option, SANsurf er FC HBA CLI shows the Target Persistent Binding menu listing st andard HBA port instances (see 4.5 .2 ), where you can select an individual HBA port or All HBAs . The following sections describe how to[...]

4 – Interactive Com m a nd s T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 F 4-47 A  T arget information (model name and number , for example)  Port Name  Port ID  T arget ID 4.6.1.2 T arget Persistent Bindin gs – Bind T arget(s) (Command Line Option -p) 6: Target Persistent Bindings  1 - n: T arget Persi[...]

4 – Interactive Comma nds T arget Persistent Bindin gs Menu ( Command Line Option -p) 4-48 SN0054614-00 F S Product ID : ST318453FC Port Name : 22-00-00-11-C6-2D-5A-3F Port ID : 11-0A-E2 Bind : No Target ID : ... n: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-11-C6-2D-5A-3F Port ID : 02-0A-E4 Bind : No Target ID : p: All Ta[...]

4 – Interactive Com m a nd s Selective LUN s Menu (Co mmand Line O ption -m) SN0054614-00 F 4-49 A 4.6.2.1 Display T arget Persistent Binding 6: Target Persistent Binding  p: All HBAs  1: Display Configuratio n When you select the Display Configuration option, the following informatio n appears. (Or , the message, No target persistent bindi[...]

4 – Interactive Comma nds Selective LUNs Menu ( Command Line Option -m) 4-50 SN0054614-00 F S  Auto Configure LUNs If this option is not available for the selected LUN, the following message appears: Configuration not permitted. Device(s) either not present or not persistently bound (HBA n)! 4.7.2 Selective LUNs (All HBAs) 7: Selective LUNs ?[...]

4 – Interactive Com m a nd s Boot Device Menu (Command Line Option -e) SN0054614-00 F 4-51 A 3: Return to Previous Menu The general view shows: ------------------------------------------------------------------------------ HBA Instance 5: QLA2300 Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 PortID 11-05-EF -------------------------------------------------[...]

4 – Interactive Comma nds Boot Device M enu (Comma nd Line Option -e) 4-52 SN0054614-00 F S 4.8.1 HBA Port Inst ance 8: Boot Device  1 - m: HBA Port Instance When you select this option, SANsurf er FC HBA CLI shows the Boot Device Settings menu for HBA Instance m. Y ou can choose to:  Display Boot Device(s)  Configure Boot Device(s) 4.8.[...]

4 – Interactive Com m a nd s Boot Device Menu (Command Line Option -e) SN0054614-00 F 4-53 A 00-00-00-00-00-00-00-00 0 ---------------------------- ------ (Alternate 3) Boot Port Name LUN ---------------------------- ------ 00-00-00-00-00-00-00-00 0 4.8.1.2 Configure Boot Device(s) 8: Boot Device  n: Port Nu mber  2: Conf igure Boot Device([...]

4 – Interactive Comma nds Driver Settings Menu (Command Line Option -fg) 4-54 SN0054614-00 F S 4.8.1.2.3 Save Configuration 8: Boot Device  n: Port Nu mber  2: Config.Boot Device  2: Device Settings  1: LUN List  1: Save Configuratio n When you select this option, th e CLI shows the Save Configuration menu:  Proceed  Cancel 4[...]

4 – Interactive Com m a nd s Driver Settings Menu ( Command Line Option -fg) SN0054614-00 F 4-55 A The current settings for t he Present persistently bound target(s)... and Bind by... are indicated by the word Current in p a rentheses after the selection. T o change these settings, select the menu number corresponding to the other option. T o sav[...]

4 – Interactive Comma nds Utilities Menu 4-56 SN0054614-00 F S 4.10 Utilities Menu 10: Utilities When you select this option, SANsurf er FC HBA CLI shows the following utilities options:  Flash Update  Flash Save  HBA Parameters Update  HBA Parameters Save  HBA Parameters T e mplates  Driver Update (Windows only)  Driver Resc[...]

4 – Interactive Com m a nd s Utilities Menu SN0054614-00 F 4-57 A 4.10.3 HBA Parameters Up date (Per HBA Port or All HBAs) (Command Line Option -r) 10: Utilities  3: HBA Parameters Up date When you select HBA Parameters Update , you are prompted to select either one of your HBA port insta nces or All HBAs to update. SANsurfer FC HBA CLI then d[...]

4 – Interactive Comma nds Utilities Menu 4-58 SN0054614-00 F S When you select the HBA Parameters Template option, SANsurfer FC HBA CLI prompts you to select an HBA port (or All HBAs ), and the n offe rs some or all of the following template types:  EMC (EMC-specific settings)  HP (HP-specific settings)  HPQ (HP-specific settings – 2Gb[...]

4 – Interactive Com m a nd s Utilities Menu SN0054614-00 F 4-59 A  Link Down T imeout specifies the time the driver waits for the link to come up after link do wn before returning the I/Os. This is an alogous to the Port Down Retry Count setting, which is used when the port is d own. The following tab les list the paramete r settings supported[...]

4 – Interactive Comma nds Utilities Menu 4-60 SN0054614-00 F S 4.10.6 Driver Up date (Command Line Option -d) 10: Utilities  6: Driver Update The Driver Update op tion is available on Windows systems only . When you select Driver Update from the Utilities menu, SANsurfer FC HBA CLI prompt s you to select an HBA port, and then e nter a file nam[...]

4 – Interactive Com m a nd s Beacon Menu SN0054614-00 F 4-61 A 4.1 1 Beacon Menu 11: Beacon When you select the Beacon option, SANsurfer FC HBA CLI sho w s the Beacon Menu containing these o ptions:  Locate HBA  Locate T arget(s) 4.1 1.1 Locate HBA – HBA Beacon (Command Line Option -a) 11: Beacon  1: Locate HBA When you select this opt[...]

4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-62 SN0054614-00 F S Y ou can select a disk number to blink the LED on that target. The blinkin g asterisk ( * ) below the Device Port Name line shows that the t arget beacon is active. ---------------------------------------------------------------------------[...]

4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-63 A 4.12.1 Diagnostics Loopback T est (Command Line Option -kl) 12: Diagnostics  n: Port Nu mber When you select an HBA port fro m the Diagnostics menu, SANsurfe r FC HBA CLI shows the list of diagnostic t est s you can run for that p[...]

4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-64 SN0054614-00 F S  Loopback T est  Read/Write Buffer T est  T ransceiver Details (ava ilable on 4Gb and 8Gb only) T est results for loopback and read/write buffer test s may include these test result s:  Loopback test result s:  T est S tatus [...]

4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-65 A The loopback test is external to th e HBA. If the HBA port is in loop mode, you can run the loopback test with a lo opback connector . If the HBA port is in point-to-point mode and attached to a switch, an echo test is run instead (n[...]

4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-66 SN0054614-00 F S After completing the loopba ck test, do the following step s to prepare for normal HBA operations: 1. Remove the loopback connector from th e HBA connector . 2. Reconnect the cable that you disconnected before installing the loopback connec[...]

4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-67 A  Display T est Parameters  Reset T est Parameters  Configure T est Parameters  S tart Diagnostics T est The read/write buf fer test sends specified data through the SCSI Write Buf fer command to a target d evice (disk). I[...]

4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-68 SN0054614-00 F S 4. The Configure Diagnostic Loopback T est Parameters or Configure Diagnostic Read/W rite Buffer T est Parameters submenu appears. Select one of the following options: 1. Show Test Configuration. T ype 1 to show the current parameter values[...]

4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-69 A Diagnostics Menu 1: Loopback Test 2: Read/Write Buffer Test 3: Transceiver details Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1. x . x Build x Diagnostics Menu HBA Model QLA2300/2310: 1: Port 1: WWPN: xx [...]

4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-70 SN0054614-00 F S Test Continuous : OFF -------------------------------------------------------------- Press <Enter> to continue: SANsurfer FC HBA CLI v1. x . x Build x Configure Loopback Test Parameters 1: Show Test Configuration 2: Restore Test Confi[...]

4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-71 A v1. x . x Build x Warning: The Diagnostic Loopback and Read/Write Buffer Tests require that the HBA has no outstanding input and output operations. Please make sure there is no active I/O before starting the test(s). Do you want to p[...]

4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-72 SN0054614-00 F S On Error : Ignore Test Continuous : OFF ------------------------------------------------------------------------ Diagnostics - Read/Write Buffer Test Result ------------------------------------------------------------ Hit <RETURN> to [...]

4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-73 A Temperature Voltage Tx Bias Tx Power Rx Power (C) (V) (mA) (mW) (mW) -------------- ------- ------- -------- -------- Value 34.17 3.33 5.86 0.498 1.174 Status Normal Normal Normal Normal Normal High Alarm 95.00 3.63 9.00 0.676 4.000 [...]

4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-74 SN0054614-00 F S BR, max: 0x00 BR, min: 0x00 Vendor SN: AZ8P72890H23 Date code: 070709 Diag Monitoring Type:-Address change required: 0x0 -Power Measurement: 0x1 -Externally Calibrated: 0x0 -Internally Calibrated: 0x1 -Digital diag monitoring: 0x1 -Legacy d[...]

4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-75 A Tx_I(Offset): 0x0000 Tx_PWR(Slope): 0x0000 Tx_PWR(Offset): 0x0000 T(Slope): 0x0000 T(Offset): 0x0000 V(Slope): 0x0000 V(Offset): 0x0000 Checksum: 0x63 Temperature MSB: 0x22 Temperature LSB: 0x2c Vcc MSB: 0x82 Vcc LSB: 0x21 TX Bias MS[...]

4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-76 SN0054614-00 F S -Reserved Warning: 0x0 -Reserved Warning: 0x0 -Reserved Warning: 0x0 -Reserved Warning: 0x0 -RX Power Low Warning: 0x0 -RX Power High Warning: 0x0 Vendor Specific: 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 4.13 S t atistics Menu (Command Line Options[...]

4 – Interactive Com m a nd s S tatistics Menu (Comm and Line Options -gs and -ls) SN0054614-00 F 4-77 A T o change the HBA statistics: 1. From the Main Menu , type the nu mber for the St atistics option, and then press ENTER. 2. From the Statistics Menu , type the number for the HBA S tatistics option, and then press ENTER. 3. From the HBA Statis[...]

4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-78 SN0054614-00 F S 4.13.1.1.1 Current Settings 13: Statistics  1: HBA Statistics  1 : Configuration  1: Cu rrent Settings The system displays the current settings for:  AutoPoll (AP)  SetRate (SR)  LogT oFile (LF) 4.13.1.1.2 Restore Default s 13: St[...]

4 – Interactive Com m a nd s S tatistics Menu (Comm and Line Options -gs and -ls) SN0054614-00 F 4-79 A If you select the Manual Poll op tion, the system prompt s you to enter a value for Manual Poll iteration: Manual Poll iteration (1-256) Enter a value from 1 to 256 and press EN TER. Th e system updates the Manual Poll iteration value and retur[...]

4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-80 SN0054614-00 F S 3. From the HBA Statistics Menu , type the number for the Show HBA St atistics option, and then press ENTER. 4. The Statistics Menu app ears and promp t s you to select an HBA port. T ype the number for the port, and then pre ss ENTER. The HBA stat[...]

4 – Interactive Com m a nd s S tatistics Menu (Comm and Line Options -gs and -ls) SN0054614-00 F 4-81 A  Auto Poll  Set Rate  Log to file T able 4-1 1 shows the statistics and link status o ptions. 4.13.2.1.1 Current Settings 13: Statistics  2: Link Status  1: Configura tion  1: Current Settings Select the Current Settings optio[...]

4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-82 SN0054614-00 F S  Auto Poll  Manual Poll If you select the Auto Poll option, the system enables Auto Po ll and returns a message: Auto Poll enabled. If you select the Manual Poll op tion, the system prompt s you to enter a value for Manual Poll iteration: Man[...]

4 – Interactive Com m a nd s Virtual Menu (Com mand Line Option - vp) SN0054614-00 F 4-83 A The Show Link Status option shows a menu of port numbers from which you can select the port for which you want the link st atus. T o view the link status: 1. T ype the number for the St atistics option, and then press ENTER. 2. The Statistics Menu appea rs[...]

4 – Interactive Comma nds Virtual Menu (Com mand Line Option -vp ) 4-84 SN0054614-00 F S QLogic's SANsurfer FC HBA CLI for Wind ows works in conjunc tion with QLogic's N_Port ID V irtualization (NPIV)-capable Windows driver . NPIV is an ANSI T1 1 standard that describes how multiple unique fabric addresses (N_Port IDs) can share a singl[...]

4 – Interactive Com m a nd s Virtual Menu (Com mand Line Option - vp) SN0054614-00 F 4-85 A 4.14.1 V irtual Menu for HBA Inst ance 14: Virtual  1: Virtual Menu When you select this option, th e Virtual Port Menu appears with the following options:  List Virtual Port s  Delete a Vi rtual port  Create a Vir tual port Enter the number fo[...]

4 – Interactive Comma nds Virtual Menu (Com mand Line Option -vp ) 4-86 SN0054614-00 F S  List Virtual Port s including for each:  Instance Nu mber  Virtual Port Number  WWPN  S tatus (Online o r Loop Down) Here is an example: Virtual Menu HBA Model QLA2462: 0: VPort 3: WWPN: 21-00-7B-E0-8B-14-5A-CF Online 1: VPort 2: WWPN: 21-00-6[...]

4 – Interactive Com m a nd s Help Menu (Command Line Option -h) SN0054614-00 F 4-87 A 4.14.1.3.1 Auto Generate 14: Virtual  1: Virtual Menu  3: Create a V irtual Port  1: Auto Generate When you select this option, th e system creates a Virt ual Port on this HBA physical port and report s the WWPN of the virtual port. For example: Virtual[...]

4 – Interactive Comma nds Help Menu (Comm and Line Option -h) 4-88 SN0054614-00 F S  About T ype the number for the option you want and press ENTER. 4.15.1 Content s 14 (or 15): Help  1: Contents When you select the Contents option, SANsurfer FC HBA CLI shows the entire Help menu. Y ou can see the help menu options rearranged into alphabeti[...]

SN0054614-00 F 5-1 Section 5 Non-interactive Commands 5.1 Introduction This section cont ains the information in the help (to view he lp, enter 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.[...]

5 – Non-interactive Commands Display System Information (Command Line Options -g , -z, and -tp) 5-2 SN0054614-00 F S 5.2.2 Host Configuration (Command Line Option -z) The command line option -z shows all of the HBA ’s information in a single command. The command format is: # scli -z The SANsurfer FC HBA CLI tool s hows the information in sectio[...]

5 – Non-interactive Commands Display System Information (Comm and Line Options -g, -z, and -tp) SN0054614-00 F 5-3 A 5.2.3 Host T opology (Command Line Option -tp) The command format for Host T opology is: # scli -tp When you select this option, th e SANsurfer FC HBA CLI tool shows the information in section 5.2.2 , as well as the following addit[...]

5 – Non-interactive Commands Display System Information (Command Line Options -g , -z, and -tp) 5-4 SN0054614-00 F S  Port S tate  Port Information  Physical Port Number (switch port number), including:  Port state  Port type  TX port type  Port module type  Attached Port (QLogic HBA, t ape device, or disk device connected[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-5 A 5.3 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. However , they must be at the beginning or at the end of the command l[...]

5 – Non-interactive Commands Command Summary 5-6 SN0054614-00 F S  Y ou can use either the hyphen (-) c haracter or the forward slash (/) character . For example, both of these commands are valid: scli -g scli /g T able 5-2 defines the command variables. . 5.3.1 -a (View or T oggle Beacon St atus) Use the -a command to either view (1) or chang[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-7 A T o view the HBA port’s LED Beacon st ate, type: # scli -a (< HBA Instance > | < HBA WWPN >)(view | ?) When the HBA ’s LED is flashing, the following message appears: HBA Port x - LED Flashing is ON. When the HBA ’s LED is not flashing, the following message appea[...]

5 – Non-interactive Commands Command Summary 5-8 SN0054614-00 F S T o save the BIOS/FCode to a file, type: # scli -b (< HBA Instance > | < HBA WWPN >) SAVE < BIOS/FCode File Name > Where: 5.3.3 -c (Show Parameter Settings) Use the -c command to show the p arameter settings for all HBAs in the system: # scli -c [ <all> ] T [...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-9 A Where: 5.3.5 -dm (Display Diagnostics Monitoring Info) This option allows you to show general o r detailed Digital Diagnost ic Monitoring Interface for optica l transceivers. T o show Tr ansceiver monitoring general information, type: # scli -dm (< HBA Instance > | < HBA W[...]

5 – Non-interactive Commands Command Summary 5-10 SN0054614-00 F S In these commands: T o view the current boot device selection on all HBAs: # scli -e (view | ?) T o view the current boot device selection for a specific HBA: # scli -e (< HBA Instance > | < HBA WWPN >) (view | ?) In Solaris SP ARC, if the system is runni ng with a csh[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-1 1 A T o cause the OS to boot from the first t arget it finds with a LUN, select a boot port name of 00-00-…00 (select able boot); this applies only if the boot BIOS is enabled. T o set a particular target as the b oot device for a specific HBA, type the following command: # scli -e[...]

5 – Non-interactive Commands Command Summary 5-12 SN0054614-00 F S 5.3.7 -ei (List SANsurfer FC HBA CLI Erro r Codes) This command lists the SANsu rfer FC HBA CLI error codes as shown in Appendix D . 5.3.8 -f (Input Parameter Options from a T ext File) T o input parameter options to SANsurfer FC HBA CLI throug h a text file, type -f , followed by[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-13 A 5.3.9 -fg (Show Driver Settings) T o show the driver settings, type: # scli -fg (< HBA Instance > | < HBA WWPN >) (view | ?) Where: 5.3.10 -fs (Configure Dri ver Settings) T ype the following command to configure the driver settings: # scli -fs (< HBA Instance > [...]

5 – Non-interactive Commands Command Summary 5-14 SN0054614-00 F S The following restrictions apply:  Under Solaris, the driver configuration feature is disabled if you are using the driver from the OS inst allation CDs (QLC driver).  Under Linux, this feature is d isabled if you are using the ioctl or sysfs (inbox) driver .  Under Macin[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-15 A Where: T able 5-4 lists the HBA statistics p arameter names, aliases, and values. Under Solaris, this feature is d isabled if you are using the driver from the OS installation CDs (QL C driver). Under Linux, this feature is disabled if you are using the ioctl or sysfs (inbox) driv[...]

5 – Non-interactive Commands Command Summary 5-16 SN0054614-00 F S 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>) - shows LUN information for a specific target scli -l (<hba no>[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-17 A 5.3.15 -i (Display HBA General Information or VP D Information for One or All HBAs) T o show general HBA information or VPD information for all HBA port s in the system, type the following comma nd: # scli -i [ <all> ] [ <VPD> ] Where: T o show general or VPD informati[...]

5 – Non-interactive Commands Command Summary 5-18 SN0054614-00 F S Sections 5.3.16.1 through 5.3.16.5 describ e how to change the default parameters for both of th ese test s. Section 5.3.16.6 cont ains command line examples and test result s for a loopback test. Section 5.3.18.1 cont ains command line examples and test result s for a read/write [...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-19 A 5.3.16.2 Dat aSize (DS) For the loopback test, the dat a size is either: DS <Parameter Value> DataSize <Parameter Value> The valid data sizes are as follows:  Read/write buffer test. The data size can be 8, 16, 32, 64, or 128 bytes. The default value is 128 bytes. ?[...]

5 – Non-interactive Commands Command Summary 5-20 SN0054614-00 F S  Loopback test (Linux systems). The data size can b e 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8 192, 16384, 32768, or 65535. The default value is 512 bytes. 5.3.16.3 T estCount (TC) The number of loopback test s is either: TC < Parameter Value > TestCount < Par[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-21 A 5.3.16.6 Run a Loopback T est The loopback test sends and receives messages, through a loopback or th rough an echo command, to the switch. T able 5-7 lists the operating system driver ve rsions that do not require a loopback connector . . T o do a loopback test using the current [...]

5 – Non-interactive Commands Command Summary 5-22 SN0054614-00 F S # scli - -kl (< HBA Instance > | < HBA WWPN >) T o do a loopback test with custom parameters, type: # scli - -kl (< HBA Instance > | < HBA WWPN >) [(< Parameter Name > | < Parameter Alias >) < Parameter Value >] Section 5.3.16 describes th[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-23 A  Error – CRC, disparity , or frame length errors occurred.  Failed – An error occurred when attempt i ng to issue a command.  Loop down – The loop is down.  CRC – Number of CRC errors.  Disp arity – Number of disparity errors.  Frame Length – Number o[...]

5 – Non-interactive Commands Command Summary 5-24 SN0054614-00 F S Where: Sections 5.3.16.1 through 5.3.16.5 describ e how to change the default parameters for both of th ese test s. Section 5.3.16.6 cont ains command line examples and test result s for a loopback test. Section 5.3.18.1 cont ains command line examples and test result s for a read[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-25 A # scli -kr (< HBA Instance > | < HBA WWPN >) T o exclude a device or devices on the selected HBA port, type: # scli -kr (< HBA Instance >|< HBA WWPN >) [(-EX | -EXCLUDE) < Target WWPN >] [(< Parameter Name >|< Parameter Alias >) < Param[...]

5 – Non-interactive Commands Command Summary 5-26 SN0054614-00 F S 5.3.18.2 Run HBA Diagnostics Read-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. The system shows the following information af ter a read/write buffer test completes:  Loop ID/s[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-27 A If the read/write buf fer test fails, the system shows the following information :  Loop/port ID (the loop ID of the HBA when operating in loop mode).  Stat us :  Success – The test p assed.  Error – A data miscomp are or link status firmware error occurred.  Fa[...]

5 – Non-interactive Commands Command Summary 5-28 SN0054614-00 F S  Write bu ffer failed  Link Failure – Numbe r 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 5.3.19 -l (Display LUN Info) This command shows LUN information for[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-29 A Where: T able 5-10 defines the link status p arameter names, aliases, and values. 5.3.21 -m (View , En able, or Disable LUNs) Use the -m command to:  View all selective L UNs for all HBA ports (1)  View an HBA ’s selective LUN list (2)  View the current selective state [...]

5 – Non-interactive Commands Command Summary 5-30 SN0054614-00 F S  Disable (deselect) a LUN on a specific t arget on a specific HBA (5)  Enable all LUNs on a specific t arget on a specific HBA (6)  Disable (deselect) all LUNs on a specific t arget on a specific HBA (7)  Enable (select) all LUNs of all ta rgets on a sp ecific HBA (8) [...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-31 A # scli -m (< HBA Instance > | < HBA WWPN >) {< Target WWNN > < Target WWPN > < LUN ID > (0 | disable | deselect)} T o enable (select) all LUNs for a specific target on a specific HBA, type: # scli -m (< HBA Instance > | < HBA WWPN >) selec[...]

5 – Non-interactive Commands Command Summary 5-32 SN0054614-00 F S T able 5-1 1 lists the HBA parameter names and aliases. . T able 5-1 1. HBA Parameters Description Name Ali as V alue Connection options ConnectionOption CO See table note, below a a Connection Options: 0 – Loop only 1 – Point-to-point only 2 – Loop preferred, otherwise poin[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-33 A 5.3.23 -o (Output to a File) T o output result and status messages into a file, type -o , followed by the file name. For example, to save LUN information to a file named systemLUNinfo : # scli -l -o systemLUNinfo Where the file name is systemLUNinfo , all messages are located in t[...]

5 – Non-interactive Commands Command Summary 5-34 SN0054614-00 F S 5.3.24 -p (Display Persistent T a rget Binding Info) With this command you can:  Show binding information for one or on all HBAs (1 )  Bind a specific target to a selected HBA (2)  Bind all target s on a specific HBA or on all HBAs (3)  Unbind a specific target (4) [...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-35 A Yes Disk xx - xx - xx - xx - xx - xx - xx - xx xx - xx - xx - xx - xx - xx - xx - xx 10-02-E4 1 Yes Disk xx - xx - xx - xx - xx - xx - xx - xx xx - xx - xx - xx - xx - xx - xx - xx 10-02-E8 2 Press <Enter> to continue: T o bind a selected target to a specific HBA, type: # sc[...]

5 – Non-interactive Commands Command Summary 5-36 SN0054614-00 F S Where: 5.3.25 -p a (Define Port Alias) With this command you can:  Define the port alias for a specific HBA port (1)  Delete the port alias from a specific HBA po rt (2)  View the po rt alias for a specific HBA port (3) T o define a port alias for the specified HBA, type:[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-37 A Where: T o view the link speed of a specific T arget attached to an HBA, type the following command: # scli -q (< HBA Instance > | < HBA WWPN > | < Target WWPN > Where: T ype the following command to set the link speed of all T argets attached to one HBA or all H[...]

5 – Non-interactive Commands Command Summary 5-38 SN0054614-00 F S 5.3.27 -r (Up date HBA Parameters) T o update the HBA Parameters, type: # scli -r (< HBA Instance > | < HBA WWPN > | all) < File Name > Where: T o save the HBA parameters to a file, typ e: # scli -r (< HBA Instance > | < HBA WWPN >) save < File Nam[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-39 A 5.3.29 -t (Display T arget Information) T o show the target information for all HBAs in the system, type: # scli -t [ <all> ] T o show the target information for a spe cific HBA, type: # scli -t (< HBA Instance > | < HBA WWPN >) T o show specific target informati[...]

5 – Non-interactive Commands Command Summary 5-40 SN0054614-00 F S 5.3.31 -tp (Display Host T opology) Use the -tp option to show the topology configurat ion of the host: # scli -tp | topology Under Linux, this feature is disabled if yo u are using the ioctl or sysfs (inbox) driver . Section 5.2.3 covers this command. 5.3.32 -v (Display V ersion)[...]

5 – Non-interactive Commands Command Summary SN0054614-00 F 5-41 A Where: T o list a specific virtual por t on a physical HBA port, type: # scli -vp (< HBA Instance > : < HBA WWPN >) list <vport wwpn> T o create a virtual port with an automatic WWPN, type: # scli -vp (< HBA Instance > : < HBA WWPN >) create auto T o [...]

5 – Non-interactive Commands Command Summary 5-42 SN0054614-00 F S 5.3.35 -x2 (Output in XML Format 2) Y ou can use this option with all no n-interactive mode options th at have a corresponding interactive mode option (see T able 5-1 ). This option must be the first or last command in the command line. When you use this option, the system shows a[...]

SN0054614-00 F A-1 Appendix A XML Format 1 A.1 Introduction The -x1 command line option (see se ction 5.3.34 ) displays all output in XML format 1. This section defines the XML fo rmat 1 ou tput, which consists of the following part s:  Main tag  Utility header  S tatus message  Error message  Reboot message A.1.1 Main T ag When SANs[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-2 SN0054614-00 F S A.1.3 S t atus Message Before the closing main t ag </QLogic> , SANsurfer FC HBA CLI displays returning st atus from the execution of the command line p arameters and the error messages. Successful execution of the command li ne pa rameters returns the following status[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-3 A A.2.1 Display System Information (Command Line Option -g) The XML format 1 for system information outpu t is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-4 SN0054614-00 F S PortDownRetryCount="value" EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="value" /> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic>[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-5 A PortType="value" Status="value" </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Here is the information for the 4G HBAs: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> &l[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-6 SN0054614-00 F S <VPD> <VPDProductIdentifier="value" VPD-RTAG="" PartNumber="value" SerialNumber="value" MiscInformation="value" ManufacturingID="value" EFIDriverVersion="value" FirmwareVersion="value" B[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-7 A A.2.5 Display LUN List (Command Line Option -l) The XML Format 1 for the adap ter LUN list information is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-8 SN0054614-00 F S <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> The <TargetBinding … /> sequence is repeated for each t arget bound to the adapter . A.2.7 Selective LUNs (Command Line Option -m) The XML Format 1 for the selective LUNs information is[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-9 A <Reboot> 0 </Reboot> </QLogic> The <BootDevice…/> sequence is repeated for each boot device of the adapter . In Windows and Linux, the TargetID="value" field is not present. A.2.9 Diagnostics Result s – Loopback T est (Command Line Optio[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-10 SN0054614-00 F S </QLogic> The <Target> sequence is repeated fo r each device att ached to the adapter . A.2.1 1 V iew Driver Settings (Command Line Option -fg) The XML Format 1 for the curre nt driver settings information is as follows: <?xml version="1.0" encoding[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-1 1 A The XML Format 1 for all adapter information is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion> <Host> <Name[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-12 SN0054614-00 F S <Param ConnectionOption="value" DataRate="value" FrameSize="value" HardLoopID="value" LoopResetDelay="value" EnableHostAdapterBIOS="value" EnableHardLoopId="value" FibreChannelTapeSupport="value&q[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-13 A BindbyPortID="value" /> </DriverSettings> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> A.2.13 Link St atistics (Command Line Option -ls ) The XML Format 1 for the lin k st atistics option is as follows: &l[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-14 SN0054614-00 F S <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn.nn.nn Build nn</AppVersion> <HBA> <HBA Port="value" WWPN="value" WWNN="value[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-15 A <HBA Port="value" WWNN="value" WWPN="value" /> <PortAlias> <Alias Name="value" /> </PortAlias> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> A.2.17 SFF DMI (Comm[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-16 SN0054614-00 F S <MeasuredTxBiasUnit>(mA)</MeasuredTxBiasUnit> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-17 A <FCTransmitterTech>"value"</FCTransmitterTech> <FCTransmissionMedia>"value"</FCTransmissionMedia> <FCSpeed>"value"</FCSpeed> </TransceiverData> <Encoding>"value"</Encoding> <BR-[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-18 SN0054614-00 F S </EnhancedOptions> <SFF-8472-Compliance>"value"</SFF-8472-Compliance> <CC_EXT> 0x7d </CC_EXT> <VendorSpecific> "value" </VendorSpecific> </Address_A0> <Address_A2> <TempHighAlarm>"value&quo[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-19 A <Reserved_MSB> "value" </Reserved_MSB> <Reserved_LSB> "value" </Reserved_LSB> <Reserved_MSB> "value" </Reserved_MSB> <Reserved_LSB> "value" </Reserved_LSB> <StatusControlBits> <[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-20 SN0054614-00 F S A.2.18 Host T opology (Command Line Option -tp) The XML Format 1 for an HBA type interconnect elemen t is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>v[...]

A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-21 A DriverVersion="value" FirmwareVersion="value" TotalNumberOfDevices="value" Host="value"/> </AttachedPort> </PhysicalPort> ... ... <PhysicalPort Number="value"> <Port WWPN="value" State="[...]

A – XML Format 1 XML Format 1 T ags for Each Option A-22 SN0054614-00 F S </InterConnectElement> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic>[...]

SN0054614-00 F B-1 Appendix B XML Format 2 B.1 Introduction The -x2 command line option (see se ction 5.3.35 ) displays all output in XML Format 2. This section defines the XML2 output format, which consist s of the following part s:  Main tag  Utility header  S tatus message  XML2 message (one for each option) B.2 Main T ag When SANsur[...]

B – XML Format 2 S tatus Message B-2 SN0054614-00 F S B.4 S t atus Message Before the closing main t ag </QLogic> , SANsurfer FC HBA CLI displays any returning st atus from the execution of the command line p arameters and the error messages. When the execution of the comma nd line pa rameters is successful, the following status is displaye[...]

B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-3 A scli -c 0 -x2 The XML Format 2 for adapter settings informatio n is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn.n.nn Build nn</AppVersion <AppXmlVersion&g[...]

B – XML Format 2 XML2 T ags for Each Optio n B-4 SN0054614-00 F S # scli -dm ( <HBA Instance > | < HBA WWPN> | <all>) (general | gen) -x2 The XML Format 2 for the boot device information is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppNam[...]

B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-5 A <MeasuredTxPowerUnit>(mW)</MeasuredTxPowerUnit> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning>&qu[...]

B – XML Format 2 XML2 T ags for Each Optio n B-6 SN0054614-00 F S <Length-9um> "value" </Length-9um> <Length-50um> "value" </Length-50um> <Length-62.5um> "value" </Length-62.5um> <Length-Copper> "value" </Length-Copper> <VendorName>"value"</[...]

B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-7 A <TempHighWarning>"value"</TempHighWarning> <TempLowWarning>"value" </TempLowWarning> <VoltageHighAlarm>"value"</VoltageHighAlarm> <VoltageLowAlarm>"value"</VoltageLowAlarm> <VoltageHighWarning[...]

B – XML Format 2 XML2 T ags for Each Optio n B-8 SN0054614-00 F S <TXFault> "value" </TXFault> <SoftRXRateSelect> "value" </SoftRXRateSelect> <RXRateSelectState> "value" </RXRateSelectState> <SoftTXDisable> "value"</SoftTXDisable> <TXDisableState> "[...]

B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-9 A -e (< HBA Instance > | < HBA WWPN >) (view | ?) -x2 The XML Format 2 for the boot device information is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn.[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-10 SN0054614-00 F S B.7.4 V iew Driver Settings (Command Line Option -fg) The command format is: scli -fg (< HBA Instance > | < HBA WWPN >) (VIEW | ?) -x2 The XML Format 2 for the curre nt driver settings information is as follows: <?xml version="value"[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-1 1 A <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN="value" /> <NumOfHBA>n</NumOfHBA> </Host> <Status> n </Status> <?ErrorMsg> "message&qu[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-12 SN0054614-00 F S </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The XML Format 2 for 4G HBAs is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI&l[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-13 A <VPD> <VPD ProductIdentifier="value" PartNumber="value" SerialNumber="value" MiscInformation="value" ManufacturingID="value" EFIDriverVersion="value" FirmwareVersion="value" BIOS[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-14 SN0054614-00 F S scli -kr (< HBA Instance > | < HBA WWPN >) [(-EX | -EXCLUDE) < Target WWPN >] (< Parameter Name > | < Parameter Alias >) < Parameter Value > -x2 The XML Format 2 for the read/write buf fer test results is as follows: <[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-15 A Vendor="value" Product="value" Revision="value" Size="value" Type="value" /> </Target> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <Target> s[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-16 SN0054614-00 F S scli -p (< HBA Instance > | < HBA WWPN > | all) (view | ?) -x2 The XML Format 2 for the adap ter target persistent binding information is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName&g[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-17 A DeviceID= "value" PortID= "value" LunCount= "value" Type= "value" DeviceStatus= "value" /> </Target> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The &l[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-18 SN0054614-00 F S <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn.n.nn Build nn</AppVersion <AppXmlVersion>n.nn</AppXmlVersion> <Host> <Name> Host Name </Name> <OSType> OS Type </OSType> <[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-19 A OperationMode="value" IntDelayTimer="value" ExecutionThrottle="value" LoginRetryCount="value" EnableLipReset="value" PortDownRetryCount="value" EnableLipFulllogin="value" LinkDownTimeout=[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-20 SN0054614-00 F S B.8.9 Link St atistics (Command Line Option -ls) The command format is: scli -ls ( < HBA Instance > | < HBA WWPN >) [(< Parameter Name > | < Parameter Alias >) < Parameter Value >] -x2 The XML Format 2 for the lin k st atistics[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-21 A The <LinkStatus…/> p arameter repeat s for each link. B.8.10 HBA S t atistics (Command Line Option -gs) The command format is: scli -gs (< HBA Instance > | < HBA WWPN >) [(< Parameter Name > | < Parameter Alias >) < Parame[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-22 SN0054614-00 F S <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN="value" /> <HBAAlias> <AliasName="value" /> </HBAAlias> </HBA> <Status> n </Status>[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-23 A <Speed>"value"</Speed> <Revision>"value"</Revision> <SerialNumber>"value" </SerialNumber> </MediaInformation> <Diagnostics> <Temperature> <MeasuredTemperature>(C)</[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-24 SN0054614-00 F S </RxPower> </Diagnostics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> B.8.13 Host T opology (Command Line Option -tp) The command format is: scli -tp -x2 The XML Format 2 for an HBA type inte rc[...]

B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-25 A PortAlias="value" DriverVersion="value" FirmwareVersion="value" Host="value"/> </AttachPort> </PhysicalPort> ... </PhysicalPortInformation> </InterconnectElements> <InterconnectElementTyp[...]

B – XML Format 2 Display System Information (Command Line Option -g) B-26 SN0054614-00 F S Notes[...]

SN0054614-00 F C-1 Appendix C Interactive Exit Codes T o list the exit codes while running SANsurfer FC HBA CLI in interactive mode: 1. From the Main Menu , select t he Help option and then press ENTER. 2. On the Help Menu , select Exit Codes and then press ENTER. The CLI lists th e exit code numbers, names, and de scriptions as shown in T able C -[...]

C – Interactive Exit Codes C-2 SN0054614-00 F S 12 ERROR_MISMA TCH_CHECKS UM File checksum does not match 13 ERROR_CORRUPTED_FILE File appears to be corrupted 14 ERROR_FILE_CHKSUM_ERROR File checksum returns error 15 ERROR_FILE_INV ALID_DA T A File has invalid data 16 ERROR_FLASH_UPDA TE_IGNORE HBA does not need to be updated 17 Reserved Not used[...]

C – Interactive Exit Codes SN0054614-00 F C-3 A 37 ERROR_FLASH_UPD A TE_NO_REGION_ LA YOUT HBA does not have flash update region lay- out 38 Reserved Not used 39 Reserved Not used 40 ERROR_DIAGNOSTICS_P ARAM_ ERROR Diagnos tics test re turns invalid parameters 41 ERROR_DIAGNOSTICS_LOOP_DOWN Unable to run diagnostics because the loop is down 42 ER[...]

C – Interactive Exit Codes C-4 SN0054614-00 F S 58 Reserved Not used 59 Reserved Not used 60 ERROR_INV ALID_P ARAM_SETTINGS Inv alid H BA parameter value/key 61 ERROR_P ARAM_UNSUPP ORTED_HBA S pecified HB A parameters is not supported 62 ERROR_P ARAM_UNSUPP ORTED_DRIVER Unable to update HBA parameters - Driver unsupported 63 ERROR_RESTORE_NVRAM_D[...]

C – Interactive Exit Codes SN0054614-00 F C-5 A 83 ERROR_PRESERVE_NVRAM_DA T A Failed to preserve HBA parameters 84 ERROR_MISSING_NVRAM_TEMPLA TE_ FILE Unable to find the NVRAM template for the HBA 85 ERROR_INV ALID_NVRAM_PROG _OPTION S pe cified key/va lue to program NVRAM are invalid 86 Reserved Not used 87 Reserved Not used 88 Reserved Not use[...]

C – Interactive Exit Codes C-6 SN0054614-00 F S 104 Reserved Not used 105 Reserved Not used 106 Reserved Not used 107 Reserved Not used 108 Reserved Not used 109 Reserved Not used 1 10 ERROR_DUPLICA TE_T ARGET_ID T arget has duplicate ID 1 1 1 ERROR_INV ALID_T ARGET_I D T arget has invalid ID 1 12 ERROR_MISM A TCH_T ARGET_ID T arget has mismatch [...]

C – Interactive Exit Codes SN0054614-00 F C-7 A 126 ERROR_F AILOVER_DRIVER_LOADED Feature is not support with failover driver 127 Reserved Not used 128 Reserved Not used 129 Reserved Not used 130 ERROR_INV ALID_HBA_WWID HBA WWPN/WWNN specified is invalid 131 ERROR_INV ALID_HBA _PID HBA in stance specified is invalid 132 ERROR_INV ALID_T ARGET_WWI[...]

C – Interactive Exit Codes C-8 SN0054614-00 F S 150 ERROR_CLOSE_ZIP_FILE Failed to close zip file 151 ERROR_READ_ZIP_FILE Fa iled to read zip file 152 ERROR_EXTRACT_ZIP_FILE Fa iled to extract zip file 153 ERROR_CORRUPTED_ZIP_FILE The zip file appears to be corrupted 154 ERROR_CREA TE_ZIP_FILE Fa iled to create zip file 155 ERROR_MISSING_DRV_FILE[...]

C – Interactive Exit Codes SN0054614-00 F C-9 A 177 IBM Reserved Blocked 178 IBM Reserved Blocked 179 IBM Reserved Blocked 180 IBM Reserved Blocked 181 IBM Reserved Blocked 182 IBM Reserved Blocked 183 IBM Reserved Blocked 184 IBM Reserved Blocked 185 IBM Reserved Blocked 186 IBM Reserved Blocked 187 IBM Reserved Blocked 188 IBM Reserved Blocked [...]

C – Interactive Exit Codes C-10 SN0054614-00 F S 204 Reserved Not used 205 Reserved Not used 206 Reserved Not used 207 Reserved Not used 208 Reserved Not used 209 Reserved Not used 210 ERROR_MISSING_IP_ADDRESS IP address is required 21 1 ERROR_MISSING_NETMASK_ADDRESS Netmask address is required 212 ERROR_MISSING_GA TEWA Y_ADDRESS Gateway addres s[...]

C – Interactive Exit Codes SN0054614-00 F C-1 1 A 231 ERROR_SA VE_T ARGET_IIDMA_SETTING S Failed to set target link speed 232 ERROR_SET_T ARGET_IIDMA_ UNSUPPORTED T arget link speed option is not supported with current HBA 233 ERROR_INV ALID_IIDMA_SETT INGS Selected t arget link spe ed rate not sup ported with current HBA 234 Reserved Not used 23[...]

C – Interactive Exit Codes C-12 SN0054614-00 F S 256 Reserved Not used 257 Reserved Not used 258 Reserved Not used 259 Reserved Not used 260 ERROR_DRIVER_RESCAN Driver resc an op eration faile d (Solaris) 261 Reserved Not used 262 Reserved Not used 263 Reserved Not used 264 Reserved Not used 265 Reserved Not used 266 Reserved Not used 267 Reserve[...]

SN0054614-00 F D-1 Appendix D Non-interactive Error Codes T o list the SANsurfer FC HBA CLI non-interactive error codes from the comma nd line, type: scli -ei (T o see the interactive exit codes, see Appendix C .) T able D-1. Error Code Descriptions – Non-interactive Mode Code Name Description 0 SUCCESS Command exec ut ed with no error 1 ERROR_OP[...]

D – Non-interactive Erro r Codes D-2 SN0054614-00 F S 18 Re served Not used 19 ERROR_FLASH_UPDA TE_UNSUPPORTED Flash update is not supported with this HBA 20 ERROR_FLASH_OPTION_DISABLED_HBA Flash update is disabl ed with this HBA 21 ERROR_FLASH_OPTION_DISABLED_OS Flash update is disabl ed with this OS 22 ERROR_FLASH_HEADER_SIGNA TURE Flash file h[...]

D – Non-interactive Error Codes SN0054614-00 F D-3 A 41 ERROR_DIAGNOSTICS_LOOP_DOWN Unable to run diagnostics because the loop is down 42 ERROR_DIAGNOSTICS_F AILURE Di agnostics test failed with errors 43 ERROR_DIAGNOSTICS_DA T A _MISCOMP ARE Diagnostics test failed with data mis- comp are 44 ERROR_DIAGNOSTICS_UN KNOWN_ST A TUS Unknown diagnostic[...]

D – Non-interactive Erro r Codes D-4 SN0054614-00 F S 63 ERROR_RESTORE_NVRAM_DEF AU L T Faile d to restore HBA p arameters to default settings 64 Re se rv ed Not used 65 Re se rv ed Not used 66 Re se rv ed Not used 67 Re se rv ed Not used 68 Re se rv ed Not used 69 Re se rv ed Not used 70 ERROR_SA VE_HBA_FLASH_TO_FILE Faile d to save HBA flash im[...]

D – Non-interactive Error Codes SN0054614-00 F D-5 A 87 Re se rv ed Not used 88 Re se rv ed Not used 89 Re se rv ed Not used 90 ERROR_READING_BOOT_D EVICE Failed to read boot device settings of the HBA 91 ERROR_SA VING_BOOT_DEVI CE Failed to sa ve boot device sett ings to the HBA 92 ERROR_BOOT_CONFIG_DISABLED _DRIVER Boot device se ttings is disa[...]

D – Non-interactive Erro r Codes D-6 SN0054614-00 F S 109 Reserved Not u sed 1 10 ERROR_DUPLICA TE_T ARGET_ ID T arget has duplicate ID 1 1 1 ERROR_INV ALID_T ARGET_ID T arget has invalid ID 1 12 ERROR_MISMA TCH_T ARGET_ID T arget has mismatch ID 1 13 ERROR_READ_FR OM_DRIVER Failed to read persistent binding dat a from driver database 1 14 ERROR_[...]

D – Non-interactive Error Codes SN0054614-00 F D-7 A 130 ERROR_INUALID_HBA_WWID HBA WWPN/WWNN specified is invalid 131 ERROR_INV ALID_HBA_PID HBA instance specified is invalid 132 ERROR_INUALID_T ARGET_WWID T arget WWPN/WWNN specified is invalid 133 ERROR_INUALID_LUN_ID LUN ID specified is invalid 134 ERROR_MISSING_INPUT Inco mplete command line [...]

D – Non-interactive Erro r Codes D-8 SN0054614-00 F S 152 ERROR_EXTRACT_ZIP_FILE F ailed to extract zip file 153 ERROR_CORRUP TED_ZIP_FILE The zip file appears to be corrupted 154 ERROR_CREA TE_ZIP_FILE Failed to create zip file 155 ERROR_MISSING _DRV_FILE Driver sys file is missing in the driv er package 156 ERROR_EMPTY_FOLDER Driver folder is e[...]

D – Non-interactive Error Codes SN0054614-00 F D-9 A 178 IBM Reserved Blocked 179 IBM Reserved Blocked 180 IBM Reserved Blocked 181 IBM Reserved Blocked 182 IBM Reserved Blocked 183 IBM Reserved Blocked 184 IBM Reserved Blocked 185 IBM Reserved Blocked 186 IBM Reserved Blocked 187 IBM Reserved Blocked 188 IBM Reserved Blocked 189 IBM Reserved Blo[...]

D – Non-interactive Erro r Codes D-10 SN0054614-00 F S 205 Reserved Not u sed 206 Reserved Not u sed 207 Reserved Not u sed 208 Reserved Not u sed 209 Reserved Not u sed 210 ERROR_MISSING_I P_ADDRESS IP ad dress is required 21 1 ERROR_MISSING_NETMASK_ADDRESS Netmask address is required 212 ERROR_MISSING_GA TEW A Y_ADDRESS Gateway address is requi[...]

D – Non-interactive Error Codes SN0054614-00 F D-1 1 A 232 ERROR_SET_T ARGET_IIDMA_U NSUPPORTED T arget link spe ed operation i s unsup- ported with current HBA 233 ERROR_INV ALID_IIDMA_SETTINGS Sel ected targ et link speed rate not supported with curre nt HBA 234 Reserved Not u sed 235 Reserved Not u sed 236 Reserved Not u sed 237 Reserved Not u[...]

D – Non-interactive Erro r Codes D-12 SN0054614-00 F S 257 Reserved Not u sed 258 Reserved Not u sed 259 Reserved Not u sed 260 ERROR_DRIVER_RESCAN Driver rescan operation failed (Solaris) 261 Reserved Not u sed 262 Reserved Not u sed 263 Reserved Not u sed 264 Reserved Not u sed 265 Reserved Not u sed 266 Reserved Not u sed 267 Reserved Not u se[...]

SN0054614-00 F E-1 Appendix E Help Commands T able E -1 is an alphabetic listing of the Help commands. Unless o therwise noted, only one command line option per input file is valid. The hyphen ( - ) and slash ( / ) characters are equivalent. That is, scl i -g and scli /g are both valid commands. T able E -1 uses the following variables: <hba ins[...]

E – Help Commands E-2 SN0054614-00 F S –b ( <all> | <hba instance> | <hba wwpn> ) [ ( <–rg> <fw | boot| all> ) ] <file name> Updates the HBA boot code from a fil e, where:  <–rg> S pecifie s Option ROM region update m ode.  <all> Updates the flash from a fu ll image file (1MB image file)[...]

E – Help Commands SN0054614-00 F E-3 A –e ( <hba instance> | <hba wwpn> ) ( view | ? ) Shows the current boot device informa tio n on an HBA port. –e ( <hba instance> | <hba wwpn> ) ( view | ? ) Shows the current boot device informa tio n on an HBA port. –e ( <hba instance> | <hba wwpn> ) disable [ prim |[...]

E – Help Commands E-4 SN0054614-00 F S –fs ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Configures the driver settings. –gs ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Shows the current statistics on an HBA [...]

E – Help Commands SN0054614-00 F E-5 A –ls ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Shows the current link status on an HBA port. –m ( <hba instance> | <hba wwpn> ) ( view | ? ) Views selective LUN information of all devices attached to an HBA port. –m ( <[...]

E – Help Commands E-6 SN0054614-00 F S –p ( <hba instance> | <hba wwpn> ) { <target wwnn> <target wwpn> <target portid> <target id> } Binds the selected device(s) att ached to an HBA port. –p ( <hba instance> | <hba wwpn> ) remove <target wwnn> | unbind <target wwnn> Unbinds a specif[...]

E – Help Commands SN0054614-00 F E-7 A –s – Suppresses the output . This option c an be combined w ith other op tions. However , this option must be at the beginning or at the end of the command line. –t ( <hba instance> | <hba wwpn> ) Displays the in formation ab out devices (d isks or tape s) attached to an HBA port. –t ( &l[...]

E – Help Commands E-8 SN0054614-00 F S –x — Writes the ou tput in XML format 1. Option –x can be used to generate an old-style format that is compatible with previo us releases (XML format 1). This option can be combin ed with other options; however , this option must be at the beginning or at the end of th e command line. –x2 — Writes [...]

SN0054614-00 F Glossary-1 Glossary adapter See HBA. AL_P A Arbitrated Loop_Physical Address. A low-level address on the FC loop. arbitrated loop A circular (ring) topology (versus point-to-point) where two or more ports can be interconnected, but only two port s can communicate at a time. All communi- cation passes th rough all ports co nnected to [...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Glossary-2 SN0054614-00 F S driver The software t hat interfaces between the file system and a physical dat a storage device or network media. The level structure for Windows XP Professional/2000/Windows Server 2003 drivers is as follows:  Cla[...]

SN0054614-00 F Glossary-3 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A F_Port The “Fabric” port in a FC fabric switch provides a point-to-point link att achment to a single N_Port. F_Port s are intermediate ports in virtual point-to-p oint links between end ports, for example N_Port [...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Glossary-4 SN0054614-00 F S IOCB I/O control block. An IOCB is a command structure in QLogic ISP architect ure. ioctl (input/output control) A system call in Uni x/Linux systems. Allows an application to control or commu- nicate with a device dri[...]

SN0054614-00 F Glossary-5 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A N_Port ID Virtualization The ability for a single physica l FC end point (N_Port) to support multiple, uniquely addressable, logical end point s. With NPIV , a host FC adapter is shared in such a way that each virtual[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Glossary-6 SN0054614-00 F S  N_Port (Node Port) —an FC port that supports poin t-to-point topology .  NL_Port (Node Loop Port) —an FC port that supports loo p topology .  F_Port (Fabric Port) —a port in a fabric where an N_Port can[...]

SN0054614-00 F Index-1 Index A -a 4-61, 5-6 abort changes to HBA p arameters 4-29 about the product 4-88 adapter , definition of Glossary-1 Adjunct driver level, definition of Glossary-2 AL_P A, definition of Glossary-1 alias HBA 5-6, A-14 HBA information 4-18 HBA port 4-19 arbitrated loop, definition of Glossary-1 Arbitrated Loop_Physical Address,[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-2 SN0054614-00 F S commands interactive mode 4-1 non-interactive mode 2-3, 5-1, 5-5 -a 4-61, 5-6 -b 4-8, 4-56, 5-7 -c 4-18, 4-22, 5-8, A-3, B-2 -d 4-60, 5-8 -dm 4-62, 4-72, 5-9, A-15, B-3 -e 4-51, 5-9, A-8, B-8 -ei 5-12, D-1 -f 5-12 -fg 4-5[...]

SN0054614-00 F Index-3 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A DataSize p arameter 5-26 default restoring 4-78 restoring for link 4-81 defining port alias 5-36 definitions of terms Glossary-1 delay timer , interrupt 4-23, 4-27 delay , loop reset 4-23 deleting virtual port 4-86 devic[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-4 SN0054614-00 F S enabling LUNs 5-29 error codes interactive mode C-1 listing 5-12 non-interactive mode D-1 error message XML Format 1 A-2 XML Format 2 B-2 execution throttle 4-23, 4-27 ExecutionT rottle parameter 5-32 exit codes, interact[...]

SN0054614-00 F Index-5 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A HBA (continued) hard loop ID 4-23 host informati o n, viewin g 4-2 iiDMA settings 4-45 information 4-17, 4-18, 5-2 viewing 5-17, A-4, A-10, B-11, B-17 viewing all 5-42 viewing by port number 4-18 instance 5-6 locating (b[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-6 SN0054614-00 F S installation (continued) Solaris 3-8 Solaris SP ARC 8, 9, 10 3-8 Solaris x86 9, 10 3-9 Windows 3-2 instance number 5-6 port, definition of Glossary-6 interactive mode 4-1 See also non-interactive mode definition of 2-1 ex[...]

SN0054614-00 F Index-7 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A loop preferred connection 4-25 reset delay 4-23, 4-26 loop (abitrated), definition of Glossary-1 loop ID, definition of Glossary-4 Loop Initialization Process (LI P), definition of Glossary-4 Loop Port (L_Port), definiti[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-8 SN0054614-00 F S non-interactive mode (continued ) error codes D-1 starting 2-3 Non-volatile Random Access Memory (NVRAM), definition of Glossary-5 NPIV (N_Port ID Virtualizat ion) Virtual Menu option 4-83 NPIV , definition of Glossary-4 [...]

SN0054614-00 F Index-9 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A port driver , definition of Glossary-2 PortDownRetryCount paramete r 5-32 Q -q 4-38, 5-36 QLA/QLE/QEM HBAs supported by 1-4 QLA/QLE24xx 5-5 QLA23xx 4-23, 5-21 QLA24xx 5-21 QLA24xx HBA, VPD 4-20 QLE23xx 4-23, 5-21 QLE24xx[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-10 SN0054614-00 F S show HBA information 5-5 HBA settings 5-4 link status 4-82 LUN list 5-5 parameter settings 5-8 system information 5-4 target list 5-5 silent mode 5-5, 5-38 size, frame 4-25 Small Computer System Interface (SCSI ), defini[...]

SN0054614-00 F Index-1 1 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A test count parameter 5-20 diagnostics loopback 4-63 increment paramete r 5-20 loopback 4-64 loopback, preparing for 4-65 number of tests p arameter 5-20, 5-26 pattern 5-26 read/write buf fer 4-66, 5-23 results, loop ba[...]

SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-12 SN0054614-00 F S W Windows driver level structure Glossary-2 installing on 3-2 operating systems supp orted by SANsurfer FC HBA CLI 1-4 uninstalling from 3-13 Windows V irtual Server environment 4-84 WWPN, bind by WWPN parameter 5-14 X -[...]