Qlogic SANsurfer iSCSI HBA CLI User Manual Download Page 5

Page: 5 / 184

SN0054621-00 E

Page v

Table of Contents

Introduction

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-1

How This Guide is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-1

Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-2

Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-3

Supported QLogic HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-4

Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-4

License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-5

Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-5

Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-5

Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-5

Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-5

Installation and Removal

Installing SANsurfer iSCSI HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-1

Downloading the Installation Package. . . . . . . . . . . . . . . . . . . . . . . . .

2-1

Installing on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-4

Windows Standard (GUI) Installation . . . . . . . . . . . . . . . . . . . . .

2-4

Windows Command Line Installation . . . . . . . . . . . . . . . . . . . . .

2-9

Installing on Red Hat/SUSE Linux/PPC . . . . . . . . . . . . . . . . . . . . . . .

2-10

Installing on Solaris SPARC/Solaris x86 . . . . . . . . . . . . . . . . . . . . . . .

2-10

Solaris Attended Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-10

Solaris Silent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-11

Removing SANsurfer iSCSI HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-12

Microsoft Windows Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-12

Start Menu Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-12

Control Panel Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-12

Command Line Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-12

Red Hat/SUSE Linux/PPC Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . .

2-13

Solaris SPARC/Solaris x86 Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . .

2-13

Summary of Contents for SANsurfer iSCSI HBA CLI

Page 1: ...SN0054621 00 E SANsurfer iSCSI HBA CLI User s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters...

Page 2: ...2006 Revision D May 7 2007 Revision E October 17 2008 Changes Sections Affected Revision E Changes Applied new user s guide template All Updated guide title and subtitle Title page page headers Enhan...

Page 3: ...tions Target Discovery Menu on page 4 44 Removed subheadings referencing non existent interactive mode commands 5 Non Interactive Mode Commands Added new miscellaneous command line options acb on page...

Page 4: ...for QLogic iSCSI Host Bus Adapters Added missing descriptions for IPv4TOS and IPv4TTL parameters Deleted obsolete Primary_DNS and SLP_Address parameters Appendix C Target Parameters Moved trace infor...

Page 5: ...er iSCSI HBA CLI 2 1 Downloading the Installation Package 2 1 Installing on Microsoft Windows 2 4 Windows Standard GUI Installation 2 4 Windows Command Line Installation 2 9 Installing on Red Hat SUSE...

Page 6: ...enu CLI Option i 4 12 HBA Information CLI Option ch 4 12 HBA Options Menu No CLI Option 4 13 Update BIOS UEFI or FCode Code Image CLI Option bootcode 4 13 Update Firmware Image CLI Option f 4 13 Updat...

Page 7: ...CLI Option lb 4 31 Perform Read Write Buffer Test CLI Option rwt 4 31 Display Port Statistics CLI Option stat 4 32 Reset Statistics CLI Option sreset 4 32 Display ARP Table CLI Option arp 4 32 Displa...

Page 8: ...d CLI Option i 4 48 Help CLI Option h 4 49 Select HBA Port No CLI Option 4 49 Refresh No CLI Option 4 49 Exit No CLI Option 4 50 5 Non interactive Mode Commands Non interactive Commands 5 3 acb 5 3 ad...

Page 9: ...dv 5 11 edchap Edit a CHAP Entry 5 11 ei 5 12 f Update Firmware Image Specific HBA 5 12 fa Update Firmware Image All HBAs 5 12 g Display General System Information 5 13 gcr Retrieve FW Crash Record 5...

Page 10: ...ffer Test 5 28 save Save Host Configuration 5 28 sbootcode Set Secondary Boot Target Information 5 29 sbootcodecid Set Alternative Client ID 5 29 sdmrc 5 29 sreset Reset Statistics 5 29 stadd 5 29 sta...

Page 11: ...uide Command Line Interface for QLogic iSCSI Host Bus Adapters A D Error Codes Interactive Mode Error Codes D 1 Non interactive Mode Error Codes D 5 E Downloadable File Names F Using Trace Trace Varia...

Page 12: ...2 8 3 1 Windows iSCSI icon 3 1 5 1 HBA Port Information 5 14 List of Tables Table Page 1 1 Related Documents 1 3 1 2 Supported HBAs 1 4 4 1 Command Line Interface Menu 4 2 5 1 Non interactive Command...

Page 13: ...is Guide is Organized The SANsurfer iSCSI HBA CLI User s Guide is organized into the following chapters and appendices 1 Introduction provides a general overview of the product lists the supported QLo...

Page 14: ...formation for using trace to identify application HBA and networking issues Following the appendices are a glossary of terms used and an index that will help you quickly find the information you need...

Page 15: ...atest firmware and product updates For a list of target parameters see Table C 1 Related Documents Table 1 1 lists other documents you may find helpful when installing or using SANsurfer iSCSI HBA CLI...

Page 16: ...Windows XP Professional SP2 IA32 x64 Windows Vista IA32 x64 Business and Enterprise editions Windows Preinstallation Environment PE 2 0 2 1 PE 2004 PE 2005 Red Hat Enterprise Linux RHEL 3 0 4 0 5 0 IA...

Page 17: ...the technical professional for both the QLogic iSCSI HBAs and switches From the training link at www qlogic com you may choose Electronic based Training or schedule an intensive hands on Certificatio...

Page 18: ...c knowledge database contains troubleshooting information for the QLogic HBAs Access the database from the QLogic Web site www qlogic com Click the Support tab and then use the search engine at the to...

Page 19: ...CSI HBA CLI installation includes the following information Downloading the Installation Package on page 2 1 Installing on Microsoft Windows on page 2 4 Installing on Red Hat SUSE Linux PPC on page 2...

Page 20: ...The installation package has the following naming convention iscli AA BB CC DD_ OS Type _ Subtype Install Type Where For example a package for the Linux operating system can be named iscli 1 0 35 0_l...

Page 21: ...n SP2 IA32 x64 Windows XP Professional IA32 x64 SP2 Windows Vista IA32 x64 Business and Enterprise editions Windows Preinstalled Environment PE 2 0 PE 2004 PE 2005 Red Hat SUSE Linux Power PC PPC see...

Page 22: ...n page 2 4 Windows Command Line Installation on page 2 9 Windows Standard GUI Installation Follow these steps to install SANsurfer iSCSI HBA CLI on a Windows operating system To install using the GUI...

Page 23: ...indow appears as shown in Figure 2 2 Figure 2 2 Install Wizard 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...

Page 24: ...box click Next recommended The default location for a Microsoft Windows system is Program Files QLogic Corporation SANsurferiCLI To select a different location click Change select the location you wan...

Page 25: ...al 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 informa...

Page 26: ...nstalling SANsurfer iSCSI HBA CLI 2 8 SN0054621 00 E S When finished the installer shows the InstallShield Wizard Completed window as shown in Figure 2 6 Figure 2 6 Install Wizard Complete 7 Click Fin...

Page 27: ...iSCSI HBA CLI application is Program files QLogic Corporation SANsurferCLI If you want a different directory type it in the command line For example SANsurferCLI msi INSTALLDIR directory The preceding...

Page 28: ...sh install Installing on Solaris SPARC Solaris x86 You can install SANsurfer iSCSI HBA CLI on a Solaris SPARC or x86 system with one of the following methods Solaris Attended Installation on page 2 1...

Page 29: ...e noask_pkgadd txt file with contents BOF action nocheck EOF 5 Type the command to Install with the two additional required files pkgadd d Install Package Filename n a noask_pkgadd txt response txt Fo...

Page 30: ...2 12 Start Menu Uninstall On the Windows Start menu point to All Programs QLogic Management Suite SANsurferiCLI and then click Uninstall SANsurferiCLI Control Panel Uninstall Follow these steps to un...

Page 31: ...ninstall To uninstall SANsurfer iSCSI HBA CLI on a Red Hat SUSE Linux PPC operating system enter the following from a command prompt rpm e iscli AA BB CC DD be sure to omit the rest of the package nam...

Page 32: ...2 Installation and Removal Removing SANsurfer iSCSI HBA CLI 2 14 SN0054621 00 E S Notes...

Page 33: ...y the list of parameters provided and then terminates Use this mode to run SANsurfer iSCSI HBA CLI from a script file or when you want to perform a single operation 5 Non interactive Mode Commands cov...

Page 34: ...SI HBA Ports detected 6 Help 7 Select HBA Port 8 Refresh 9 Exit enter selection Depending on the menu selection SANsurfer iSCSI HBA CLI prompts for more input as needed For example if you select Selec...

Page 35: ...nfo Operations on the main menu SANsurfer iSCSI HBA CLI displays a new menu the Host Level Info Operations Menu From this menu you have several choices including 1 Display General System Information 2...

Page 36: ...rt HBA Configuration see page 4 10 3 Select HBA Port see page 4 49 4 Refresh see page 4 49 5 Exit see page 4 50 3 Update Firmware Multiple Adapters see page 4 11 4 Install HBA Driver All Adapters see...

Page 37: ...lect HBA Port see page 4 49 4 Save Changes and Reset HBA see page 4 18 5 Refresh see page 4 49 6 Exit see page 4 50 6 Display VPD Information see page 4 18 7 Select HBA Port see page 4 11 8 Refresh se...

Page 38: ...ific Port Setting see page 4 24 3 Configure iSCSI Settings see page 4 24 4 Configure Firmware Settings see page 4 25 5 Configure Device Settings see page 4 25 6 Configure Basic Settings see page 4 26...

Page 39: ...4 33 12 Display Local Prefix List IPv6 see page 4 33 13 Select HBA Port see page 4 49 14 Refresh see page 4 49 15 Exit see page 4 50 6 BIOS UEFI or FCode Settings Menu see page 4 34 1 Display BIOS UEF...

Page 40: ...t see page 4 40 9 Configure Target Authentication Menu see page 4 40 1 Display CHAP Table see page 4 41 2 Display Targets Using CHAP Entries see page 4 41 3 Assign a CHAP Entry to a Target see page 4...

Page 41: ...46 10 Display iSNS Settings see page 4 46 11 Configure iSNS see page 4 46 12 Save changes and reset HBA see page 4 18 13 Select HBA Port see page 4 50 14 Refresh see page 4 50 15 Exit see page 4 50 1...

Page 42: ...ER 2 A list of HBA port instances appears 3 Type the number for the HBA port instance you want to change and then press ENTER 4 Make changes in the following submenus 1 Display General System Informat...

Page 43: ...e page 4 49 4 Refresh see page 4 49 5 Exit see page 4 50 Before making a selection from the Import HBA Menu specify the HBA port whose settings you want to view or change by typing the number for Sele...

Page 44: ...t one to import 3 Type the number of the HBA whose configuration you want to import and then press ENTER The following appears You will now specify the target HBA to import the configuration to Please...

Page 45: ...rmware file name and path press ENTER Install HBA Driver All Adapters CLI Option d When you select the Install HBA Driver All Adapters option SANsurfer iSCSI HBA CLI shows the current driver version a...

Page 46: ...enu save the changes by typing the number for Save changes and reset HBA and then pressing ENTER This saves your changes and resets all ports on the HBA To update the firmware with these changes type...

Page 47: ...nu option varies depending on your system architecture automatically detected by SANsurfer iSCSI HBA CLI Bootcode that is the bootable code image is either BIOS FCode or EFI that allows system boot fr...

Page 48: ...sh cache sync disk and so forth A firmware update and reset will be performed that requires all applications accessing impacted LUNs to be shut down Any impacted systems must be unmounted Following fi...

Page 49: ...refresh the HBA to show these changes by typing the number for Refresh and then pressing ENTER If you do not select this option your changes will not be visible in SANsurfer iSCSI HBA CLI Retrieve FW...

Page 50: ...ou select the Display HBA Level Statistics option SANsurfer iSCSI HBA CLI lists statistics for the selected HBA For example MACTxFramesCount 118 MACTxBytesCount 26705 MACTxMulticast 4 MACTxBroadcast 1...

Page 51: ...l Parameters see page 4 17 2 Configure HBA Level Parameters see page 4 18 3 Select HBA Port see page 4 49 4 Save changes and reset HBA see page 4 17 5 Refresh see page 4 49 6 Exit see page 4 50 4 For...

Page 52: ...of that parameter in brackets value Type a new value for each parameter and then press ENTER To leave a parameter set to the current value just press ENTER Save Changes and Reset HBA Before resetting...

Page 53: ...ports on the HBA To update the firmware with these changes type the number for the Refresh option and then press ENTER If you do not select this option your changes will not be visible in SANsurfer i...

Page 54: ...ress ENTER Save Changes and Reset HBA if necessary Before resetting the HBA ensure no connections are active Select the Save Changes and Reset HBA option to save your changes and reset all ports on th...

Page 55: ...btain Router Address Auto IPv6 Default Router IP Address You are prompted to turn on or off each feature the current state is shown at the end of the prompt For example the following prompt indicates...

Page 56: ...page 4 49 8 Exit see page 4 50 4 For each submenu save the changes by typing the number for the Save changes and reset HBA option and then pressing ENTER This saves your changes and resets all ports...

Page 57: ...ettings see page 4 24 4 Configure Firmware Settings see page 4 25 5 Configure Device Settings see page 4 25 6 Configure Basic Settings see page 4 26 7 Configure Advanced Settings see page 4 26 8 Confi...

Page 58: ...page 4 25 Configure Basic Settings on page 4 26 Configure Advanced Settings on page 4 26 To edit specific HBA settings 1 At the following prompt type the name of the parameter you want to change Enter...

Page 59: ...mple AFW_Device_Timeout on To change the value type the new value after the prompt To keep the current value press ENTER at the prompt The next firmware setting appears The settings are displayed one...

Page 60: ...alue in brackets for example Task_Management_Timeout 10 To change the value type the new value after the prompt To keep the current value press ENTER at the prompt SANsurfer iSCSI HBA CLI displays the...

Page 61: ...tting is displayed with the current value in brackets for example KeepAliveTO 30 To change the value type the new value after the prompt To keep the current value press ENTER at the prompt The next se...

Page 62: ...ng the firmware to its default configuration These changes will not become permanent until the HBA settings are saved Press the enter key to continue Port Restore Factory Defaults CLI Option rdh Use t...

Page 63: ...Table see page 4 32 7 Display Connection Error Log see page 4 32 8 Export Connection Error Log see page 4 33 9 Display Neighbor Cache IPv6 see page 4 33 10 Display Destination Cache IPv6 see page 4 3...

Page 64: ...a number between 1 and 2147483648 2 31 and then press ENTER SANsurfer iSCSI HBA CLI prompts you as follows Enter the packet size in bytes for the PING 32 4 Type the number you want For IPv6 networks...

Page 65: ...you want to stop the loopback test should an error occur type y for the Stop on error Y option After the test is complete SANsurfer iSCSI HBA CLI displays the number of failed tests and successful te...

Page 66: ...A port statistics counters are immediately reset Display ARP Table CLI Option arp Select the Display ARP Table option to view the Address Resolution Protocol ARP cache which keeps a record of host por...

Page 67: ...remote destinations For multicast and on link unicast destinations the next hop IP address always matches the destination IP address For unicast destinations that are off link the next hop IP address...

Page 68: ...tings you want to change and then press ENTER 3 Select the following submenus to view or make changes to the HBA bootcode settings 1 Display BIOS UEFI or FCode Information see page 4 35 2 Set BIOS UEF...

Page 69: ...ng on your system architecture to select the bootcode mode For example Choose from one of the following modes 1 BIOS UEFI or FCode Boot Disabled 2 BIOS UEFI or FCode Boot Manual Mode 3 BIOS UEFI or FC...

Page 70: ...o Operations Before making a selection from the HBA Target Menu follow these steps 1 Specify the HBA port whose settings you want to view or change by typing the number for Select HBA Port and then pr...

Page 71: ...I devices as defined by the iSCSI standard iSCSI name target iSCSI name as defined by the iSCSI standard Alias target iSCSI alias name as defined by the manufacturer software State of the target sessi...

Page 72: ...n TGTISCSIO_Initial_R2T on TGTISCSIO_Data_Sequence_In_Order on TGTISCSIO_Data_PDU_In_Order on TGTISCSIO_CHAP_Authentication on TGTISCSIO_Bidi_CHAP_Authentication off TGTISCSIO_Snack off TGTISCSIO_Disc...

Page 73: ...g it in the HBA flash Targets that are not persistently bound will not persist across firmware resets or HBA power cycles When you select this option SANsurfer iSCSI HBA CLI lists available targets At...

Page 74: ...it The target remains in the HBA database Enable a Target Select the Enable a Target option to re enable the target and re establish the connection if possible Configure Target Authentication Menu The...

Page 75: ...y CHAP Table option to view the CHAP table which is an array of records containing CHAP names and secrets used by the HBA during CHAP authentication For example CHAP TABLE Entry 1 DEFAULT BIDI CHAP en...

Page 76: ...LI Option addchap To add an entry to the CHAP table 1 On the HBA CHAP Menu type 4 Add a CHAP entry and then press ENTER 2 At the CHAPName prompt type a name for the CHAP entry and then press ENTER The...

Page 77: ...BIDI CHAP entry with the defbibi command See defbidi Add a Default BIDI CHAP on page 5 7 Edit a CHAP Entry CLI Option edchap To edit a CHAP entry 1 On the HBA CHAP Menu type 6 Edit a CHAP entry and t...

Page 78: ...Entry on page 5 7 Save Target CHAP Changes No CLI Option Save any changes you made in sections Assign a CHAP Entry to a Target CLI Option linkchap on page 4 42 through Delete a CHAP Entry CLI Option...

Page 79: ...50 Display Send Targets Select the Display Send Targets option to view a list of send targets in the SANsurfer iSCSI HBA CLI database as well as the persistent send targets in the HBA database Displa...

Page 80: ...failover Before this option can take effect you must select the Save Target CHAP Settings option see page 4 47 Duplicate a Discovered Target Select the Duplicate a Discovered Target option to copy a...

Page 81: ...target For example iSCSI HBA Target Menu HBA Target Menu Enter selection 7 Target ID 64 IP 192 166 1 41 Port 3260 iSCSI Name iqn 1992 08 com netapp sn 51403494 Alias drive4 State Session Active Enter...

Page 82: ...C HBA Serial Number FS10506A02810 FW Version 2 2 4 45 Type Copper IP Address 192 168 104 129 Alias iSCSI name iqn 2000 04 com qlogic qla4050c fs10506a02810 1 2 HBA 1 Port 0 HBA Port Index 2 HBA Model...

Page 83: ...t this is in the list of all system iSCSI ports HBA model for example QLA4052C HBA serial number Firmware version Type of connection Copper or Optical IP Address Alias iSCSI Name The display looks sim...

Page 84: ...21 00 E S Exit No CLI Option To return to the next higher level parent menu type the number for Exit and then press ENTER If you are at the top level of the interactive menu the CLI offers you the opt...

Page 85: ...ith the HBA from a menu based system use Interactive mode commands instead for details see Section 4 Interactive Mode Commands The command format for non interactive mode is iscli optional parameters...

Page 86: ...e system is prepared for a HBA reset before making changes Table 5 1 Non interactive Command Variables Variable Definition hba_port_inst The system port formerly HBA number Target ID Target ID LUN ID...

Page 87: ...CHAP entry is BIDI bidirectional When this parameter is not specified default the CHAP entry is local Issuing this command resets the HBA For more information on CHAP and the interactive version of t...

Page 88: ...when QLogic releases a new bootcode with bug fixes or enhancements At the prompt type the name of the file containing the bootcode code image to upload to the HBA For information on bootcode file nam...

Page 89: ...he port enter the c command as follows c hba_port_inst When you specify a port instance information for only that HBA is shown When you do not specify a port instance information for all HBA ports in...

Page 90: ...Target Information To clear the primary boot target and LUN enter the cpbootcode command as follows cpbootcode hba_port_inst For information on the interactive version of this command see Clear Prima...

Page 91: ...Cache IPv6 CLI Option dc on page 4 33 dce To display the connection error logs for up to 100 latest connections enter the dce command as follows dce hba_port_inst target_id filename If hba_port_inst...

Page 92: ...an specify the following actions p Pre install driver package default i Install driver package u Uninstall driver package g Get driver package path You may also specify the following flags DRIVER_PACK...

Page 93: ...ion on the interactive version of this command Display Discovered Targets on page 4 45 dtdspa List Targets To view discovered targets including persistent and non persistent enter the dtspa command as...

Page 94: ..._instance To obtain the target instance use the command dtdsp Display Discovered Targets on page 5 9 For information on the interactive version of this command Login and Persist a Discovered Target on...

Page 95: ...on page 4 16 dumpnvram Retrieve FW Flash NVRAM Record To dump the NVRAM to a file name of your choice enter the dumpnvram command as follows dumpnvram hba_port_inst File name For information on the in...

Page 96: ...the iSCSI protocol and general HBA functioning Use the f command to update the firmware image For information on firmware file names see Appendix E Downloadable File Names To update the HBA firmware...

Page 97: ...e following Host name Host version Host type User type For information on the interactive version of this command see Display General System Information CLI Option g on page 4 9 gcr Retrieve FW Crash...

Page 98: ...hich ports were detected HBA number that is the number of this HBA in the detection process HBA port number 0 or 1 for this HBA Port instance number in the system two port HBAs appear twice Port Insta...

Page 99: ...P Address 192 168 3 38 Alias iSCSI name iqn 2000 04 com qlogic as10506a02810 1 3 HBA 2 Port 0 HBA Port Instance 3 HBA Model QLA4010 HBA Serial Number FS20407B03135 FW Version 3 0 1 17 Type Copper IP A...

Page 100: ...21 isns Configure iSNS Settings To configure the iSNS settings for QLA4010 and QLA405x enter the isns command as follows I Configure the iSCSI name T Configure the targets C Configure the CHAP table B...

Page 101: ...P Address parameter this command disables the iSNS client on the specified HBA port Issuing this command resets the HBA For information on the interactive version of this command see iSNS Settings CLI...

Page 102: ...For a fiber connection the link speed is always 1000 Mbs The optional parameter FLOW will turn on or off flow control lcd Display Configured Link Configuration To display the configured link settings...

Page 103: ...local prefix list enter the lp command as follows lp hba_port_inst There is no corresponding interactive mode option for this command model To view the HBA model s board type s in the system enter th...

Page 104: ...ce_Negotiate_Main_iSCSI_ Keys iSCSI_Alias IALS on or off iSCSI_Data_Digests IDD on or off iSCSI_Discovery_Logout ID on or off iSCSI_Header_Digests IHD on or off iSCSI_Immediate_Data IID on or off iSCS...

Page 105: ...nf hba_port_inst IP IP Address IPNM Subnet Mask IPGW Gateway IP Address Where Setting the IP address subnet mask or gateway turns off DHCP address resolution for the IP configuration if it is on For i...

Page 106: ...mask of the HBA IPGW Gateway Address Sets the gateway DISN4 Disables IPv4 network setupa a Mutually exclusive with the other IPv4 commands IPV4DHCP Set DHCP ONb b Mutually exclusive with IP IPNM IPGW...

Page 107: ...mmand as follows nh hba_port_inst Config name Config alias Value Config name Config alias Value The valid parameters and their values are shown in Table 5 3 For a complete list of HBA parameters see A...

Page 108: ...pbootcode hba_port_inst tgt lun This command is not active for the PPC For information on the interactive version of this command see Set Primary Boot Target Information CLI Option pbootcode on page 4...

Page 109: ...rt_inst Target ID If you do not specify the Target ID SANsurfer iSCSI HBA CLI displays all targets for the specified HBA port number If you do not specify the port instance hba_port_inst nor the Targe...

Page 110: ...upload For information on the interactive version of this command see Update ROM Image CLI Option r on page 4 14 rdf Enter the rdf command to restore the specified HBA port s firmware values to the f...

Page 111: ...dh on page 4 28 NOTE The rdh command is not supported in the QLA4010 HBA hba_port_inst HBA port whose factory settings you want to restore A Restores the factory settings for the entire HBA firmware p...

Page 112: ...save the configuration in XML of all HBAs detected enter the save command as follows save File Name For information on the interactive version of this command see Save Host Configuration CLI Option s...

Page 113: ...e client ID seven characters maximum enter the sbootcodecid command as follows sbootcodecid hba_port_inst Alternative Client ID This command is not active for the Power PC PPC For information on the i...

Page 114: ...thba hba_port_inst stdsp To view the send targets enter the stdsp command as follows stdsp hba_port_inst strd To execute a rediscovery of targets for the specified send target enter the strd command a...

Page 115: ...config_alias value For information on the interactive version of this command see Configure Target Parameters CLI Option tc on page 4 39 tp To see information stored in Flash memory about persistent...

Page 116: ...VPD enter the vpd command as follows vpd hba_port_inst Available VPD information varies by HBA manufacturer For information on the interactive version of this command see Display VPD Information CLI...

Page 117: ...abetically for ease of use Table A 1 Port Settings Parameter Value Alias Description AFW_AutoConnect on off AFWC When on the HBA will not try to autoconnect to the configured targets at boot time Inst...

Page 118: ...Pv4 Enable_IPv6 on off EIPV6 Enables use of IPv6 ExeThrottle 0 32767 ET Specifies the execution throttle value The exe cution throttle is used by the firmware to limit the number of concurrently execu...

Page 119: ...om the target in a status IOCB FW_ZIO_Enable_Mode on off ZIOE Enables Zero Interrupt Operation ZIO mode When on the firmware minimizes the number of interrupts it generates to the host driver while it...

Page 120: ...6_Addr_Local_Link IPv6 address IPLL Contains the IPv6 link local address IPv6_Addr_Routable0 IPv6 address IPR0 Contains the IPv6 first manually configured routable address IPv6_Addr_Routable1 IPv6 add...

Page 121: ...pdated value is received in a router advertise ment IPv6_ND_Stale_Timeout 0 42949 67295b IPV6STO Specifies the time in milliseconds after which a stale IPv6 neighbor cache entry is discarded IPv6_Port...

Page 122: ...ctions IPv6_VLAN_Enable on off IPV6VLANEN When on VLAN filtering is enabled for the HBA IPv6 traffic only IPv6_VLAN_ID 0 4095 IP_V6VLANID When the IPv6_VLAN_Enable parameter is on this 12 bit ID appen...

Page 123: ...validated and CRC protection is removed iSCSI_Immediate_Data on off IID When on the HBA firmware negotiates during login phase for Immediate Data yes When off immediate data is disabled and the firmwa...

Page 124: ...s are discarded LDROUTER_AUTO on off LDRA Local default router Gets router address auto matically LOC_LINK_AUTO on off LOCLA Local link auto MaxBurstLen 0 32767 unitsa MBL Tells max length for data se...

Page 125: ...factor that adjusts the interval between timer ticks on each connection allowing faster timeouts on small networks TCP_Window_Scale 0 14 WINSCALE TCP window scale VLAN_Enable on off VLAN When on VLAN...

Page 126: ...t_ Reass_Timeout 40 to 600 units are 1 10 secs HBADFRT For QLE406x HBAs only Default value for the IP Fragment Reas sembly Timeout HBA_Delayed_ACK on or off HBADELACK For QLE406x HBAs only Deter mines...

Page 127: ...IPInvalidAddrErrorCount IP invalid address error count IPRxBytesCount IP received byte count IPRxFragmentOutOfOrderCount IP received fragment out of order count IPRxFragmentOverlapCount IP received f...

Page 128: ...tesCount iSCSI data bytes received count iSCSIRxPDUCount iSCSI PDU received count iSCSISeqErrorCount iSCSI sequence error count iSCSITxBytesCount iSCSI data bytes transmitted count iSCSITxPDUCount iSC...

Page 129: ...rrals MAC transmitted deferrals MACTxExcessDeferrals MAC transmitted excess deferrals MACTxFramesCount MAC transmitted frame count MACTxFramesDropped MAC transmitted dropped frames MACTxJumboFrames MA...

Page 130: ...ount TCP transmitted segment count TCPRxWindowProbeCount TCP received window probe count TCPRxWindowUpdateCount TCP received window update count TCPTxBytesCount TCP transmitted byte count TCPTxPureACK...

Page 131: ...isplay Target Information option You can configure a target by changing specific parameters Table C 1 lists target parameters and their range of values You can configure the parameters shown in boldfa...

Page 132: ...tagram when TTL zero 0 255 TGT_4022_Delayed_Ack TGT4022DACK Target QLA4022 delayed acknowledgement on off TGT_DDB_IPv6 TGT_DDB_IPv6 Target device database IPv6 on off TGT_DefaultTimeout TGTDTO Target...

Page 133: ...entLen Target max receive data seg ment length 128 TGT_MaxSegmentSize TGTMSS Target maximum segment size 1460 TGT_MaxTxDataSegmentLen Target maximum transmit data segment length 0 TGT_Perm_Redirect_Op...

Page 134: ...HAP_Authentication Target iSCSI I O CHAP authentication on off TGTISCSIO_Data_Digests TGTIDD Target iSCSI I O data digests on off TGTISCSIO_Data_PDU_In_Order Target iSCSI I O data PDU in order on off...

Page 135: ...cess_Granted Target option access granted on off TGTO_Initiator_Entry Target option initiator entry on off TGTO_Target Entry Target option target entry on off TGTTCPO_Nagle TGTTCPN Target TCP option N...

Page 136: ...C Target Parameters C 6 SN0054621 00 E S Notes...

Page 137: ...d parameter use h switch to see proper usage 101 CORE_ERR_MEM_FAIL Failed to allocate memory error 102 CORE_ERR_SDM_FAIL A call to the SDM Library failed 103 CORE_ERR_NO_HBA HBA instance specified is...

Page 138: ...RE_ERR_GET_TGTINFO_FAIL Failed to get target information 124 CORE_ERR_STATS_READ_FAILED Failed to get statistic information 125 CORE_ERR_WRITE_FAILED Failed to write information 126 CORE_ERR_READ_DEF_...

Page 139: ...er HBAs with HBA DHCP off allowed modes are 1 and 2 with HBA DHCP on Mode 3 is also allowed 147 CORE_ERR_NO_IMP_HBAS No HBAs in specified file to import 148 CORE_ERR_PARSING_ERROR Parsing error in the...

Page 140: ...164 ERR_INVALID_CFG_PARAMETER Invalid configuration parameter 165 CORE_ERR_GET_V6_CACHE Retrieval of IPv6 data failed 166 CORE_ERR_GET_ARP_TABLE Retrieval of ARP table failed 167 CORE_ERR_WRONG_FW_IM...

Page 141: ...Command Error Codes addchap CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_CHAP_CONV CORE_ERR_CHAP_TBL_FULL CORE_ERR_EXT CORE_ERR_CHAP_SAVE_FAIL b CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_EXT binfo CORE_ERR...

Page 142: ..._SETBOOTCODE csbootcode CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_SETBOOTCODE defbidi CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_CHAP_CONV CORE_ERR_CHAP_TBL_FULL CORE_ERR_EXT CORE_ERR_CHAP_S...

Page 143: ...NABLE_TO_BUILD_ADAPTER_ID CORE_ERR_OPERATION_NOT_SUPPORTED CORE_ERR_FAILURE_TO_INSTALL_DRIVERS CORE_ERR_UNEXPECTED_FILE_TYPE dspchap CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_CHAP_CONV dumpnvram CORE_E...

Page 144: ..._SOURCE_HBA CORE_ERR_INVFILE CORE_ERR_EXT CORE_ERR_INITFW_INVALID CORE_ERR_SAVE_INITFW CORE_ERR_HBAOPEN CORE_ERR_CHAP_SAVE_FAIL CORE_ERR_DDB_SAVE_FAIL CORE_ERR_SETBOOTCODE ipdhcp CORE_ERR_HBAINV CORE_...

Page 145: ...TED 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_ERR_NO_HBA CORE_ERR_INV CORE_ERR_CHAP_CONV...

Page 146: ...CORE_ERR_SETBOOTCODE CORE_ERR_SAVE_INITFW CORE_ERR_INV netconf CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_INITFW_INVALID CORE_ERR_SAVE_INITFW netconf6 CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_...

Page 147: ...O_HBA CORE_ERR_INV CORE_ERR_NOSPACE CORE_ERR_EXT pinfo CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_EXT ps CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_TGT_INV CORE_ERR_NOCOUNT CORE_ERR_INV pu CO...

Page 148: ...O_HBA CORE_ERR_INV save CORE_ERR_INV CORE_ERR_INVFILE sbootcode CORE_ERR_HBAINV CORE_ERR_NO_HBA CORE_ERR_INV CORE_ERR_TGT_INV CORE_ERR_NOT_SUPPORTED CORE_ERR_SETBOOTCODE sbootcodecid CORE_ERR_HBAINV C...

Page 149: ...or Codes 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 Table D 2 Non interactive Mode Err...

Page 150: ...D Error Codes Non interactive Mode Error Codes D 14 SN0054621 00 E S Notes...

Page 151: ...de or EFI for Solaris allows system boot from Boot Code 406x BIOS for x86 and x64 processors FCode or EFI for Solaris allows system boot from BIOS 405x QL4022RM bin BIOS 406x QL4022RM bin BIOS 4010 QL...

Page 152: ...E Downloadable File Names E 2 SN0054621 00 E S Notes...

Page 153: ...SANsurfer iSCSI HBA CLI Windows desktop icon b Click Properties c On the Shortcut page click Find Target 2 Go to the following directory C installed pre dvt 1 1 00 09 3 To activate trace locate the i...

Page 154: ...ter String Set Level only True or False Output buffered True or False Source Line and file True or False Console True or False Console Date time Prefix True or False Dump FW Cmp inst True or False Dum...

Page 155: ...race Levels Trace Output Value iscsi cli clear screen true or false iscsi cli trace output setlevelonly true or false iscsi cli trace output buffered true or false iscsi cli trace output src line and...

Page 156: ...p mem bootcode true or false iscsi cli trace output dump mem targets true or false iscsi cli trace output file true or false iscsi cli trace output file datetimeprefix true or false iscsi cli trace ou...

Page 157: ...e primary function of the boot code is communication with the external boot device before the operating system is up and running There are also secondary functions that can be performed by the boot co...

Page 158: ...There is a separate class for disk Ethernet and so forth This level handles all generic aspects of opera tions for that class Port Driver The middle driver level which handles aspects of the operation...

Page 159: ...gle N_Port F_Ports are intermediate ports in virtual point to point links between end ports for example N_Port to F_Port to F_Port to N_Port using a single FC fabric switch fabric A fabric consists of...

Page 160: ...you to locate the HBA IOCB I O control block An IOCB is a command structure in QLogic ISP architecture ioctl Input output control A system call in Unix Linux systems Allows an application to control...

Page 161: ...Port using a single FC fabric switch See FL_Port N_Port ID Virtualization The ability for a single physical FC end point N_Port to support multiple uniquely addressable logical end points With NPIV a...

Page 162: ...irectly connected not in a loop port Access points in a device where a link attaches There are four types of ports as follows N_Port Node Port an FC port that supports point to point topology NL_Port...

Page 163: ...t parameter 4 25 4 26 5 20 A 1 AFW_Serlz_Task_Mngmt parameter 4 26 A 2 AL_PA definition of Glossary 1 alias 4 48 HBA 4 49 iSCSI 4 24 4 26 5 20 A 6 iSCSI port 4 22 port instance 5 14 alternative client...

Page 164: ...rget iSCSI I O C 4 configuring 4 40 default bidirectional BIDI adding 4 43 5 7 entry 4 42 adding 5 3 assigning to target 4 42 5 19 deleting 4 44 5 7 displaying targets 4 41 5 6 editing 4 43 5 11 iSCSI...

Page 165: ...5 21 netconf6 4 27 5 22 nh 4 24 5 23 pa 4 40 5 23 pad 5 24 pb 4 39 5 24 pbootcode 4 35 5 24 pdt 5 24 pet 5 24 pinfo 5 24 ping 4 30 5 25 ps 5 25 pu 5 25 px 5 26 r 4 14 5 26 rdf 5 26 rdh 4 28 5 27 rwt...

Page 166: ...mer card identification number viewing 4 18 D d 4 11 5 6 data digests iSCSI 4 24 4 27 5 20 A 6 digests target iSCSI C 4 immediate C 4 maximum receive data segment length A 8 PDU in order iSCSI A 6 C 4...

Page 167: ...information 4 12 level parameters 4 17 level statistics 5 30 types in system 5 19 help file 4 49 5 13 local prefix list IPv6 4 33 5 19 LUN information 5 17 neighbor cache 4 33 5 21 network settings 4...

Page 168: ...viewing 4 18 execution count C 2 execution throttle 4 26 5 20 A 2 C 2 ExeThrottle parameter 4 25 4 26 5 20 A 2 exit to higher level interactive menu mode 4 50 exporting connection error log 4 33 data...

Page 169: ..._ND_Reachable_Timer A 5 IPv6_ND_Retransmit_Timer A 5 IPv6_ND_Stale_Timeout A 5 IPv6_Port A 5 IPv6_Redirect_Enable A 5 IPv6_TCP_Time_Stamp A 5 IPv6_TCP_Timer_Scale A 5 IPv6_TCP_Window_Scale A 5 IPv6_Tr...

Page 170: ...formation viewing 5 13 getting started 3 1 glossary of terms Glossary 1 granted access C 5 gratuitous neighbor IPv6 settings 4 28 guide documentation conventions 1 2 intended audience 1 1 organization...

Page 171: ...g 5 19 header digests iSCSI 4 24 4 27 5 20 A 7 target iSCSI I O C 4 help file viewing 4 49 5 13 hop limit IPv6 A 4 Host Adapter Module HAM definition of Glossary 3 Host Adapter Module HAM NetWare requ...

Page 172: ...arameter A 3 IP_Gateway parameter 5 20 A 3 IP_Subnet Mask parameter A 3 IP_Subnet_Mask parameter 5 20 ipdhcp 4 21 5 16 IPR setting 5 16 IPv4 disabling 5 22 enabling A 2 parameters configuring 4 26 tim...

Page 173: ..._VLAN_ID parameter 4 27 A 6 IPv6_VLAN_User_Priority parameter 4 27 A 6 IPv6MCast_listnr_Disco_Enable parameter A 4 iSCSI alias 4 24 4 26 A 6 bidirectional CHAP authentication A 6 CHAP authentication A...

Page 174: ...4010 restoring settings 4 28 limit IPv6 hop A 4 link configuration configuring 4 20 5 18 displaying 4 20 5 18 link settings port 4 19 link IPv6 address local A 4 linkchap 4 42 5 19 Linux Red Hat 2 3 S...

Page 175: ...ay Program Version Information 4 8 Exit 4 50 HBA Level Info Operations Menu 4 12 Help 4 49 Host Level Info Operations Menu 4 8 List All QLogic iSCSI HBA Ports Detected 4 48 Port Level Info Operations...

Page 176: ...ed 1 4 operations host 4 8 port 4 19 optical connection 5 14 optional parameters 5 1 options HBA 4 13 organization of guide 1 1 P pa 4 40 5 23 package driver pre installing 5 8 pad 5 24 parameters HBA...

Page 177: ...LUN 4 47 5 17 program version 4 8 5 31 ps 5 25 pu 5 25 px 5 26 Q QLA4010 restoring settings 4 28 QLogic contacting 1 5 technical support 1 5 QLogic iSCSI HBAS listing 4 48 quiet installation Windows...

Page 178: ...ing 4 33 5 8 IPv6 settings 4 27 local default auto A 8 running loopback test 5 18 read write buffer test 4 31 5 28 rwt 4 31 5 28 S SAN Storage Area Network definition of Glossary 6 sans serif font mea...

Page 179: ...support See technical support supported operating systems 1 4 SUSE Linux installing on 2 9 2 10 uninstalling 2 13 system information viewing 4 9 5 13 port instance 5 14 T t 4 37 5 30 target parameter...

Page 180: ...ogout C 4 TGTSCSIO_Strict_Login C 5 TGTSCSIO_Strict_Logout C 5 target definition of Glossary 6 targets See Also target parameters adding 4 40 authentication configuring 4 40 binding persistent 4 39 5...

Page 181: ...nitiatorSessID C 2 TGT_IPv6_Address C 2 TGT_IPv6_Flow_Label C 2 TGT_IPv6_iSCSI_Name C 2 TGT_IPv6_Port parameter C 3 TGT_IPv6_Source_Add_Flg C 3 TGT_iSCSI_Name C 3 TGT_KeepAliveTimeout C 3 TGT_Local_IP...

Page 182: ...mount F 4 levels F 2 using F 1 variables F 2 traffic class C 4 IPv6 A 6 training certification 1 5 transmit window scale C 4 ts 5 31 TTL time to live IPv4 4 25 C 2 type of service TOS 4 25 C 4 IPv4 A...

Page 183: ...2 VPD displaying info 4 18 5 32 W window scale enable C 4 scale receive C 3 size maximum 5 20 TCP window scale 4 27 A 9 Windows Control Panel uninstall 2 12 driver level structure Glossary 2 installat...

Page 184: ...PARC International Inc Products bearing SPARC trademarks are based on an architecture developed by Sun Microsystems Inc SUSE is a registered trademark of Novell Inc All other brand and product names a...

Search results

Summary of Contents for SANsurfer iSCSI HBA CLI

Reviews:

Related manuals for SANsurfer iSCSI HBA CLI

Brands by name

Popular brands

Qlogic SANsurfer iSCSI HBA CLI, User Manual

Search results

Summary of Contents for SANsurfer iSCSI HBA CLI

Reviews:

Related manuals for SANsurfer iSCSI HBA CLI

Brands by name

Popular brands