SANsurfer FC/CNA HBA Command Line Interface (CLI) QLogic Corporation. All rights reserved. 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 FC HBA CLI 5.1 Installing SANsurfer FC HBA CLI 5.2 Starting SANsurfer FC HBA CLI 5.3 Removing SANsurfer FC HBA CLI 6. Additional Notes 6.1 General (Applies to All OSs) 6.2 Windows 6.3 Solaris 7. Known Issues and Workarounds 7.1 Windows 7.2 Linux 7.
1. Package Contents SANsurfer FC HBA Command Line Interface (CLI) installation packages available for the supported OS platforms include the following. File Name Description scli-1.7.3-bb.windows.exe All supported Windows platforms scli-1.7.3-bb.sparc.Solaris.pkg.Z Solaris SPARC scli-1.7.3-bb.x86.Solaris.pkg.Z Solaris x86 scli.1.7.3-bb.macosx.pkg.tgz Mac OS X (Intel/PowerPC) scli-1.7.3-bb.i386.rpm.gz Linux (Intel x86, Intel 64, and AMD64) scli-1.7.3-bb.IA64.rpm.gz Linux (Intel IA64) scli-1.7.
● About 7 MB disk space 2.2 Software Requirements SANsurfer FC HBA CLI requires the following minimum software: ● QLogic QLA2xxx drivers for your OS platform ● Administrative privileges to perform management functions ● One of the operating systems listed in the OS Support section. 3. OS Support SANsurfer FC HBA CLI runs on the following OS platforms.
Linux Operating Systems OS Name OS Type Hardware Platform Red Hat RHEL AS 3.0 32-bit, 64-bit Intel x86 Intel 64, AMD64 Red Hat RHEL AS 4.x 32-bit, 64-bit Intel IA64, Intel 64, AMD64 Red Hat RHEL AS 5.x 32-bit, 64-bit Intel IA64, Intel 64, AMD64 Novell SLES 8 32-bit, 64-bit x86, Intel 64, AMD64 Novell SLES 9 32-bit, 64-bit IA64, Intel 64, AMD64 Novell SLES 10 32-bit, 64-bit IA64, Intel 64, AMD64 VMware ESX Server Operating Systems OS Name OS Type ESX 3.
6. Additional Notes This section provides additional information according to operating system (OS): 6.1 General (Applies to All OSs) Two different measurement formats are used when displaying the hard drive size: decimal (GB) and binary (GB). Both Linux and Windows show the correct number using their numeric format: ● Windows uses binary (numbers that are a power of 2). ● Linux uses decimal (numbers that are a power of 10). For example: 2^10 is 1,024. The closest decimal number is 10^3 or 1,000.
● The QLC driver does not support selective LUN configuration. 7. Known Issues and Workarounds This section describes the known issues and workarounds (if any) for SANsurfer FC HBA CLI according to operating system. 7.1 Windows 7.1.1 Unsigned Windows Driver Update Issue: When performing a driver update on unsigned Windows drivers, the OS displays a confirmation dialog box. The dialog box appears in front of SANsurfer (focus). Workaround: None 7.1.
● HBA beacon ● Target / LUN list Workaround: None 7.2 Linux 7.2.1 Information Left After Deleting Persistent Configuration Issue: Deleting the persistent configuration does not remove the options qla2x00 ConfigRequired=1 ql2xuseextopts=1 string from the /etc/modules file. Workaround: To fully delete all persistent data, you must manually edit this file . 7.2.2 Non-Failover Driver Issue: Under Linux, when running with a non-failover driver, the ConfigRequired=1 parameter is ignored.
7.2.5 Warning Messages on Startup Issue: When launching SANsurfer FC HBA CLI, the following warning messages may appear on the console: qla2xxx qla2xxx qla2xxx qla2xxx qla2xxx qla2xxx qla2xxx 0000:01:02.0: 0000:01:02.0: 0000:01:02.1: 0000:01:02.1: 0000:01:02.0: 0000:01:02.1: 0000:01:02.0: Unable Unable Unable Unable Unable Unable Unable to to to to to to to read read read read read read read SFP SFP SFP SFP SFP SFP SFP data data data data data data data (102/a0/0). (102/a0/0). (102/a0/0). (102/a0/0).
Workaround: None TIP: When writing scripts, use the adapter WWPN instead of adapter number. 7.4.2 Unable to Save Configuration Issue: Under Mac OS X, non-root users with admin privilege cannot save Target Persistent Binding or Selective LUN configuration. Workaround: Use the sudo command. This allows you to run SANsurfer as the superuser or another user. For example: # sudo scli [options] By default, sudo requires that users authenticate themselves with a password.
8. 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 E-mail: support@qlogic.com Go to Top © Copyright 2009. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation.
