Q-Logic SN0054621-00 E manual

SN0054621-00 E SANsurfer iSCSI HBA CLI User ’ s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters[...]

Page ii SN0054621-00 E S SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Information fu rnished in this manual is believed to be accurate and reliable. However , QLogic Corporation assumes no responsibility for its use, nor for any infringements of patent s or other rights of third part ies which m[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters SN0054621-00 E Page iii S Updated (added and remove d paramete rs) the list of device settings. “Configure Device Settings” on p age 4-25 Updated (added and remove d paramete rs) the list of basic settings. “Configure Basic Settings” on p age[...]

Page iv SN0054621-00 E S SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Added missing de scriptions for IPv4TOS and IPv4TTL parameters . Deleted obsolete Primary_DNS a nd SLP_Address parameters. Appendix C T arget Parameters Moved trace information from 5 Non-Inte ractive Mode Commands to a new ap[...]

SN0054621-00 E Page v T able of Content s 1 Introduction Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 How This Guide is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 T ypographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

Page vi SN0054621-00 E SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters S 3 Getting St arted Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 S tarting Interactive Mo de . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

SN0054621-00 E Page vii SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A Configure Link Configuration (CLI Option -lc) . . . . . . . . . . . . . . . 4-20 Save Changes and Reset HBA (if necessary) . . . . . . . . . . . . . . 4-20 Port Network Settings Menu . . . . . . . . . . . . . . . . . . . . .[...]

Page viii SN0054621-00 E SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters S T arget Level Info & Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36 List T argets (CLI Option -t) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37 Display T arget Information (C[...]

SN0054621-00 E Page ix SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A -dr (Display Default Router List [IPv6 only]) . . . . . . . . . . . . . . . . . . . . 5-8 -dspchap (Display a CHAP T able) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 -dt dsp (Display Discovered T argets) . . [...]

Page x SN0054621-00 E SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters S -pb (Bind T arget) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24 -pbootcode (Set Primary Boot T arget Information) . . . . . . . . . . . . . . . 5-24 -pdt . . . . . . . . . . . . . . . .[...]

SN0054621-00 E Page xi SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A D Error Codes Interactive Mode Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1 Non-interactive Mode Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-5 E Downl[...]

Page xii SN0054621-00 E SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters S List of Figures Figure Page 2-1 Install Wizard: W elcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 2-2 Install Wizard: Sele ct Which Users . . . . . . . . . . . . . . . . [...]

SN0054621-00 E 1-1 1 Introduction The command line interf ace (CLI) applicatio n is a simplified, condensed version of the SANsurfer iSCSI HBA Manager graphical user interf ace (GUI). SANsurfer iSCSI HBA CLI does not provide any features that re quire a GUI. This introductory chapter covers the following:  “Intended Audience” on page 1-1 [...]

1 – Introduction How This Guide is Organized 1-2 SN0054621-00 E S  Appendix A Port- and HBA-level Parameters provides an alphabetic list of the HBA port firmware p arameters and their values.  Appendix B HBA S tatistics provides an alp habetic list of the HBA st atistics shown when you select either the interactive mode Display HBA Statisti[...]

1 – Introduction How This Guide is Organized SN0054621-00 E 1-3 A  Italicized text within a ngle brackets indicates use r-defined variables. For example: -arp <hba_port_inst>  T ext within square brackets indicates optional parame ters. For example iscli [optional parameters] [ Command Variable ]  T ext shown in blue indicates a cr[...]

1 – Introduction Supported QLo gic HBAs 1-4 SN0054621-00 E S Supported QLogic HBAs SANsurfer iSCSI HBA CLI is supported on the fo llowing QLogic HBAs: Supported Operating Systems SANsurfer iSCSI HBA CLI is supported on the fo llowing operating systems:  Windows ® 2000 Server SP4+ (IA32, x64)  Windows Server ™ 2003, S tandard or Enterpris[...]

1 – Introduction License Agreeme nts SN0054621-00 E 1-5 A License Agreement s Refer to the QLogic Software End User License Agreement f or a complete listing of all license agreements af fecting this product. T echnical Support Customers should cont act their authorized maintenance provider for technical support of their QLogic switch product s. [...]

1 – Introduction T echnical Supp ort 1-6 SN0054621-00 E S The QLogic knowledge dat abase contains troubleshooting information for the QLogic HBAs. Access the database from the QLogic W eb site, www .qlogic.com . Click the Support t ab, and then use the search engine at the top of the p age to look for specific trouble shooting information.[...]

SN0054621-00 E 2-1 2 Inst allation and Removal This section provides procedures for the following:  “Installing SANsurfer iSCSI HBA CLI” on p age 2-1  “Removing SANsurfer iSCSI HBA CLI” on p age 2-12 Before you can run SANsurfer iSCSI HBA CLI, ensure that your system meet s the following requirement s:  HBAs are installed .  HBA[...]

2 – Inst allation and Remo val Installing SANsurfer iSCSI HBA CLI 2-2 SN0054621-00 E S 3. Under Drivers, Managemen t T ools, and API Libraries: click the appropriate operating system. 4. In the SANsurfer iSCSI row of the Managemen t T ools table , in the Download column, click Download. SANsurfer iSCSI HBA CLI shows the End User License Ag reemen[...]

2 – Installation and Removal Installing SANsurfer iSCSI HBA CLI SN0054621-00 E 2-3 A  Windows Server 2003, S tandard or Enterprise Ed ition, SP2 (IA32, x64)  Windows XP Professional (IA32, x64) SP2  Windows V ista (IA32, x6 4) (Busi ness and Enterprise editions)  Windows Preinstalled En vironment (PE) 2.0, PE 2004, PE 2005  Red Hat[...]

2 – Inst allation and Remo val Installing SANsurfer iSCSI HBA CLI 2-4 SN0054621-00 E S Inst alling on Microsof t Windows Choose one of the following optio ns for installing SANsurfe r iSCSI HBA CLI:  “Windows S tandard (GUI) I nstallatio n” on page 2-4  “Windows Command Line Inst allation” on page 2-9 Windows S tandard (GUI) Inst al[...]

2 – Installation and Removal Installing SANsurfer iSCSI HBA CLI SN0054621-00 E 2-5 A The Select Which Users window appears, as shown in Figure 2-2 . Figure 2-2 Install Wiza rd: Select Which Users 3. Choose whether you want SANsurfer iSCSI HBA CLI available for all users or only the current user , and then click Next. The Destination Folder window[...]

2 – Inst allation and Remo val Installing SANsurfer iSCSI HBA CLI 2-6 SN0054621-00 E S 4. Choose one of the following options:  T o select the destination in the dialog box, click Next (recommended). The default location for a Microsof t Windows system is: Program FilesQLogic CorporationSANsurferiCLI  T o select a different locatio n, cli[...]

2 – Installation and Removal Installing SANsurfer iSCSI HBA CLI SN0054621-00 E 2-7 A The installer shows the progress of file copying, as shown in Figure 2-5 . Figure 2-5 Install Wizard : Installing SANsurferiCLI 6. Read the information, and then click Next .[...]

2 – Inst allation and Remo val Installing SANsurfer iSCSI HBA CLI 2-8 SN0054621-00 E S When finished, the inst aller shows the InstallShield Wizard Complete d window , as shown in Figure 2-6 . Figure 2-6 Install Wizard: Complete 7. Click Finish . 8. Restart your computer .[...]

2 – Installation and Removal Installing SANsurfer iSCSI HBA CLI SN0054621-00 E 2-9 A Windows Command Line Inst allation Y ou can install SANsurfer iSCSI HBA CLI from the comman d prompt using the Microsoft Windows I nstaller (MSI ). Use one of the following methods:  “S tandard Windo ws Interactive (CLI) Inst allation” on page 2-9  “Q[...]

2 – Inst allation and Remo val Installing SANsurfer iSCSI HBA CLI 2-10 SN0054621-00 E S Overwrite Previous Window s Inst allations T ype the following for an installation that overwrites any prev ious installations without asking for confirmation. T ype: SANsurferX-AgentOnly.msi /i FORCEINSTALL=TRUE Inst alling on Red Hat/SUSE Linux/PPC SANsurfer[...]

2 – Installation and Removal Installing SANsurfer iSCSI HBA CLI SN0054621-00 E 2-1 1 A Solaris Silent Inst allation This section contain s a pkgadd (SOLARIS) example for silent inst allation. T o inst all silently on Solaris: 1. Create the following two files: response.txt noask_pkgadd.txt 2. Run the pkgadd command. 3. Create the response.txt fil[...]

2 – Inst allation and Remo val Removing SANsurfer iSCSI HBA CLI 2-12 SN0054621-00 E S Removing SANsurfer iSCSI HBA CLI T o remove SANsurfer iSCSI HBA CLI from y our system, follow the instructions that that correspond to your OS:  “Microsoft Windows Uninst all” on page 2-12  “Red Hat/SUSE Linux/PPC Uninst all” on page 2-13  “So[...]

2 – Installation and Removal Removing SANsurfer iSCSI HBA CLI SN0054621-00 E 2-13 A T o uninst all quietly from the command line: Enter the following from a command prompt: msiexec /q /x SANsurferiCLI.msi Red Hat/SUSE Linux/PPC Uninst all T o uninstall SANsurfer iSCSI HBA CLI on a Red Hat/SUSE Linux/PPC operating system, enter the following from [...]

2 – Inst allation and Remo val Removing SANsurfer iSCSI HBA CLI 2-14 SN0054621-00 E S Notes[...]

SN0054621-00 E 3-1 3 Getting S t arted Introduction SANsurfer iSCSI HBA CLI operates in the two following modes:  Interactive mode. SANsurfe r iSCSI HBA CLI start s and prompts for user input. Based on the input, the CLI executes the specified commands until terminated by the user . Use this mode to perform multiple operations. 4 Interactive Mod[...]

3 – Getting S tarted S tarting Non-inte ractive Mode 3-2 SN0054621-00 E S The Windows system displays the Main Menu . For example: main Interactive Menu ------------------------------------------------------- Program Version: 1.2.00.xx Driver Version: 2.1.x.x (STOR w32) IC: 1 Current HBA/Port Information: HBA Alias: qlogic HBA: 0 Port: 0 HBA Port[...]

SN0054621-00 E 4-1 4 Interactive Mode Commands This chapter provides an explanation of each menu and menu o ption in the SANsurfer iSCSI interactive command line inte rface (CLI). The command line interface commands are nested an d some selections from the main menu open new menus. For example, if you click item 2. Host Level Info & Operations [...]

4 – Interactive Mo de Commands 4-2 SN0054621-00 E S T able 4-1. Command Line Interface Menu Level 1 Level 2 Level 3 Level 4 (Shown in Bold Black ) (Shown in Black) (Shown in Brown ) (Shown in Green ) 1. Display Program V ersion Information (see page 4-8 ) 2. Host Level Info & Operations (see page 4-8 ) 1. DIsplay General System Information (s[...]

4 – Interactive Mode Commands SN0054621-00 E 4-3 A 4. HBA Diagnostic Menu (see page 4-15 ) 1. Retrieve FW Crash Record (see page 4-15 ) 2. Retrieve FW Flash & NVRAM Record (see pa ge 4-15 ) 3. Retrieve FW Coredump Record (see page 4-16 ) 4. Display HBA Level S tatistics (see p age 4-16 ) 5. Select HBA Port (see page 4-49 ) 6. Refresh (see pag[...]

4 – Interactive Mo de Commands 4-4 SN0054621-00 E S 2. Port Network Settings Menu (see page 4- 20 ) 1. Display Network Settings (see page 4-20 ) 2. Configure IP Settings (see page 4- 21 ) 3. iSNS Settings (see page 4-21 ) 4. Select HBA Port (see page 4-49 ) 5. Save Changes and Reset HBA (see pag e 4-18 ) 6. Refresh (see page 4-49 ) 7. Exit (see p[...]

4 – Interactive Mode Commands SN0054621-00 E 4-5 A 5. Port Diagnostic Menu (see page 4-29 ) 1. Ping T arget (see page 4- 30 ) 2. Perform Loopback T est (see page 4- 31 ) 3. Perform Read/W rite Buffer T est (see page 4-31 ) 4. Display Port S tatistics (see page 4-32 ) 5. Reset S tatistics (see page 4- 32 ) 6. Display ARP T able (see page 4-32 ) 7.[...]

4 – Interactive Mo de Commands 4-6 SN0054621-00 E S 7. T arget L evel Info & Operat ions (see page 4- 36 ) 1. List T argets (see page 4-37 ) 2. Display T arget Information (see p age 4-37 ) 3. Bind T arget (see page 4-39 ) 4. Delete T arget (see page 4-39 ) 5. Configur e T arg et Parameters (see page 4-39 ) 6. Add a T arget (s ee page 4-40 ) [...]

4 – Interactive Mode Commands SN0054621-00 E 4-7 A 10. T arget Discov ery Menu (see p age 4-44 ) 1. Display Send T argets (see p age 4-45 ) 2. Display Discovered T argets (see page 4-45 ) 3. Add a Sen d T arg et (see page 4-45 ) 4. Mark Send T arget for Re-discovery (see p age 4-45 ) 5. Remove a Send T arge t (see page 4-46 ) 6. Login and pers is[...]

4 – Interactive Mo de Commands Display Program V e rs ion Information (CLI Option -ver) 4-8 SN0054621-00 E S Display Program V ersion Information (CLI Option -ver) When you select this option, SANsurf er iSCSI HBA CLI displays the following information: SANsurfer iSCSI HBA CLI Program version : x.x.xx.xx iSDMAPI (iSCSI SAN device manager API) xx.[...]

4 – Interactive Mode Commands Host Level Info & Operations Menu SN0054621-00 E 4-9 A Display General System Information (CLI Option -g) Choose the Display General System Information o ption to show information about SANsurfer iSCSI HBA CLI; for example: Host Name : ( name ) Host Version: Service Pack n (Build xxxx ) Host Type : Microsoft Wind[...]

4 – Interactive Mo de Commands Host Level Info & Operations Menu 4-10 SN0054621-00 E S Import HBA Configuration (CLI Optio n -import) T o import a single HBA configuration: 1. From the HBA Import Menu , type the nu mber for the Import option, and then press ENTER . SANsurfer iSCSI HBA CLI prompt s you to enter a file name cont aining the HBA [...]

4 – Interactive Mode Commands Host Level Info & Operations Menu SN0054621-00 E 4-1 1 A After you have selected the p arameter sets to import, the following messag e is displayed: Resetting HBA This may take a few minutes. After the HBA is reset, th e HBA Import Menu reappears. Up date Firmware, Multiple Adapters When you select the Update Fir[...]

4 – Interactive Mo de Commands HBA Level Info & Operations Menu (CLI Option -i) 4-12 SN0054621-00 E S HBA Level Info & Operations Menu (CLI Option -i) The HBA Level Info & Op erations Menu provides the following o ptions for each HBA port instance: 1. HBA Information (see page 4-12 ) 2. HBA Options Menu (see page 4-13 ) 3. HBA Reset ([...]

4 – Interactive Mode Commands HBA Level Info & Operations Menu (CLI Optio n -i) SN0054621-00 E 4-13 A HBA Options Menu (No CLI Option) The HBA Options Menu provides the following se lections: 1. Update BIOS/UEFI [or FCode] Code Image (see p age 4-13 ) 2. Update Firmware Image (see p age 4-13 ) 3. Update ROM Image (see page 4-14 ) 4. Select HB[...]

4 – Interactive Mo de Commands HBA Level Info & Operations Menu (CLI Option -i) 4-14 SN0054621-00 E S Up date ROM Image (CLI Opt ion -r) Select the Update ROM Image option to update the ROM image. At the prompt, type the name of the file cont aining the ROM image to upload to the HBA. For information on ROM Image file names, see Appe ndix E D[...]

4 – Interactive Mode Commands HBA Level Info & Operations Menu (CLI Optio n -i) SN0054621-00 E 4-15 A HBA Diagnostic Menu (No CLI Option) The HBA Diagnostic Menu provides th e following options: 1. Retrieve FW Crash Record (see p age 4-15 ) 2. Retrieve FW Flash & NVRAM Record (see page 4-15 ) 3. Retrieve FW Coredump Record (see p age 4-16[...]

4 – Interactive Mo de Commands HBA Level Info & Operations Menu (CLI Option -i) 4-16 SN0054621-00 E S Retrieve FW Coredump Record (CLI Option -dumpcore) When you select the Retrieve FW Coredump Record option, SANsurf er iSCSI HBA CLI queries you for the name of a file in which to d ump the Flash and core contents. Be sure to use full p ath na[...]

4 – Interactive Mode Commands HBA Level Info & Operations Menu (CLI Optio n -i) SN0054621-00 E 4-17 A MACRxLengthErrorCountLarge : 0 MACRxLengthErrorCountSmall : 0 MACRxMulticast : 402 MACRxBroadcast : 177 HBA Level Parameters Menu (No CLI Option) T o make changes to the HBA level p arameters: 1. S pecify the HBA port whose settings you want [...]

4 – Interactive Mo de Commands HBA Level Info & Operations Menu (CLI Option -i) 4-18 SN0054621-00 E S HBA_Reserved_TCP_Config : 0x0001314c HBA_Delayed_ACK : on Note that not all pa rameters are available for all HBA models. Configure HBA Level Parameters (CLI Opt ion -n) Select the Configure HBA Level Parameters option to configure a single p[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-19 A Port Level Info & Operations Menu The Port Level Info & Ope rations Menu provides the following options: 1. Port Link Settings (see p age 4-19 ) 2. Port Network Settings Menu (see p age 4-20 ) 3. Edit Configured Port Settings Menu (see page 4-22 ) 4.[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-20 SN0054621-00 E S Display Configured Link Configuration (CLI Opt ion -lcd) Select the Display Configured Link Configuration option to view the following information about the configured link: Portal Flow Control : ( on or off ) Auto-negotiate link speed: ( on or off ) Link S[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-21 A Link Local Address : fe80::2c0:ddff:fe08:5a13 IPv6 Local Address State : Valid (0x5) IPv6 Address 0 : Source Address Not Valid IPv6 Address 1 : Source Address Not Valid IPv6 Default Router : Router Address Not Valid IPv6 Port Number : 3260 IPv6 Router Adv Li[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-22 SN0054621-00 E S Edit Configured Port Settings Menu T o edit the configured HBA settings: 1. S pecify the HBA port whose settings you want to view or change by typing the number for Select HBA Po rt , and then pressing ENTER . SANsurfer iSCSI HBA CLI lists all iSCSI HBA por[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-23 A HBA port aliases are communicated between the initia tor and target at login, and can be displayed on the PC monitor on bot h sides, making it easy to see if the initiators and t argets are correct . Do not use the alias to identify , address, or authenticat[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-24 SN0054621-00 E S  Basic settings for inst ance 0  Advanced settings for inst ance 0 Edit a Specific Port Setting Use the Edit a Specific Port Set ting option when you know the name and parameters of the settings you want to change. For a list of parameter names and va[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-25 A Each setting is displayed with the current value in bracket s, for example: iSCSI_Snack [off] : T o change the value, type the new value af ter the prompt. T o keep the current value, press ENTER at the prompt. The next iSCSI set ting appears. The settings a[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-26 SN0054621-00 E S Configure Basic Settings Select the Configure Basic Settings optio n to modify the following settings (listed here in alphabetic order):  ENABLE_4022IPv4  ENABLE_IPv4  ENABLE_IPv6  IP_Address  IP_Gateway  IP_Subnet_Mask  IPv6_Addr_Local[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-27 A  IPv6_DAD_Count  IPv6_Hop_Limit  IPv6_MCast_Listnr_Disco_Enable  IPv6_ND_Reachable_ T imer  IPv6_ND_Retransmit_T imer  IPv6_ND_S tale_T imeout  IPv6_TCP_T ime_S tamp  IPv6_TCP_Window_Scale  IPv6_T raffic_Class  IPv6_VLAN_Enable [...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-28 SN0054621-00 E S IPv6_Port [3260] :_ IPv6_Gratuitious_Neighbor_Ad_Enable [off] :_ IPv6_Redirect_Enable [off] :_ Configure IPv6 TCP Settings Select the Configure IPv6 TCP Settings option to view each cu rrent IPv6 TCP setting and, optionally , changing a setting. For example[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-29 A  If you want to restore all the default s, press ENTER .  If you want to restore some of the default s, type no , and then press ENTER . Each setting appears one-by-o ne, in the order listed in th e preceding. T o restore the factory default for that s[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-30 SN0054621-00 E S 4. After making changes, refre sh the HBA to show these cha nges by typing 6 ( Refresh ), and then pressing ENTER . If you do not select this op tion, your changes will not be visible in SANsurfer iSCSI HBA CLI. Ping T arget (CLI Option -ping) T o ping a t [...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-31 A Enter Choice:1 Ping to fe80::2a0:98ff:fe03:c98e successful (1 of 1). Press the Enter key to continue. Perform Loopback T est (CLI Option -lb) T o st art a loopback test: 1. On the Port Diagnostic Menu , type the number for the Perform Loopback T est option, [...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-32 SN0054621-00 E S 3. T ype the number corresponding to the data p attern you want, and then press ENTER . 4. If you want to stop the loopback test if an error o ccurs, type y for the Stop on error[Y]? option. After the test is done, the number of failed test s and successful[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-33 A Export Connection Error Log When you select the Export Connection Error Log option, SANsurfer iSCSI HBA CLI prompts you for a file name with which to save th e log of connection errors. Enter a file name and then press ENTER . Display Neighbor Cache (IPv6) ([...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-34 SN0054621-00 E S FW Boot time = Mon Apr 23 17:08:56 2007 BIOS/UEFI [or FCode] Settings Menu SANsurfer iSCSI HBA CLI detects the system architecture and shows this menu as either BIOS/UEFI Settings Menu or FCode Settings Menu , depending on your system. On Intel type machine[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-35 A Display BIOS/UEFI [o r FCode] Information (CLI Opt ion -binfo) Select the Display BIOS/UEFI Informat ion or Display FCode Information option (this menu option varies depending on your system architecture) to view information about the bootcod e. For example:[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-36 SN0054621-00 E S Clear Primary Boot T a rget Information (CLI Option -cpbootc ode) Select the Clear Primary Boot Target Information option to disable the primary boot target. At t he prompt, type a ta rget ID and associated LUN. Clear Secondary Boot T arget Information (CLI[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-37 A 4. For each submenu, save the chan ges by typing the numbe r for the Save T arget/CHAP changes option, and then pressing ENTER . 5. T ype the number for the Refresh option, and then press ENTER . If you do not select this option, your changes w ill not be vi[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-38 SN0054621-00 E S TGTO_Active : off(*) TGTO_Access_Granted : off(*) TGTO_Target_Entry : on(*) TGTO_Initiator_Entry : off(*) TGT_RetryCount : 0(*) TGT_RetryDelay : 0(*) TGT_DevType : 0(*) TGT_ExeThrottle : 64 TGT_FirstBurstLen : 128 TGTIPO_Fragmentation : on(*) TGTISCSIO_Forc[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-39 A TGT_TargetSessID : 5(*) TGT_TargetIPAddress : 10.14.64.154 TGT_Window_Scale_Enable : on TGT_Rx_Window_Scale : 0 TGT_Tx_Window_Scale : 2(*) TGT_TimeStamp_Enable : 64(*) TGT_DDB_IPv6 : off TGT_IPv6_Address : a0e:409a:: TGT_Local_TCP_Port : 29251(*) TGT_Type_of[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-40 SN0054621-00 E S Add a T arget (CLI Opt ion -pa) Select the Add a Target option to add a new t arget to the current working adapter . When prompted, type the following info rmation for the new target; the p arameters are displayed one at a time:  TGT_iSCSI_Name (target i[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-41 A 3. From the HBA CHAP Menu , make changes as needed by selecting from the following options: 1. Display CHAP table (see p age 4-41 ) 2. Display Targets Using CHAP Entries (see page 4-41 ) 3. Assign a CHAP Entry to a Target (see p age 4-42 ) 4. Add a CHAP Entr[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-42 SN0054621-00 E S  Name (CHAP name)  Secret (CHAP secret) Assign a CHAP Entry to a T arget (CLI Option -linkchap) T o assign a CHAP entry to a t arget: 1. On the HBA CHAP Menu , type 3 ( Assign a CHAP Entry to a Target ). SANsurfer iSCSI HBA CLI lists available targe t[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-43 A Add a Default BIDI CHAP (CLI Option -defbidi) A default bidirectional (BIDI) CHAP causes the HBA to authenticate only the CHAP secrets of a ll targe ts with CHAP (the CHAP names are ignored). In addition, the CHAP names of any bidirectional CHAP entries are [...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-44 SN0054621-00 E S  If you do not want the HBA to authenticate the t arget and the prompt is CHAPBidi [off] , press ENTER . If the prompt is CHAPBidi [on] , type off , and then press ENTER . Y ou can also edit a CHAP entry with the -edchap command. See “-edchap (Edit a C[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-45 A Select the Target Discovery Menu option to view the HBA Target Discovery Menu containing the following options: 1. Display Send Targets (see p age 4-45 ) 2. Display Discovered Targets (see p age 4-45 ) 3. Add a Send Target (see p age 4-45 ) 4. Mark Send Targ[...]

4 – Interactive Mo de Commands Port Level Info & Operations Menu 4-46 SN0054621-00 E S Remove a Send T a rget Select the Remove a Send Targ et option to remove only non-persistent o r send target s local to the SANsurfer iSCSI HBA CLI dat abase. T o remove target s stored in the HBA database, u se the Delete Target option instead (see p age 4[...]

4 – Interactive Mode Commands Port Level Info & Operations Menu SN0054621-00 E 4-47 A List LUN Information (CLI Opt ion -l) Select the List LUN Information op tion to view the following informa tion about LUNs attached to the selected t arget:  HBA/T arget/LUN Number  V endor name  Product ID  Product revision  LUN size Y ou ca[...]

4 – Interactive Mo de Commands List All QLogic iSCSI HBA Port s Detected (CLI Option -i) 4-48 SN0054621-00 E S List All QLogic iSCSI HBA Port s Detected (CLI Option -i) Select the List All QLogic iSCSI HBA Ports Detec ted option to view the following information for all HBA p orts in the system:  HBA model (HBA name, for example, QLA4010)  [...]

4 – Interactive Mode Commands Help (CLI Option -h) SN0054621-00 E 4-49 A Help (CLI Option -h) Select the Help option to view the SANsurfer iSCSI HBA CLI help file, which contains a list of non-intera ctive m ode commands and the synt ax of each. Y ou can also obtain assi stance by entering the -h command; see “-h (Help)” on page 5-13 . Select[...]

4 – Interactive Mo de Commands Exit (No CLI Opti on) 4-50 SN0054621-00 E S Exit (No CLI Option) T o return to the next higher level (pare nt) menu, type the number for Exit , and then press ENTER . If you are at the top-level of the interactive menu, the CLI of fers you the option to save or discard any cha nges you made, and then closes.[...]

SN0054621-00 E 5-1 5 Non-Interactive Mode Commands Use non-interactive commands in scrip ts and simila r applications to configure QLogic QLA4xxx iSCSI HBAs and the stora ge connected to the m. If you prefer to work with the HBA from a menu-base d system, use Interactive mode commands instead (for deta ils, see Section 4 Interactive Mode Commands )[...]

5 – Non-Intera ctive Mode Commands 5-2 SN0054621-00 E S T able 5-1 defines the command variables. The command section to which they apply . describes command-specific variables. The positional p arameters vary , depending on the command option specified. For example, to display an HBA ’s configured settings, use the command option -C , followed[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-3 A Non-interactive Commands This section contain s an alphabetical list of the SANsurfer iSCSI HBA CLI commands used in non-interactive mode. -acb T o inquire whether the ACB (access method contro l block) firmware functions are supported, enter the -acb command. In gene[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-4 SN0054621-00 E S For information on the interactive version of this command “HBA Reset (CLI Option -b)” on pa ge 4-14 . -binfo (Display BIOS/UEFI [or FCode] Informatio n) T o display the bootcode settings for the specified HBA port, enter the -binfo command as follows: -binfo <[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-5 A Where: If HBA DHCP is enabled (see “-ipdhcp (Configure IP Settin gs)” on p age 5-16 ), modes 1–3 are allowed. If HBA DHCP is not enabled, bootcode DHCP is not allowed. This mode is not supported for QLA40 10 HBAs. This mode is not active for the PPC. For IBM car[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-6 SN0054621-00 E S For a list of HBA settings, see T able 5-3 on page 5-19 . For a complete list of HBA parameters, see Appendix C T arget Parameters . For information on the int eractiv e version of this command, see “HBA Information (CLI Option -ch)” on page 4-12 . -chapmap (Disp[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-7 A For information on the interactive version of this command, see “Install HBA Driver , All Adapters (CLI Option -d)” on page 4-1 1 . -dc (Display Destination Cache [IPv6 only]) The IPv6 destination cache cont ains th e IP address, next-hop IP address, and path MTU [...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-8 SN0054621-00 E S -df T o view the firmware properties, enter the -df command as follows: -df <hba_port_inst> SANsurfer iSCSI HBA CLI displays information about the HBA: mo del, serial number , port number , iSCSI name, alias, IP address, instance number , and the following firm[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-9 A -dr < hba_port_inst > For information on the interactive version of this command, “Display Default Router List (IPv6) (CLI Option -dr)” on page 4-33 . -dspchap (Display a CHAP T able) T o view the CHAP table, enter the -dspchap command as follows: -dspchap &[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-10 SN0054621-00 E S -d t dup d (Duplicate a Persistent T arget) T o duplicate a discovered target that is persistent, enter the -dtdupd command as follows: -dtdupd < hba_port_inst > < target_id > A duplicate ta rget is assigned a new iSCSI initiator ID (ISID) and can the n [...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-1 1 A -d trema (Remove Discovered T arget) T o remove all non-persistent discovered t argets, en ter the -dtrema command as follows: -dtrema < hba_port_inst > For information on the interactive version of this command, “Remove Discovered T arget” on page 4-46 . [...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-12 SN0054621-00 E S Y ou can repeat the < Parameter >|< Parameter Alias > < Va l u e > p arameter pair to ch ange multiple values as shown in Ta b l e 5 - 2 . Press ENTER after each entry . Issuing this command resets the HBA. For information on the interactive versio[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-13 A -fa < Filename > For example if the image is for a QL A4010, all QLA4010s are updated, and no other HBAs. (Newer images may be appropriate for both QLA405x and QLA406x type HBAs.) Issuing this command rese ts all updated HBAs. For information on the interactive[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-14 SN0054621-00 E S -i (List All QLogic iSCSI HBA Port s Detected) Use the -i command to view a list of all detected HBA p ort instances (“po rts”) in the system. Each port inst ance (hba_port_inst ) is identifie d by its number . T o view general HBA information, enter the -i comm[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-15 A The following shows an example of how the HBA port information might appear: 0. HBA 0 Port: 0 HBA Port Instance: 0 HBA Model: QLA4050C HBA Serial Number: FS20525B03135 FW Version: 2.2.4.45 Type: Copper IP Address: 192.168.3.7 Alias: iSCSI name: iqn.2000-04.com.qlogic[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-16 SN0054621-00 E S For information on the interactive version of this command, see “Import HBA Configuration (CLI Option -import)” on page 4 -10 . -ip dhcp (Configure IP Settings) T o set the HBA to get its IP address, subnet mask, and gateway from the DHCP server , enter the -ipd[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-17 A -isns <hba_port_inst> [ iSNS IP Address ] [ iSNSPORT <port_number> ] If you do not specify t he [ iSNS IP Address ] paramet er , the command disables the iSNS client on the specified HBA port. Issuing this command resets the HBA. For information on the in[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-18 SN0054621-00 E S -lb (Perform Loopback T est) T o run a loopback test, enter the -lb command as follows: -lb < hba_port_inst > [-STOP] [-EXTLB] [-CNT < Test Count >] Where: For information on the interactive version of this command, see “Perform Loopback T est (CLI Opt[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-19 A -linkchap (Assign a CHAP Entry to a T arget) T o link a CHAP entry to a target, enter the -linkchap command as follows: -linkchap < hba_port_inst > < CHAP No. > < Target ID > This command does not reset the HBA. For information on the intera ctive v[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-20 SN0054621-00 E S AFW_Device_T imeout AFWDT on or off AFW_Delayed_Ack AFWDACK on or of f ExeThrottle ET 0–32767 FirstBurstLen FB 0–32767 IP Options IP_ARP_Redirect IP ARP on or of f IP_Address IP AD IP address format IP_Subnet_Mask IPSM IP address format IP_Gateway IPGW IP addres[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-21 A For information on the interactive version of this command, see “Configure iSCSI Settings (CLI Options -n and -nh)” on p age 4-24 . -nc (Display Neighbor Cache) T o display the neighbor cache (IPv6 only), enter the -n c command as follows: -nc < hba_port_inst [...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-22 SN0054621-00 E S -netconf6 (Configure IPv6 Settings) T o manually configure the IPv6 network settings, enter the -netconf6 command as follows: -netconf6 <hba_port_inst> [-IP < IPv6 Address >] [-IPNM < Subnet Mask><IPv6> ] [-IPGW < Gateway Address >] Whe[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-23 A T o set only the local link address, enter the following: -netconf6 0 -IPLL fe80::1 T o set everything automatically , enter the following: -netconf6 0 -IPLLA -IPR01A -IPRRA T o disable the IPv4 network, enter the following: -netconf6 0 -DISN4 T o disables the IPv4 a[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-24 SN0054621-00 E S -p ad T o view all targets for a port, enter the -pad commands as follows: -pad < hba_port_inst > -pb (Bind T arget) Enter the -pb command to bind a t arget (make it persistent): -pb <hba_port_inst> < Target ID > For information on the interactive [...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-25 A -ping (Ping T arg et) T o ping the target device specified IP a ddress, enter the -ping command as follows: -ping < hba_port_inst > < IP Address > < Ping Count > < Packet size > < IPv6 source address > The following provides the IPv6 sou[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-26 SN0054621-00 E S -px T o unbind all persistent targets on t he HBA, enter the -px command as follows: -px <hba_port_inst> -r (Up date ROM Image) For information on ROM image file names, refer to Appendix E Downloadable File Names . Be sure to select Save changes and re set HBA[...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-27 A -rdh (Port Restore F actory Default s) T ype the following command to restore the specified HBA port’ s settings to their factory defaults: -rdh <hba_port_inst> [A] [F N I T C V] Where: If you want to resto re all areas of the HBA port, either use the A p ara[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-28 SN0054621-00 E S -rwt (Perform Read/Write Buffer T est ) The read/write buf fer test writes an 8- or 16-byte p attern to the disk’s buf fer and reads the written buf fer back. It is non-destructive to disk data. T o do a read/write buffer test, ent er the -rwt command as follows: [...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-29 A -sbootcode (Set Secondary Boot T arget Information) T o set the secondary boot target and LUN, enter the -sbootcode command as follows: -sbootcode <hba_port_inst> < Boot Target > < Boot LUN > Issuing this command saves the configuration data to a n [...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-30 SN0054621-00 E S -st at (Display Port St atistics) T o view the port statistics fo r the specified HBA, enter the -stat command as follows: -stat < hba_port_inst > For a list of the stat istics that are displayed and information on the interactive version of this command, see [...]

5 – Non-Interactive Mode Commands Non-interactive Commands SN0054621-00 E 5-31 A -t < hba_port_inst > [ Target ID ] If you only specify the < hba_port_inst > parameter , SANsurfer iSCSI HBA CLI displays target information for all t arget s on the specified HBA port. If you specify the optional par ameter [ Target ID ] , SANsurfer iSCS[...]

5 – Non-Intera ctive Mode Commands Non-interactive Commands 5-32 SN0054621-00 E S -ver For information on the interactive version of this command “Display Program V ersion Information (CLI Option -ver)” on page 4-8 . -vp d (Display VPD Information) T o view Vital Product Dat a (VPD), enter the -vpd command as follows: -vpd <hba_port_inst&g[...]

SN0054621-00 E A-1 A Port- and HBA-level Parameters The tables in t his appendix list the foll owing types of SANsurfer iSCSI HBA CLI parameters:  Port-level Parameters  HBA-level Parameters (see page A-10 ) Port-level Parameters T able A-1 lists the HBA port firmware p arameters and their values. T o view all parameters, both conf igurable a[...]

A – Port- and HBA-level Parameters Port-level Para meters A-2 SN0054621-00 E S AFW_Serlz_T ask _Mngmt on, off AFWSTM When enabled, th e firmware will serialize all Immediate task man agement function req uests (SCSI) such that only one Immediate t ask man- agement command is out standin g to the t arget at a time. Default_IPv6_Router IPv6 address[...]

A – Port- and HBA-level Parameters Port-level Paramete rs SN0054621-00 E A-3 A FW_Fast_Posting a on, off n/a When on, allows posting SCSI command com- pletions for multiple SCSI commands during a single system interrupt. FW_Initiat or_Mode a on, off n/a When on, the HBA is in initiator mode. FW_Marker a on, of f n /a When on does not require a ma[...]

A – Port- and HBA-level Parameters Port-level Para meters A-4 SN0054621-00 E S IPv4_TOS_Ena ble on, off T OS_ ENABLE IPv4 type of service QLA405 x and QLE406 x only . IPv4_TOS 0–255 IPV4T OS Controls the value of the type of service (T OS) field of IPv4 headers transmitted by the firmware on iSCSI connections. The firmware uses the value when t[...]

A – Port- and HBA-level Parameters Port-level Paramete rs SN0054621-00 E A-5 A IPv6_Nagle on, off TCPV6ND When enabl ed, the firmware uses th e Nagle algorithm. When di sabled, the firm ware disables the Nagle algori thm. (For a description of the Nagle algorit hm, see RFC 896—Congestion Control in IP/TCP Internetworks .) IPv6_ND_Reachable_ Ti [...]

A – Port- and HBA-level Parameters Port-level Para meters A-6 SN0054621-00 E S IPv6_TCP_T imer_Scale 0–7 TCPV6TS Each TCP timer in the firm ware is refe renced to a local timer and is defined as a number of loca l timer ticks. T he TCP T imer Scale bits are a scale factor that adju sts the time interval between timer ticks on a per connection b[...]

A – Port- and HBA-level Parameters Port-level Paramete rs SN0054621-00 E A-7 A iSCSI_Data_PDU_In_ Order a on, off n/a When on, the syste m driver reports the DataP- DUInOrder v alue negotiated d uring login to the HBA firmware. iSCSI_Data_Seq_In_ Order a on, of n/a When on, the system driver report s the DataSe- quenceInOrder value negotiated dur[...]

A – Port- and HBA-level Parameters Port-level Para meters A-8 SN0054621-00 E S KeepAliveTO 0–655 35 seconds KA TO This parameter indicates the time interval (in seconds) between connec tion keep-alive pings. When a connection is idle for the connection keep-alive time out interval, the HBA sends an NOP ping to the ot her device (t arget) that i[...]

A – Port- and HBA-level Parameters Port-level Paramete rs SN0054621-00 E A-9 A T ask_Management_ Ti m e o ut 0– 65535 TMTO T imeout value for var ious firmwa re operations. For example, timeout value is used for PDUs created and transmitted that are not related to IOCB and T ask Management commands. TCP_DHCP on, off TCPDHCP When on, the HBA use[...]

A – Port- and HBA-level Parameters HBA-level Parameters A-10 SN0054621-00 E S HBA-level Parameters T able A-2 lists the HBA parameters a nd their values. T o view all HBA parameters, both configurable and non-configur able (read-only), use the -ch option in non-interactive mode. T o edit configurable parameters, use the -nh option in non-interact[...]

SN0054621-00 E B-1 B HBA S t atistics T able B-1 lists the HBA statist ics shown when you select either the interactive mode Display HBA Statistics option (see page 4-32 ), or the non-interactive mode -stat command (see p age 5-30 ). NOTE: The parame ters in this table are sorted alphabetically for ease of use. T able B-1. HBA S tatistics St atisti[...]

B – HBA S tatistics B-2 SN0054621-00 E S IPv6FragRxOverlapCo unt IPv6 fragment received ove rlap count IPv6InvalidAddressError IPv6invalid ad dress errors IPv6RxByteCount IPv6 received byte count IPv6RxFragmentCount IP v6 received fragment s count IPv6RxPack etsC ount IPv6 rece ived pa cket s count IPv6TxByteCount IPv6 transmit ted byte count IPv[...]

B – HBA S tatistics SN0054621-00 E B-3 A MACRxFramesDropped MAC received dropped frames MACRxJabber MAC received jabber MACRxLengthErrorCoun tLarge MAC received larg e length error count MACRxLengthErrorCountSmall MAC rece ived small length error count MACRxMulticast MAC received multicast MACRxPauseFrames MAC received pause frames MACRxUnknownCo[...]

B – HBA S tatistics B-4 SN0054621-00 E S TCPRxPureACKCount TCP received pure ACK count TCPRxSegmentErrorCount TCP received segm ent error count TCPRxSegmentOutO fOrderCo unt TCP rece ived segment out-of-ord er count TCPRxSegment sCount TCP transmitte d segment count TCPRxWindowProbeCount TCP received window probe count TCPRxWindowUpdateCount TCP [...]

SN0054621-00 E C-1 C T arget Parameters This appendix lists t arget parameters, both fixed and configurable. Y ou can view target information with the Display Target Information option. Y ou can configure a targe t by changing specific parameters. T able C-1 lists target para meters and their range of values. Y ou can configure the parameters shown[...]

C – T arget Parameters C-2 SN0054621-00 E S T able C-1. T arget Parameters Parameter Alias Function Va l u e IPv4TOS IPV4TO S When the DDB en try is for an IPv6 device (the IPv6 Device bit—Options fie ld bit 8—is set), this field specifies the IPv6 TC field to be used in the IPv6 TCP packet s trans- mitted from the firmware to the device. Whe[...]

C – T arget Parameters SN0054621-00 E C-3 A TGT_IPv6_Port TGTPORT_ IPv6 T arget IPv 6 port 3260 TGT_IPv6_Source Addr T arget IPv6 source addr ess IPv6 TGT_IPv6_Source Addr_Flg TGTSRCADDRIPv6 T arget IPv 6 source address flag 0-3 † TGT_iSCSI_Name TGTINAME T arget iSCS I name ‡ TGT_KeepAliveT imeout TGTKA TO T arget keep-alive time out 30 † T[...]

C – T arget Parameters C-4 SN0054621-00 E S TGT_T askManagementT imeout TGTTMS T arget task manage ment tim- eout 10 † TGT_T imeS tamp_Enable T a rget time-stamp enable 64* TGT_T emp _Redirect_Option T arget te mporary redirect option on/off* TGT_T raffic_Class T arget traffic class 0* † TGT_Tx_Window_Scale T arget transmit window scale 2* ?[...]

C – T arget Parameters SN0054621-00 E C-5 A TGTISCSIO_Send_Markers T arget iSCSI I/O send mark- ers on/off* TGTISCSIO_Snack TGTISNACK T arget iSCSI I/ O snack on/of f TGTISCSIO_S trict_Login TGTIS T arget iSCSI I/O strict login on/off TGTISCSIO_S trict_Logout TGTLDS T arge t iSCSI I/O strict logout on/off TGTO_Active T arg et option active on/off[...]

C – T arget Parameters C-6 SN0054621-00 E S Notes[...]

SN0054621-00 E D-1 D Error Codes This appendix provides the error code s for both CLI modes, interactive and non-interactive. Interactive Mode Error Codes T able D-1 lists the return, name, and description for each interactive mode error code. NOTE: The return codes in this t able are sorted numerically for ease of use. T able D-1. Interactive-Mode[...]

D – Error Code s Interactive Mode Error Codes D-2 SN0054621-00 E S 111 CORE_ERR_NOSP ACE No space in persistent or dynamic table for this entry . 1 12 CORE_ERR_NOCOUNT A count is required. 11 3 CORE_ERR_HBAINV The specified HBA was invalid. 1 14 CORE_ERR_NO_TGT No TGT to operate on was specified. 11 5 CORE_ERR_NO_LUN No LUN to operate on was spec[...]

D – Error Code s Interactive Mode Error Codes SN0054621-00 E D-3 A 138 CORE_ERR_INITFW_INV ALID Invalid IP address in In itFW . Correct to save changes. 139 CORE_ERR_SETBOOTCODE Bootcode save error . 140 CORE_ERR_INV_LUN LUN is invalid. 141 CORE_ERR_NO_LUN_INFO Cannot get LUN info rmation for this target. 142 CORE_ERR_NOT_SUPPORTED_BY_ FW Operati[...]

D – Error Code s Interactive Mode Error Codes D-4 SN0054621-00 E S 156 CORE_ERR_SECURITY_DESCRIPTOR _INITIALIZA T ION_F AILED Security descriptor initialization failed. 157 CORE_ERR_UNABLE_SET_SECURITY _DESCRIPTOR_DECL Unable to set securi ty descriptor decl. 158 CORE_ERR_DRIVER_UPDA TE_ F AILED Driver update failed. 159 CORE_ERR_DEVICE_NOT_FOUND[...]

D – Error Code s Non-interactive Mo de Error Code s SN0054621-00 E D-5 A Non-interactive Mode Error Codes T able D-2 lists each command and the non-interactive mode error code associated with each. NOTE: The commands in this t able are sorted alphabetically for ease of use. T able D-2. Non-interactive Mode Error Codes Command Error Cod es -addcha[...]

D – Error Code s Non-interactive Mode Error Codes D-6 SN0054621-00 E S -bootcodemode CORE_ERR_HBAINV CORE_ERR_NO_HBA -c CORE_ERR_HBAINV CORE_ERR_NO_HBA -chapmap CORE_ERR_HBAINV CORE_ERR_NO_HBA -cpbootcode CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_SETBOOTCODE -csbootcode CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_SETBOOTCODE -defbidi CORE_ERR_HBAINV [...]

D – Error Code s Non-interactive Mo de Error Code s SN0054621-00 E D-7 A -d CORE_ERR_ZIP_FILE_NOT_FOUND CORE_ERR_UNABLE_TO_UNZIP_DRIVER_FILE CORE_ERR_UNABLE_TO_GET_I NFO_FROM_DIRVER_FILE CORE_ERR_ SECURITY_D ESCRIPTOR_INITIALIZA TION_F AI LED CORE_ERR_UNABLE_SET_SECUR ITY_DESCRIPTOR_DECL CORE_ERR_DRIVER_UPDA TE_F AILED CORE_ERR_DEVICE_NOT_FOUND C[...]

D – Error Code s Non-interactive Mode Error Codes D-8 SN0054621-00 E S -gcr CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_GET_CRASH_REC -i CORE_ERR_HBAINV CORE_ERR_NO_HBA -import CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_INV ALID_SOURCE_HBA CORE_ERR_INVFILE CORE_ERR_EXT CORE_ERR_INITFW_INV ALID CORE_ERR_SA VE_INITFW CORE_ERR_H[...]

D – Error Code s Non-interactive Mo de Error Code s SN0054621-00 E D-9 A -isns6 CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_NOT_SUPPORTED CORE_ERR_EXT CORE_ERR_ISNS_NOT_SUPOORTED -l CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_NO_TGT CORE_ERR_EXT CORE_ERR_INV -lb CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV -linkchap CORE_ERR_HBAINV CORE_ER[...]

D – Error Code s Non-interactive Mode Error Codes D-10 SN0054621-00 E S -n CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_NO_P AIR CORE_ERR_POSTTOIFW CORE_ERR_EXT CORE_ERR_INITFW_INV ALID CORE_ERR_CHAP_SA VE_F AIL CORE_ERR_DDB_SA VE_F AIL CORE_ERR_HBAOPEN CORE_ERR_HBAOPEN CORE_ERR_SETBOOTCODE CORE_ERR_SA VE_INITFW CORE_ERR_INV -netconf CORE_ERR_HBAINV [...]

D – Error Code s Non-interactive Mo de Error Code s SN0054621-00 E D-1 1 A -pbootcode CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_TGT_INV CORE_ERR_NOT_SUPPORTED CORE_ERR_SETBOOTCODE -pb CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_NOSP ACE CORE_ERR_EXT -pinfo CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_EXT -ps CORE_ERR_HBAINV CORE[...]

D – Error Code s Non-interactive Mode Error Codes D-12 SN0054621-00 E S -rdf CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_FWUPD CORE_ERR_READ_DEF_IFW -rdh CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_SDMF AIL CORE_ERR_NOT_SUPPORTED -rwt CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV -save CORE_ERR_INV CORE_ERR_INVFILE -sbootcode CORE_ERR_HBAIN[...]

D – Error Code s Non-interactive Mo de Error Code s SN0054621-00 E D-13 A -t CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV -ts CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV -ver -vpd CORE_ERR_HBAINV CORE_ERR_NO_HBA T able D-2. Non-interactive Mode Error Codes (Continued) Command Error Cod es[...]

D – Error Code s Non-interactive Mode Error Codes D-14 SN0054621-00 E S Notes[...]

SN0054621-00 E E-1 E Downloadable File Names T able E-1 lists, by file type and HBA, the typical file names of do wnloadable files for QLogic iSCSI HBAs. T able E-1. File Names File T ype HBA File Name Description Boot Code 405 x BIOS for x86 and x64 processors; FCod e or EFI for Solaris—allows system boot from. Boot Code 406 x BIOS for x86 and x[...]

E – Downloadable File Names E-2 SN0054621-00 E S Notes[...]

SN0054621-00 E F-1 F Using T race T racing can provide useful informati on to QLogic developers for identifying application, HBA, and networking issues. For ad vanced users of SANsurfer iSCSI HBA CLI, tracing may provide useful information a bout detailed steps that a re occurring for vari ous operations. T o use trace: 1. T o identify the director[...]

F – Using T race F-2 SN0054621-00 E S T race V a riables Y ou can set the trace variables listed in T able F-1 . T r ace Level Y ou can select the iSCSI trace level by choosing a number from 0 to 1 000. For example: iscsi.cli.trace.level = 0 to 1000 T able F-2 shows what trace level each number select s. T able F-1. Trace Pa rameters V ariable Ch[...]

F – Using Trace SN0054621-00 E F-3 A T o continue, press ENTER . T able F-3 shows some more information about trace levels. T able F-2. Trace Level Comm ands Va l u e T race Level 0 No trace data requeste d 50 Error level 100 W arning error 200 Event level 300 Sp a w n l e v e l 400 T rac e level 500 Connection level 600 Memory level 700 Config l[...]

F – Using T race F-4 SN0054621-00 E S T o continue, press ENTER . T race Dat a Y ou can select the amount of trace dat a you want, as sh own in T able F-4 . : T o continue, press ENTER . iscsi.cli.trace.output.dump.mem.params true or fa lse iscsi.cli.trace.output.setlevelonly true or fa lse iscsi.cli.trace.output.dump.mem.isns true or false iscsi[...]

SN0054621-00 E 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 iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Glossary-2 SN0054621-00 E S CNA Converged network adapters support bo th data networking (TCP/IP) an d storage networking (FC) traf fic on a single I/O adapter using two new techno logies: Enhanced Ethernet and Fibre Channel over Ethernet ( FCoE ). Co[...]

SN0054621-00 E Glossary-3 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A In NetW are, the required drivers include:  Host Adapter Module (HAM) . HAM is the driver component associated with the host adapter hardware. It pro vides the functionality to route request s to the bus where a s pecif[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Glossary-4 SN0054621-00 E S Flash Nonvolatile memory holding the boot code. At times, Flash and boot code are u sed interchangeably . (See boot code ) Flash BIOS A flash PROM contains the BIOS code for the HBA. G_Port Generic port. A port that can ope[...]

SN0054621-00 E Glossary-5 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A LUN Logical Unit Number , a subdivision of a SCSI target. It is the small in teger handle that dif ferentiates an individual disk drive or partitio n (volume) within a common SCSI target device such as a disk array . T ech[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Glossary-6 SN0054621-00 E S network adapter A chip that provides network cap abilities. A computer may include a network adapter on its syste m board, or on an adapter card. Also a NIC (network interface card or controller). ONC Open network computing[...]

SN0054621-00 E Index-1 Index A -acb 5-3 ACB firmware functions 5-3 accept AEN A-2 access control, firmware A-2 access granted C-5 active option C-5 adapter , definition of Glossary-1 -addchap 4-42 , 5-3 adding 4-42 CHAP default BIDI 4-43 CHAP entry 5-3 send target 5-29 target s 4-40 address HBA port instance 5-14 IP 4-25 , 4-26 , 4-49 , 5-20 , A-3 [...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-2 SN0054621-00 E S boot iSCSI drive 4-13 target information clearing primary 4-36 , 5-6 clearing secondary 4-36 , 5-6 setting primary 4-35 , 5-24 setting secondary 4-3 5 , 5-29 boot code, definition of Glossary-1 boot device, definition of Gloss[...]

SN0054621-00 E Index-3 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A commands ( continued ) -dspchap 4-41 , 5-9 -dt dsp 5-9 -dt dspa 5-9 -dtli 5-10 -dtlia 5-10 -dtrem 5-10 -dtrema 5-11 -dtupd 5-9 , 5-10 -dumpcore 4-16 , 5-11 -dumpnvram 4-15 , 5-11 -dv 5-11 -edchap 4-43 , 5-11 -ei 5-12 -f 4-13 [...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-4 SN0054621-00 E S configuring ( continue d ) iSCSI settings 4-24 iSNS 5-16 , 5-17 link configuration 4-20 , 5-18 manual 5-21 target p arameters 5-31 connection error log displaying 4-32 exporting 4-33 connection medium 5-14 connection type 4-48[...]

SN0054621-00 E Index-5 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A discovered target s duplicating 5-9 , 5-10 log in all 5-10 log in specific 5-10 non-persistent, viewing 5-9 persistent, viewing 5-9 removing 5-10 removing all 5-11 discovery logout, iSCSI 4-24 , 4-26 , 5-20 , A-6 logout, targ[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-6 SN0054621-00 E S E E_Port (Expansion Port), definition of Glossary-3 EC level, viewing 4-18 echo diagnostic test, definition of Glossary-3 -edchap 4-43 , 5-11 editing CHAP entry 4-43 , 5-11 HBA bootcode settings 4-34 port settings, specific 4-[...]

SN0054621-00 E Index-7 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A firmware parameters AFW_AutoConnect 4-25 , 4-26 , 5-19 , A-1 AFW_Delayed_Ack 4-25 , 4-26 , 5-20 , A-1 AFW_Device_T imeout 4-26 , 5-20, A-1 AFW_Device_TO 4-25 AFW_Serlz_T ask_Mngmt 4-26 , A-2 Default_IPv6_Router A-2 DefaultT i[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-8 SN0054621-00 E S firmware parameters ( continued ) VLAN_ID 4-27 , A-9 VLAN_User_Priority 4-27 , A-9 ZIO 4-27 , A-9 ZIO_Enable_Mode A-3 first burst length 4-26 , 5-20 , A-2 , C-2 FirstBurstLen parameter 4-25 , 4-26 , 5-20 , A-2 Flash definition[...]

SN0054621-00 E Index-9 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A HBAs ( continued ) information, viewing 4-12 , 5-24 iSCSI version 4-12 level information 4-12 level parameters, configuring 4-18 level parameters, displaying 4-17 level statistics, displaying 5-30 list all QLogic HBAs 4-48 MA[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-10 SN0054621-00 E S installation ( continue d ) naming convention 2-2 quiet, Windows 2-9 Red Hat/SUSE Linux/PPC 2-9 Solaris SP ARC/Solaris x86 2-10 Solaris, silent 2-11 Windows 2-4 instance driver ID 4-48 port 5-14 port, definition of Glossary-6[...]

SN0054621-00 E Index-1 1 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A IPv6 ( continued ) Source_Add_Flg, target C-3 TCP settings 4-28 TCP timer scale A-5 TGT_Flow_Label C-2 time stamp, TCP A-5 timers, reachable A-5 traffic class A-6 VLAN ID A-6 VLAN user priority A-6 VLAN, enabling A-6 IPv6_A[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-12 SN0054621-00 E S iSCSI_S trict_Login para meter 4-24 , 5-20 , A-7 iSDMAPI versio n 4-9 ISID (iSCSI initiator ID) 5-9 iSNS configuring 5-16 , 5-17 enabling 4-21 settings, viewing 4-20 -isns 4-21 , 4-27 , 5-16 -isns6 4-27 , 5-17 italicized text[...]

SN0054621-00 E Index-13 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A LUNs boot target, clea ring 5-6 definition of Glossary-5 information, listing 4-47 , 5-17 number 5-17 product ID 4-47 , 5-17 product revision 4-47 , 5-17 size 4-47 , 5-17 vendor name 4-47 , 5-17 M MAC address 4-1 2 manually [...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-14 SN0054621-00 E S Network Interface Controller (NIC), definition of Glossary-5 network settings 5-22 configuring 5-21 displaying 4-20 port, viewing 4-20 Nexus driver level, definition of Glossary-2 -nh 4-24 , 5-23 NIC, definition of Glossary-5[...]

SN0054621-00 E Index-15 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A ports ( continue d ) instance 5-14 IPv6 settings 4-28 , A-5 IPv6 target C-3 iSCSI alias name 4-22 , 4-48 iSCSI name 5-14 link settings 4-19 local TCP C-3 network settings, viewing 4-20 number A-8 resetting 4-14 settings, con[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-16 SN0054621-00 E S required parameters 5-1 resetting HBA 4-14 , 5-3 port statistics 4-32 statistics to zero 5-29 restoring default firmware settings 5-26 port factory defaults 4-28 , 5-27 QLA4010 port settings 4-28 retransmit timer , IPv6 A-5 r[...]

SN0054621-00 E Index-17 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A snack iSCSI 4-24 , 5-20 , A-7 target iSCSI I/O C-5 Solaris SP ARC 2-3 SP ARC driver structure Glossary-2 x86 2-3 Solaris SP ARC/Solaris x86 installation 2-10 uninstall 2-13 -sreset 4-32 , 5-29 -stadd 5-29 S tart menu uninst [...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-18 SN0054621-00 E S target p arameters ( continued ) TGT_T argetPortalGroupID C-3 TGT_T argetSessID C-3 TGT_T askManagementT i meout C-4 TGT_T emp_Redirect_Option C-4 TGT_T imeS tamp_Enable C-4 TGT_T raffic_Class C-4 TGT_Tx_Window_Scale C-4 TGT_[...]

SN0054621-00 E Index-19 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A TCP auto discovery 5-20 DHCP A-8 information, obtaining 4-21 IPv6 settings 4-28 maximum window size 5-20 Nagle 5-20 , A-8 , C-5 TCP_DHCP 5-20 time stamp 4-27 , 5-20 , A-5 , A-8 timer scale A-5 , A-9 window scale 4-27 , A-9 T[...]

SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interface for Q Logic iSCSI Host Bus Adapters Index-20 SN0054621-00 E S TGTO_Active C-5 TGTO_Initiato r_Entry C-5 TGTO_T arget Entry C-5 TGTSCSIO_CHAP_Authentication C-4 TGTSCSIO_Discovery_Logout C-4 TGTSCSIO_S trict_Login C-5 TGTSCSIO_S trict_Logout C-5 time stamp CPO (target) C-5 enable C-4 TCP[...]

SN0054621-00 E Index-21 SANsurfer iSCSI HBA CLI User ’s Guide Command Line Interfa ce for QLogic iSCSI Host Bus Ad apters A VLAN enabling 4-27 , A-6 , A-9 ID 4-27 , A-6 , A-9 user priority 4-27 , A-6 , A-9 VLAN_Enable parameter 4-27 , A-9 VLAN_ID parameter 4-27 , A-9 VLAN_User_Priority parameter 4-27 , A-9 -vpd 4-18 , 5-32 VPD, displaying info 4-[...]

© 2008 QLogi c Corporatio n. S pecifications are sub ject to change without noti ce. All right s reserved worldwide. QL ogic, QLA, SAN bl ade, SANbox, S ANsurfer , and the QLogic logo are re gis- tered tradem arks of QLogic C orporation. Li nux is a regi stered tradema rk of Linus T orvalds. Micro soft and W indows are reg istered trademarks and W[...]