QLogic SANsurfer iSCSI Command Line Utility for Windows, Solaris ...
QLogic SANsurfer iSCSI Command Line Utility for Windows, Solaris ...
QLogic SANsurfer iSCSI Command Line Utility for Windows, Solaris ...
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
<strong>QLogic</strong> <strong>SANsurfer</strong> <strong>iSCSI</strong> <strong>Command</strong> <strong>Line</strong> <strong>Utility</strong><br />
<strong>for</strong> <strong>Windows</strong>, <strong>Solaris</strong>, and Linux<br />
This software license applies only to <strong>QLogic</strong> customers.<br />
<strong>QLogic</strong> Corporation.<br />
All rights reserved.<br />
Table of Contents<br />
1. OS Support<br />
2. Overview<br />
3. Installing the <strong>Utility</strong><br />
3.1 <strong>Windows</strong><br />
3.2 Linux<br />
3.3 <strong>Solaris</strong><br />
4. Additional Notes<br />
4.1 Two-Part <strong>Utility</strong> <strong>for</strong> <strong>Windows</strong><br />
4.2 CHAP Table<br />
4.3 iSNS Targets<br />
4.4 Boot Code<br />
5. Requirements<br />
5.1. Hardware Requirements<br />
5.2. Software Requirements<br />
6. Known Issues and WorkArounds<br />
7. Contacting Support
1. OS Support<br />
This utility, iscli, supports the QLA4010, QLA4010C, QLA4050C, and QLA4052C HBAs and runs on the following<br />
plat<strong>for</strong>ms:<br />
● <strong>Windows</strong> 2000 (IA32), <strong>Windows</strong> XP (IA32, x64), <strong>Windows</strong> Server 2003 (IA32, x64)<br />
●<br />
<strong>Solaris</strong> 8, 9, 10 (SPARC)<br />
● <strong>Solaris</strong> 10 (IA32, x64)<br />
●<br />
●<br />
●<br />
Red Hat Linux 2.1, 3.0, 4.0, SuSe Linux 8, 9, 10 (IA32)<br />
SuSe Linux 9, 10 (x64)<br />
Red Hat Linux 3.0, 4.0 (x64)<br />
2. Overview/Features<br />
The iscli utility function set closely mirrors the function set contained in the <strong>SANsurfer</strong> Graphical User Interface<br />
(GUI). You may use it as an alternative to the GUI to view, configure, and diagnose the QLA4010, QLA4010C,<br />
QLA4050C, and QLA4052C <strong>iSCSI</strong> HBAs.<br />
Functions include:<br />
●<br />
Asset Management, which enables users to:<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
View details about attached <strong>iSCSI</strong> HBAs.<br />
View details about <strong>iSCSI</strong> devices and LUNs connected to the <strong>iSCSI</strong> HBAs.<br />
Save the host configuration to text file.<br />
View Vendor Private Data.<br />
Clone all or parts of pre-saved HBA configuration <strong>for</strong> HBA replacement, quick configuration<br />
duplication, or to ensure consistent configurations.<br />
●<br />
Configuration Management, which enables users to:<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
❍<br />
Configure <strong>QLogic</strong> <strong>iSCSI</strong> HBAs network and <strong>iSCSI</strong> parameters.<br />
Configure connections to <strong>iSCSI</strong> targets.<br />
View target negotiated parameters.<br />
Specify CHAP secrets.<br />
Display LUN properties.<br />
Update firmware.<br />
Update BIOS, FCODE, and ROM.<br />
Restore firmware factory default settings.<br />
Use Comprehensive Restore Factory Defaults feature (405x).<br />
Use VLAN Configuration (405x).<br />
Use ZIO Configuration (405x).<br />
Update BIOS & FCode Boot targets.<br />
Update <strong>iSCSI</strong> Boot configuration (disable, manual, DHCP <strong>for</strong> 405x).<br />
●<br />
Statistics, which are available <strong>for</strong> each <strong>iSCSI</strong> HBA.
●<br />
Advanced Diagnostics, which enables users to:<br />
❍<br />
❍<br />
❍<br />
❍<br />
Ping a target to verify connectivity between HBA port and a target.<br />
Per<strong>for</strong>m read/write buffer tests.<br />
Per<strong>for</strong>m internal loop back tests.<br />
Per<strong>for</strong>m external loop back tests.<br />
●<br />
HBA State and Target Session Connection State Displays enable users to:<br />
❍<br />
❍<br />
Display <strong>QLogic</strong> <strong>iSCSI</strong> HBAs and their states.<br />
Display target connections and displays their state.<br />
●<br />
Driver Installation (available <strong>for</strong> <strong>Windows</strong> only).<br />
3. Installing the <strong>Utility</strong><br />
The iscli utility (version 1.0.39.07) comes in one of the OS-specific installation packages shown in the following<br />
table.<br />
OS Plat<strong>for</strong>m<br />
iSCLI Installation Package<br />
<strong>Windows</strong> 2000, <strong>Windows</strong> XP, 2003 (IA32) iscli-1.0.39-07_win.exe<br />
<strong>Windows</strong> XP, <strong>Windows</strong> Server 2003 (x64)<br />
Linux Red Hat AS 2.1, 3.0, 4.0<br />
SuSE 8.0, 9.0 (IA32)<br />
Red Hat AS 3.0, 4.0<br />
SuSE 9.0, 10.0 (x64)<br />
<strong>Solaris</strong> 8, 9, 10 (SPARC)<br />
<strong>Solaris</strong> 10 (IA32, x64)<br />
iscli-1.0.39-07_linux_i386.rpm<br />
iscli-1.0.39-07_solaris_sparc_x86.Z<br />
The install package name uses the following naming convention:<br />
iscli-AA.BB.CC-DD__.<br />
where:<br />
is win, linux, or solaris<br />
is i386 or sparc_x86 (<strong>Windows</strong> does not include a subtype)<br />
AA.BB.CC-DD is the version number<br />
is the file extension (rpm <strong>for</strong> Linux, exe <strong>for</strong> <strong>Windows</strong>, and none <strong>for</strong> <strong>Solaris</strong>)<br />
For example, the IA32 Linux package name <strong>for</strong> the 1.0.39.07 release is iscli-1.0.39-07_linux_i386.rpm.<br />
3.1 <strong>Windows</strong><br />
To install the package on <strong>Windows</strong>:<br />
1. Run the self extracting archive iscli-AA.BB.CC-DD_win.exe.<br />
2. Follow the prompts in the install wizard.<br />
NOTE: The install script adds the installation path to the environment variables. To make this take effect,<br />
restart the system or access the environment variables property list and click Apply.<br />
To uninstall the utility, go to Add/Remove programs in Control Panel and remove <strong>SANsurfer</strong>iCLI.
3.2 Linux<br />
To install the package on Linux, open a command prompt and enter:<br />
rpm -i iscli-AA.BB.CC-DD_linux_.rpm<br />
The install script automatically places the files in the following directory and adds it to the execution path:<br />
opt/<strong>QLogic</strong>_Corporation/<strong>SANsurfer</strong>iCLI<br />
To uninstall the utility, type the command:<br />
rpm -e iscli-AA.BB.CC-DD (be sure to omit the rest of the name)<br />
3.3 <strong>Solaris</strong><br />
To install the package on <strong>Solaris</strong>, enter the following command at a command prompt:<br />
uncompress iscli-AA.BB.CC-DD_solaris_sparc_x86.Z<br />
pkgadd -d iscli-AA.BB.CC-DD_solaris_sparc_x86<br />
The install script automatically places the files in the following directory and adds it to the execution path:<br />
/opt/<strong>QLogic</strong>_Corporation/<strong>SANsurfer</strong>iCLI<br />
To uninstall type the command <strong>for</strong> your <strong>Solaris</strong> plat<strong>for</strong>m:<br />
pkgrm QLSisclix86 (<strong>for</strong> x86)<br />
or<br />
pkgrm QLSisclisparc (<strong>for</strong> SPARC)<br />
4. Additional Notes<br />
4.1 Two-Part <strong>Utility</strong> <strong>for</strong> <strong>Windows</strong><br />
The <strong>Windows</strong> version of the iscli utility consists of two parts:<br />
●<br />
The utility program (iscli.exe)<br />
●<br />
A support (SDM<strong>iSCSI</strong>d.dll) library.<br />
If you copy the utility to another directory, you must also copy the DLL to the same location. Note that <strong>SANsurfer</strong><br />
<strong>iSCSI</strong> HBA Manager also uses this DLL.<br />
WARNING: Do not copy the utility to the same directory where the <strong>SANsurfer</strong> <strong>iSCSI</strong> HBA Manager resides. Doing so<br />
may overwrite the support DLL and cause incompatibilities.<br />
4.2 CHAP Table<br />
The <strong>for</strong>mat of the CHAP table (stored on the HBA) used by versions of <strong>SANsurfer</strong> iX Control earlier than 02.05.05 are<br />
not compatible with the <strong>for</strong>mat used by the CLUI. To convert the CHAP table to the newer <strong>for</strong>mat, use the chapConv<br />
utility.<br />
NOTE: If you convert the CHAP table, you must also upgrade <strong>SANsurfer</strong> ix Control to a newer version of (02.05.XX)<br />
since the new CHAP table <strong>for</strong>mat is not compatible with older software versions.<br />
4.3 iSNS Targets<br />
When discovering targets, the utility displays a maximum of 62 iSNS targets as persistent targets (target ID's 0 -<br />
64). The iscli utility cannot detect iSNS targets beyond 62.
4.4 Boot Code<br />
You can download the BIOS and FCode, which are used <strong>for</strong> remote boot, and configure them using the iscli utility.<br />
The processor/operating system plat<strong>for</strong>ms that BIOS and FCode work with include the following:<br />
●<br />
BIOS:<br />
❍ <strong>Windows</strong> 2000/SP4+ (IA32), 2003 (IA32, x64), XP Pro (IA32, x64)<br />
❍ SuSE Linux ES 8.0 (IA32), 9.0 (IA32, x64), 10 (IA32, x64)<br />
❍ Red Hat Linux AS 2.1 (IA32), 3.0, 4.0 (IA32, x64)<br />
●<br />
FCode:<br />
❍ <strong>Solaris</strong> (SPARC) 9 and 10<br />
5. Requirements<br />
See the following topics <strong>for</strong> product requirements:<br />
●<br />
●<br />
5.1. Hardware Requirements<br />
5.2. Software Requirements<br />
5.1. Hardware Requirements<br />
●<br />
●<br />
●<br />
<strong>QLogic</strong> QLA4xxx <strong>iSCSI</strong> adapter<br />
Single or Multi-processor Server or Workstation<br />
One of the following:<br />
❍<br />
❍<br />
Pentium II class 300 MHz, 64 MB RAM, 1 MB disk space<br />
<strong>Solaris</strong> SPARC Server/Workstation running <strong>Solaris</strong>, 128MB RAM, 1MB disk space<br />
5.2. Software Requirements<br />
●<br />
Based on your hardware plat<strong>for</strong>m, one of the following operating systems:<br />
❍<br />
❍<br />
❍<br />
<strong>Windows</strong><br />
- XP Pro (IA32, x64)<br />
- 2000 SP4 or later (IA32) Server, Advanced Server<br />
- 2003 Server SP1 (IA32, x64)<br />
Linux<br />
- Red Hat Linux AS 2.1 (IA32), 3.0, 4.0 (IA32, x64)<br />
- SuSE Linux ES 8.0 (IA32), 9.0 (IA32, x64), 10 (IA32, x64)<br />
<strong>Solaris</strong><br />
- <strong>Solaris</strong> (SPARC) 9 and 10<br />
- <strong>Solaris</strong> (x86) 10<br />
●<br />
●<br />
<strong>QLogic</strong> QL4xxx Drivers.<br />
PDF Viewer must be installed to view the User's Guide.
6. Known Issues and WorkArounds<br />
●<br />
After installing the drivers, you must restart the iscli to view HBAs. This is regardless of the message<br />
regarding the need <strong>for</strong> the reboot.<br />
●<br />
When installing iscli on a Linux machine that includes an earlier version, the RPM update option -U does<br />
not work correctly when the prior iscli version is older than 1.0.39.02.<br />
WORKAROUND: Use the -ivh --<strong>for</strong>ce options. For example:<br />
rpm -ivh --<strong>for</strong>ce iscli-1.0.39-02.ppc64.rpm<br />
7. Contacting Support<br />
Please feel free to contact your <strong>QLogic</strong> approved reseller or <strong>QLogic</strong> Technical Support at any phase of integration <strong>for</strong><br />
assistance. <strong>QLogic</strong> Technical Support can be reached by the following methods:<br />
Web: http://support.qlogic.com<br />
North America Contact In<strong>for</strong>mation<br />
Email: support@qlogic.com<br />
Phone: (952) 932-4040<br />
Support contact in<strong>for</strong>mation <strong>for</strong> other regions of the world is available at the <strong>QLogic</strong> website:<br />
http://support.qlogic.com<br />
Go to Top<br />
© Copyright 2006. All rights reserved worldwide. <strong>QLogic</strong>, the <strong>QLogic</strong> logo, and the Powered by <strong>QLogic</strong> logo are<br />
registered trademarks of <strong>QLogic</strong> Corporation. All other brand and product names are<br />
trademarks or registered trademarks of their respective owners.