Installation and Removal | Q-Logic SN0054621-00 E guide

2 Installation and Removal

This section provides procedures for the following:

“Installing SANsurfer iSCSI HBA CLI” on page 2-1

“Removing SANsurfer iSCSI HBA CLI” on page 2-12

Before you can run SANsurfer iSCSI HBA CLI, ensure that your system meets the following requirements:

HBAs are installed.

HBA drivers are installed.

To install SANsurfer iSCSI HBA CLI, the PC hard disk must have about 1 MB free space.

NOTE:

SANsurfer iSCSI HBA CLI is designed to configure QLogic HBAs on the local machine (where it is installed). It cannot configure HBAs on remote machines.

Installing SANsurfer iSCSI HBA CLI

This section on SANsurfer iSCSI 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-10

“Installing on Solaris SPARC/Solaris x86” on page 2-10

Downloading the Installation Package

Follow the procedure in this section to download the SANsurfer iSCSI HBA CLI installation package from the QLogic Web site.

To download the installation package:

1.From the QLogic home page (www.qlogic.com), click Downloads.

2.Select your HBA.

SN0054621-00 E

2-1

Image 19

Q-Logic SN0054621-00 E Installation and Removal, Installing SANsurfer iSCSI HBA CLI, Downloading the Installation Package

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 Ports Media Supported QLogic HBAsSupported Operating Systems Supported HBAs Training License AgreementsTechnical Support Availability Introduction Technical Support SN0054621-00 E To download the installation package Installation and RemovalInstalling SANsurfer iSCSI HBA CLI Downloading the Installation Package Where „ Microsoft Windows see Installing on Microsoft Windows on Installation and Removal Installing SANsurfer iSCSI HBA CLI Read the information, and then click Next Installing on Microsoft WindowsWindows Standard GUI Installation To install using the GUI installation 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 Passive Windows Installation Windows Command Line InstallationStandard Windows Interactive CLI Installation Quiet or Unattended Windows Installation Solaris Attended Installation Installing on Red Hat/SUSE Linux/PPCInstalling on Solaris SPARC/Solaris Overwrite Previous Windows Installations Create the following two files Solaris Silent InstallationTo install silently on Solaris Create the noaskpkgadd.txt file with contents Command Line Uninstall Microsoft Windows UninstallStart Menu Uninstall Control Panel 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 CLI Option -g Save Host ConfigurationDisplay General System Information Import HBA Menu, Multiple Adapters Select from the following parameter sets to import Import HBA ConfigurationTo import a single HBA configuration Select a configuration import option, and then press Enter CLI Option -d Update Firmware, Multiple AdaptersInstall HBA Driver, All Adapters Select HBA Port HBA Information HBA Level Info & Operations MenuCLI Option -ch No CLI Option Update BIOS/UEFI or FCode Code ImageUpdate Firmware Image HBA Options Menu Update ROM Image HBA Reset Retrieve FW Flash & Nvram Record HBA Diagnostic MenuHBA Diagnostic Menu provides the following options Retrieve FW Crash Record Display HBA Level Statistics Retrieve FW Coredump Record Display HBA Level Parameters HBA Level Parameters MenuTo make changes to the HBA level parameters CLI Option -vpd Configure HBA Level ParametersSave Changes and Reset HBA Display VPD Information Display Active Link Configuration Port Link Settings MenuPort Level Info & Operations Menu Save Changes and Reset HBA if necessary Port Network Settings MenuDisplay Configured Link Configuration Configure Link Configuration ISNS Settings Configure IP Settings Change Port Iscsi Alias Name Edit Configured Port Settings MenuDisplay Configured Port Settings To edit the configured HBA settings To make changes to the HBA firmware settings Port Firmware Settings Menu At the following prompt, type the new value Edit a Specific Port SettingConfigure iSCSI Settings To edit specific HBA settings Configure Device Settings Configure Firmware Settings „ Ldrouterauto „ Loclinkauto „ Routableauto Configure Basic SettingsConfigure Advanced Settings „ TaskManagementTimeout „ ZIO Configure IPv6 Settings„ Vlanid „ VLANUserPriority This option is not supported in the QLA4010 HBA Port Restore Factory DefaultsConfigure IPv6 TCP Settings Legacy QLA4010 Restore Default Port Settings Port Diagnostic Menu contains the following options Port Diagnostic MenuTo use port diagnostics Here is an example of a ping on an IPv6 network Ping TargetTo ping a target Here is an example of a successful ping attempt To start a read/write buffer test Perform Loopback TestPerform Read/Write Buffer Test To start a loopback test Display ARP Table Reset StatisticsDisplay Connection Error Log Display Port Statistics Display Destination Cache IPv6 Export Connection Error LogDisplay Default Router List IPv6 Display Neighbor Cache IPv6 To edit the HBA BIOS/UEFI or FCode settings BIOS/UEFI or FCode Settings Menu Set Secondary Boot Target Information Display BIOS/UEFI or FCode InformationSet BIOS/UEFI or FCode Mode Set Primary Boot Target Information Set Alternative Client ID Clear Primary Boot Target InformationClear Secondary Boot Target Information Target Level Info & Operations Display Target Information CLI Option -t List TargetsHBA CLI Interactive Mode Commands Port Level Info & Operations Menu Bind Target Configure Target ParametersDelete Target To configure target authentication Chap Disable a TargetEnable a Target Configure Target Authentication Menu Display Chap Table Display Targets Using Chap Entries To assign a Chap entry to a target Assign a Chap Entry to a TargetAdd a Chap Entry „ Name Chap name „ Secret Chap secret To edit a Chap entry Add a Default Bidi ChapTo add a default Bidi Chap Edit a Chap Entry To delete an entry from the Chap table Delete a Chap EntrySave Target/CHAP Changes Target Discovery Menu Mark Send Target for Re-discovery Display Send TargetsDisplay Discovered Targets Add a Send Target Remove a Send Target Login and Persist a Discovered TargetDisplay iSNS Settings Configure iSNS 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 Addchap Non-interactive CommandsHBA Reset Acb Binfo BootcodeBootcodemode Update BIOS/UEFI or FCode Mode For IBM cards, the following modes are available HBA Information System reboot may be required see the log file for details CpbootcodeCsbootcode Install HBA Driver, All Adapters Display Destination Cache IPv6 only DceDefbidi Delchap Display Default Router List IPv6 only Dtdupd DspchapDtdsp Dtdspa Dtlia DtliDtrem Edchap DtremaDumpcore Dumpnvram Parameter Parameter Alias Value Update Firmware Image-Specific HBAUpdate Firmware Image-All HBAs Chap Parameters 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 HBA Parameters Configuration Name Configuration Alias ValueLinkchap Model Ipad AfwdtAfwdack Iparp Display Neighbor Cache Netconf Netconf6 Where option includes the following To set only the local link address, enter the following To disable the IPv4 network, enter the followingTo disables the IPv4 and IPv6 networks To add persistent targets, enter the -pacommand as follows Pet PbootcodePad Pdt Following provides the IPv6 source address values Ping Rdf Rdh Port Restore Factory Defaults Save Rwt Sdmrc SbootcodeSbootcodecid Sreset Strd StatStathba Stdsp Display Program Version Information Ver Display VPD Information Vpd Parameter Value Alias Description Table A-1. Port SettingsPort- and HBA-level Parameters Port-level Parameters EIPV6 AfwstmIprr EIPV4 Zioe IPV4TTL EnableTOS IPV4TOS IPV6STO TCPV6NDIPV6NDRT IPV6NDRET IPV6VLANEN TCPV6TSIPV6TCPWS IPV6TC When on, iSCSi headers with CRC protection Locla LdrouterautoLdra Loclinkauto Vlanid TmtoWinscale Vlan 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 TGEMOR2T TgtinameTgtkato Tgtmb Tgtlds TgttmsTgtwinscaleen Tgtidd Tgtis TgtisnackTgttcpn Target Parameters SN0054621-00 E Return Name Description Error CodesInteractive Mode Error Codes Table D-1. Interactive-Mode Error Code Descriptions Coreerrnotgt CoreerrnospaceCoreerrnocount Coreerrhbainv Coreerrbootcodemode CoreerrsetbootcodeCoreerrbootcodeenabled Coreerrbootcodeinvalid Initializationfailed CoreerrdriverupdatefailedCoreerrfailuretoinstall Coreerrsecuritydescriptor Table D-2. Non-interactive Mode Error Codes Non-interactive Mode Error CodesCommand Error Codes Chapmap Coreerrsecuritydescriptorinitializationfailed CoreerrfailuretoinstalldriversCoreerrunabletounzipdriverfile Coreerrunabletogetinfofromdirverfile Gcr Corestatusbad Isns6 Netconf Pbootcode Stat Coreerrinvalidcfgparameter Ver Vpd Error Codes Non-interactive Mode Error Codes SN0054621-00 E File Name Description Downloadable File NamesTable E-1. File Names File Type Downloadable File Names SN0054621-00 E To use trace Using TraceClick Properties Variable Character String Trace VariablesTrace Level Table F-1. Trace Parameters Trace Output Value Table F-2. Trace Level CommandsValue Trace Level Table F-3. Some More Info About Trace Levels Amount Data Level Trace DataTo continue, press Enter Table F-4. Trace Data Glossary Device CoSCSV file Comma separated values CSV file Fast!UTIL HBA alias Flash BiosFlash GPort NPort ID Virtualization LUN maskingMedia NPort Node Port Port Network adapterPath Point-to-point ARP BiosIndex MAC Ch4-12,5-5 C4-22,5-5cache41,5-9 36,5-29 31,5-28 30,5-2514,5-26 28,5-27 TCP Tcpdchp DhcpHBA Dumpnvram 4-15, 5-11-dv ChapDr4-33,5-8driver Core 4-17,5-11firmware core 4-16firmware Flash 4-15NVRAM Version 4-12,4-48,5-14version, HBA 26,A-226,5-20,A-2,C-2 25,4-26,5-20,A-2 Routableauto A-8 Ldrouterauto A-8 H4-49,5-13 G4-9,5-13 12,4-48,4-49,5-14 12,5-2448,4-49 48,5-14 26,A-4 IocbAddress 4-26,4-49,5-20,A-3,C-3HBA port 25,A-4 Alias 4-24,4-26,A-6 IPv6 SourceAddFlg, target C-3TCP settings LIP Suse N4-18,4-24,5-19 21,A-85-1 49,5-14 Glossary-6 Nh4-24,5-23Nvram Pa4-40,5-23 IP ARP PPCID, LUN R2T 12,4-49,5-14 35,5-29Scsi C-5 T4-37,5-30 SnackISCSI 4-24,5-20,A-7target iSCSI I/O C-5 Stat4-32,5-30-stathba5-30statistics Index-18 SN0054621-00 E Dhcp A-8 TCPTcpdhcp 25,C-4 TCP 4-27,5-20,A-5,A-8time to live, IPv4 4-25,A-4timeouts25,4-27,A-7,C-3 25,C-2 SN0054621-00 E Index-21 Vlan Camberley Surrey, GU16 7ER UK +44 0 1276 804