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
Introduction
How This Guide is Organized
 Typographic Conventions
 Related Documents
Related Documents
Part Number Title Or Name
 Supported Operating Systems
Supported QLogic HBAs
Supported HBAs
Ports Media
 Technical Support
License Agreements
Availability
Training
 Introduction Technical Support SN0054621-00 E
 Installing SANsurfer iSCSI HBA CLI
Installation and Removal
Downloading 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 Windows
To 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 Installation
Quiet or Unattended Windows Installation
Passive Windows Installation
 Installing on Solaris SPARC/Solaris
Installing on Red Hat/SUSE Linux/PPC
Overwrite Previous Windows Installations
Solaris Attended Installation
 To install silently on Solaris
Solaris Silent Installation
Create the noaskpkgadd.txt file with contents
Create the following two files
 Start Menu Uninstall
Microsoft Windows Uninstall
Control Panel Uninstall
Command Line Uninstall
 Solaris SPARC/Solaris x86 Uninstall
Red Hat/SUSE Linux/PPC Uninstall
To uninstall quietly from the command line
Page
 Getting Started
Starting Interactive Mode
Introduction
 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 Information
To choose an HBA
 Display General System Information
Save Host Configuration
Import HBA Menu, Multiple Adapters
CLI Option -g
 To import a single HBA configuration
Import HBA Configuration
Select a configuration import option, and then press Enter
Select from the following parameter sets to import
 Install HBA Driver, All Adapters
Update Firmware, Multiple Adapters
Select HBA Port
CLI Option -d
 HBA Information
HBA Level Info & Operations Menu
CLI Option -ch
 Update Firmware Image
Update BIOS/UEFI or FCode Code Image
HBA Options Menu
No CLI Option
 Update ROM Image
HBA Reset
 HBA Diagnostic Menu provides the following options
HBA Diagnostic Menu
Retrieve FW Crash Record
Retrieve FW Flash & Nvram Record
 Display HBA Level Statistics
Retrieve FW Coredump Record
 Display HBA Level Parameters
HBA Level Parameters Menu
To make changes to the HBA level parameters
 Save Changes and Reset HBA
Configure HBA Level Parameters
Display VPD Information
CLI Option -vpd
 Display Active Link Configuration
Port Link Settings Menu
Port Level Info & Operations Menu
 Display Configured Link Configuration
Port Network Settings Menu
Configure Link Configuration
Save Changes and Reset HBA if necessary
 ISNS Settings
Configure IP Settings
 Display Configured Port Settings
Edit Configured Port Settings Menu
To 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 Setting
To 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 Defaults
Legacy QLA4010 Restore Default Port Settings
This option is not supported in the QLA4010 HBA
 Port Diagnostic Menu contains the following options
Port Diagnostic Menu
To use port diagnostics
 To ping a target
Ping Target
Here 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 Test
To start a loopback test
To start a read/write buffer test
 Display Connection Error Log
Reset Statistics
Display Port Statistics
Display ARP Table
 Display Default Router List IPv6
Export Connection Error Log
Display 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 Information
Set Primary Boot Target Information
Set Secondary Boot Target Information
 Clear Secondary Boot Target Information
Clear Primary Boot Target Information
Target Level Info & Operations
Set Alternative Client ID
 Display Target Information CLI Option -t
List Targets
HBA CLI
 Interactive Mode Commands Port Level Info & Operations Menu
 Bind Target
Configure Target Parameters
Delete Target
 Enable a Target
Disable a Target
Configure 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 Chap
Edit a Chap Entry
To edit a Chap entry
 Save Target/CHAP Changes
Delete a Chap Entry
Target Discovery Menu
To delete an entry from the Chap table
 Display Discovered Targets
Display Send Targets
Add a Send Target
Mark Send Target for Re-discovery
 Display iSNS Settings
Login and Persist a Discovered Target
Configure iSNS
Remove a Send Target
 List LUN Information
 List All QLogic iSCSI HBA Ports Detected
 Select HBA Port
Help
Refresh
 Exit
 Non-Interactive Mode Commands
 Variable Definition
Non-interactive Command Variables
 HBA Reset
Non-interactive Commands
Acb
Addchap
 Bootcodemode
Bootcode
Update BIOS/UEFI or FCode Mode
Binfo
 For IBM cards, the following modes are available
HBA Information
 Csbootcode
Cpbootcode
Install HBA Driver, All Adapters
System reboot may be required see the log file for details
 Defbidi
Dce
Delchap
Display Destination Cache IPv6 only
 Display Default Router List IPv6 only
 Dtdsp
Dspchap
Dtdspa
Dtdupd
 Dtlia
Dtli
Dtrem
 Dumpcore
Dtrema
Dumpnvram
Edchap
 Update Firmware Image-All HBAs
Update Firmware Image-Specific HBA
Chap Parameters
Parameter Parameter Alias Value
 Display General System Information
Gcr
Help
 Port 0 on this HBA HBA Model Number
List All QLogic iSCSI HBA Ports Detected
 Import
 Ipdhcp
Configure iSNS Settings
Isns
 Isns6
 Lcd
 Linkchap
Configuration Name Configuration Alias Value
Model
HBA Parameters
 Afwdack
Afwdt
Iparp
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 following
To add persistent targets, enter the -pacommand as follows
To set only the local link address, enter the following
 Pad
Pbootcode
Pdt
Pet
 Following provides the IPv6 source address values
Ping
 Rdf
 Rdh
Port Restore Factory Defaults
 Save
Rwt
 Sbootcodecid
Sbootcode
Sreset
Sdmrc
 Stathba
Stat
Stdsp
Strd
 Display Program Version Information
Ver
 Display VPD Information
Vpd
 Port- and HBA-level Parameters
Table A-1. Port Settings
Port-level Parameters
Parameter Value Alias Description
 Iprr
Afwstm
EIPV4
EIPV6
 Zioe
 TOS
Enable
IPV4TOS
IPV4TTL
 IPV6NDRT
TCPV6ND
IPV6NDRET
IPV6STO
 IPV6TCPWS
TCPV6TS
IPV6TC
IPV6VLANEN
 When on, iSCSi headers with CRC protection
 Ldra
Ldrouterauto
Loclinkauto
Locla
 Winscale
Tmto
Vlan
Vlanid
 HBA-level Parameters
Table A-2. HBA Settings
 Table B-1. HBA Statistics
HBA Statistics
Statistic 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
Tgtiname
Tgtmb
TGEMOR2T
 Tgtwinscaleen
Tgttms
Tgtidd
Tgtlds
 Tgtis
Tgtisnack
Tgttcpn
 Target Parameters SN0054621-00 E
 Interactive Mode Error Codes
Error Codes
Table D-1. Interactive-Mode Error Code Descriptions
Return Name Description
 Coreerrnocount
Coreerrnospace
Coreerrhbainv
Coreerrnotgt
 Coreerrbootcodeenabled
Coreerrsetbootcode
Coreerrbootcodeinvalid
Coreerrbootcodemode
 Coreerrfailuretoinstall
Coreerrdriverupdatefailed
Coreerrsecuritydescriptor
Initializationfailed
 Table D-2. Non-interactive Mode Error Codes
Non-interactive Mode Error Codes
Command Error Codes
 Chapmap
 Coreerrunabletounzipdriverfile
Coreerrfailuretoinstalldrivers
Coreerrunabletogetinfofromdirverfile
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 Names
File Type
File Name Description
 Downloadable File Names SN0054621-00 E
 To use trace
Using Trace
Click Properties
 Trace Level
Trace Variables
Table F-1. Trace Parameters
Variable Character String
 Value Trace Level
Table F-2. Trace Level Commands
Table F-3. Some More Info About Trace Levels
Trace Output Value
 To continue, press Enter
Trace Data
Table F-4. Trace Data
Amount Data Level
 Glossary
 CSV file
CoS
Comma separated values CSV file
Device
 Fast!UTIL
 Flash
Flash Bios
GPort
HBA alias
 Media
LUN masking
NPort Node Port
NPort ID Virtualization
 Path
Network adapter
Point-to-point
Port
 Index
Bios
MAC
ARP
 41,5-9
C4-22,5-5cache
36,5-29
Ch4-12,5-5
 14,5-26
30,5-25
28,5-27
31,5-28
 TCP Tcpdchp
Dhcp
HBA
 Dr4-33,5-8driver
Chap
Core 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-2
25,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-24
48,5-14
12,4-48,4-49,5-14
 Address 4-26,4-49,5-20,A-3,C-3HBA port
Iocb
25,A-4
26,A-4
 Alias 4-24,4-26,A-6
IPv6 SourceAddFlg, target C-3TCP settings
 LIP
Suse
 5-1
21,A-8
49,5-14
N4-18,4-24,5-19
 Nvram
Nh4-24,5-23
Pa4-40,5-23
Glossary-6
 ID, LUN
PPC
R2T
IP ARP
 Scsi
35,5-29
C-5
12,4-49,5-14
 ISCSI 4-24,5-20,A-7target iSCSI I/O C-5
Snack
Stat4-32,5-30-stathba5-30statistics
T4-37,5-30
 Index-18 SN0054621-00 E
 Dhcp A-8
TCP
Tcpdhcp
 25,4-27,A-7,C-3
TCP 4-27,5-20,A-5,A-8time to live, IPv4 4-25,A-4timeouts
25,C-2
25,C-4
 SN0054621-00 E Index-21
Vlan
 Camberley Surrey, GU16 7ER UK +44 0 1276 804