Qlogic SANsurfer iSCSI HBA CLI, QLA4010, QLA4010C, QLA4050, QLA4050C User Manual

SANsurfer iSCSI HBA CLI

User’s Guide

Command Line Interface for

QLogic iSCSI Host Bus Adapters

SN0054621-00 E

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.

S

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.

Expanded Introduction chapter to include new
information.

Added supported operating systems Windows
Server 2008 and Windows PE.

Removed obsolete Linux attended installation sec­tion.

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.

All

Intended Audience, How This Guide is Organized

(Typographic Conventions, Related Documents),

License Agreements

“Supported Operating Systems” on page 1-4

“Installing on Red Hat/SUSE Linux/PPC” on
page 2-10

“Update Firmware, Multiple Adapters” on
page 4-11

Added new Port Link Settings Menu and menu
items.

Updated Display Network Settings example. Display Network Settings (CLI Options -netconf)

Page ii SN0054621-00 E

“Port Link Settings Menu” on page 4-19

S

SANsurfer iSCSI HBA CLI User’s Guide

Command Line Interface for QLogic iSCSI Host Bus Adapters

Updated (added and removed parameters) the list
of device settings.

Updated (added and removed parameters) the list
of basic settings.

Updated (added and removed parameters) the list
of advanced settings.

Changed Bootcode Settings Menu to new
BIOS/UEFI (or FCode) Settings Menu.

Removed Unbind Target option from Target
Level Info & Operations menu.

Added more detail for Display Target Information
option.

Added new Target Discovery Menu and its
options.

Removed subheadings referencing non-existent
interactive mode commands.

Added new miscellaneous command line options. “-acb” on page 5-3, “-dce” on page 5-7, “-dp” on

Added new discovered target command line
options.

“Configure Device Settings” on page 4-25

“Configure Basic Settings” on page 4-26

“Configure Advanced Settings” on page 4-26

“BIOS/UEFI [or FCode] Settings Menu” on
page 4-34

“Target Level Info & Operations” on page 4-36

“Display Target Information (CLI Option -t)” on
page 4-37

“Target Discovery Menu” on page 4-44

5 Non-Interactive Mode Commands

page 5-8,

“-dtdsp (Display Discovered Targets)” on page 5-9

through “-dtrema (Remove Discovered Target)” on

page 5-11

Added new link configuration command line
options.

Added other new target command line options. “-pad” on page 5-24, “-pdt” on page 5-24 and “-pet”

Added unbind persistent target command line
options.

Added new send target and statistics command
line options.

Added new port and HBA configuration parame­ters (each in a separate table).

Added missing descriptions for parameters.

Deleted obsolete parameters.

“-lc (Configure Link Configuration)” on page 5-18

and “-lcd (Display Configured Link Configuration)”

on page 5-18

on page 5-24

“-pu” on page 5-25 and “-px” on page 5-26

“-stadd” on page 5-29 through “-strema” on
page 5-30

Appendix A Port- and HBA-level Parameters

SN0054621-00 E Page iii

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

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

SN0054621-00 E Page v

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

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

S

Page vi SN0054621-00 E

A

SANsurfer iSCSI HBA CLI User’s Guide

Command Line Interface for QLogic iSCSI Host Bus Adapters

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

SN0054621-00 E Page vii

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

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

S

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

Page viii SN0054621-00 E

A

SANsurfer iSCSI HBA CLI User’s Guide

Command Line Interface for QLogic iSCSI Host Bus Adapters

-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

SN0054621-00 E Page ix

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

-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

S

A Port- and HBA-level Parameters

Port-level Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

HBA-level Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10

B HBA Statistics

C Target Parameters

Page x SN0054621-00 E

A

Command Line Interface for QLogic iSCSI Host Bus Adapters

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

SANsurfer iSCSI HBA CLI User’s Guide

SN0054621-00 E Page xi

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

Page xii SN0054621-00 E

1 Introduction

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.

SN0054621-00 E 1-1

1 – Introduction
How This Guide is Organized

 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.

S

Typographic Conventions

This guide uses the following typographic conventions:

 Te x 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 y for the Stop on error[Y]? option.

 Te x 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-2 SN0054621-00 E

A

1 – Introduction

How This Guide is Organized

 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
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.

Part Number

or Name

IS0054501-00
Rev C

readme.txt SANsurfer notes included with SANsurfer iSCSI HBA CLI.

Release notes SANsurfer iSCSI HBA CLI Release Notes provide details about

IS0054602-00
Rev. B

for the latest

Table 1-1. Related Documents

Title

Quick Start Guide: iSCSI HBA Installation (PDF).

modifications made since the previous version. Separate release
notes are provided for each operating system.

SANsurfer iSCSI HBA Manager User’s Guide provides details for

using the graphical user interface tool to manage QLogic iSCSI
HBAs.

SN0054621-00 E 1-3

1 – Introduction
Supported QLogic HBAs

Supported QLogic HBAs

SANsurfer iSCSI HBA CLI is supported on the following QLogic HBAs:

Table 1-2. Supported HBAs

HBA Ports Media

QLA4010 1 Optical

QLA4010C 1 Copper

QLA4050 1 Optical

QLA4050C 1 Copper

QLA4052C 2 Copper

QLE4060C 1 Copper

QLE4062C 2 Copper

S

QMC4052 (IBM) 2 Copper

QMH4062 (HP) 2 Copper

Supported Operating Systems

SANsurfer iSCSI HBA CLI is supported on the following operating systems:

®

 Windows
 Windows Server
 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
 Red Hat
 Novell

PPC)

 Solaris
 Solaris x86 9, 10 (IA32, x64)

NOTE:

Throughout this guide, HBA may be shortened to adapter. The term device
often refers to targets.

2000 Server SP4+ (IA32, x64)

™

2003, Standard or Enterprise Edition SP1 (IA32, x64)

®

Enterprise Linux® (RHEL) 3.0, 4.0, 5.0 (IA32, x64)

®

Enterprise Linux® (RHEL) 4.0, 5.0 (PPC)

®

SUSE® Linux Enterprise Server (SLES) 8.0, 9.0, 10.0 (IA32, x64,

®

SPARC 9, 10

1-4 SN0054621-00 E

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.

1 – Introduction

License Agreements

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
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

[e-mail]

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:

Web http://support.qlogic.com

North America Contact Information

E-mail [e-mail]

Phone [phone]

, you

.

Support contact information for other regions of the world is available at the
QLogic Web site: http://support.qlogic.com

SN0054621-00 E 1-5

1 – Introduction
Technical Support

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.

.

1-6 SN0054621-00 E

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

2. Select your HBA.

SN0054621-00 E 2-1

), click Downloads.

2 – Installation and Removal
Installing SANsurfer iSCSI HBA CLI

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:

AA.BB.CC-DD = Version number

OS Type = One of the following:

Subtype = One of the following:

Install Type = One of the following:

S

 win

 linux

 solaris

 i386

 PPC 64 (Power PC)

 sparc_x86

(There is no Subtype in the Windows package name.)

 rpm (Linux)

 exe (Windows)

 Z (Solaris)

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

page 2-4)

 Windows

 Windows Server 2003, Standard or Enterprise Edition SP1 (IA32,

2-2 SN0054621-00 E

®

x64)

®

Windows

(see “Installing on Microsoft Windows” on

2000 Server SP4+ (IA32, x64)

A

2 – Installation and Removal

Installing SANsurfer iSCSI HBA CLI

 Windows Server 2003, Standard or Enterprise Edition, SP2

(IA32, x64)

 Windows XP Professional (IA32, x64) SP2

 Windows Vista (IA32, x64) (Business and Enterprise editions)

 Windows Preinstalled Environment (PE) 2.0, PE 2004, PE 2005

 Red Hat/SUSE Linux/Power PC (PPC) (see “Installing on Red

Hat/SUSE Linux/PPC” on page 2-10)

 Solaris SPARC/Solaris x86 (see “Installing on Solaris SPARC/Solaris

x86” on page 2-10)

SN0054621-00 E 2-3

2 – Installation and Removal
Installing SANsurfer iSCSI HBA CLI

Installing on Microsoft Windows

Choose one of the following options for installing SANsurfer iSCSI HBA CLI:

 “Windows Standard (GUI) Installation” on page 2-4
 “Windows Command Line Installation” on page 2-9

Windows Standard (GUI) Installation

Follow these steps to install SANsurfer iSCSI HBA CLI on a Windows operating
system.

To install using the GUI installation:

1. Locate and double-click the install package on the CD or Web site.

InstallShield Wizard opens, and shows the welcome window (Figure 2-1).

S

Figure 2-1 Install Wizard: Welcome

2. Read the information, and then click Next.

2-4 SN0054621-00 E

A

2 – Installation and Removal

Installing SANsurfer iSCSI HBA CLI

The Select Which Users window appears, as shown in Figure 2-2.

Figure 2-2 Install Wizard: Select Which Users

3. Choose whether you want SANsurfer iSCSI HBA CLI available for all users
or only the current user, and then click Next.

The Destination Folder window appears, as shown in Figure 2-3.

Figure 2-3 Install Wizard: Destination Folder

SN0054621-00 E 2-5

2 – Installation and Removal
Installing SANsurfer iSCSI HBA CLI

4. Choose one of the following options:

 To select the destination in the dialog box, click Next (recommended).

The default location for a Microsoft Windows system is:

 To select a different location, click Change, select the location you

want, and then click Next.

The Ready to Install window appears as shown in Figure 2-4.

S

Program Files\QLogic Corporation\SANsurferiCLI

Figure 2-4 Install Wizard: Ready to Install

5. To begin installation, click Install.

2-6 SN0054621-00 E

A

2 – Installation and Removal

Installing SANsurfer iSCSI HBA CLI

The installer shows the progress of file copying, as shown in Figure 2-5.

Figure 2-5 Install Wizard: Installing SANsurferiCLI

6. Read the information, and then click Next.

SN0054621-00 E 2-7

2 – Installation and Removal
Installing SANsurfer iSCSI HBA CLI

When finished, the installer shows the InstallShield Wizard Completed
window, as shown in Figure 2-6.

S

Figure 2-6 Install Wizard: Complete

7. Click Finish.

8. Restart your computer.

2-8 SN0054621-00 E

A

Windows Command Line Installation

You can install SANsurfer iSCSI HBA CLI from the command prompt using the
Microsoft Windows Installer (MSI). Use one of the following methods:

 “Standard Windows Interactive (CLI) Installation” on page 2-9
 “Quiet or Unattended Windows Installation” on page 2-9
 “Passive Windows Installation” on page 2-9
 “Overwrite Previous Windows Installations” on page 2-10

NOTE:

You can also configure the installation using MSI commands. To see a
summary of MSI commands, at the command prompt, type: msiexec.

To obtain more information about MSI, visit the Microsoft Web site.

Standard Windows Interactive (CLI) Installation

To begin a standard installation of SANsurfer iSCSI HBA CLI on a Microsoft
Windows operating system, at a command line, type one of the following:

2 – Installation and Removal

Installing SANsurfer iSCSI HBA CLI

SANsurferCLI.msi

msiexec /i SANsurferCLI.msi

The default directory for SANsurfer iSCSI HBA CLI application is:

Program files\QLogic Corporation\SANsurferCLI

If you want a different directory, type it in the command line. For example:

SANsurferCLI.msi INSTALLDIR="directory"

The preceding command installs SANsurfer iSCSI HBA CLI in the directory
named directory. Use full path names.

Quiet or Unattended Windows Installation

Type the following for a quiet (silent) installation using default values. For
example, the following command installs silently using defaults and does not show
any errors:

SANsurferCLI.msi /q

Passive Windows Installation

Type the following for a passive installation using default values. For example:

SANsurferCLI.msi /passive

Installs with minimum interaction, showing only the progress bar and any errors.

SN0054621-00 E 2-9

2 – Installation and Removal
Installing SANsurfer iSCSI HBA CLI

Overwrite Previous Windows Installations

Type the following for an installation that overwrites any previous installations
without asking for confirmation. Type:

SANsurferX-AgentOnly.msi /i FORCEINSTALL=TRUE

Installing on Red Hat/SUSE Linux/PPC

SANsurfer iSCSI HBA CLI installation on a Linux system requires that you use the
“quiet” installation method. This method ensures that, if needed, the Linux driver
interface module (ioctl module) is also installed.

To install quietly on Linux:

1. Unzip and untar the iSCSI CLI gzipped tar bundle as follows:

tar -xvzf

2. To start the installation, type:

./iscli.dkms.install.sh install

S

Installing on Solaris SPARC/Solaris x86

You can install SANsurfer iSCSI HBA CLI on a Solaris SPARC or x86 system with
one of the following methods:

 “Solaris Attended Installation” on page 2-10
 “Solaris Silent Installation” on page 2-11

Solaris Attended Installation

Follow this procedure from the command prompt to install SANsurfer iSCSI HBA
CLI on a Solaris SPARC/Solaris x86 operating system.

To install attended on Solaris:

1. To uncompress the package you downloaded in “Downloading the

Installation Package” on page 2-1, type the following:

uncompress iscli-AA.BB.CC-DD_solaris_sparc_x86.Z

2. To install iSANsurfer iSCSI HBA CLI on a Solaris SPARC/Solaris x86
operating system, type the following:

pkgadd -d iscli-AA.BB.CC-DD_solaris_sparc_x86

Solaris puts the files in the following directory:

/opt/QLogic_Corporation/SANsurferiCLI

It also adds this directory to the execution path.

2-10 SN0054621-00 E

A

Solaris Silent Installation

This section contains a pkgadd (SOLARIS) example for silent installation.

To install silently on Solaris:

1. Create the following two files:

response.txt

noask_pkgadd.txt

2. Run the pkgadd command.

3. Create the response.txt file with contents of first question of arch, for
example:

<BOF> 1 <EOF>

4. Create the noask_pkgadd.txt file with contents:

<BOF> action=nocheck <EOF>

5. Type the command to Install with the two additional (required) files:

2 – Installation and Removal

Installing SANsurfer iSCSI HBA CLI

pkgadd -d ./<Install Package Filename> -n -a
./noask_pkgadd.txt < ./response.txt

For example:

pkgadd -d ./iscli-1.1.00-11_solaris_sparc_x86 -n -a
./noask_pkgadd.txt < ./response.txt

Available packages include:

 QLSisclisparc—QLogic SANsurfer iSCSI CLI (HBA Configuration

Utility) (SPARC) 1.1.00 Build 11 (Solaris 8-11)

 QLSisclix86—QLogic SANsurfer iSCSI CLI (HBA Configuration

Utility) (x86) 1.1.00 Build 11 (Solaris 9-11)

6. Select the package(s) you want to process (or all to process all packages).

(default: all) [x,xx,q]:

SN0054621-00 E 2-11

2 – Installation and Removal
Removing SANsurfer iSCSI HBA CLI

Removing SANsurfer iSCSI HBA CLI

To remove SANsurfer iSCSI HBA CLI from your system, follow the instructions that
that correspond to your OS:

 “Microsoft Windows Uninstall” on page 2-12
 “Red Hat/SUSE Linux/PPC Uninstall” on page 2-13
 “Solaris SPARC/Solaris x86 Uninstall” on page 2-13

Microsoft Windows Uninstall

The Windows OS offers the following methods of uninstalling SANsurfer iSCSI HBA
CLI:

 “Start Menu Uninstall” on page 2-12
 “Control Panel Uninstall” on page 2-12
 “Command Line Uninstall” on page 2-12

Start Menu Uninstall

On the Windows Start menu, point to All Programs > QLogic Management
Suite > SANsurferiCLI, and then click Uninstall SANsurferiCLI.

S

Control Panel Uninstall

Follow these steps to uninstall SANsurfer iSCSI HBA CLI using the Windows
Control Panel.

To uninstall from the Control Panel:

1. On the Start menu, click Control Panel.

2. Click Add/Remove Programs.

3. Select SANsurferiCLI.

4. Click Change/Remove.

Command Line Uninstall

You can uninstall SANsurfer iSCSI HBA CLI from the command line. Select
interactive, passive, or silent uninstall.

To uninstall interactively from the command line:

Enter the following from a command prompt:

SANsurferiCLI.msi

To uninstall passively from the command line:

Enter the following from a command prompt:

msiexec /x SANsurferiCLI.msi

2-12 SN0054621-00 E