Instruction/ maintenance manual of the product FC HBA CLI Q-Logic
Go to page of 280
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.
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.
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 .
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.
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).
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.
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.
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.
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 . . . . . . . . . . . . . . . . . . . . . . . . . .
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 .
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) .
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 .
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 .
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) .
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) .
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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).
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.
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.
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.
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.
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.
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 .
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 – 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 – 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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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 .
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.
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.
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.
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.
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.
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 .
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 – 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.
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 – 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.
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.
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.
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 .
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 .
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.
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 .
4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-6 SN0054614-00 F S Here is an example: ================================= = InterConnect Element = =====================.
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.
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 Wi.
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.
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 HB.
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 Num.
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 .
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 .
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 .
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 -------------------------------- Dri.
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 ------------------------------------ ------------------------ ---.
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 ------.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 arge.
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 .
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 .
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 – 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 t.
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.
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 – 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.
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 arge.
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.
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 – 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 Sp.
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.
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 .
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.
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 : .
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.
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.
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: ------------------------------------------------------.
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.
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.
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.
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.
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 U.
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.
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 of.
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.
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 .
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.
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: .
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.
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 .
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 .
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).
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.
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.
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.
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.
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 --------------------------------------------------.
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.
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.
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 .
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.
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.
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.
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.
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.
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 – 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.
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.
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 .
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 V.
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.
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.
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.
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.
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.
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.
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.
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 – 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.
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.
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.
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 se.
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.
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 – 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.
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 .
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).
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.
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 informa.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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 HB.
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 .
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 op.
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.
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.
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 - x.
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 .
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 &.
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 > | al.
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> ].
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 .
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 >) lis.
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.
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.
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.
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.
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.
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.
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=".
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.
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.
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 – 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.
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.
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&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.
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.
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.
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>"v.
A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-17 A <FCTransmitterTech>"value"</FCTransmitterTech> <FCTransmissionMedia>"value"</FCTran.
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 </C.
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> &l.
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.
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> .
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.
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.
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.
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 infor.
B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-5 A <MeasuredTxPowerUnit>(mW)</MeasuredTxPowerUnit> <Value>"value"</Value> <Status>"value&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.
B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-7 A <TempHighWarning>"value"</TempHighWarning> <TempLowWarning>"value" </TempLowWarning> <.
B – XML Format 2 XML2 T ags for Each Optio n B-8 SN0054614-00 F S <TXFault> "value" </TXFault> <SoftRXRateSelect> "value" </SoftRXRateSelect> <RXRateSe.
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 &g.
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&q.
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.
B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-13 A <VPD> <VPD ProductIdentifier="value" PartNumber="value" SerialNumber="val.
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 >] (< Param.
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=&.
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 te.
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" D.
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.
B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-19 A OperationMode="value" IntDelayTimer="value" ExecutionThrottle="value" LoginRe.
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 > |.
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 – 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&qu.
B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-23 A <Speed>"value"</Speed> <Revision>"value"</Revision> <SerialN.
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.
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> .
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.
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 checksu.
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_DIAGNOSTI.
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 pecif.
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 .
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.
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 ER.
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 f.
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 .
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.
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 su.
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 (So.
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 .
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 up.
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 err.
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 s.
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 .
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 ER.
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 AR.
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_.
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 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_ADDRES.
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.
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 Reser.
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.
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.
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 – Help Commands E-4 SN0054614-00 F S –fs ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Configures the driver settings.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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, defin.
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-6.
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-8.
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-in.
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 iiD.
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 Solari.
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).
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-vola.
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.
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-.
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 parame.
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 operatin.
An important point after buying a device Q-Logic FC HBA CLI (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought Q-Logic FC HBA CLI yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data Q-Logic FC HBA CLI - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, Q-Logic FC HBA CLI you will learn all the available features of the product, as well as information on its operation. The information that you get Q-Logic FC HBA CLI will certainly help you make a decision on the purchase.
If you already are a holder of Q-Logic FC HBA CLI, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime Q-Logic FC HBA CLI.
However, one of the most important roles played by the user manual is to help in solving problems with Q-Logic FC HBA CLI. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device Q-Logic FC HBA CLI along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
