Manuals / Q-Logic / Computer Equipment / Network Card

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

Models: SN0054621-00 E

1 184

Download 184 pages 45.53 Kb

Page 1

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 HistorySN0054621-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 ParametersTrace Variables Trace Level Trace Data Glossary IndexList 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 MediaTechnical Support License AgreementsAvailability TrainingIntroduction Technical Support SN0054621-00 E Installing SANsurfer iSCSI HBA CLI Installation and RemovalDownloading the Installation Package To download the installation packageWhere „ Microsoft Windows see Installing on Microsoft Windows onInstallation 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 NextSelect Which Users window appears, as shown in Figure Install Wizard Select Which UsersTo begin installation, click Install Install Wizard Ready to InstallInstall Wizard Installing SANsurferiCLI Click Finish Restart your computer Install Wizard CompleteStandard Windows Interactive CLI Installation Windows Command Line InstallationQuiet or Unattended Windows Installation Passive Windows InstallationInstalling on Solaris SPARC/Solaris Installing on Red Hat/SUSE Linux/PPCOverwrite Previous Windows Installations Solaris Attended InstallationTo install silently on Solaris Solaris Silent InstallationCreate the noaskpkgadd.txt file with contents Create the following two filesStart Menu Uninstall Microsoft Windows UninstallControl Panel Uninstall Command Line UninstallSolaris 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 ModeInteractive Mode Commands Level Command Line Interface MenuPort 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 -gTo import a single HBA configuration Import HBA ConfigurationSelect a configuration import option, and then press Enter Select from the following parameter sets to importInstall HBA Driver, All Adapters Update Firmware, Multiple AdaptersSelect HBA Port CLI Option -dHBA Information HBA Level Info & Operations MenuCLI Option -ch Update Firmware Image Update BIOS/UEFI or FCode Code ImageHBA Options Menu No CLI OptionUpdate ROM Image HBA ResetHBA Diagnostic Menu provides the following options HBA Diagnostic MenuRetrieve FW Crash Record Retrieve FW Flash & Nvram RecordDisplay HBA Level Statistics Retrieve FW Coredump RecordDisplay 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 -vpdDisplay 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 necessaryISNS Settings Configure IP SettingsDisplay Configured Port Settings Edit Configured Port Settings MenuTo edit the configured HBA settings Change Port Iscsi Alias NameTo make changes to the HBA firmware settings Port Firmware Settings MenuConfigure iSCSI Settings Edit a Specific Port SettingTo edit specific HBA settings At the following prompt, type the new valueConfigure Device Settings Configure Firmware SettingsConfigure Advanced Settings Configure Basic Settings„ TaskManagementTimeout „ Ldrouterauto „ Loclinkauto „ Routableauto„ Vlanid Configure IPv6 Settings„ VLANUserPriority „ ZIOConfigure IPv6 TCP Settings Port Restore Factory DefaultsLegacy QLA4010 Restore Default Port Settings This option is not supported in the QLA4010 HBAPort 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 networkPerform Read/Write Buffer Test Perform Loopback TestTo start a loopback test To start a read/write buffer testDisplay Connection Error Log Reset StatisticsDisplay Port Statistics Display ARP TableDisplay Default Router List IPv6 Export Connection Error LogDisplay Neighbor Cache IPv6 Display Destination Cache IPv6To edit the HBA BIOS/UEFI or FCode settings BIOS/UEFI or FCode Settings MenuSet BIOS/UEFI or FCode Mode Display BIOS/UEFI or FCode InformationSet Primary Boot Target Information Set Secondary Boot Target InformationClear Secondary Boot Target Information Clear Primary Boot Target InformationTarget Level Info & Operations Set Alternative Client IDDisplay 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 ChapDisplay Chap Table Display Targets Using Chap EntriesAdd a Chap Entry Assign a Chap Entry to a Target„ Name Chap name „ Secret Chap secret To assign a Chap entry to a targetTo add a default Bidi Chap Add a Default Bidi ChapEdit a Chap Entry To edit a Chap entrySave Target/CHAP Changes Delete a Chap EntryTarget Discovery Menu To delete an entry from the Chap tableDisplay Discovered Targets Display Send TargetsAdd a Send Target Mark Send Target for Re-discoveryDisplay iSNS Settings Login and Persist a Discovered TargetConfigure iSNS Remove a Send TargetList LUN Information List All QLogic iSCSI HBA Ports Detected Select HBA Port HelpRefresh Exit Non-Interactive Mode Commands Variable Definition Non-interactive Command VariablesHBA Reset Non-interactive CommandsAcb AddchapBootcodemode BootcodeUpdate BIOS/UEFI or FCode Mode BinfoFor IBM cards, the following modes are available HBA InformationCsbootcode CpbootcodeInstall HBA Driver, All Adapters System reboot may be required see the log file for detailsDefbidi DceDelchap Display Destination Cache IPv6 onlyDisplay Default Router List IPv6 only Dtdsp DspchapDtdspa DtdupdDtlia DtliDtrem Dumpcore DtremaDumpnvram EdchapUpdate Firmware Image-All HBAs Update Firmware Image-Specific HBAChap Parameters Parameter Parameter Alias ValueDisplay General System Information GcrHelp Port 0 on this HBA HBA Model Number List All QLogic iSCSI HBA Ports DetectedImport Ipdhcp Configure iSNS SettingsIsns Isns6 Lcd Linkchap Configuration Name Configuration Alias ValueModel HBA ParametersAfwdack AfwdtIparp IpadDisplay Neighbor Cache NetconfNetconf6 Where option includes the followingTo 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 followingPad PbootcodePdt PetFollowing provides the IPv6 source address values PingRdf Rdh Port Restore Factory DefaultsSave RwtSbootcodecid SbootcodeSreset SdmrcStathba StatStdsp StrdDisplay Program Version Information VerDisplay VPD Information VpdPort- and HBA-level Parameters Table A-1. Port SettingsPort-level Parameters Parameter Value Alias DescriptionIprr AfwstmEIPV4 EIPV6Zioe TOS EnableIPV4TOS IPV4TTLIPV6NDRT TCPV6NDIPV6NDRET IPV6STOIPV6TCPWS TCPV6TSIPV6TC IPV6VLANENWhen on, iSCSi headers with CRC protection Ldra LdrouterautoLoclinkauto LoclaWinscale TmtoVlan VlanidHBA-level Parameters Table A-2. HBA SettingsTable 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 ParametersTgtkato TgtinameTgtmb TGEMOR2TTgtwinscaleen TgttmsTgtidd TgtldsTgtis TgtisnackTgttcpn Target Parameters SN0054621-00 E Interactive Mode Error Codes Error CodesTable D-1. Interactive-Mode Error Code Descriptions Return Name DescriptionCoreerrnocount CoreerrnospaceCoreerrhbainv CoreerrnotgtCoreerrbootcodeenabled CoreerrsetbootcodeCoreerrbootcodeinvalid CoreerrbootcodemodeCoreerrfailuretoinstall CoreerrdriverupdatefailedCoreerrsecuritydescriptor InitializationfailedTable D-2. Non-interactive Mode Error Codes Non-interactive Mode Error CodesCommand Error Codes Chapmap Coreerrunabletounzipdriverfile CoreerrfailuretoinstalldriversCoreerrunabletogetinfofromdirverfile CoreerrsecuritydescriptorinitializationfailedGcr Corestatusbad Isns6Netconf Pbootcode Stat CoreerrinvalidcfgparameterVer Vpd Error Codes Non-interactive Mode Error Codes SN0054621-00 E Table E-1. File Names Downloadable File NamesFile Type File Name DescriptionDownloadable File Names SN0054621-00 E To use trace Using TraceClick Properties Trace Level Trace VariablesTable F-1. Trace Parameters Variable Character StringValue Trace Level Table F-2. Trace Level CommandsTable F-3. Some More Info About Trace Levels Trace Output ValueTo continue, press Enter Trace DataTable F-4. Trace Data Amount Data LevelGlossary CSV file CoSComma separated values CSV file DeviceFast!UTIL Flash Flash BiosGPort HBA aliasMedia LUN maskingNPort Node Port NPort ID VirtualizationPath Network adapterPoint-to-point PortIndex BiosMAC ARP41,5-9 C4-22,5-5cache36,5-29 Ch4-12,5-514,5-26 30,5-2528,5-27 31,5-28TCP Tcpdchp DhcpHBA Dr4-33,5-8driver ChapCore 4-17,5-11firmware core 4-16firmware Flash 4-15NVRAM Dumpnvram 4-15, 5-11-dv26,5-20,A-2,C-2 26,A-225,4-26,5-20,A-2 Version 4-12,4-48,5-14version, HBARoutableauto A-8 Ldrouterauto A-8H4-49,5-13 G4-9,5-1348,4-49 12,5-2448,5-14 12,4-48,4-49,5-14Address 4-26,4-49,5-20,A-3,C-3HBA port Iocb25,A-4 26,A-4Alias 4-24,4-26,A-6 IPv6 SourceAddFlg, target C-3TCP settingsLIP Suse5-1 21,A-849,5-14 N4-18,4-24,5-19Nvram Nh4-24,5-23Pa4-40,5-23 Glossary-6ID, LUN PPCR2T IP ARPScsi 35,5-29C-5 12,4-49,5-14ISCSI 4-24,5-20,A-7target iSCSI I/O C-5 SnackStat4-32,5-30-stathba5-30statistics T4-37,5-30Index-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-4SN0054621-00 E Index-21 VlanCamberley Surrey, GU16 7ER UK +44 0 1276 804