Linux SuperInstaller

QLogic Corporation All rights reserved

Table of Contents
1 2 3 4 Package Contents OS Support Supported Features Using the Linux SuperInstaller 4.1 Command Line Options 4.2 Running Linux SuperInstaller (qlinstall) Commands Known Issues Additional Notes Contacting Support

5 6 7

1 Package Contents
The QLogic Linux SuperInstaller is an easy-to-use utility that can be used to install the following components for the 2400/2500/8100/8200/3200 Series Adapters: FC-FCoE, iSCSI, and Ethernet Networking drivers QConvergeConsole command line interface (CLI) Management Tool and SNIA HBA APIs for 2400/2500/8100/8200 (FC-FCoE functions) FC-FCoE, iSCSI, and Ethernet Networking Management Agents to enable remote access using QConvergeConsole (GUI) Management Tool Linux Tools (scripts) for commonly performed storage networking tasks

The Linux SuperInstaller package contains the following files:

File Name Description Script to install FC-FCoE, iSCSI, and Ethernet Networking Drivers for 2400/2500/8100/3200/8200 Series Adapters Vendor device mapping file RPC command and FC-FCoE, iSCSI, and Networking Management Agents QConvergeConsole Command Line (CLI) Management tool SANsurfer iSCSI CLI tool for 4000 Series iSCSI Adapters

qlinstall ql-pci.ids agents/ qaucli/ iscli/

LinuxTools/ql-dynamicScans for newly added LUNs tgt-lun-disc-2.21.tgz LinuxTools/ql-set-cmd- Allows you to set the timeout on the devices connected to the QLogic timeout-1.8.tgz Fibre Channel-FCoE Adapters Linux SuperInstalller Page 1 of 7

LinuxTools/ql-lunstate-online-1.7.tgz LinuxTools/ql-hbasnapshot-1.15.tgz LinuxTools/ql-hbacollect-1.11.tgz Readme.txt

Allows you to change the state of the LUNs connected to the QLogic adapter from offline to online/running Works on sysfs to display details about the QLogic adapter attached to the system Collects all the system information and configuration This readme file

2 OS Support
The adapter driver installation script runs on the following Linux operating system (OS) platforms:
Operating Systems OS Name Red Hat RHEL 5.4/5.5 Red Hat RHEL 6.0 Novell SLES 10 SP3 Novell SLES 11 Novell SLES 11 SP1 OS Type 32-bit, 64-bit 32-bit, 64-bit 32-bit, 64-bit 32-bit, 64-bit 32-bit, 64-bit Hardware Platform Intel x86, Intel64, AMD64 Intel x86, Intel64, AMD64 Intel x86, Intel64, AMD64 Intel x86, Intel64, AMD64 Intel x86, Intel64, AMD64

NOTE: For specific service packs (SP) and OS updates, refer to the descriptions where this software version is posted on the QLogic Web site: http://driverdownloads.qlogic.com

3 Supported Features
The Linux SuperInstaller (qlinstall script) supports the following features: Supports Fibre Channel, iSCSI, Intelligent Ethernet Adapters, and Converged Network Adapters. Builds, installs, and loads the driver with the configuration module for Fibre Channel/iSCSI/Converged Network Adapters on the 2.6.x kernel, based on the QLogic adapter model installed in the system. Installs the driver before installing the Fibre Channel/iSCSI/Intelligent Ethernet Adapters/Converged Network Adapters. Installs and updates the driver in the RAMdisk. Performs a device discovery and displays devices found. Provides the following command line options: o o o Invokes the device discovery at a later stage. Rebuilds the RAMdisk to exclude or include the QLogic adapter driver. Unload or load the driver. Page 2 of 7

Linux SuperInstalller

4 Using the Linux SuperInstaller

The following sections provide script options and examples: 4.1 Command Line Options 4.2 Running Linux SuperInstaller (qlinstall) Commands

4.1 Command Line Options

The following options are available: -i | --install [-ia|--install_agent] This option checks for the pre-built binaries for the running OS arch combination and installs it. If a pre-built binary is not found, the binary is generated from the source RPM for the running kernel. To install the qlremote/iqlremote/netlqlremote agent (which is used with SANsurfer HBA Manager and QConvergeConsole Management Tool (GUI)), use -ia or -install_agent. -ifc | --install_fc [-a]"

This option checks for and installs the pre-build binaries for the running OS arch for the Fiber Channel/FCoE driver. If a pre-built binary is not found, the binary is generated from the source RPM for the running kernel. To install the qlremote, use the -ifc -a option. -inic | --install_nic [-a]"

This option checks for and installs the pre-build binaries for the running OS arch for the Ethernet Networking driver. If a pre-built binary is not found, the binary is generated from the source RPM for the running kernel. To install the netqlremote, use the -inic -a option -iiscsi | --install_iscsi [-a]"

This option checks for and installs the pre-build binaries for the running OS arch for the iSCSI driver. If a pre-built binary is not found, the binary is generated from the source RPM for the running kernel. To install the iqlremote, use the -iiscsi -a option -up | --upgrade This option installs the driver source, builds the driver, and loads the driver on the next OS boot. It creates the RAMdisk to load the QLogic adapter driver at boot time. NOTE: Do not use this option with the -i option. Linux SuperInstalller Page 3 of 7

dl | --device_list This option displays the devices connected on all the adapters. -u | --uninstall [ -l|--loaded] This option uninstalls the driver. To keep the current drivers loaded during the uninstall process, specify -l or -loaded. -ufc | --uninstall_fc [ -a ] This option uninstalls the Fibre Channel/FCoE driver with agent, if the -a option is specified. -unic | --uninstall_nic [ -a ] This option uninstalls the Ethernet Networking driver with agent, if the -a option is specified. -uiscsi | --uninstall_iscsi [ -a ] This option uninstalls the iSCSI driver with agent, if the -a option is specified. -l | --load [module-name] This option detects the installed adapters in the system and loads the driver for each installed adapter. It unloads any older driver versions before loading the latest drivers. If this option includes a module name, it loads only that module. -ul | --unload [module-name] This option unloads all drivers for the installed adapters. -br | --buildramdisk [--include | --exclude] [module-name] This option, by default, builds the RAMdisk again. It stores a backup of the original RAMdisk in the /boot directory with the time stamp mmddyy-hhmmss. It makes a copy of the modprobe file and stores it in the /usr/src/qlogic/<driver ver-rpm release>/backup directory with the time stamp mmddyy-hhmmss. This option also allows you to include or exclude the QLogic driver. To exclude or include a module, you must specify the module name. Options: --exclude, -ex --include, -in iq | --install_qaucli This option installs QConvergeConsole CLI (qaucli). -nq | --no_qaucli Linux SuperInstalller Page 4 of 7

This option skips the qaucli installation. -iis | --install_iscli This option installs SANsurfer iSCSI HBA CLI. nis | --no_iscli This option skips the iscli installation. -al | --autoload [options] This option enables or disables the autoload script. Options: -e - enable the script -d - disable the script -h | --help | -? This option displays the help message.

4.2 Running Linux SuperInstaller (qlinstall) Commands

This section describes how to perform tasks using the qlinstall command options at the command line with a root or superuser account. To start the installation script, type: # ./qlinstall To display help for the command line options, type: # ./qlinstall h To run the installation script, type one of the following: # ./qlinstall # ./qlinstall i # ./qlinstall install To install the driver without an existing QLogic adapter, type: # ./qlinstall force To install the driver without unloading and loading the current drivers, type: # ./qlinstall -up

Linux SuperInstalller

Page 5 of 7

To install driver and agent, type one of the following: # # # # # ./qlinstall ./qlinstall ./qlinstall ./qlinstall ./qlinstall -i ia -i a -ifc a -inic a -iiscsi a

To display the device list, type: # ./qlinstall dl To uninstall driver and agent, type one of the following: # # # # # # ./qlinstall ./qlinstall ./qlinstall ./qlinstall ./qlinstall ./qlinstall u uninstall -u a -ufc a -unic a -uiscsi a

To load the driver, type one of the following: # ./qlinstall l # ./qlinstall load To load a specific module, for example, qla2xxx, type: # ./qlinstall -l qla2xxx To unload the driver, type one of the following: # ./qlinstall ul # ./qlinstall unload To unload a specific module, for example, qla2xxx, type: # ./qlinstall -ul qla2xxx To build RAMdisk, type one of the following: # ./qlinstall br # ./qlinstall buildramdisk To exclude the QLogic module from RAMdisk, type: # ./qlinstall -br ex To include the QLogic module from RAMdisk, type: # ./qlinstall -br in

Linux SuperInstalller

Page 6 of 7

To exclude or include a specific module, specify the module name, for example: # ./qlinstall -br -in qla2xxx To run CLI tools, type one of the following: # ./qlinstall iq # ./qlinstall iis

5 Known Issues
None

6 Additional Notes
The installer package also provides Linux tools in the LinuxTools directory. To use these tools, change to the LinuxTools directory, and then run the following command to uncompress all Linux tools: # ./uncompress_all.sh

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 E-mail: [email protected] Go to Top
Copyright 2010. 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.

Linux SuperInstalller

Page 7 of 7