Q-Logic SN0054621-00 E guide

SANsurfer iSCSI HBA CLI User’s Guide

Command Line Interface for QLogic iSCSI Host Bus Adapters

S

Added missing descriptions for IPv4TOS and IPv4TTL parameters.

Deleted obsolete Primary_DNS and SLP_Address parameters.

Moved trace information from 5 Non-Interactive Mode Commands to a new appendix.

Appendix C Target Parameters

Appendix F Using Trace

Page iv

SN0054621-00 E

Image 4

Q-Logic SN0054621-00 E manual Appendix C Target Parameters Appendix F Using Trace

Contents

SANsurfer iSCSI HBA CLI User’s Guide Document Revision History Changes Sections Affected Revision E Changes 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 HBA Statistics Target Parameters Port-level Parameters HBA-level Parameters Glossary Index Trace Variables Trace Level Trace Data List of Figures Intended Audience IntroductionHow This Guide is Organized Typographic Conventions Related Documents Related DocumentsPart Number Title Or Name Supported QLogic HBAs Supported Operating SystemsSupported HBAs Ports Media License Agreements Technical SupportAvailability Training Introduction Technical Support SN0054621-00 E Installation and Removal Installing SANsurfer iSCSI HBA CLIDownloading the Installation Package To download the installation package „ Microsoft Windows see Installing on Microsoft Windows on Where Installation and Removal Installing SANsurfer iSCSI HBA CLI Installing on Microsoft Windows Windows Standard GUI InstallationTo install using the GUI installation Read the information, and then click Next Install Wizard Select Which Users Select Which Users window appears, as shown in Figure Install Wizard Ready to Install To begin installation, click Install Install Wizard Installing SANsurferiCLI Install Wizard Complete Click Finish Restart your computer Windows Command Line Installation Standard Windows Interactive CLI InstallationQuiet or Unattended Windows Installation Passive Windows Installation Installing on Red Hat/SUSE Linux/PPC Installing on Solaris SPARC/SolarisOverwrite Previous Windows Installations Solaris Attended Installation Solaris Silent Installation To install silently on SolarisCreate the noaskpkgadd.txt file with contents Create the following two files Microsoft Windows Uninstall Start Menu 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 Starting Non-interactive Mode Windows system displays the Main Menu. For example Interactive Mode Commands Command Line Interface Menu Level 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 Save Host Configuration Display General System InformationImport HBA Menu, Multiple Adapters CLI Option -g Import HBA Configuration To import a single HBA configurationSelect a configuration import option, and then press Enter Select from the following parameter sets to import Update Firmware, Multiple Adapters Install HBA Driver, All AdaptersSelect HBA Port CLI Option -d HBA Information HBA Level Info & Operations MenuCLI Option -ch Update BIOS/UEFI or FCode Code Image Update Firmware ImageHBA Options Menu No CLI Option HBA Reset Update ROM Image HBA Diagnostic Menu HBA Diagnostic Menu provides the following optionsRetrieve FW Crash Record Retrieve FW Flash & Nvram Record Retrieve FW Coredump Record Display HBA Level Statistics Display HBA Level Parameters HBA Level Parameters MenuTo make changes to the HBA level parameters Configure HBA Level Parameters Save Changes and Reset HBADisplay VPD Information CLI Option -vpd Display Active Link Configuration Port Link Settings MenuPort Level Info & Operations Menu Port Network Settings Menu Display Configured Link ConfigurationConfigure Link Configuration Save Changes and Reset HBA if necessary Configure IP Settings ISNS Settings Edit Configured Port Settings Menu Display Configured Port SettingsTo edit the configured HBA settings Change Port Iscsi Alias Name Port Firmware Settings Menu To make changes to the HBA firmware settings Edit a Specific Port Setting Configure iSCSI SettingsTo edit specific HBA settings At the following prompt, type the new value Configure Firmware Settings Configure Device Settings Configure Basic Settings Configure Advanced Settings„ TaskManagementTimeout „ Ldrouterauto „ Loclinkauto „ Routableauto Configure IPv6 Settings „ Vlanid„ VLANUserPriority „ ZIO Port Restore Factory Defaults Configure IPv6 TCP SettingsLegacy 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 Ping Target To ping a targetHere is an example of a successful ping attempt Here is an example of a ping on an IPv6 network Perform Loopback Test Perform Read/Write Buffer TestTo start a loopback test To start a read/write buffer test Reset Statistics Display Connection Error LogDisplay Port Statistics Display ARP Table Export Connection Error Log Display Default Router List IPv6Display Neighbor Cache IPv6 Display Destination Cache IPv6 BIOS/UEFI or FCode Settings Menu To edit the HBA BIOS/UEFI or FCode settings Display BIOS/UEFI or FCode Information Set BIOS/UEFI or FCode ModeSet Primary Boot Target Information Set Secondary Boot Target Information Clear Primary Boot Target Information Clear Secondary 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 Disable a Target Enable a TargetConfigure Target Authentication Menu To configure target authentication Chap Display Targets Using Chap Entries Display Chap Table Assign a Chap Entry to a Target Add a Chap Entry„ Name Chap name „ Secret Chap secret To assign a Chap entry to a target Add a Default Bidi Chap To add a default Bidi ChapEdit a Chap Entry To edit a Chap entry Delete a Chap Entry Save Target/CHAP ChangesTarget Discovery Menu To delete an entry from the Chap table Display Send Targets Display Discovered TargetsAdd a Send Target Mark Send Target for Re-discovery Login and Persist a Discovered Target Display iSNS SettingsConfigure iSNS Remove a Send Target List LUN Information List All QLogic iSCSI HBA Ports Detected Select HBA Port HelpRefresh Exit Non-Interactive Mode Commands Non-interactive Command Variables Variable Definition Non-interactive Commands HBA ResetAcb Addchap Bootcode BootcodemodeUpdate BIOS/UEFI or FCode Mode Binfo HBA Information For IBM cards, the following modes are available Cpbootcode CsbootcodeInstall HBA Driver, All Adapters System reboot may be required see the log file for details Dce DefbidiDelchap Display Destination Cache IPv6 only Display Default Router List IPv6 only Dspchap DtdspDtdspa Dtdupd Dtlia DtliDtrem Dtrema DumpcoreDumpnvram Edchap Update Firmware Image-Specific HBA Update Firmware Image-All HBAsChap Parameters Parameter Parameter Alias Value Display General System Information GcrHelp List All QLogic iSCSI HBA Ports Detected Port 0 on this HBA HBA Model Number Import Ipdhcp Configure iSNS SettingsIsns Isns6 Lcd Configuration Name Configuration Alias Value LinkchapModel HBA Parameters Afwdt AfwdackIparp Ipad Netconf Display Neighbor Cache Where option includes the following Netconf6 To disable the IPv4 network, enter the following To disables the IPv4 and IPv6 networksTo add persistent targets, enter the -pacommand as follows To set only the local link address, enter the following Pbootcode PadPdt Pet Ping Following provides the IPv6 source address values Rdf Port Restore Factory Defaults Rdh Rwt Save Sbootcode SbootcodecidSreset Sdmrc Stat StathbaStdsp Strd Ver Display Program Version Information Vpd Display VPD Information Table A-1. Port Settings Port- and HBA-level ParametersPort-level Parameters Parameter Value Alias Description Afwstm IprrEIPV4 EIPV6 Zioe Enable TOSIPV4TOS IPV4TTL TCPV6ND IPV6NDRTIPV6NDRET IPV6STO TCPV6TS IPV6TCPWSIPV6TC IPV6VLANEN When on, iSCSi headers with CRC protection Ldrouterauto LdraLoclinkauto Locla Tmto WinscaleVlan Vlanid Table A-2. HBA Settings HBA-level Parameters Table B-1. HBA Statistics HBA StatisticsStatistic Abbreviation Meaning HBA Statistics Table B-1. HBA Statistics Table B-1. HBA Statistics Target Parameters Table C-1. Target Parameters Parameter Alias Function Value Tgtiname TgtkatoTgtmb TGEMOR2T Tgttms TgtwinscaleenTgtidd Tgtlds Tgtis TgtisnackTgttcpn Target Parameters SN0054621-00 E Error Codes Interactive Mode Error CodesTable D-1. Interactive-Mode Error Code Descriptions Return Name Description Coreerrnospace CoreerrnocountCoreerrhbainv Coreerrnotgt Coreerrsetbootcode CoreerrbootcodeenabledCoreerrbootcodeinvalid Coreerrbootcodemode Coreerrdriverupdatefailed CoreerrfailuretoinstallCoreerrsecuritydescriptor Initializationfailed Table D-2. Non-interactive Mode Error Codes Non-interactive Mode Error CodesCommand Error Codes Chapmap Coreerrfailuretoinstalldrivers CoreerrunabletounzipdriverfileCoreerrunabletogetinfofromdirverfile Coreerrsecuritydescriptorinitializationfailed Gcr Isns6 Corestatusbad Netconf Pbootcode Coreerrinvalidcfgparameter Stat Ver Vpd Error Codes Non-interactive Mode Error Codes SN0054621-00 E Downloadable File Names Table E-1. File NamesFile Type File Name Description Downloadable File Names SN0054621-00 E To use trace Using TraceClick Properties Trace Variables Trace LevelTable F-1. Trace Parameters Variable Character String Table F-2. Trace Level Commands Value Trace LevelTable F-3. Some More Info About Trace Levels Trace Output Value Trace Data To continue, press EnterTable F-4. Trace Data Amount Data Level Glossary CoS CSV fileComma separated values CSV file Device Fast!UTIL Flash Bios FlashGPort HBA alias LUN masking MediaNPort Node Port NPort ID Virtualization Network adapter PathPoint-to-point Port Bios IndexMAC ARP C4-22,5-5cache 41,5-936,5-29 Ch4-12,5-5 30,5-25 14,5-2628,5-27 31,5-28 TCP Tcpdchp DhcpHBA Chap Dr4-33,5-8driverCore 4-17,5-11firmware core 4-16firmware Flash 4-15NVRAM Dumpnvram 4-15, 5-11-dv 26,A-2 26,5-20,A-2,C-225,4-26,5-20,A-2 Version 4-12,4-48,5-14version, HBA Ldrouterauto A-8 Routableauto A-8 G4-9,5-13 H4-49,5-13 12,5-24 48,4-4948,5-14 12,4-48,4-49,5-14 Iocb Address 4-26,4-49,5-20,A-3,C-3HBA port25,A-4 26,A-4 IPv6 SourceAddFlg, target C-3TCP settings Alias 4-24,4-26,A-6 Suse LIP 21,A-8 5-149,5-14 N4-18,4-24,5-19 Nh4-24,5-23 NvramPa4-40,5-23 Glossary-6 PPC ID, LUNR2T IP ARP 35,5-29 ScsiC-5 12,4-49,5-14 Snack ISCSI 4-24,5-20,A-7target iSCSI I/O C-5Stat4-32,5-30-stathba5-30statistics T4-37,5-30 Index-18 SN0054621-00 E Dhcp A-8 TCPTcpdhcp TCP 4-27,5-20,A-5,A-8time to live, IPv4 4-25,A-4timeouts 25,4-27,A-7,C-325,C-2 25,C-4 Vlan SN0054621-00 E Index-21 Camberley Surrey, GU16 7ER UK +44 0 1276 804