Table of Contents

1	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

2	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

SN0054621-00 E

Page v

Page 5

Image 5

Contents

SANsurfer iSCSI HBA CLI User’s Guide Changes Sections Affected Revision E Changes Document Revision History SN0054621-00 E Appendix C Target Parameters Appendix F Using Trace Table of Contents Getting Started SN0054621-00 E Non-interactive Mode Commands SN0054621-00 E Port-level Parameters HBA-level Parameters HBA Statistics Target Parameters Trace Variables Trace Level Trace Data Glossary Index List of Figures How This Guide is Organized IntroductionIntended Audience Typographic Conventions Part Number Title Or Name Related DocumentsRelated Documents Supported Operating Systems Supported QLogic HBAsSupported HBAs Ports Media Technical Support License AgreementsAvailability Training Introduction Technical Support SN0054621-00 E Installing SANsurfer iSCSI HBA CLI Installation and RemovalDownloading the Installation Package To download the installation package Where „ Microsoft Windows see Installing on Microsoft Windows on Installation and Removal Installing SANsurfer iSCSI HBA CLI Windows Standard GUI Installation Installing on Microsoft WindowsTo install using the GUI installation Read the information, and then click Next Select Which Users window appears, as shown in Figure Install Wizard Select Which Users To begin installation, click Install Install Wizard Ready to Install Install Wizard Installing SANsurferiCLI Click Finish Restart your computer Install Wizard Complete Standard Windows Interactive CLI Installation Windows Command Line InstallationQuiet or Unattended Windows Installation Passive Windows Installation Installing on Solaris SPARC/Solaris Installing on Red Hat/SUSE Linux/PPCOverwrite Previous Windows Installations Solaris Attended Installation To install silently on Solaris Solaris Silent InstallationCreate the noaskpkgadd.txt file with contents Create the following two files Start Menu Uninstall Microsoft Windows UninstallControl Panel Uninstall Command Line Uninstall To uninstall quietly from the command line Red Hat/SUSE Linux/PPC UninstallSolaris SPARC/Solaris x86 Uninstall Page Introduction Starting Interactive ModeGetting Started Windows system displays the Main Menu. For example Starting Non-interactive Mode Interactive Mode Commands Level Command Line Interface Menu Port Level Info & Operations see Port Network Settings Menu see Ping Target see Target Level Info & Operations see List All QLogic iSCSI HBA Ports Detected see To choose an HBA Display Program Version InformationHost Level Info & Operations Menu Display General System Information Save Host ConfigurationImport HBA Menu, Multiple Adapters CLI Option -g To import a single HBA configuration Import HBA ConfigurationSelect a configuration import option, and then press Enter Select from the following parameter sets to import Install HBA Driver, All Adapters Update Firmware, Multiple AdaptersSelect HBA Port CLI Option -d CLI Option -ch HBA Level Info & Operations MenuHBA Information Update Firmware Image Update BIOS/UEFI or FCode Code ImageHBA Options Menu No CLI Option Update ROM Image HBA Reset HBA Diagnostic Menu provides the following options HBA Diagnostic MenuRetrieve FW Crash Record Retrieve FW Flash & Nvram Record Display HBA Level Statistics Retrieve FW Coredump Record To make changes to the HBA level parameters HBA Level Parameters MenuDisplay HBA Level Parameters Save Changes and Reset HBA Configure HBA Level ParametersDisplay VPD Information CLI Option -vpd Port Level Info & Operations Menu Port Link Settings MenuDisplay Active Link Configuration Display Configured Link Configuration Port Network Settings MenuConfigure Link Configuration Save Changes and Reset HBA if necessary ISNS Settings Configure IP Settings Display Configured Port Settings Edit Configured Port Settings MenuTo edit the configured HBA settings Change Port Iscsi Alias Name To make changes to the HBA firmware settings Port Firmware Settings Menu Configure iSCSI Settings Edit a Specific Port SettingTo edit specific HBA settings At the following prompt, type the new value Configure Device Settings Configure Firmware Settings Configure Advanced Settings Configure Basic Settings„ TaskManagementTimeout „ Ldrouterauto „ Loclinkauto „ Routableauto „ Vlanid Configure IPv6 Settings„ VLANUserPriority „ ZIO Configure IPv6 TCP Settings Port Restore Factory DefaultsLegacy QLA4010 Restore Default Port Settings This option is not supported in the QLA4010 HBA To use port diagnostics Port Diagnostic MenuPort Diagnostic Menu contains the following options To ping a target Ping TargetHere is an example of a successful ping attempt Here is an example of a ping on an IPv6 network Perform Read/Write Buffer Test Perform Loopback TestTo start a loopback test To start a read/write buffer test Display Connection Error Log Reset StatisticsDisplay Port Statistics Display ARP Table Display Default Router List IPv6 Export Connection Error LogDisplay Neighbor Cache IPv6 Display Destination Cache IPv6 To edit the HBA BIOS/UEFI or FCode settings BIOS/UEFI or FCode Settings Menu Set BIOS/UEFI or FCode Mode Display BIOS/UEFI or FCode InformationSet Primary Boot Target Information Set Secondary Boot Target Information Clear Secondary Boot Target Information Clear Primary Boot Target InformationTarget Level Info & Operations Set Alternative Client ID HBA CLI List TargetsDisplay Target Information CLI Option -t Interactive Mode Commands Port Level Info & Operations Menu Delete Target Configure Target ParametersBind Target Enable a Target Disable a TargetConfigure Target Authentication Menu To configure target authentication Chap Display Chap Table Display Targets Using Chap Entries Add a Chap Entry Assign a Chap Entry to a Target„ Name Chap name „ Secret Chap secret To assign a Chap entry to a target To add a default Bidi Chap Add a Default Bidi ChapEdit a Chap Entry To edit a Chap entry Save Target/CHAP Changes Delete a Chap EntryTarget Discovery Menu To delete an entry from the Chap table Display Discovered Targets Display Send TargetsAdd a Send Target Mark Send Target for Re-discovery Display iSNS Settings Login and Persist a Discovered TargetConfigure iSNS Remove a Send Target List LUN Information List All QLogic iSCSI HBA Ports Detected Refresh HelpSelect HBA Port Exit Non-Interactive Mode Commands Variable Definition Non-interactive Command Variables HBA Reset Non-interactive CommandsAcb Addchap Bootcodemode BootcodeUpdate BIOS/UEFI or FCode Mode Binfo For IBM cards, the following modes are available HBA Information Csbootcode CpbootcodeInstall HBA Driver, All Adapters System reboot may be required see the log file for details Defbidi DceDelchap Display Destination Cache IPv6 only Display Default Router List IPv6 only Dtdsp DspchapDtdspa Dtdupd Dtrem DtliDtlia Dumpcore DtremaDumpnvram Edchap Update Firmware Image-All HBAs Update Firmware Image-Specific HBAChap Parameters Parameter Parameter Alias Value Help GcrDisplay General System Information Port 0 on this HBA HBA Model Number List All QLogic iSCSI HBA Ports Detected Import Isns Configure iSNS SettingsIpdhcp Isns6 Lcd Linkchap Configuration Name Configuration Alias ValueModel HBA Parameters Afwdack AfwdtIparp Ipad Display Neighbor Cache Netconf Netconf6 Where option includes the following To disables the IPv4 and IPv6 networks To disable the IPv4 network, enter the followingTo add persistent targets, enter the -pacommand as follows To set only the local link address, enter the following Pad PbootcodePdt Pet Following provides the IPv6 source address values Ping Rdf Rdh Port Restore Factory Defaults Save Rwt Sbootcodecid SbootcodeSreset Sdmrc Stathba StatStdsp Strd Display Program Version Information Ver Display VPD Information Vpd Port- and HBA-level Parameters Table A-1. Port SettingsPort-level Parameters Parameter Value Alias Description Iprr AfwstmEIPV4 EIPV6 Zioe TOS EnableIPV4TOS IPV4TTL IPV6NDRT TCPV6NDIPV6NDRET IPV6STO IPV6TCPWS TCPV6TSIPV6TC IPV6VLANEN When on, iSCSi headers with CRC protection Ldra LdrouterautoLoclinkauto Locla Winscale TmtoVlan Vlanid HBA-level Parameters Table A-2. HBA Settings Statistic Abbreviation Meaning HBA StatisticsTable B-1. HBA Statistics HBA Statistics Table B-1. HBA Statistics Table B-1. HBA Statistics Target Parameters Parameter Alias Function Value Table C-1. Target Parameters Tgtkato TgtinameTgtmb TGEMOR2T Tgtwinscaleen TgttmsTgtidd Tgtlds Tgttcpn TgtisnackTgtis Target Parameters SN0054621-00 E Interactive Mode Error Codes Error CodesTable D-1. Interactive-Mode Error Code Descriptions Return Name Description Coreerrnocount CoreerrnospaceCoreerrhbainv Coreerrnotgt Coreerrbootcodeenabled CoreerrsetbootcodeCoreerrbootcodeinvalid Coreerrbootcodemode Coreerrfailuretoinstall CoreerrdriverupdatefailedCoreerrsecuritydescriptor Initializationfailed Command Error Codes Non-interactive Mode Error CodesTable D-2. Non-interactive Mode Error Codes Chapmap Coreerrunabletounzipdriverfile CoreerrfailuretoinstalldriversCoreerrunabletogetinfofromdirverfile Coreerrsecuritydescriptorinitializationfailed Gcr Corestatusbad Isns6 Netconf Pbootcode Stat Coreerrinvalidcfgparameter Ver Vpd Error Codes Non-interactive Mode Error Codes SN0054621-00 E Table E-1. File Names Downloadable File NamesFile Type File Name Description Downloadable File Names SN0054621-00 E Click Properties Using TraceTo use trace Trace Level Trace VariablesTable F-1. Trace Parameters Variable Character String Value Trace Level Table F-2. Trace Level CommandsTable F-3. Some More Info About Trace Levels Trace Output Value To continue, press Enter Trace DataTable F-4. Trace Data Amount Data Level Glossary CSV file CoSComma separated values CSV file Device Fast!UTIL Flash Flash BiosGPort HBA alias Media LUN maskingNPort Node Port NPort ID Virtualization Path Network adapterPoint-to-point Port Index BiosMAC ARP 41,5-9 C4-22,5-5cache36,5-29 Ch4-12,5-5 14,5-26 30,5-2528,5-27 31,5-28 HBA DhcpTCP Tcpdchp Dr4-33,5-8driver ChapCore 4-17,5-11firmware core 4-16firmware Flash 4-15NVRAM Dumpnvram 4-15, 5-11-dv 26,5-20,A-2,C-2 26,A-225,4-26,5-20,A-2 Version 4-12,4-48,5-14version, HBA Routableauto A-8 Ldrouterauto A-8 H4-49,5-13 G4-9,5-13 48,4-49 12,5-2448,5-14 12,4-48,4-49,5-14 Address 4-26,4-49,5-20,A-3,C-3HBA port Iocb25,A-4 26,A-4 Alias 4-24,4-26,A-6 IPv6 SourceAddFlg, target C-3TCP settings LIP Suse 5-1 21,A-849,5-14 N4-18,4-24,5-19 Nvram Nh4-24,5-23Pa4-40,5-23 Glossary-6 ID, LUN PPCR2T IP ARP Scsi 35,5-29C-5 12,4-49,5-14 ISCSI 4-24,5-20,A-7target iSCSI I/O C-5 SnackStat4-32,5-30-stathba5-30statistics T4-37,5-30 Index-18 SN0054621-00 E Tcpdhcp TCPDhcp A-8 25,4-27,A-7,C-3 TCP 4-27,5-20,A-5,A-8time to live, IPv4 4-25,A-4timeouts25,C-2 25,C-4 SN0054621-00 E Index-21 Vlan Camberley Surrey, GU16 7ER UK +44 0 1276 804

Q-Logic SN0054621-00 E manual Table of Contents

Models: SN0054621-00 E

SN0054621-00 E