QLogic SANsurfer iSCSI Command Line Utility for Windows, Solaris ...

QLogic SANsurfer iSCSI Command Line Utility 

for Windows, Solaris, and Linux 

This software license applies only to QLogic customers. 

QLogic Corporation. 

All rights reserved. 

Table of Contents 

1. OS Support 

2. Overview 

3. Installing the Utility 

3.1 Windows 

3.2 Linux 

3.3 Solaris 

4. Additional Notes 

4.1 Two-Part Utility for Windows 

4.2 CHAP Table 

4.3 iSNS Targets 

4.4 Boot Code 

5. Requirements 

5.1. Hardware Requirements 

5.2. Software Requirements 

6. Known Issues and WorkArounds 

7. Contacting Support

1. OS Support 

This utility, iscli, supports the QLA4010, QLA4010C, QLA4050C, and QLA4052C HBAs and runs on the following 

platforms: 

● Windows 2000 (IA32), Windows XP (IA32, x64), Windows Server 2003 (IA32, x64) 

● 

Solaris 8, 9, 10 (SPARC) 

● Solaris 10 (IA32, x64) 

● 

● 

● 

Red Hat Linux 2.1, 3.0, 4.0, SuSe Linux 8, 9, 10 (IA32) 

SuSe Linux 9, 10 (x64) 

Red Hat Linux 3.0, 4.0 (x64) 

2. Overview/Features 

The iscli utility function set closely mirrors the function set contained in the SANsurfer Graphical User Interface 

(GUI). You may use it as an alternative to the GUI to view, configure, and diagnose the QLA4010, QLA4010C, 

QLA4050C, and QLA4052C iSCSI HBAs. 

Functions include: 

● 

Asset Management, which enables users to: 

❍ 

❍ 

❍ 

❍ 

❍ 

View details about attached iSCSI HBAs. 

View details about iSCSI devices and LUNs connected to the iSCSI HBAs. 

Save the host configuration to text file. 

View Vendor Private Data. 

Clone all or parts of pre-saved HBA configuration for HBA replacement, quick configuration 

duplication, or to ensure consistent configurations. 

● 

Configuration Management, which enables users to: 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

❍ 

Configure QLogic iSCSI HBAs network and iSCSI parameters. 

Configure connections to iSCSI targets. 

View target negotiated parameters. 

Specify CHAP secrets. 

Display LUN properties. 

Update firmware. 

Update BIOS, FCODE, and ROM. 

Restore firmware factory default settings. 

Use Comprehensive Restore Factory Defaults feature (405x). 

Use VLAN Configuration (405x). 

Use ZIO Configuration (405x). 

Update BIOS & FCode Boot targets. 

Update iSCSI Boot configuration (disable, manual, DHCP for 405x). 

● 

Statistics, which are available for each iSCSI HBA.

● 

Advanced Diagnostics, which enables users to: 

❍ 

❍ 

❍ 

❍ 

Ping a target to verify connectivity between HBA port and a target. 

Perform read/write buffer tests. 

Perform internal loop back tests. 

Perform external loop back tests. 

● 

HBA State and Target Session Connection State Displays enable users to: 

❍ 

❍ 

Display QLogic iSCSI HBAs and their states. 

Display target connections and displays their state. 

● 

Driver Installation (available for Windows only). 

3. Installing the Utility 

The iscli utility (version 1.0.39.07) comes in one of the OS-specific installation packages shown in the following 

table. 

OS Platform 

iSCLI Installation Package 

Windows 2000, Windows XP, 2003 (IA32) iscli-1.0.39-07_win.exe 

Windows XP, Windows Server 2003 (x64) 

Linux Red Hat AS 2.1, 3.0, 4.0 

SuSE 8.0, 9.0 (IA32) 

Red Hat AS 3.0, 4.0 

SuSE 9.0, 10.0 (x64) 

Solaris 8, 9, 10 (SPARC) 

Solaris 10 (IA32, x64) 

iscli-1.0.39-07_linux_i386.rpm 

iscli-1.0.39-07_solaris_sparc_x86.Z 

The install package name uses the following naming convention: 

iscli-AA.BB.CC-DD__. 

where: 

is win, linux, or solaris 

is i386 or sparc_x86 (Windows does not include a subtype) 

AA.BB.CC-DD is the version number 

is the file extension (rpm for Linux, exe for Windows, and none for Solaris) 

For example, the IA32 Linux package name for the 1.0.39.07 release is iscli-1.0.39-07_linux_i386.rpm. 

3.1 Windows 

To install the package on Windows: 

1. Run the self extracting archive iscli-AA.BB.CC-DD_win.exe. 

2. Follow the prompts in the install wizard. 

NOTE: The install script adds the installation path to the environment variables. To make this take effect, 

restart the system or access the environment variables property list and click Apply. 

To uninstall the utility, go to Add/Remove programs in Control Panel and remove SANsurferiCLI.

3.2 Linux 

To install the package on Linux, open a command prompt and enter: 

rpm -i iscli-AA.BB.CC-DD_linux_.rpm 

The install script automatically places the files in the following directory and adds it to the execution path: 

opt/QLogic_Corporation/SANsurferiCLI 

To uninstall the utility, type the command: 

rpm -e iscli-AA.BB.CC-DD (be sure to omit the rest of the name) 

3.3 Solaris 

To install the package on Solaris, enter the following command at a command prompt: 

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

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

The install script automatically places the files in the following directory and adds it to the execution path: 

/opt/QLogic_Corporation/SANsurferiCLI 

To uninstall type the command for your Solaris platform: 

pkgrm QLSisclix86 (for x86) 

or 

pkgrm QLSisclisparc (for SPARC) 

4. Additional Notes 

4.1 Two-Part Utility for Windows 

The Windows version of the iscli utility consists of two parts: 

● 

The utility program (iscli.exe) 

● 

A support (SDMiSCSId.dll) library. 

If you copy the utility to another directory, you must also copy the DLL to the same location. Note that SANsurfer 

iSCSI HBA Manager also uses this DLL. 

WARNING: Do not copy the utility to the same directory where the SANsurfer iSCSI HBA Manager resides. Doing so 

may overwrite the support DLL and cause incompatibilities. 

4.2 CHAP Table 

The format of the CHAP table (stored on the HBA) used by versions of SANsurfer iX Control earlier than 02.05.05 are 

not compatible with the format used by the CLUI. To convert the CHAP table to the newer format, use the chapConv 

utility. 

NOTE: If you convert the CHAP table, you must also upgrade SANsurfer ix Control to a newer version of (02.05.XX) 

since the new CHAP table format is not compatible with older software versions. 

4.3 iSNS Targets 

When discovering targets, the utility displays a maximum of 62 iSNS targets as persistent targets (target ID's 0 - 

64). The iscli utility cannot detect iSNS targets beyond 62.

4.4 Boot Code 

You can download the BIOS and FCode, which are used for remote boot, and configure them using the iscli utility. 

The processor/operating system platforms that BIOS and FCode work with include the following: 

● 

BIOS: 

❍ Windows 2000/SP4+ (IA32), 2003 (IA32, x64), XP Pro (IA32, x64) 

❍ SuSE Linux ES 8.0 (IA32), 9.0 (IA32, x64), 10 (IA32, x64) 

❍ Red Hat Linux AS 2.1 (IA32), 3.0, 4.0 (IA32, x64) 

● 

FCode: 

❍ Solaris (SPARC) 9 and 10 

5. Requirements 

See the following topics for product requirements: 

● 

● 




● 

● 

● 

QLogic QLA4xxx iSCSI adapter 

Single or Multi-processor Server or Workstation 

One of the following: 

❍ 

❍ 

Pentium II class 300 MHz, 64 MB RAM, 1 MB disk space 

Solaris SPARC Server/Workstation running Solaris, 128MB RAM, 1MB disk space 


● 

Based on your hardware platform, one of the following operating systems: 

❍ 

❍ 

❍ 

Windows 

- XP Pro (IA32, x64) 

- 2000 SP4 or later (IA32) Server, Advanced Server 

- 2003 Server SP1 (IA32, x64) 

Linux 

- Red Hat Linux AS 2.1 (IA32), 3.0, 4.0 (IA32, x64) 

- SuSE Linux ES 8.0 (IA32), 9.0 (IA32, x64), 10 (IA32, x64) 

Solaris 

- Solaris (SPARC) 9 and 10 

- Solaris (x86) 10 

● 

● 

QLogic QL4xxx Drivers. 

PDF Viewer must be installed to view the User's Guide.

6. Known Issues and WorkArounds 

● 

After installing the drivers, you must restart the iscli to view HBAs. This is regardless of the message 

regarding the need for the reboot. 

● 

When installing iscli on a Linux machine that includes an earlier version, the RPM update option -U does 

not work correctly when the prior iscli version is older than 1.0.39.02. 

WORKAROUND: Use the -ivh --force options. For example: 

rpm -ivh --force iscli-1.0.39-02.ppc64.rpm 

7. Contacting Support 

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 

Email: support@qlogic.com 

Phone: (952) 932-4040 

Support contact information for other regions of the world is available at the QLogic website: 

http://support.qlogic.com 

Go to Top 

© Copyright 2006. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are 

registered trademarks of QLogic Corporation. All other brand and product names are 

trademarks or registered trademarks of their respective owners.

QLogic SANsurfer iSCSI Command Line Utility for Windows, Solaris ...

Create successful ePaper yourself

Delete template?

Save as template?