QConvergeConsole Command Line Interface QLogic Corporation All rights reserved
Table of Contents 1 2 3 4 5 6
7 8
Package Contents Hardware Requirements OS Support Supported Features Using the QCC CLI Additional Notes 6.1 Features Not Available When Running FCoE Windows Driver with NPIV Enabled 6.2 Features Not Available When Running FCoE Sysfs Inbox Driver 6.3 Warning Messages on Startup 6.4 VLAN and Teaming Driver Support 6.5 VLAN and Teaming Save and Restore Features 6.6 8200 Series Adapters—Internal and External Loopback Diagnostics Features 6.7 8200 Series Adapters (iSCSI) Features Currently Not Supported 6.8 QLogic iSCSI IOCTL Module Required on Linux Operating Systems 6.9 Before Installing/Upgrading Drivers 6.10 OS Hot Fix for Performance Issues on Windows Server 2008 R2 6.11 RHEL 6.0 Inbox iSCSI Driver Information 6.12 RHEL 6.0 Installation of 32-bit Compatibility Libraries Known Issues and Workarounds Contacting Support
1 Package Contents The QConvergeConsole Command Line Interface (QCC CLI) package contains the following files: File Name
Description
Windows® x64 qaucli.exe
QCC CLI – main executable
enable_disable_x64.exe
QCC CLI Support EXE
ncli.dll
Networking protocol DLL
icli.dll
iSCSI protocol DLL
Fibre Channelapi_x64.dll
Fibre Channel protocol DLL
QConvergeConsole Command Line Interface Readme
Page 1 of 7
File Name
Description
ql_p3p_npar.dll
NPAR DLL
fcscli-exitcodes.txt
Fibre Channel supporting TXT
Readme.txt
Readme TXT
npiv.bat
Fibre Channel mof file installer
iscli.bat
iSCSI BAT
netscli.bat
Networking BAT
qldiag.bat
QLDiag BAT
scli.bat
Fibre Channel BAT
iscli.cfg
iSCSI trace configuration
netscli.cfg
Networking trace configuration
qaucli.cfg
QCC CLI trace configuration
drivers
DIR - Networking/IM driver files
nvramdefs
DIR - NVRAM defines
VlanTeaming
DIR - 8100 Series VLAN/Teaming Driver files
—
Additional various DLL, BAT, and properties files
Windows x86 qaucli
QCC CLI – main executable
enable_disable_x32.exe
QCC CLI Support EXE
ncli.dll
Networking protocol DLL
icli.dll
iSCSI protocol DL
fcapi_x32.dll
Fibre Channel protocol DLL
ql_p3p_npar.dll
NPAR DLL
fcscli-exitcodes.txt
Fibre Channel supporting TXT
Readme.txt
Readme TXT
npiv.bat
Fibre Channel mof file installer
iscli.bat
iSCSI BAT
netscli.bat
Networking BAT
qldiag.bat
QLDIag BAT
scli.bat
Fibre Channel BAT
iscli.cfg
iSCSI trace configuration
netscli.cfg
Networking trace configuration
qaucli.cfg
QCC CLI trace configuration
drivers
DIR - Networking/IM driver files
nvramdefs
DIR - NVRAM define
VlanTeaming
DIR – 8100 Series VLAN/Teaming Driver files
—
Additional various DLL, BAT, and properties files
Linux® qaucli
QCC CLI – main executable
scli
Fibre Channel SHELL
iscli
iSCSI SHELL
netscli
Networking SHELL
readme.txt
QCC CLI - Readme
iscli.cfg
iSCSI trace configuration
QConvergeConsole Command Line Interface Readme
Page 2 of 7
File Name
Description
netscli.cfg
Networking trace configuration
qaucli.cfg
QCC CLI trace configuration
nvramdefs
DIR - NVRAM defines
agent.properties
QCC CLI configuration
—
Additional various properties files
2 Hardware Requirements The QCC CLI requires the following minimum hardware:
One or more of the following QLogic adapters: 2400 and 2500 Series Fibre Channel Adapters 3200 Series Intelligent Ethernet Adapters 8100 and 8200 Series Converged Network Adapters
Single- or multi-processor server or workstation Pentium® II class 300MHz, 64MB RAM, 1MB disk space
3 OS Support The QCC CLI runs on the following operating system (OS) platforms: Operating Systems OS Name Windows Server 2008 Red Hat® RHEL AS/ES 6.0 Red Hat RHEL AS/ES 5.6/5.5 Novell® SLES 11 SP1 Novell SLES 10 SP3/SP4
OS Type
Hardware Platform
32-bit
—
64-bit
—
32-bit
x86
64-bit
x64
32-bit
x86
64-bit
x64
32-bit
x86
64-bit
Intel 64, AMD64
32-bit
x86
64-bit
Intel 64, AMD64
NOTE: For specific OS service packs (SPs) and updates, refer to the descriptions where this software version is posted on the QLogic Web site: http://driverdownloads.qlogic.com/
4 Supported Features QCC CLI can configure adapters with the following protocols:
Networking iSCSI Fibre Channel/Fibre Channel over Ethernet (FCoE)
For details on the supported features, see the QConvergeConsole Command Line Utility User's Guide. QConvergeConsole Command Line Interface Readme
Page 3 of 7
5 Using the QCC CLI The QConvergeConsole Command Line Utility User's Guide provides procedures for installing, starting, and removing the QCC CLI. It also provides detailed explanations of command line options. You can download a copy of this document from the driver download page for your adapter at QLogic's Driver Downloads/Documentation Web page: http://driverdownloads.qlogic.com/
6 Additional Notes 6.1
Features Not Available When Running FCoE Windows Driver with NPIV Enabled
When running the FCoE driver with NPIV enabled on Windows, the following features are not available with virtual port:
Adapter parameters settings Adapter parameters restore default Flash update from file Flash save to file Adapter parameters update from file Adapter parameters save to file Adapter parameters update from templates Target link speed Boot device settings Driver settings Adapter beacon Target/LUN list
6.2
Features Not Available When Running FCoE Sysfs Inbox Driver
When running the FCoE Sysfs Inbox Driver on a Linux OS, the following features are not available:
Persistent binding Selective LUN Adapter port statistics Driver settings
6.3
Warning Messages on Startup
When launching QCC 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) (102/a0/0) (102/a0/0) (102/a0/0)
The FCoE driver displays these messages when it is unable to read SFP data. You can safely ignore them.
QConvergeConsole Command Line Interface Readme
Page 4 of 7
6.4 VLAN and Teaming Driver Support The QConvergeConsole CLI’s VLAN & Teaming features are not compatible with the older VLAN and Teaming drivers distributed with the “SANsurfer Converged Network Adapter Networking CLI” versions 1.0.00.01.10 and earlier. To use the QConvergeConsole CLI’s VLAN & Teaming features, this old VLAN and Teaming driver must be removed and the newer VLAN and Teaming driver must be installed. This newer driver is available in the latest version of the QLogic “Windows SuperInstaller.”
6.5 VLAN and Teaming Save and Restore Features The QConvergeConsole CLI’s VLAN & Teaming feature to save and restore VLAN and Teaming configuration uses a file format that is only valid for the QConvergeConsole CLI and is not compatible with any other applications at this time.
6.6 8200 Series Adapters—Internal and External Loopback Diagnostics Features At this time the internal and external loopback features are not supported on the 8200 adapter series for iSCSI, FCoE, or NIC protocols.
6.7 8200 Series Adapters (iSCSI) Features Currently Not Supported At this time the following features are not supported for the 8200 adapter series with the iSCSI protocol:
Retrieval of the firmware coredump record is not supported. Configuration of the Converged Network Adapter level parameters is not supported, except for the Converged Network Adapter level alias. Configuration of port (duplex, flow control, link speed, DCBX) parameters is not supported.
6.8 QLogic iSCSI IOCTL Module Required on Linux Operating Systems To discover 8200 Series Adapter iSCSI ports on Linux OSs, a QLogic iSCSI Linux IOCTL module must be installed and loaded. This IOCTL module, qisioctl, is included in the iSCSI Linux driver packages posted to the QLogic Web site. Use the command lsmod | grep qis to confirm that the IOCTL module, qisioctl, is loaded. If this module is not loaded, then use the command modprobe -v qisioctl to load the module.
6.9 Before Installing/Upgrading Drivers The QConvergeConsole command line interface (QCC CLI) must be closed before installing or upgrading the FCoE, NIC, or iSCSI drivers.
6.10 OS Hot Fix for Performance Issues on Windows Server 2008 R2 Poor performance has been observed on some computers that have Non-Uniform Memory Access (NUMA)-based processors and are running Windows Server 2008 R2. This issue occurs for applications with threads that request a large amount of memory. A correction to
QConvergeConsole Command Line Interface Readme
Page 5 of 7
this problem is available in Windows Server 2008 R2 SP1. If an upgrade to SP1 is not possible, then a hot fix is available at: http://support.microsoft.com/default.aspx?scid=kb;en-US;2155311
6.11 RHEL 6.0 Inbox iSCSI Driver Information On RHEL6.0, the inbox iSCSI driver does not have the interfaces to support the QConvergeConsole GUI or QConvergeConsole CLI applications. Download the RHEL6.0 outof-box iSCSI driver and QConvergeConsole applications from the QLogic Website.
6.12 RHEL 6.0 Installation of 32-bit Compatibility Libraries The installation sequence is: 1. Select RHEL6.0-20100805.0-Server-x86_64-DVD1.iso to install the system (Kernel version: 2.6.32-59.el6.x86_64). 2. Choose installation with Basic Video driver. 3. Select Basic storage device. 4. Install software for software development work machines and extra install compatibility libraries. List of compatibility library RPMs:
Compat-db-4.6.21-15.el6,x86_64 Compat-expat1-1.95.8-8.el6.x86_64 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. Make sure iptables/firewall is disabled. 6. Install the QConvergeConsole CLI. 7. Install the following library RPMs in sequence. libXau-1.0.5.1.el6.i686.rpm libxcb-1.5.1el6.i686.rpm libX11-1.3.2.el6.i686.rpm libXext.1.1.3.2.el6.i686.rpm libXp.1.0.0.15.1.el6.i686.rpm 8. Run the QConvergeConsole CLI application.
QConvergeConsole Command Line Interface Readme
Page 6 of 7
7 Known Issues and Workarounds In some scenarios on SLES 11 SP1, the iSCSI ports may not be discovered and the following error message may be seen in the system error log: FATAL: module '/lib/modules/2.6.32.27-0.2-default/extra/qlgc-qla4xxx/qisioctl.ko' is unsupported use --allow-unsupported or set allow_unsupported_modules to 1 in /etc/modprobe.d/unsupported-modules. Workaround:
Add the Module.supported file with the following contents in the qla4xxx directory to include qisioctl as a supported module for SLES11 SP1: qla4xxx.ko external qisioctl.ko external
Rebuild the modules after inclusion of the Module.supported file. The qisioctl module should be loaded after loading the qla4xxx driver and before starting the QConvergeConsole CLI by issuing the following command: modprobe qisioctl
NOTE: For details on building and installing the driver and IOCTL module, refer to the Linux driver readme.
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:
[email protected] Go to Top
© Copyright 2011. 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.
QConvergeConsole Command Line Interface Readme
Page 7 of 7