Q-Logic SN0054621-00 E instruction

SANsurfer iSCSI HBA CLI

User’s Guide

Command Line Interface for

QLogic iSCSI Host Bus Adapters

SN0054621-00 E

Image 1

Q-Logic SN0054621-00 E manual SANsurfer iSCSI HBA CLI User’s Guide

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 Intended Audience IntroductionHow This Guide is Organized Typographic Conventions Related Documents Related DocumentsPart Number Title Or Name 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 Solaris SPARC/Solaris x86 Uninstall Red Hat/SUSE Linux/PPC UninstallTo uninstall quietly from the command line Page Getting Started Starting Interactive ModeIntroduction 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 Host Level Info & Operations Menu Display Program Version InformationTo choose an HBA 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 HBA Information HBA Level Info & Operations MenuCLI Option -ch 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 Display HBA Level Parameters HBA Level Parameters MenuTo make changes to the HBA level parameters Save Changes and Reset HBA Configure HBA Level ParametersDisplay VPD Information CLI Option -vpd Display Active Link Configuration Port Link Settings MenuPort Level Info & Operations Menu 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 Port Diagnostic Menu contains the following options Port Diagnostic MenuTo use port diagnostics 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 Display Target Information CLI Option -t List TargetsHBA CLI Interactive Mode Commands Port Level Info & Operations Menu Bind Target Configure Target ParametersDelete 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 Select HBA Port HelpRefresh 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 Dtlia DtliDtrem Dumpcore DtremaDumpnvram Edchap Update Firmware Image-All HBAs Update Firmware Image-Specific HBAChap Parameters Parameter Parameter Alias Value Display General System Information GcrHelp Port 0 on this HBA HBA Model Number List All QLogic iSCSI HBA Ports Detected Import Ipdhcp Configure iSNS SettingsIsns 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 Table B-1. HBA Statistics HBA StatisticsStatistic Abbreviation Meaning 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 Tgtis TgtisnackTgttcpn 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 Table D-2. Non-interactive Mode Error Codes Non-interactive Mode Error CodesCommand 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 To use trace Using TraceClick Properties 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 TCP Tcpdchp DhcpHBA 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 Dhcp A-8 TCPTcpdhcp 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