Qlogic SANsurfer iSCSI HBA CLI User manual

SN0054621-00 E
SANsurfer iSCSI HBA CLI
User’s Guide
Command Line Interface for
QLogic iSCSI Host Bus Adapters

Page ii SN0054621-00 E
S
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters
Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no
responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its
use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications
described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no
representation nor warranty that such applications are suitable for the specified use without further testing or
modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document.
Document Revision History
Revision A, September 30, 2005
Revision B, November 10, 2005
Revision C, July 14, 2006
Revision D, May 7, 2007
Revision E, October 17, 2008
Changes Sections Affected
Revision E Changes:
Applied new user’s guide template. All
Updated guide title and subtitle. Title page, page headers
Enhanced and edited all content, including index. All
Removed all references to obsolete features
related to DNS and SLP.
All
Expanded Introduction chapter to include new
information.
Intended Audience, How This Guide is Organized
(Typographic Conventions, Related Documents),
License Agreements
Added supported operating systems Windows
Server 2008 and Windows PE.
“Supported Operating Systems” on page 1-4
Removed obsolete Linux attended installation sec-
tion.
“Installing on Red Hat/SUSE Linux/PPC” on
page 2-10
Removed Table 2-1. “Starting Non-interactive Mode” on page 3-2
Updated map of interactive menus and options. Table 4-1 on page 4-2
Added new firmware update option to Host Level
Info & Operations menu.
“Update Firmware, Multiple Adapters” on
page 4-11
Added new Port Link Settings Menu and menu
items.
“Port Link Settings Menu” on page 4-19
Updated Display Network Settings example. Display Network Settings (CLI Options -netconf)

SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters
SN0054621-00 E Page iii
S
Updated (added and removed parameters) the list
of device settings.
“Configure Device Settings” on page 4-25
Updated (added and removed parameters) the list
of basic settings.
“Configure Basic Settings” on page 4-26
Updated (added and removed parameters) the list
of advanced settings.
“Configure Advanced Settings” on page 4-26
Changed Bootcode Settings Menu to new
BIOS/UEFI (or FCode) Settings Menu.
“BIOS/UEFI [or FCode] Settings Menu” on
page 4-34
Removed Unbind Target option from Target
Level Info & Operations menu.
“Target Level Info & Operations” on page 4-36
Added more detail for Display Target Information
option.
“Display Target Information (CLI Option -t)” on
page 4-37
Added new Target Discovery Menu and its
options.
“Target Discovery Menu” on page 4-44
Removed subheadings referencing non-existent
interactive mode commands.
5 Non-Interactive Mode Commands
Added new miscellaneous command line options. “-acb” on page 5-3, “-dce” on page 5-7, “-dp” on
page 5-8,
Added new discovered target command line
options.
“-dtdsp (Display Discovered Targets)” on page 5-9
through “-dtrema (Remove Discovered Target)” on
page 5-11
Added new link configuration command line
options.
“-lc (Configure Link Configuration)” on page 5-18
and “-lcd (Display Configured Link Configuration)”
on page 5-18
Added other new target command line options. “-pad” on page 5-24, “-pdt” on page 5-24 and “-pet”
on page 5-24
Added unbind persistent target command line
options.
“-pu” on page 5-25 and “-px” on page 5-26
Added new send target and statistics command
line options.
“-stadd” on page 5-29 through “-strema” on
page 5-30
Added new port and HBA configuration parame-
ters (each in a separate table).
Added missing descriptions for parameters.
Deleted obsolete parameters.
Appendix A Port- and HBA-level Parameters

Page iv SN0054621-00 E
S
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters
Added missing descriptions for IPv4TOS and
IPv4TTL parameters.
Deleted obsolete Primary_DNS and SLP_Address
parameters.
Appendix C Target Parameters
Moved trace information from 5 Non-Interactive
Mode Commands to a new appendix.
Appendix F Using Trace

SN0054621-00 E Page v
Table of Contents
1 Introduction
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
How This Guide is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Related Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Supported QLogic HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
2 Installation and Removal
Installing SANsurfer iSCSI HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Downloading the Installation Package. . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Installing on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Windows Standard (GUI) Installation . . . . . . . . . . . . . . . . . . . . . 2-4
Windows Command Line Installation . . . . . . . . . . . . . . . . . . . . . 2-9
Installing on Red Hat/SUSE Linux/PPC . . . . . . . . . . . . . . . . . . . . . . . 2-10
Installing on Solaris SPARC/Solaris x86 . . . . . . . . . . . . . . . . . . . . . . . 2-10
Solaris Attended Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Solaris Silent Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
Removing SANsurfer iSCSI HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Microsoft Windows Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Start Menu Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Control Panel Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Command Line Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
Red Hat/SUSE Linux/PPC Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Solaris SPARC/Solaris x86 Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . 2-13

Page vi SN0054621-00 E
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters S
3 Getting Started
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Starting Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Starting Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
4 Interactive Mode Commands
Display Program Version Information (CLI Option -ver) . . . . . . . . . . . . . . . . 4-8
Host Level Info & Operations Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Display General System Information (CLI Option -g) . . . . . . . . . . . . . 4-9
Import HBA Menu, Multiple Adapters (CLI Options -import and
-save) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Save Host Configuration (CLI Option -save) . . . . . . . . . . . . . . . 4-9
Import HBA Configuration (CLI Option -import) . . . . . . . . . . . . . 4-10
Update Firmware, Multiple Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Install HBA Driver, All Adapters (CLI Option -d) . . . . . . . . . . . . . . . . . 4-11
Select HBA Port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
HBA Level Info & Operations Menu (CLI Option -i) . . . . . . . . . . . . . . . . . . . 4-12
HBA Information (CLI Option -ch) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
HBA Options Menu (No CLI Option) . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Update BIOS/UEFI [or FCode] Code Image (CLI Option
-bootcode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
Update Firmware Image (CLI Option -f) . . . . . . . . . . . . . . . . . . . 4-13
Update ROM Image (CLI Option -r) . . . . . . . . . . . . . . . . . . . . . . 4-14
HBA Reset (CLI Option -b) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
HBA Diagnostic Menu (No CLI Option) . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Retrieve FW Crash Record (CLI Option -gcr). . . . . . . . . . . . . . . 4-15
Retrieve FW Flash & NVRAM Record (CLI Option
-dumpnvram) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Retrieve FW Coredump Record (CLI Option -dumpcore). . . . . . 4-16
Display HBA Level Statistics (CLI Option -stathba) . . . . . . . . . . 4-16
HBA Level Parameters Menu (No CLI Option) . . . . . . . . . . . . . . . . . . 4-17
Display HBA Level Parameters (CLI Option -i). . . . . . . . . . . . . . 4-17
Configure HBA Level Parameters (CLI Option -n) . . . . . . . . . . . 4-18
Save Changes and Reset HBA . . . . . . . . . . . . . . . . . . . . . . . . . 4-18
Display VPD Information (CLI Option -vpd). . . . . . . . . . . . . . . . . . . . . 4-18
Port Level Info & Operations Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
Port Link Settings Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
Display Active Link Configuration . . . . . . . . . . . . . . . . . . . . . . . . 4-19
Display Configured Link Configuration (CLI Option -lcd) . . . . . . 4-20

SN0054621-00 E Page vii
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters
A
Configure Link Configuration (CLI Option -lc). . . . . . . . . . . . . . . 4-20
Save Changes and Reset HBA (if necessary) . . . . . . . . . . . . . . 4-20
Port Network Settings Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20
Display Network Settings (CLI Options -netconf) . . . . . . . . . . . . 4-20
Configure IP Settings (CLI Option -ipdhcp) . . . . . . . . . . . . . . . . 4-21
iSNS Settings (CLI Option -isns) . . . . . . . . . . . . . . . . . . . . . . . . 4-21
Edit Configured Port Settings Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22
Display Configured Port Settings (CLI Option -c) . . . . . . . . . . . . 4-22
Change Port ISCSI Alias Name (No CLI Option) . . . . . . . . . . . . 4-22
Port Firmware Settings Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
Legacy QLA4010 Restore Default Port Settings . . . . . . . . . . . . 4-28
Port Restore Factory Defaults (CLI Option -rdh) . . . . . . . . . . . . . . . . . 4-28
Port Diagnostic Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
Ping Target (CLI Option -ping) . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30
Perform Loopback Test (CLI Option -lb) . . . . . . . . . . . . . . . . . . . 4-31
Perform Read/Write Buffer Test (CLI Option -rwt) . . . . . . . . . . . 4-31
Display Port Statistics (CLI Option -stat). . . . . . . . . . . . . . . . . . . 4-32
Reset Statistics (CLI Option -sreset). . . . . . . . . . . . . . . . . . . . . . 4-32
Display ARP Table (CLI Option -arp) . . . . . . . . . . . . . . . . . . . . . 4-32
Display Connection Error Log. . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
Export Connection Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33
Display Neighbor Cache (IPv6) (CLI Option -nc) . . . . . . . . . . . . 4-33
Display Destination Cache (IPv6) (CLI Option -dc) . . . . . . . . . . 4-33
Display Default Router List (IPv6) (CLI Option -dr). . . . . . . . . . . 4-33
Display Local Prefix List (IPv6) (CLI Option -lp) . . . . . . . . . . . . . 4-33
BIOS/UEFI [or FCode] Settings Menu. . . . . . . . . . . . . . . . . . . . . . . . . 4-34
Display BIOS/UEFI [or FCode] Information (CLI Option
-binfo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
Set BIOS/UEFI [or FCode] Mode (CLI Option
-bootcodemode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
Set Primary Boot Target Information (CLI Option
-pbootcode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
Set Secondary Boot Target Information (CLI Option
-sbootcode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35
Clear Primary Boot Target Information (CLI Option
-cpbootcode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36
Clear Secondary Boot Target Information (CLI Option
-csbootcode). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36
Set Alternative Client ID (CLI Option -sbootcodecid) . . . . . . . . . 4-36

Page viii SN0054621-00 E
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters S
Target Level Info & Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36
List Targets (CLI Option -t) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
Display Target Information (CLI Option -t) . . . . . . . . . . . . . . . . . 4-37
Bind Target (CLI Option -pb). . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
Delete Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
Configure Target Parameters (CLI Option -tc) . . . . . . . . . . . . . . 4-39
Add a Target (CLI Option -pa). . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
Disable a Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
Enable a Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
Configure Target Authentication Menu . . . . . . . . . . . . . . . . . . . . 4-40
Target Discovery Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
List LUN Information (CLI Option -l) . . . . . . . . . . . . . . . . . . . . . . 4-47
Save Target/CHAP Changes (No CLI Option) . . . . . . . . . . . . . . 4-47
List All QLogic iSCSI HBA Ports Detected (CLI Option -i) . . . . . . . . . . . . . . 4-48
Help (CLI Option -h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
Select HBA Port (No CLI Option) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
Refresh (No CLI Option). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
Exit (No CLI Option) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50
5 Non-interactive Mode Commands
Non-interactive Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
-acb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
-addchap (Add a CHAP Entry) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
-arp (Display ARP Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
-b (HBA Reset) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
-binfo (Display BIOS/UEFI [or FCode] Information). . . . . . . . . . . . . . . 5-4
-bootcode (Update BIOS/UEFI [or FCode] Mode). . . . . . . . . . . . . . . . 5-4
-bootcodemode (Set BIOS/UEFI [or FCode] Mode) . . . . . . . . . . . . . . 5-4
-c (Display Configured Port Settings) . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
-ch (HBA Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
-chapmap (Display Targets Using CHAP Entries) . . . . . . . . . . . . . . . . 5-6
-cpbootcode (Clear Primary Boot Target Information) . . . . . . . . . . . . . 5-6
-csbootcode (Clear Secondary Boot Target Information) . . . . . . . . . . 5-6
-d (Install HBA Driver, All Adapters) . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
-dc (Display Destination Cache [IPv6 only]) . . . . . . . . . . . . . . . . . . . . 5-7
-dce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
-defbidi (Add a Default BIDI CHAP). . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
-delchap (Delete a CHAP Entry) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
-df . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
-dp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

SN0054621-00 E Page ix
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters
A
-dr (Display Default Router List [IPv6 only]) . . . . . . . . . . . . . . . . . . . . 5-8
-dspchap (Display a CHAP Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
-dtdsp (Display Discovered Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
-dtdspa (List Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
-dtdupd (Duplicate a Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . 5-9
-dtdupd (Duplicate a Persistent Target) . . . . . . . . . . . . . . . . . . . . . . . . 5-10
-dtli (Login and Persist a Discovered Target). . . . . . . . . . . . . . . . . . . . 5-10
-dtlia (Login and Persist a Discovered Target). . . . . . . . . . . . . . . . . . . 5-10
-dtrem (Remove Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
-dtrema (Remove Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
-dumpcore (Retrieve FW Coredump Record) . . . . . . . . . . . . . . . . . . . 5-11
-dumpnvram (Retrieve FW Flash & NVRAM Record) . . . . . . . . . . . . . 5-11
-dv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
-edchap (Edit a CHAP Entry). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11
-ei) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
-f (Update Firmware Image—Specific HBA) . . . . . . . . . . . . . . . . . . . . 5-12
-fa (Update Firmware Image—All HBAs). . . . . . . . . . . . . . . . . . . . . . . 5-12
-g (Display General System Information) . . . . . . . . . . . . . . . . . . . . . . 5-13
-gcr (Retrieve FW Crash Record) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
-h (Help). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
-i (List All QLogic iSCSI HBA Ports Detected). . . . . . . . . . . . . . . . . . . 5-14
-import (Import HBA Configuration). . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15
-ipdhcp (Configure IP Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16
-isns (Configure iSNS Settings). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16
-isns6 (iSNS Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
-l (List LUN Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
-lb (Perform Loopback Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
-lc (Configure Link Configuration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18
-lcd (Display Configured Link Configuration). . . . . . . . . . . . . . . . . . . . 5-18
-linkchap (Assign a CHAP Entry to a Target). . . . . . . . . . . . . . . . . . . . 5-19
-lp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
-model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
-n (Configure iSCSI Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
-nc (Display Neighbor Cache) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
-netconf (Configure IPv6 Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
-netconf6 (Configure IPv6 Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22
-nh (Configure iSCSI Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23
-pa (Add a Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23
-pad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24

Page x SN0054621-00 E
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters S
-pb (Bind Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
-pbootcode (Set Primary Boot Target Information) . . . . . . . . . . . . . . . 5-24
-pdt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
-pet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
-pinfo (Port Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24
-ping (Ping Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
-ps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
-pu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25
-px . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26
-r (Update ROM Image). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26
-rdf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26
-rdh (Port Restore Factory Defaults) . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
-rwt (Perform Read/Write Buffer Test) . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
-save (Save Host Configuration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
-sbootcode (Set Secondary Boot Target Information) . . . . . . . . . . . . . 5-29
-sbootcodecid (Set Alternative Client ID). . . . . . . . . . . . . . . . . . . . . . . 5-29
-sdmrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
-sreset (Reset Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
-stadd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
-stat (Display Port Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
-stathba . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
-stdsp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
-strd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
-strem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
-strema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
-t (Display Target Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30
-tc (Configure Target Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
-tp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
-ts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31
-ver (Display Program Version Information) . . . . . . . . . . . . . . . . . . . . 5-31
-vpd (Display VPD Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
-z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
A Port- and HBA-level Parameters
Port-level Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
HBA-level Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
B HBA Statistics
C Target Parameters

SN0054621-00 E Page xi
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters
A
D Error Codes
Interactive Mode Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
Non-interactive Mode Error Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-5
E Downloadable File Names
F Using Trace
Trace Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Trace Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Trace Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-4
Glossary
Index

Page xii SN0054621-00 E
SANsurfer iSCSI HBA CLI User’s Guide
Command Line Interface for QLogic iSCSI Host Bus Adapters S
List of Figures
Figure Page
2-1 Install Wizard: Welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
2-2 Install Wizard: Select Which Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
2-3 Install Wizard: Destination Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
2-4 Install Wizard: Ready to Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
2-5 Install Wizard: Installing SANsurferiCLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
2-6 Install Wizard: Complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
3-1 Windows iSCSI icon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
5-1 HBA Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
List of Tables
Table Page
1-1 Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
1-2 Supported HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
4-1 Command Line Interface Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
5-1 Non-interactive Command Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
5-2 CHAP Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
5-3 HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
A-1 Port Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
A-2 HBA Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
B-1 HBA Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
C-1 Target Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-2
D-1 Interactive-Mode Error Code Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1
D-2 Non-interactive Mode Error Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-5
E-1 File Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-1
F-1 Trace Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
F-2 Trace Level Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
F-3 Some More Info About Trace Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-3
F-4 Trace Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-4

SN0054621-00 E 1-1
1Introduction
The command line interface (CLI) application is a simplified, condensed version of
the SANsurfer iSCSI HBA Manager graphical user interface (GUI). SANsurfer
iSCSI HBA CLI does not provide any features that require a GUI.
This introductory chapter covers the following:
“Intended Audience” on page 1-1
“How This Guide is Organized” on page 1-1
“Supported QLogic HBAs” on page 1-4
“Supported Operating Systems” on page 1-4
“License Agreements” on page 1-5
“Technical Support” on page 1-5
Intended Audience
This guide is intended for end users responsible for administration of QLogic
iSCSI HBAs.
How This Guide is Organized
The SANsurfer iSCSI HBA CLI User’s Guide is organized into the following
chapters and appendices:
1 Introduction provides a general overview of the product, lists the supported
QLogic HBAs and operating systems, and provides contact information for
technical support.
2 Installation and Removal provides step-by-step instructions for installing
and uninstalling SANsurfer iSCSI HBA CLI on Windows, Linux, and Solaris.
3 Getting Started describes the two modes used in SANsurfer iSCSI HBA
CLI: interactive and non-interactive.
4 Interactive Mode Commands provides detailed explanations and
examples of the command line options used in the menu-driven interactive
mode.
5 Non-Interactive Mode Commands provides detailed explanations and
examples of the command line options used in non-interactive mode.

1 – Introduction
How This Guide is Organized
1-2 SN0054621-00 E
S
Appendix A Port- and HBA-level Parameters provides an alphabetic list of
the HBA port firmware parameters and their values.
Appendix B HBA Statistics provides an alphabetic list of the HBA statistics
shown when you select either the interactive mode Display HBA Statistics
option or the non-interactive mode -stat command.
Appendix C Target Parameters provides an alphabetic list of target
parameters, both fixed and configurable.
Appendix D Error Codes provides an alphabetic list of the error codes that
can occur while running SANsurfer iSCSI HBA CLI in both interactive mode
and non-interactive mode.
Appendix E Downloadable File Names lists, by file type and HBA, the typical
file names of downloadable files for QLogic iSCSI HBAs.
Appendix F Using Trace provides information for using trace to identify
application, HBA, and networking issues.
Following the appendices are a glossary of terms used and an index that will help
you quickly find the information you need.
Typographic Conventions
This guide uses the following typographic conventions:
Tex t i n bold font indicates a menu or menu item. For example:
From the HBA Import Menu, type the number for the Import option,
and then press ENTER.
Text in a sans serif font (Courier New) indicates CLI window text output.
For example:
Enter an IP Address:
Text in a bold sans serif font (Courier New) indicates user input (what you
type). For example:
Type yfor the Stop on error[Y]? option.
Tex t i n ALL CAPITALS and sans serif font indicates the name of a key that
you press on the keyboard. For example:
Type the number for Host Information and then press ENTER.
Italicized text indicates either a document reference, glossary term, or
emphasis. For example:
The HBA port alias is a symbolic name you assign.
For a complete list, see the QLogic SAN Interoperability Guide.

1 – Introduction
How This Guide is Organized
SN0054621-00 E 1-3
A
Italicized text within angle brackets indicates user-defined variables. For
example:
-arp <hba_port_inst>
Text within square brackets indicates optional parameters. For example
iscli [optional parameters] [Command Variable]
Text shown in blue indicates a cross-reference hyperlink to a Web site or to
another section of this guide. Click the hyperlink to jump to that site or
section. For example:
Visit the QLogic support Web site at support.qlogic.com for the latest
firmware and product updates.
For a list of target parameters, see Table C-1.
Related Documents
Table 1-1 lists other documents you may find helpful when installing or using
SANsurfer iSCSI HBA CLI.
Table 1-1. Related Documents
Part Number
or Name Title
IS0054501-00
Rev C
Quick Start Guide: iSCSI HBA Installation (PDF).
readme.txt SANsurfer notes included with SANsurfer iSCSI HBA CLI.
Release notes SANsurfer iSCSI HBA CLI Release Notes provide details about
modifications made since the previous version. Separate release
notes are provided for each operating system.
IS0054602-00
Rev. B
SANsurfer iSCSI HBA Manager User’s Guide provides details for
using the graphical user interface tool to manage QLogic iSCSI
HBAs.

1 – Introduction
Supported QLogic HBAs
1-4 SN0054621-00 E
S
Supported QLogic HBAs
SANsurfer iSCSI HBA CLI is supported on the following QLogic HBAs:
Supported Operating Systems
SANsurfer iSCSI HBA CLI is supported on the following operating systems:
Windows®2000 Server SP4+ (IA32, x64)
Windows Server™2003, Standard or Enterprise Edition SP1 (IA32, x64)
Windows Server 2003, Standard or Enterprise Edition, SP2 (IA32, x64)
Windows Server 2008, Standard or Enterprise Edition (IA32, x64)
Windows XP Professional, SP2 (IA32, x64)
Windows Vista (IA32, x64) (Business and Enterprise editions)
Windows Preinstallation Environment (PE) 2.0, 2.1, PE 2004, PE 2005
Red Hat®Enterprise Linux®(RHEL) 3.0, 4.0, 5.0 (IA32, x64)
Red Hat®Enterprise Linux®(RHEL) 4.0, 5.0 (PPC)
Novell®SUSE®Linux Enterprise Server (SLES) 8.0, 9.0, 10.0 (IA32, x64,
PPC)
Solaris® SPARC 9, 10
Solaris x86 9, 10 (IA32, x64)
Table 1-2. Supported HBAs
HBA Ports Media
QLA4010 1Optical
QLA4010C 1 Copper
QLA4050 1Optical
QLA4050C 1 Copper
QLA4052C 2Copper
QLE4060C 1 Copper
QLE4062C 2Copper
QMC4052 (IBM) 2 Copper
QMH4062 (HP) 2Copper
NOTE:
Throughout this guide, HBA may be shortened to adapter. The term device
often refers to targets.

1 – Introduction
License Agreements
SN0054621-00 E 1-5
A
License Agreements
Refer to the QLogic Software End User License Agreement for a complete listing
of all license agreements affecting this product.
Technical Support
Customers should contact their authorized maintenance provider for technical
support of their QLogic switch products. QLogic-direct customers may contact
QLogic Technical Support; others will be redirected to their authorized
maintenance provider.
For the latest firmware and software updates, visit the QLogic support Web site
listed in Contact Information.
Availability
QLogic Technical Support for products under warranty is available during local
standard working hours, excluding QLogic Observed Holidays.
Training
QLogic offers certification training for the technical professional for both the
QLogic iSCSI HBAs and switches. From the training link at www.qlogic.com, you
may choose Electronic-based Training or schedule an intensive “hands-on”
Certification course.
Technical Certification courses include installation, maintenance, and
troubleshooting QLogic SAN products. Upon demonstrating knowledge using live
equipment, QLogic awards a certificate identifying the student as a Certified
Professional. The training professionals at QLogic may be reached by e-mail at
[email protected].
Contact Information
Please feel free to contact your QLogic approved reseller or QLogic Technical
Support at any phase of integration for assistance. QLogic Technical Support can
be reached by the following methods:
Support contact information for other regions of the world is available at the
QLogic Web site: http://support.qlogic.com
Web http://support.qlogic.com
North America Contact Information
E-mail [email protected]
Phone [phone]

1 – Introduction
Technical Support
1-6 SN0054621-00 E
S
The QLogic knowledge database contains troubleshooting information for the
QLogic HBAs. Access the database from the QLogic Web site, www.qlogic.com.
Click the Support tab, and then use the search engine at the top of the page to
look for specific troubleshooting information.

SN0054621-00 E 2-1
2Installation 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.
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.
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.

2 – Installation and Removal
Installing SANsurfer iSCSI HBA CLI
2-2 SN0054621-00 E
S
3. Under Drivers, Management Tools, and API Libraries: click the
appropriate operating system.
4. In the SANsurfer iSCSI row of the Management Tools table, in the
Download column, click Download.
SANsurfer iSCSI HBA CLI shows the End User License Agreement box.
5. Scroll to the bottom, and then click Agree.
SANsurfer iSCSI HBA CLI shows the File Download dialog box.
6. Click Save. Select a directory on your system and download the file.
The installation package has the following naming convention:
iscli-AA.BB.CC-DD_<OS Type>_<Subtype>.<Install Type>
Where:
For example, a package for the Linux operating system can be named:
iscli-1.0.35-0_linux_i386.rpm
7. Follow the installation instructions in the section for your operating system
(OS):
Microsoft®Windows®(see “Installing on Microsoft Windows” on
page 2-4)
Windows 2000 Server SP4+ (IA32, x64)
Windows Server 2003, Standard or Enterprise Edition SP1 (IA32,
x64)
AA.BB.CC-DD =Version number
OS Type =One of the following:
win
linux
solaris
Subtype =One of the following:
i386
PPC 64 (Power PC)
sparc_x86
(There is no Subtype in the Windows package name.)
Install Type =One of the following:
rpm (Linux)
exe (Windows)
Z (Solaris)