User`s guide

ManualsBrandsQlogic ManualsComputer equipmentSANsurfer iSCSI HBA CLI

SANsurfer iSCSI HBA CLI Readme Page 1 of 10

SANsurfer iSCSI HBA CLI

QLogic Corporation

Table of Contents

1 Package Contents

2 Requirements

2.1 Hardware Requirements

2.2 Software Requirements

3 OS Support

4 Supported Features

5 Using SANsurfer iSCSI HBA CLI

5.1 Installing SANsurfer iSCSI HBA CLI

5.2 Unattended Installation of SANsurfer iSCSI HBA CLI

5.3 Removing SANsurfer iSCSI HBA CLI

6 Additional Notes

6.1 Two-Part Utility for Windows

6.2 CHAP Table

6.3 iSNS Targets

6.4 Boot Code

6.5 Return Codes

6.6 RHEL 6.x Requires Inbox Driver Update (Out-of-Box Driver)

6.7 RHEL 6.x with the x86_x64 Architecture

6.8 SLES 11 SP1 Error Message

7 Known Issues and Workarounds

8 Contacting Support

1 Package Contents

The SANsurfer iSCSI HBA CLI (also referred to in this document as iscli) package contains

the files listed in the following table.

File Name Description

Windows

iscli-<version>-win.msi

Executable installer package

Linux

iscli-<version>_linux_<arch>.install.tar.gz

Package file

iscli.dkms.install.sh

Install script

iscli-<version>_<arch>.rpm

Red Hat Package Manager (RPM) installer

package file

Summary of content (10 pages)

PAGE 1
SANsurfer iSCSI HBA CLI QLogic Corporation All rights reserved Table of Contents 1 2 3 4 5 6 7 8 Package Contents Requirements 2.1 Hardware Requirements 2.2 Software Requirements OS Support Supported Features Using SANsurfer iSCSI HBA CLI 5.1 Installing SANsurfer iSCSI HBA CLI 5.2 Unattended Installation of SANsurfer iSCSI HBA CLI 5.3 Removing SANsurfer iSCSI HBA CLI Additional Notes 6.1 Two-Part Utility for Windows 6.2 CHAP Table 6.3 iSNS Targets 6.4 Boot Code 6.5 Return Codes 6.6 RHEL 6.
PAGE 2
Requirements This section defines the following minimum requirements:   2.1 Hardware Requirements 2.2 Software Requirements 2.1 Hardware Requirements SANsurfer iSCSI HBA CLI requires the following minimum hardware:    QLogic 4000 Series iSCSI Adapter Single- or multi-processor server or workstation Pentium II class 300MHz, 64MB RAM, 1MB disk space 2.
PAGE 3
The following describes the functions you can perform using SANsurfer iSCSI HBA CLI:  Asset Management: View information about attached iSCSI Adapters. View information about iSCSI devices and LUNs connected to the iSCSI Adapters. Save host configuration to a text file. View vital product data (VPD). Clone all or parts of a pre-saved adapter configuration for adapter replacement, quick configuration duplication, or to ensure consistent configurations.
PAGE 4
5 Using SANsurfer iSCSI HBA CLI This section provides the following information:    5.1 Installing SANsurfer iSCSI HBA CLI 5.2 Unattended SANsurfer iSCSI HBA CLI 5.3 Removing SANsurfer iSCSI HBA CLI 5.1 Installing SANsurfer iSCSI HBA CLI SANsurfer iSCSI HBA CLI is packaged by operating system: one package for Windows and one package for IA32 Linux (2.4.x kernel or 2.6.x kernel). The install package name is: iscli-A.B.CC-DD__. where: AA.BB.
PAGE 5
 To perform a silent installation (without displaying any errors), issue the following command: SANsurferiCLI.msi /q  To display only a progress bar with minimal interaction and no error messages, issue the following command: SANsurferiCLI.msi /passive  To install the utility in a specific directory, use the full file path names: SANsurferiCLI.
PAGE 6
5.3 Removing SANsurfer iSCSI HBA CLI To remove SANsurfer iSCSI HBA CLI, follow the appropriate procedure for your operating system:   5.3.1 Windows 5.3.2 Linux 5.3.1 Windows Use one of the following methods to remove the utility:  Go to Add/Remove Programs in the Windows Control Panel, and then remove SANsurferiCLI.  On the Windows Start menu, point to QLogic Management Suite, and then click SANsurfer Uninstaller.  To start an interactive uninstall, issue the following command: SANsurferiCLI.
PAGE 7
6.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 SANsurfer iSCSI HBA Manager is installed. Doing so may overwrite the support DLL and cause incompatibilities. 6.
PAGE 8
Value 0 Return Code Description Success. 100 A parameter was invalid. Use the iscli -h switch to display proper usage. 101 Failed to allocate memory error. 102 A call to the SDM library failed. 103 HBA instance specified is invalid. 104 Failed to open the HBA for an operation. 105 Failed to save the INITFW settings to the HBA. 108 A required parameter was missing. 109 An error occurred updating the firmware. 119 An unknown system error occurred. 152 Driver zip or inf file not found.
PAGE 9
Comapt-glibc-2.5.46.2.x86_64 Compat-libgfortran-41-4.1.2-39.el6.x86_64 Compat-libstdc++-296-2.96-144.el6.x86_64 Compat-libstdc++-33-3.2.3-69.el6.x86_64 Compat-libtermcap-2.0.8.49.el6.x86_64 Compat-openldap-2.4.19_2.3.43-15.el6.x86_64 Openssl098e-0.9.8e-17.el6.x86_64 5. Configure the network and ensure that the iptables/firewall is disabled. 6. Install SANsurfer iSCSI HBA CLI. 7. Install the library RPMs in the following sequence: libXau-1.0.5.1.el6.i686.rpm libxcb-1.5.1el6.i686.rpm libX11-1.3.2.el6.i686.
PAGE 10
Known Issue Workaround On Linux 2.6 and newer kernels, you may see the Set the IP address to a non-zero value. warning message, Error Read FW settings from HBA instance if the adapter is not initialized or is unable to acquire an IP address using DHCP. This occurs when the IPv4 address is 0.0.0.0. iSCSI Adapters are not discovered on Linux systems. Ensure that SANsurfer iSCSI HBA CLI was installed with the script, and not with the RPM file.