emc linux jan2010
Post on 07-Apr-2018
222 Views
Preview:
TRANSCRIPT
-
8/6/2019 EMC Linux Jan2010
1/202
EMC Corporation
Corporate Head qua rters:
Hop kinton, MA 01748-91031-508-435-1000www.EMC.com
EMC Host Connectivity with QLogic
Fibre Channel and iSCSI Host Bus Adapters(HBAs) and Fibre Channel over Ethernet
Converged Network Adapters (CNAs)for the Linux Environment
P/ N 300-002-803REV A13
-
8/6/2019 EMC Linux Jan2010
2/202
EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t2
Copyright 20012010 EMC Corp oration. All rights reserved .
Published Janu ary, 2010
EMC believes the information in this publication is accurate as of its pu blication d ate. The information issubject to change w ithout n otice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NOREPRESENTATIONS OR WARRANTIES OF AN Y KIND WITH RESPECT TO THE INFORMATION IN THISPUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHAN TABILITY ORFITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and d istribution of any EMC software described in this pu blication requ ires an app licablesoftware license.
For the most u p-to-date listing of EMC prod uct nam es, see EMC Corporation Tradem arks on EMC.com. Forthe m ost up-to-date regulatory document for your prod uct line, go to the EMC Powerlink w ebsite.
All other trad emarks used herein are the p roperty of their respective owners.
-
8/6/2019 EMC Linux Jan2010
3/202
EMC Host Conne c tivity w ith QLog ic FC a nd iSCSI HBAs a nd FCoE CNAs for the Linux Environm ent 3
Preface ............................................................................................................................. 9
Chapter 1 Introduction
Purpose of this document................................................................ 14Host connectiv ity .............................................................................. 14
Fibre Chan nel ..............................................................................14
Fibre Channel over Ethernet .....................................................14
iSCSI..............................................................................................15
Boot device support .......................................................................... 16
Zoning ................................................................................................ 17
FC and FCoE................................................................................17
iSCSI............................................................................................. 17EMC storage array-specific settings............................................... 18
Chapter 2 Installation Steps
Prerequ isites for first-tim e in sta llation .......................................... 20
Summary of installation steps......................................................... 22
Installing the ad ap ter ....................................................................... 25
Matching the adap ter w ith the correct PCI slot .....................26
Chapter 3 Installing and Configuring the BIOS Settings
Verifying and configu ring the BIOS sett ings ................................ 34
Verifying the correct BIOS version...........................................34
Up grad ing the ad ap ter BIOS ....................................................35
EMC recomm end ed ad ap ter BIOS sett ings ............................37
EMC recommend ed NVRAM settings for Linu x...................37
Contents
-
8/6/2019 EMC Linux Jan2010
4/202
EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t4
Contents
Manu ally setting th e topology for QLogic Fibre Channel
ad ap ters .............................................................................................. 41
Manu ally setting th e data rate for QLogic Fibre Channel
ad ap ters .............................................................................................. 42
Chapter 4 Installing and Configuring the Linux Host with theQLogic Driver
Int rod uction ....................................................................................... 44
QLogic SANsu rfer and SANsurfer CLI......................................... 45Fibre Channel and FCoE in kernel d river versions ..................... 47
Supported in kernel dr iver versions ........................................ 47
Installation instru ctions for th e in kern el QLogic driver
for Linu x 2.4.x kern el ................................................................. 50
Installation Instru ctions for th e in kern el QLogic driver
in Linux 2.6.x kernels ................................................................. 52
Fibre Chan nel and FCoE out of kernel dr iver versions .............. 56
Supported ou t of kernel dr iver ver sions .................................56Installation instru ctions for th e out of kernel QLogic
driver ............................................................................................57
Uninstallation m ethods for the QLogic v7.xx.xx/ v8.xx.xx
driver ............................................................................................73
QLogic v7.x and v8.x series d river pa ram eters ...................... 75
iSCSI in kernel driver versions ....................................................... 85
iSCSI su pported in kernel dr iver versions ..............................85
Installation instru ctions for th e in kern el QLogic driverin Linux 2.6.x kernels ................................................................. 86
iSCSI out of kernel d river versions ................................................ 90
iSCSI su pp orted out of kernel d river versions ....................... 90
Installation instru ctions for th e out of kernel QLogic
driver ............................................................................................91
Installing the Linu x v2.4.x host and the QLogic v3.x-
Series iSCSI HBA driver ............................................................ 91
Installing the Linu x v2.6.x host and the QLogic v5.x-Series iSCSI HBA driver .......................................................... 101
Chapter 5 Updating the CEE/ Menlo or iSCSI Firmware
Upd ating the QLogic CEE / Menlo firmw are for FCoE
ad ap ters ............................................................................................ 124
Updating the QLogic firm ware for iSCSI adap ters ................... 125
-
8/6/2019 EMC Linux Jan2010
5/202
5EMC Host Conne c tivity w ith QLog ic FC a nd iSCSI HBAs a nd FCoE CNAs for the Linux Environm ent
Contents
Chapter 6 Connecting to the Storage
Zoning and connection plann ing in a Fibre Channel or FibreChann el over Ethernet environ ment ............................................ 128
Plann ing proced ure ..................................................................128
Establishing connectivity to the storage array......................128
Zoning and connection p lanning in an iSCSI environment...... 129
Configuring the Q LA40xx-Series H BA to d iscover iSCSI
targets................................................................................................ 130
Configur ing p ersistent bind ing for th e Linux QLogic iSCSI
HBA................................................................................................... 131Configuring persistent binding using SANsurferCLI.........132
Unconfiguring persistent binding using SANsur ferCLI.....134
Chapter 7 Configuring a Boot Device on an EMC Storage Array
Int rod uction ..................................................................................... 138
Cautions an d restrictions for booting from EMC storage
ar ray .................................................................................................. 139Symm etrix-specific cau tions and restr ictions ...................... 139
CLARiiON-specific cautions and restrictions...................... 139
Limitat ion s ....................................................................................... 141
Com mon limitations .................................................................141
Symmetr ix-specific limitations ...............................................142
CLARiiON-specific limita tions ...............................................143
Configuring a Symm etrix boot device for FC or FCoE ............. 144
Preparing the Symmetrix storage array.................................144Prepar ing the host .....................................................................144
Configuring the QLogic BIOS for SAN boot.........................145
Configuring a CLARiiON boot d evice for FC or FCoE ............. 147
Preparing the CLARiiON storage array ................................147
Prepar ing the host .....................................................................147
Configuring the QLogic BIOS for SAN boot.........................148
Installing the Linux operating systems with out of kernel
drivers onto a boot device using FCoE Adap ters ....................... 151RHEL 5 OS SAN -boot installation with QLogic FCoE
ad ap ters ......................................................................................151
SLES10 OS SAN -boot inst allation with Q Logic FCoE
ad ap ters ......................................................................................152
SLES 11 OS SAN -boot insta llation w ith QLogic FCoE
ad ap ters ......................................................................................153
Configuring a Symm etrix boot d evice for iSCSI 3.x .................. 154
Preparing the Symmetrix storage array.................................154
Prepar ing the host .....................................................................154
-
8/6/2019 EMC Linux Jan2010
6/202
EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t6
Contents
Configuring the QLogic BIOS for SAN boot ........................155
Configuring a CLARiiON boot device for iSCSI 3.x ................. 158
Preparing the CLARiiON storage array ................................ 158
Prep aring th e host .................................................................... 158
Configuring the QLogic BIOS for SAN boot ........................159
Installing on to the boot d evice w ith the QLogic HBA v3.x-
Series driver ..................................................................................... 162
How to build a Device Driver Update Disk (DD-DISK).....162
Up grad ing the kern el ............................................................... 169
Configuring a Symmetrix boot device for iSCSI 5.x.................. 170Preparin g the Sym metrix storage array ................................ 170
Prep aring th e host .................................................................... 170
Configuring the QLogic BIOS for SAN boot ........................171
Configuring a CLARiiON boot device for iSCSI 5.x ................. 174
Preparing the CLARiiON storage array ................................ 174
Prep aring th e host .................................................................... 174
Configuring the QLogic BIOS for SAN boot ........................175
Installing on to the boot d evice w ith the QLogic HBA v5.x-Series driver ..................................................................................... 178
Chapter 8 Additional Notes
Ethernet conn ectivity over the CNA............................................ 180
Device reconfiguration p rocedu res for FC and FCoE ............... 181
Device reconfigura tion p rocedu res for the iSCSI 3.x driver ..... 182
Rebooting th e host .................................................................... 182Unload ing and reloading the modu lar QLogic dr iver ....... 182
Device reconfigurat ion procedu res for the iSCSI 5.x dr iver..... 184
Rebooting th e host .................................................................... 184
Unload ing and reloading the modu lar QLogic dr iver ....... 184
Ad ap ter information for RHEL5, SLES10, and SLES 11............ 187
SN IA API for th ird-party softw are (EMC ControlCenter
an d Solu tion Enabler )..................................................................... 188
OS upgrade from sup porting out of kernel driver to OSversion support ing in kernel d river ............................................. 189
Rebooting th e host .................................................................... 189
Unload ing and reloading the modu lar QLogic dr iver ....... 189
Device reconfigu rat ion: Device nu mbering ................................ 192
HPQ server-sp ecific note ............................................................... 193
(CLARiiON Only) d isconn ected ghost LUNs ............................ 194
-
8/6/2019 EMC Linux Jan2010
7/202
7EMC Host Conne c tivity w ith QLog ic FC a nd iSCSI HBAs a nd FCoE CNAs for the Linux Environm ent
Contents
Appe ndix A Setting Up External Boot for IBM Blade Server HS40
(8839)Configure HS40 BladeCenter server to boot from external
ar ray .................................................................................................. 196
Appendix B Special Instructions
CLARiiON CX200 direct-connect d ua l-host Oracle9i RAC
or RHEL 2.1 Cluster Manager cluster configura tions w ith
QLA234x adapters........................................................................... 198Setting the FC-AL loop ID for CLARiiON CX200 direct-
connect Oracle9iRAC and RHEL 2.1 Cluster Manager
configura tions with QLogic QLA234x-Series adapters ............. 199
Index .............................................................................................................................. 201
-
8/6/2019 EMC Linux Jan2010
8/202
EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t8
Contents
-
8/6/2019 EMC Linux Jan2010
9/202
EMC Host Conne c tivity w ith QLog ic FC a nd iSCSI HBAs a nd FCoE CNAs for the Linux Environm ent 9
Preface
As part of an effort to improve and enhance the performance and capabilities
of its product line, EMC from time to time releases revisions of its hardware
and software. Therefore, some functions described in this document may not
be supported by all revisions of the software or hardware currently in use.For the most up-to-date in formation on product features, refer to your
product release notes.
If a product does not function properly or does not function as described in
this document, please contact your EMC representative.
This guide describes the features and setup procedu res for Linux
hosts with QLogic host bus ad apters (HBAs) and converged netw ork
adapters (CNAs) to EMC Symm etrix and CLARiiON Storage Array
systems.
Audience This guide is intend ed for use by storage adm inistrators, systemprogramm ers, or operators w ho are involved in acquiring, managing,
or operating Symmetrix, CLARiiON, and host d evices.
Readers of this guide are expected to be fam iliar with the following
topics: Symm etrix or CLARiiON system op eration
Linux operating environment
QLogic adapters and drivers
EMC Support Matrix For the most up -to-date information, always consult theEMC SupportMatrix(ESM), available through E-Lab Interoperability Navigator
(ELN) a t: http:/ / elabnavigator.EMC.com, und er the PDFs andGuides tab.
https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
10/202
10 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Preface
Relateddocumentation
The following related documen ts are available on Powerlink:
EMC Host Connectivity Guide for Linux
EMC Linux iSCSI Attach Release Notes
EMC N etworked Storage Topology Guide
For information on N avisphere, refer to the Nav isphere
Management software docum entation in the Documentation
Library on EMC Powerlink at http:/ / Powerlink.EMC.com.
Conventions used inthis document
EMC uses th e following conventions for special notices.
Note: A note p resents information that is important, but not hazard -related.
IMPORTANT!An important notice contains information essential to operation of
the sof tware.
CAUTION!A caution contains information essen tial to avoid data loss or
damage to the system or equipment.
Typographica l conventions
EMC uses the following typ e style conventions in this docum ent:Normal Used in running (nonprocedural) text for:
Names of interface elements (such as names of windows,dialog boxes, buttons, fields, and menus)
Names of resources, attributes, pools, Boolean expressions,buttons, DQL statements, keywords, clauses, environmentvariables, filenames, functions, utilities
URLs, pathnames, filenames, directory names, computernames, links, groups, service keys, file systems, notifications
Bold Used in running (nonprocedural) text for:
Names of commands, daemons, options, programs,processes, services, applications, utilities, kernels,notifications, system call, man pages
Used in procedures for:
Names of interface elements (such as names of windows,dialog boxes, buttons, fields, and menus)
What user specifically selects, clicks, presses, or types
http://powerlink.emc.com/http://powerlink.emc.com/ -
8/6/2019 EMC Linux Jan2010
11/202
EMC Host Conne c tivity w ith QLog ic FC a nd iSCSI HBAs a nd FCoE CNAs for the Linux Environm ent 11
Preface
Where to get help EMC supp ort, produ ct, and licensing information can be obtained asfollows.
Product information For docum entation, release notes, softwareup da tes, or for information about EMC prod ucts, licensing, and
service, go to the EMC Pow erlink w ebsite (registration required) at:
http://Powerlink.EMC.com
Technical support For techn ical support , go to EMC Custom er
Service on Powerlink. To open a service request through Pow erlink,
you m ust have a valid su pp ort agreement. Please contact your EMC
sales representative for deta ils about obtaining a valid su pp ort
agreement or to answ er any qu estions about you r account.
Your comments Your suggestions w ill help u s continue to imp rove the accuracy,organization, and overall quality of the user p ublications. Please send
your op inion of this document to:
techpub_comments@EMC.com
Italic: Used in all text (including procedures) for:
Full titles of publications referenced in text
Emphasis (for example a new term)
Variables
Courier Used for:
System output, such as an error message or script
URLs, complete paths, filenames, prompts, and syntax whenshown outside of running text
Courier bold Used for:
Specific user input (such as commands)Courier italic Used in procedures for:
Variables on command line
User input variables
< > Angle brackets enclose parameter or variable values supplied bythe user
[ ] Square brackets enclose optional values
| Vertical bar indicates alternate selections - the bar means or{ } Braces indicate content that you must specify (that is, x or y or z)
... Ellipses indicate nonessential information omitted from theexample
http://powerlink.emc.com/http://powerlink.emc.com/ -
8/6/2019 EMC Linux Jan2010
12/202
12 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Preface
-
8/6/2019 EMC Linux Jan2010
13/202
Introduction 13
1Invisible Body Tag
This document d escribes the procedures for installing an
EMC-app roved Q Logic host bus ad apter (HBA) or converged
network ad apter (CNA) into a Linux host environm ent and
configuring th e host for connection to an EMC storage array overFibre Channel, Fibre Chann el over Ethernet (FCoE), or iSCSI.
Purp ose of th is document ................................................................. 14
Host con nectivity ............................................................................... 14
Boot d evice support ........................................................................... 16
Zoning.................................................................................................. 17
EMC storage arr ay-sp ecific set tings ................................................ 18
Introduction
-
8/6/2019 EMC Linux Jan2010
14/202
14 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Introduction
Purpose of this document
This docum ent is meant to assist in the installation and configuration
of QLogic Fibre Channel host bus ad apters (HBAs) and Fibre
Chann el Over Ethernet (FCoE) converged n etwork adapters (CNAs),
and iSCSI HBAs in Linu x environmen ts. The focus of this docum ent
is to enable the integrated QLogic driver in the Linu x distributions
for EMC-supp orted QLogic adapters or Fibre Chann el adap ters or to
set up Linux hosts u sing the EMC-sup ported dr iver for QLogic
adapters, available from th e EMC-app roved section of the QLogicwebsite.
Host connectivity
Review theEMC Support M atrix or contact your EMC representative
for the latest information on qua lified ad apters, dr ivers, and Linu x
distributions.
Note: EMC does not sup port m ixing d ifferent types of Fibre Chann el adapter
(includ ing different typ es from th e same vend or) in a server.
Fibre Channel
The Fibre Channel adapter d river functions as a device driver layerbelow the stan dard Linu x SCSI adap ter dr iver. The Fibre Channel
interface therefore is transp arent to the Linu x disk administration
system.
Fibre Channel over Ethernet
EMC supp orts the QLogic Fibre Channel over Ethernet (FCoE)Converged Netw ork Ad apter (CNA). FCoE adapters provide a
method to converge both Fibre Channel and Ethernet traffic over a
single physical link to a switch infrastructure w hich manages both
storage (SAN ) and n etwork (IP) connectivity within a single unit.
The benefits of FCoE technology become app arent in large data
centers:
Where dense, rack-mou nted an d blade server chassis exist.
Where physical cable topology simplification is a priority.
https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
15/202
Host c onne c tivity 15
Introduction
In virtualization environmen ts, where several physical storage
and network links are comm only required.
The installation of the QLogic FCoE CNA provides the host w ith an
Intel-based 10 gigabit Ethernet interface (using the existing in-box
drivers), and an QLogic Fibre Channel ad apter interface, which
requires the installation of the sup ported dr iver revision.
Following installation of the prop er dr iver for the FCoE CNA, the
Fibre Chann el interface will fun ction identically to that of a stand ard
QLogic Fibre Channel HBA, as the FCoE simply encapsulates Fibre
Chann el traffic within ethernet frames. As such, FC-based content
within this docum ent also app lies directly to the QLogic FCoE CNAs.
In-depth information about FCoE and its sup ported features and
topologies can be foun d in the "Fibre Chan nel over Ethernet (FCoE)"
chapter of the EMC N etworked Storage Topology Guide, available
throu gh E-Lab Interoperability Navigator at:
http:/ / elabnavigator.EMC.com.
iSCSI
The iSCSI HBA prov ides PCI connectivity to SCSI using the iSCSI
protocol. iSCSI enables the use of IP-based SAN s, wh ich are similar to
Fibre Chann el SAN s. The QLA40xx-Series HBA imp lemen ts the
TCP/ IP and iSCSI protocols on the H BA and offloads the host of any
I/ O p rotocol processing. This type of adap ter is also referred to by
QLogic as an iSCSI Offload Engine (iSOE). Offloading the host frees
the system to p erform other tasks and optimizes system p erformance.
The QLogic iSCSI HBA driver functions a s a dev ice driver layer
below the stand ard Linu x SCSI adapter d river. The iSCSI interface,
therefore, is transp arent to the Linu x disk adm inistration system.
https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
16/202
16 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Introduction
Boot device support
Linu x hosts using Q Logic adap ters have been qualified for booting
from EMC storage array d evices interfaced throu gh Fibre Channel
and iSCSI as specified in the EMC Support M atrix .
The Symm etrix or CLARiiON device that is to contain th e Master
Boot Record (MBR) for the host must have a lower logical unit
nu mber (LUN) than any oth er device visible to the host. This device
should be mapp ed as / dev/ sda by the Linux operating system forthe boot to su cceed from th e device.
Refer to Chap ter 7, Configuring a Boot Device on an EMC Storage
Array, for further information on booting from the SAN.troduction
https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
17/202
Zoning 17
Introduction
Zoning
This section contains general configura tion gu idelines when
connecting a Linux server via Fibre Chan nel or iSCSI to an EMC
storage array.
Note: Multi-initiator zones are not recommended in a Linux fabric
environment.
FC and FCoE
When u sing Linu x hosts in a fabric environment, the zoning mu st be
set up as single initiator and single target zoning. A single
initiator/ single target zone is comp osed of one adapter an d one EMC
storage array port. Storage array ports can be shared among adap ters;
however, each ad apter m ust be in its own zone.
Note: Multi-initiator zones are not recommended in a Linux fabric
environment.
iSCSI
Follow the gu idelines outlined by EMC. Be aware that u sing
imp roper settings m ay cause erratic behavior. In p articular, note the
following:
Each QLogic iSCSI HBA in a Linux server m ust be on a separate
subnet.
A single host can not m ix HBAs and NICs to connect to the same
array or d ifferent arrays.
A single host may n ot attach to an EMC Fibre Channel Array an dan EMC iSCSI Array simultaneously.
QLogic SANsurfer or iscli are required to be installed in ord er to
configure iSCSI HBAs to connect to iSCSI targets
-
8/6/2019 EMC Linux Jan2010
18/202
18 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Introduction
Figure 1 provides a zoning examp le.
Figure 1 Zoning example
EMC storage array-specific settings
Refer to theEMC Host Connectivity Guide for Linux , available at
http:/ / Powerlink.EMC.com, for EMC storage array-specific settings.
sub-network
SPA 0 SPA 1 SPB 0 SPB 1
Arra
HBA or NIC
Linux Server
sub-network
HBA or NIC
http://powerlink.emc.com/http://powerlink.emc.com/ -
8/6/2019 EMC Linux Jan2010
19/202
Insta lla tion Steps 19
2Invisible Body Tag
This chapter outlines the prerequisisites for first-time installation,
offers a sum mary of the installation steps with links to the
app ropriate sections, and p rovides information on installing the
adapter.
Review theEMC Support M atrix for the latest information on
app roved adapters and drivers.
Prerequ isites for first-tim e insta llation ........................................... 20
Summary of inst allat ion step s .......................................................... 22
Installing the adap ter......................................................................... 25
Installation Steps
http://elabnavigator.emc.com/http://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
20/202
20 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Installa tion Steps
Prerequisites for first-time installation
In order to complete a first-time installation of the QLogic adp ater in
your server, you w ill need the following:
Operating system on page 20
QLogic SAN Surfer and SANSurfer CLI on p age 20
BIOS and firmw are on page 20
Linux driver on page 21
Operating system Before the adap ter is installed, the Linu x operating system m ust beinstalled and prop erly configured. Install the Linu x kernel from th e
distribution installation CD by following the procedu re provided in
the d istribution installation gu ide. Partition the boot drive, and select
the packages and services necessary for the host.
IMPORTANT!Include the kernel source/development package and the gcc
compiler tools during the ins tallation. If these tools are not
installed, then the out-of-kernel driver installation may fail and the
driver will not be installed.
QLogic SANSurfer and
SANSurfer CLI
QLogic's SANsurfer program is a GUI-based u tility and the
SANsurfer CLI is a text-based utility. Both applications may beinstalled on any Linux system and used to man age, configure, and
up date th e EMC-app roved QLogic adap ters.
Comp lete docum entation and the EMC-qua lified versions of
SANsurfer and the SANsurfer CLI are available for down load from
the EMC-approved section of the QLogic website at
http:/ / qlogic.com.
Follow the Dow nloads > EMC links to your adap ter for theapp ropriate version.
BIOS and firmware The version of BIOS and firmwa re (adap ter firmware for your iSCSIHBA, and CEE/ Menlo firmw are for your CN A) per theEMC Support
Matrix for your supp orted configuration.
These are available for down load from the EMC-approved section of
the QLogic website at http:/ / qlogic.com.
http://www.qlogic.com/support/oem_emc.asphttp://www.qlogic.com/support/oem_emc.asphttp://elabnavigator.emc.com/http://elabnavigator.emc.com/http://elabnavigator.emc.com/http://elabnavigator.emc.com/http://www.qlogic.com/support/oem_emc.asp -
8/6/2019 EMC Linux Jan2010
21/202
Prerequisites for first-time installation 21
Installa tion Steps
Follow the Dow nloads > EMC links to your ad apter for the
app ropriate v ersion.
Linux driver The Linux driver for your H BA or CNA p er theEMC Support M atrixfor you r su pp orted configuration.
EMC supp orts both in-kernel and ou t-of-kernel drivers.
Note: The installation of the in-kernel driver occurs when you install your
Linu x distribut ion of choice.
Refer to the latestEMC Support M atrixfor your specific Linux
distribution, kernel version, and driver to d etermine whether or not
you n eed to p roceed w ith the following ou t-of-kernel instru ctions.
If your installation requ ires an out of kernel driver, dow nload it from
the EMC-approved section of the QLogic websiteat
http:/ / qlogic.com.
Follow the Dow nloads > EMC links to your ad apter for theapp ropriate v ersion.
http://elabnavigator.emc.com/http://elabnavigator.emc.com/http://elabnavigator.emc.com/http://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
22/202
22 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Installa tion Steps
Summary of installation steps
Table 1describes the procedu res for installing an EMC-app roved
QLogic ad apters into a Linux host and configuring the h ost for
connection to an EMC Storage Array over Fibre Chan nel (FC) or Fibre
Channel over Ethernet (FCoE).
Table 1 Installation steps (page 1 of 3)
Step Instructions For Fibre Channel, refer to For Fibre Channel overEthernet (FCoE), refer to
For iSCSI, refer to
1 Install theadapter .
Installing the adapter on
page 25
Installing the adapter on
page 25
Installing the adapter on
page 25
2 Verify theBIOS version
Verifying the correct BIOSversion on page 34
Verifying the correct BIOSversion on page 34
Verifying the correct BIOSversion on page 34
3 Install the BIOS.
There are three states:
If noversion isinstalled
Upgrading the adapter BIOSon page 35
Upgrading the adapter BIOSon page 35
Upgrading the adapter BIOS onpage 35
If wrongversion isinstalled
Upgrading the adapter BIOSon page 35
Upgrading the adapter BIOSon page 35
Upgrading the adapter BIOS onpage 35
If correctversion isinstalled
Proceed to step 4. Proceed to step 4. Proceed to step 4.
-
8/6/2019 EMC Linux Jan2010
23/202
Summ ary o f insta lla tion steps 23
Installa tion Steps
4 Install the driver.
There are two states:
In kernel For drivers listed in the EMCSupport Matrixas in kerneldrivers, there is no need to install
a driver since the process ofinstalling the operating systemhas already included the driver.
Table 4 on page 47 listssupported QLogic driverversions .
If in kernel, proceed to Step 5.
For drivers listed in the EMCSupport Matrixas in kerneldrivers, there is no need to install
a driver since the process ofinstalling the operating systemhas already included the driver.
Table 4 on page 47 listssupported QLogic driverversions .
If in kernel, proceed to Step 5.
For drivers listed in the EMC
Support Matrix as in kernel
drivers, there is no need to install
a driver since the process of
installing the operating system
has already included the
driver.
Table 7 on page 85 lists
supported QLogic driver
versions.
If in kernel, perform the stepsoutlined in Installationinstructions for the in kernelQLogic driver in Linux 2.6.xkernels on page 86 to disablethe qla3xxx driver then proceedto Step 5.
Out of
kernel
Installation instructions for the
out of kernel QLogic driver onpage 57
Method 2: Installing the QLogic
v7.xx.xx/v8.xx.xx driver via theQLogic installation script onpage 61.
Proceed to either Installation
instructions for the out of kernelQLogic driver on page 91
Table 1 Installation steps (page 2 of 3)
Step Instructions For Fibre Channel, refer to For Fibre Channel overEthernet (FCoE), refer to
For iSCSI, refer to
-
8/6/2019 EMC Linux Jan2010
24/202
24 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Installa tion Steps
5 Install the firmware.
There are two states:
Wrongfirmware
The adapter firmware is part ofthe Linux driver and cannot bealtered..
Proceed to Step 6.
The adapter firmware is part ofthe Linux driver and cannot bealtered.
Updating the QLogic CEE/Menlo firmware for FCoEadapters on page 124
Once corrected, proceed to Step6.
Updating the QLogic firmwarefor iSCSI adapters on page 125
Once corrected, proceed to Step6.
Correct
firmware
Proceed to Step 6. Proceed to Step 6. Once corrected, proceed to Step
6.
6 Connect to thestorage.
Zoning and connection planningin a Fibre Channel or FibreChannel over Ethernetenvironment on page 128
Zoning and connection planningin a Fibre Channel or FibreChannel over Ethernetenvironment on page 128
Zoning and connection planningin an iSCSI environment onpage 129
7 Reconfigurethe device.
Device reconfigurationprocedures for FC and FCoE on
page 181
Device reconfigurationprocedures for FC and FCoE on
page 181
Proceed to either Devicereconfiguration procedures for
the iSCSI 3.x driver on page 182or Device reconfigurationprocedures for the iSCSI 5.xdriver on page 184
Table 1 Installation steps (page 3 of 3)
Step Instructions For Fibre Channel, refer to For Fibre Channel overEthernet (FCoE), refer to
For iSCSI, refer to
-
8/6/2019 EMC Linux Jan2010
25/202
Installing the ad ap ter 25
Installa tion Steps
Installing the adapter
Follow the instructions includ ed w ith your ad ap ter. The adap ter
insta lls into a single slot.
To connect the cable to the ad apter:
1. (Optical cable only) Remove the protective covers on each
fiber-opt ic cable.
2. Plug one end of the cable into the connector on the adapter as
shown in the ap propriate figure in this step. (The hard ware m ight
be rotated 90 degrees clockwise from th e orientation show n.)
Fibre Channel adapter connectivity options include copper
cable with DB9 conn ector, SC op tical, and LC optical cable, as
shown next.
Copper cable with DB9 connector:
SC optical cable:
LC optical cable:
21 3
21 3
I ll i S
-
8/6/2019 EMC Linux Jan2010
26/202
26 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Installa tion Steps
Fibre Channel over Ethernet converged network adapter
(CNA) connectivity op tions include LC optical and Cisco
SFP+, shown next.
LC optical cable:
Cisco SFP+ (Twinax cable)
3. Plug the other end of the cable into a connector on the storage
system or a hub/ switch port.
4. Label each cable to identify the adapter and the
storage/ switch/ hub port to which it connects.
5. After connecting all adap ters in the server, pow er up the server.
Matching the adapter with the correct PCI slot
When choosing an ad apter for your server, it is important to know
wh ich ad apter is compatible with your server's PCI/ PCI-X/ PCI
Express slots. Certain ad apter mod els have specific voltage
requirements or physical limitations that allow them to w ork only in
specific slots.
21 3
Installa tion Steps
-
8/6/2019 EMC Linux Jan2010
27/202
Installing the ad ap ter 27
Installa tion Steps
Servers hav e several different bu s slot types for accepting adap ters:
PCI PCI-X
PCI-X 2.0
PCI-Express
PCIslots can be 32-bit and 64-bit (denoted by their 124-pin or 188-pin
connectors.) These slots have plastic "keys" that prevent certain
ad apters from fitting into them. These keys work with the cutou t
notches in the adap ter edge connector so that only compa tible
ad apters w ill fit into them . This is done because of the voltagecharacteristics of the ad apter. Inserting a 3.3v adapter into a 5v slot
wou ld cause severe dam age to both the adap ter and th e server.
Therefore, the slot keys denote the typ e of voltage provided by the
slot and effectively prevent a voltage incompatible adapter from
being inserted.
Figure 2 shows how PCI slots will app ear with their keys and w hat
type of voltage is provid ed for each slot type.
Figure 2 PCI slot types and voltage key loca tions
Installa tion Steps
-
8/6/2019 EMC Linux Jan2010
28/202
28 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Installa tion Steps
Figure 3 shows th e adap ter edge connectors comp atible with the PCI
slots show n in Figure 2 on page 27. Note adap ter 5, which show s a
un iversal adapter ed ge connector. Universal adap ters are comp atiblewith both 3.3 V and 5 V PCI slots.
Figure 3 Adapter edge connectors
PCI-X(or PCI Extended) slots increase the speed w ith wh ich data
travels over the bus. PCI-X slots appea r identical to a 64-bit PCI slot
keyed for 3.3 V. (Refer to n umber 3 in Figure 2 on page 27 an d
Figure 3.) PCI-X slots are backw ard s compatible with 3.3 V PCIadap ters and u niversal adap ters. Inserting standard PCI adap ters
into PCI-X slots will lower the bu s speed as they cannot take
advantage of the improved performan ce.
PCI-X 2.0 is the next generation of PCI-X buses. PCI-X 2.0 increases
the bus speed again, providing more performance for adap ters.
PCI-X 2.0 slots also ap pea r identical to a 64-bit PCI slot keyed for 3.3
V. (Refer to n umber 3 in Figure 2 an d Figure 3.) PCI-X 2.0 is also fully
backward compa tible w ith 3.3 V PCI and PCI-X.
PCI Express (sometimes noted as PCIe) is a new bus typ e that uses
the existing PCI model, but imp lements it in a faster, serial protocol.
Because of the serial way it transm its data, th e PCI Express bus slot
can be d ifferent sizes depend ing on the th roughpu t it supp orts. PCI
Express slot speeds are expressed in "lanes" and are n ormally shown
as x1, x4, x8, and x16. Each type of slot is a different length (as show n
in Figure 4 on page 29) and ad apter ed ge connectors will also be ofvarying lengths d epending on how man y lanes they require for
Installa tion Steps
-
8/6/2019 EMC Linux Jan2010
29/202
Installing the ad ap ter 29
Installa tion Steps
throu ghpu t. Because of how PCI Express slots are keyed, an x1
adapter can be inserted in all four slot types, as the adap ter will
negotiate with th e slot to d etermine the h ighest mutu ally sup portednu mber of lanes. However, an adap ter requiring x16 lanes will not fit
into a sm aller slot.
Figure 4 PCI Express slots
Figure 5 show s x1, x4, and x16 lane slots aligned on a mainboard . You
can see how the slots are keyed so that low-lane adapters can fit into
larger slots.
Figure 5 PCI Express slots aligned
Installa tion Steps
-
8/6/2019 EMC Linux Jan2010
30/202
30 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
p
QLogic offers adapters for each bus/ slot type available. Table 2
show s each of the EMC-supp orted QLogic ad apters, and th eir
respective slot requirements. Be sure to consu lt both you r server u serguide and QLogic to ensure that the adap ter you wan t to use is
compatible with your server's bus.
Remem ber that som e of the older ad apters are tall (also referred to as
full-height) and m ay not fit into a server w ith a low-profile chassis.
These factors must be considered before imp lementing you r
configuration to avoid unnecessary delays and possible equipment
swaps or returns.
Currently, the QLogic FCoE converged netw ork ad apters (CNAs)
require servers tha t can accommodate full-height, full-length PCIExpress ad apters. Always refer to theEMC Support M atrix for the
Table 2 Slot requirements of EMC-supported QLogic adapters
Adapter model Protocol PCI spec BUS length Power Slot key
QLA2200F FC PCI 2.1 64-bit 3.3V, 5V Universal
QLA200 FC PCI-X 1.0a & PCI 2.2 32-bit 3.3V, 5V 3.3V
QLA210 FC PCI-X 1.0a & PCI 2.2 32-bit 3.3V 3.3V
QLA2310F FC PCI-X 1.0a & PCI 2.2 64-bit 3.3V, 5V Universal
QLA2340LF FC PCI-X 1.0a & PCI 2.2 64-bit 3.3V, 5V Universal
QLA2342LF FC PCI-X 1.0a & PCI 2.2 64-bit 3.3V, 5V Universal
QLE2360 FC PCI Express x4 lane 3.3V n/a
QLE2362 FC PCI Express x4 lane 3.3V n/a
QLA2460 FC PCI-X 2.0a & PCI 2.3 64-bit 3.3V 3.3V
QLA2462 FC PCI-X 2.0a & PCI 2.3 64-bit 3.3V 3.3V
QLE2460 FC PCI Express x4 lane 3.3V n/a
QLE2462 FC PCI Express x4 lane 3.3V n/a
QLE220 FC PCI Express x4 lane 3.3V n/a
QLE2560 FC PCI Express x4 lane 3.3V n/a
QLE2562 FC PCI Express x4 lane 3.3V n/a
QLE8042 FCoE PCI Express x8 lane 3.3V n/a
QLE8140/8142 FCoE PCI Express x4/x8 lane 3.3V n/a
QLE8150/8152 FCoE PCI Express x4/x8 lane 3.3V n/a
Installa tion Steps
http://elabnavigator.emc.com/http://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
31/202
Installing the ad ap ter 31
most u p-to-date information on wh ich servers supp ort these
adapters.
Installa tion Steps
-
8/6/2019 EMC Linux Jan2010
32/202
32 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
3
-
8/6/2019 EMC Linux Jan2010
33/202
Insta lling a nd Co nfigu ring t he BIOS Set tings 33
3Invisible Body Tag
This chap ter describes the procedu res for installing and configur ing
the BIOS settings.
Verifying and configu ring the BIOS sett ings ................................. 34
Manu ally setting th e topology for QLogic Fibre Channelad ap ter s ............................................................................................... 41
Manu ally setting the d ata rate for QLogic Fibre Chann el
ad ap ter s ............................................................................................... 42
Installing and Configuringthe BIOS Settings
Installing a nd Configuring the BIOS Settings
-
8/6/2019 EMC Linux Jan2010
34/202
34 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Verifying and configuring the BIOS settings
After the adap ter is installed, follow these steps d uring system boot
to verify and configure adapter firmw are settings.
To u se SAN surfer or SANsurfer CLI for th is function refer to the
SANsurfer or SANsurfer CLI documentation you have d ownloaded.
Refer to theEMC Support M atrix for requ ired BIOS versions for
qualified adapters.
Verifying the correct BIOS version
You can d etermine the BIOS version at boot time from the QLogic
banner or from th e Fast!Util Options menu.
From the banner Boot the host and w atch for the banner
(shown in the QLA2340 examp le below, w ith the ROM BIOS
version highlighted):
If the banner displays the required version, continue to the
section EMC recomm end ed ad apter BIOS settings onpage 37.
If the banner does not display the required version, upgrade
the firmw are as described u nder the Upgrad ing the adapter
BIOS on p age 35; then p roceed to EMC recommended
adap ter BIOS settings on p age 37.
From the QLogic Fast!Util Options menu:
a. Boot the host. When the QLogic banner appears, pressCTRL-Q to enter Fast!Util.
b . Select Configuration Settings from th e Fast!Util Options
menu.
c. Select Adapter Settings from th e Configuration Settings
menu.
Qlogic Corporation
QLA2312 PCI Fibre Channel ROM BIOS Version 1.42
Copyright Qlogic Corporation 1993-2002 All rights reserved
Press for Fast!UTIL
www.qlogic.com
Installing a nd Configuring the BIOS Settings
https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
35/202
Verifying and c on figuring the BIOS sett ings 35
d . Und er Adapter Settings, note the BIOS version:
If the banner displays the required version, continue to
EMC recomm ended adap ter BIOS settings on p age 37.
If the banner does not display the required version,
up grade the firmware as described u nd er the Upgrading
the adap ter BIOS on p age 35; then p roceed to EMC
recomm ended adap ter BIOS settings on p age 37.
Upgrading the adapter BIOSThe BIOS may be u pgraded using one of the following three
methods:
Method One: Upgrad ing the adap ter BIOS using the N VRAM
file on a DOS bootable floppy on page 35
Method 2: Upgrad ing the ad apter BIOS using QLogic
SANsurfer on page 36
Method 3: Upgrad ing the ad apter BIOS using QLogic SAN surfer
CLI on page 37
Method One: Upgrading the a dapter BIOS using the NVRAM file on a DOS bootable floppy
Follow these steps to upgrade th e QLogic BIOS using th e NVRAM
file on a DOS bootable floppy:
1. Obtain the latest version of the BIOS from the Q Logic website:
a. Access http:/ / ww w.qlogic.com.
b. Click Downloads at the left side of the screen.
c. Click the EMC link below OEM Models .
d. Find the NVRAM file for the adap ter(s) in your system, and
click the associated Download link to save the file.
2. The file is a self-extracting .zip containing the BIOS and N VRAMfiles. Make su re flasu til.exe an d the sou rce files (BIN, DEF, DAT,
and BAT files) are in th e sam e d irectory. EMC-specific settings are
contained in files nam ed emcXXXX.def and emcXXXX.dat w here
XXXX is the mod el nu mber of the ad apter.
These settings files (also referred to as N VRAM setting files)
shou ld also be in the sam e directory with the flash u tility and
source files. Note tha t some versions of BIOS may use differentfilenames d epending on th e version and adap ter model.
Installing a nd Configuring the BIOS Settings
-
8/6/2019 EMC Linux Jan2010
36/202
36 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Be sure to check the read me includ ed with the BIOS files to make
sure you have all of the app ropriate files before proceeding.
a. Insert a diskette into a Microsoft Window s 9x machine.
b. Open any DOS window.
c. At the DOS prompt, format the diskette by entering:
format /s a:
d. At the DOS prompt, change directory (cd) to the location of
the saved zipped file, then extract the file to the d iskette.
Note: The QLogic adapter(s) mu st be installed in th e host before
proceeding.
3. Insert the BIOS up grade installation diskette into the floppy
drive.
4. Reboot the host.
5. After the host has rebooted, a DOS prompt app ears. Type
flasutil /L /F and p ress Enter.
Note: The adapter BIOS upgrad e might take a few minutes.
6. After the upgrade is complete, remove the diskette and reboot the
host. During startup, the QLogic banner should d isplay the new
BIOS version.
Me thod 2: Upgrading the adapter BIOS using QLogic SANsurfer
The SANsurfer GUI may be down loaded from the EMC-approved
section of the QLogic website. To up date the BIOS using th e
SAN surfer CLI, refer to the QLogic provided docum entation on their
website for detailed instru ctions.
To invoke the GUI, run the following comm and from a termina l
window:
/opt/QLogic_Corporation/SANsurfer/SANsurfer &
When u pgrading the BIOS for QLogic 4 GB adapters, the m inimu m
requ ired version of the QLogic SAN sur fer GUI is 2.0.30b52.
When using QLogic QLA40xx-series HBAs, the m inimum required
version of the QLogic SAN surfer GUI is 4.01.00.
Installing a nd Configuring the BIOS Settings
-
8/6/2019 EMC Linux Jan2010
37/202
Verifying and c on figuring the BIOS sett ings 37
Method 3: Upgrading the adapter BIOS using QLogic SANsurfer CLI
The SANsurfer CLI (scli) is installed as part of the qlinstaller or m ay
be dow nloaded from the EMC-app roved section of the QLogicwebsite. To u pd ate the BIOS using the SANsurfer CLI, refer to the
QLogic provid ed d ocumen tation on their website for deta iled
instructions.
To invoke the CLI, run the following command :
/opt/QLogic_Corporation/SANsurferCLI/scli
When up grad ing the BIOS for QLogic 4 GB adapters, the m inimu mrequ ired version of the QLogic SAN sur fer CLI is 1.06.16build23.
When using QLogic QLA40xx-series HBAs, te minimu m required
version of the QLogic SANsur fer CLI is 1.0.30.00.
EMC recommended adapter BIOS settings
EMC requires configu ring the QLogic BIOS settings w ith theEMC-approved NVRAM settings file. This file contains all of the
BIOS settings for the QLogic adapters th at have been tested and
approved for connection to EMC storage arrays.
Refer to theEMC Support M atrix for required N VRAM versions for
qualified adapters.
EMC recommended NVRAM settings for Linux
This section contains the recomm ended N VRAM settings for Linu x
for the following ad apters:
Fibre Channel HBAs on page 37
Fibre Channel over Ethernet (FCoE) CNAs on page 40
iSCSI HBAs on p age 40
Fibre Channel HBAs
Table 3 on page 38 lists the NVRAM parameters and their values. The
QLogic default values are those that ship with a standard adap ter
that w as not includ ed in an EMC package. The EMC-recommen ded
settings depen d u pon w hether failover fun ctionality is used . The
settings listed u nd er the N o Failover Functionality heading are those
that h ave been pre-configured in the EMC-app roved N VRAM file.
The settings listed und er the With Pow erPath or VEERITAS DMP
Installing a nd Configuring the BIOS Settings
https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
38/202
38 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
heading are those that have been tested and determined to be
app licable in a Linu x environment.
The settings are configurable in NVRAM using th e Host Adapter
Settings , Advanced Settings, and Extended Firmware Settings
menus. To use SANsu rfer or the SANsurfer CLI to mod ify the
NVRAM settings, refer to the SANsur fer or SANsurfer CLI
docum entation from QLogic.
Table 3 QLogic BIOS settings for Fibre Channel HBAs (page 1 of 2)
EMC recommended settings
QLogic default No Multipath functionality With Multipath functionality
Host Adapter settings
Host Adapter BIOS Disabled Disabled (No boot from SAN) Enabled (Boot from SAN)
Disabled (No boot from SAN) Enabled (Boot from SAN)
Frame Size 2048 2048 2048
Loop Reset Delay 5 5 5
Adapter Hard Loop IP Disabled Disabled Disabled
Hard Loop ID 0 125 125
Spin-up Delay Disabled Disabled Disabled
Connection Options (topology) 2 1 (FC Fabric environment)
0 (FC DAS/Loop environment)
1 (FC Fabric environment)
0 (FC DAS/Loop environment)
Fibre Channel Tape Support Enabled Disabled Disabled
Data Rate 2 1248
Note: Match port data rate on real
environment.
1248
Note: Match port data rate on real
environment.
Advanced Adapter settings
Execution Throttle 16 256 256
LUNs per Target 8 256 256
Enable LIP Reset No No No
Installing a nd Configuring the BIOS Settings
-
8/6/2019 EMC Linux Jan2010
39/202
Verifying and c on figuring the BIOS sett ings 39
* The WWNN of the server's boot LUN mu st be listed in this field.
Note: The QLogic dr iver may overr ide the EMC-recommend ed NVRAM
values. Unless otherw ise specified, use the default imp lemented by the
driver.
The values for the Connection Options parameter are as follows:
0 for Loop Only
1 for Poin t-to-Point
2 for Loop preferred, otherw ise Point-to-Point
Enable LIP Full Login Yes Yes Yes
Enable Target Reset Yes Yes Yes
Login Retry Count 8 8 8
Port Down Retry Count 8 45 30
Link Down Timeout 15 45 15
Extended Error Logging Disabled Disabled (Do not usedebugging)
Enable (Use debugging)
Disabled (Do not usedebugging)
Enable (Use debugging)
Operation Mode 0 0 0
Interrupt Delay Timer 0 0 0
Selectable Boot settings
Selectable Boot Disabled Disabled Disabled
(Primary) Boot Port Name, LUN WWNN* WWNN* WWNN*
Boot Port Name, LUN 0 0 0
Boot Port Name, LUN 0 0 0
Boot Port Name, LUN 0 0 0
Table 3 QLogic BIOS settings for Fibre Channel HBAs (page 2 of 2)
EMC recommended settings
QLogic default No Multipath functionality With Multipath functionality
Installing a nd Configuring the BIOS Settings
-
8/6/2019 EMC Linux Jan2010
40/202
40 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Note: For Linux attach, EMC recommends setting the Connection Opt ions
parameter to 1 wh en attached to a fabric and to 0 wh en attached to an EMC
storage arr ay d irectly.
Fibre Channel over Ethernet (FCoE) CNAs
EMC recomm ends the d efault settings for the QLogic CNAs. There
are no set tings to the BIOS or N VRAM to a lter.
iSCSI HBAs
The only settings that are requ ired to comp lete the installation arethose of the inten ded iSCSI targets. The iSCSI targets mu st reside on
the same subnet as th e initiator.
The iSCSI targets must be configured after the QLogic v3.x-series or
5.x-series driver h as been installed and is operating. Ad ditionally, to
establish th ese settings, the SANsurfer GUI or the SANsur ferCLI
mu st be dow nloaded and installed on the host.
Installing a nd Configuring the BIOS Settings
-
8/6/2019 EMC Linux Jan2010
41/202
Ma nua lly setting the to p ology fo r QLog ic Fibre Cha nnel ad a pte rs 41
Manually setting the topology for QLogic Fibre Channel
adaptersThe EMC default setting for the top ology is set to 2 (Loop preferred;
otherw ise, point to point).
For Linux environm ents, it is recomm end ed th at the Connection
Options param eter be set to 1 wh en attached to a fabric and to 0 when
d irectly attached to an EMC storage array.
Follow these steps to set the N VRAM variables for the topology:
1. Boot the host. When the QLogic banner app ears, press Ctrl-Q to
enter the Fast!Util menu.
2. Select Configuration Settings from th e Fast!Util Options menu.
3. Select Host Adapter Settings from the Configuration Settings
menu.
4. Select Connection Options (topology) and press Enter.
5. Select the appropriate topology and press Enter:
FC-AL - 0 (loop only)
FC-SW - 1 (point to point only)
6. Press ESC to return to the Fast!Util Options menu.
7. When prompted to save the changes made to the current adapter,
select Save Changes.
8. If you have more adapters to configure, choose Select Host
Adapter and repeat steps 2 through 7 for each adap ter.
9. Press ESC to exit the Fast!Util menu.
10. Reboot the host.
Installing a nd Configuring the BIOS Settings
-
8/6/2019 EMC Linux Jan2010
42/202
42 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Manually setting the data rate for QLogic Fibre Channel
adaptersThe EMC default setting for the d ata rate on the QLA23xx/ QLE23xx
adapters is Au to Select m ode. If necessary, the mode m ay be set
manu ally to 1 GB, 2 GB, or Auto Select mod e.
The EMC default setting for the d ata rate on the QLA24xx/ QLE24xx
4 GB capable adapters is Auto Select mode. If necessary, the mode
may be set m anua lly to 1 GB, 2 GB, 4 GB, or Au to Select mod e.
To use SAN surfer or th e SANsur fer CLI to mod ify the NVRAM
settings, refer to th e SAN surfer or SANsu rfer CLI docum entation
from QLogic.
Note: For any d evice connected to the ad apter, set the device data rate (if
app licable) before setting the adapter d ata rate.
Follow these steps for each QLogic adap ter to be m odified:
1. Boot the host. When the QLogic banner appears, press Ctrl-Q to
enter the Fast!Util menu.
2. Select Configuration Settings from th e Fast!Util Options menu.
3. Select Host Adapter Settings from th e Configuration Settings
menu.
4. Select the Data Rate setting an d press Enter.
5. Select the appropriate speed for the device to which the QLA23xx
adapter will connect. The op tions are 0 for 1 GB/ s, 1 for 2 GB/ s,
and 2 for Au to Select.
6. Press ESC to return to the Fast!Util Options menu.
7. When prompted to save the changes made to the current adapter,
select Save Changes.8. Repeat steps 2 through 7 for each adapter.
9. Press ESC to exit the Fast!Util menu.
10. Reboot the host.
4Invisible Body Tag
-
8/6/2019 EMC Linux Jan2010
43/202
Insta lling a nd Co nfiguring the Linux Host w ith the Q Log ic Drive r 43
y g
This chap ter describes the procedu res for installing and configur ing
the d river. It is d ivided into the follow ing sections.
Introduction ........................................................................................ 44
QLogic SANsurfer and SANsurfer CLI .......................................... 45 Fibre Channel and FCoE in kernel d river v ersions ....................... 47
Fibre Channel an d FCoE out of kernel d river versions ................ 56
iSCSI in kernel d river version s......................................................... 85
iSCSI out of kern el driver ver sions.................................................. 90
Installing and Configuring
the Linux Host with theQLogic Driver
Installing a nd Configuring the Linux Host with the Q Logic Driver
-
8/6/2019 EMC Linux Jan2010
44/202
44 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Introduction
Using the QLogic adap ter with the Linux operating system requires
adapter d river software. The driver functions at a layer below the
Linux SCSI driver to present Fibre Channel (FC), FibreChannel over
Ethernet (FCoE) or iSCSI devices to the op erating system as if they
were stan dard SCSI devices.
EMC supp orts the QLogic in kernel default drivers for FC and FCoE,
as listed in Table 4 on page 47, in the distribution in m ost later
operating systems. Table 5 on page 56 lists QLogic out o f kerneldriver versions sup ported with correspond ing OS upd ates for FC and
FCoE. (These driver versions requ ire man ual insta llation.)
Installation of these drivers are furth er discussed in the following
sections:
Fibre Channel and FCoE in kernel driver versions on page 47
Fibre Channel and FCoE out of kernel d river versions on
page 56
EMC also supports the QLogic in kernel d efault d rivers for iSCSI, as
listed in Table 7 on page 85, in the d istribution in most later operating
systems. Table 8 on page 90 lists QLogic out of kernel d river versions
sup por ted w ith correspond ing OS upd ates for iSCSI. (These dr iver
versions require m anu al installation.) Installation of these dr ivers are
further d iscussed in the following sections:
iSCSI in kernel driver versions on page 85
iSCSI out of kernel d river versions on page 90
Refer to the latestEMC Support M atrix for specific qualified kern el
versions and distributions.
Note: The sup port stated in theEMC Support Matrix supersedes versions
listed in th is document.
Installing a nd Configuring the Linux Host with the QLogic Driver
https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
45/202
QLog ic SANsurfer and SANsurfer CLI 45
QLogic SANsurfer and SANsurfer CLI
QLogic's SANsurfer program is a GUI-based u tility and the
SANsurfer CLI is a text-based utility. Both applications may be
installed on any Linux system and used to man age, configure, and
up date th e EMC-app roved QLogic adapters.
Comp lete docum entation and the EMC-qua lified versions of
SAN surfer and the SANsurfer CLI are available for down load from
the EMC-approved section of the QLogic website.
http://www.qlogic.com
For 4 GB QLogic adap ters, the minimu m requ ired versions are:
SANsurfer - 2.0.30b52
SANsu rfer CLI - 1.06.016 build 23
For 8 GB QLogic adap ters, the minimu m requ ired versions are:
SANsurfer - 2.0.32b SANsu rfer CLI - 1.06.016 build 23
Note: For SANsurfer usage with Asianu x 3.0 SP1 you w ill need to turn on th e
por tmap service. This is accomplished by issuing the following Linux
command as the root user.
chkconfig portmap on
service portmap start
IOCTL module for RHEL4
The RHEL4 in kernel driver needs the ioctl mod ule to sup port
SAN surfer. Using ou t of kernel driver on RHEL4 does not have this
issue. For RHEL4 U3 and RHEL4 U4, the out of kern el ioctl mod ule
needs to installed before you use SANsu rfer.
Note: For RHEL4 U5 or above, the ioctl mod ule is hooked u p w ith the OS and
needs to be loaded manu ally.
The following is an example p rocedu re to install the ioctl on RHEL4
U3 and RHEL4 U4:
1. Download QLogic Linux IOCTL Modu le from EMC- approved
site on th e QLogic website.
2. Enter tar xvf qioctl-ins tall.tar
Installing a nd Configuring the Linux Host with the Q Logic Driver
-
8/6/2019 EMC Linux Jan2010
46/202
46 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
3. Enter qioctl-install install
The follow ing is an example of load IOCTL module on RHLE4 U5
and above with comman d:
modprobe -v qioctlmod
RPM packages needed for RHEL5
To run the SANsu rfer installer un der Redh at 5 Linu x, if the d efau lt
install is selected , the following RPMs need to be installed:
compat-libstdc++-33-3.2.3-61..rpm
libXp-1.0.0-8..rpm
Note: On x86_64 make sure to load 32 bit libs.
Installing a nd Configuring the Linux Host with the QLogic Driver
-
8/6/2019 EMC Linux Jan2010
47/202
Fibre Cha nne l and FCo E in kernel d river versions 47
Fibre Channel and FCoE in kernel driver versions
The following installation information is contained in this section:
Sup ported in kernel driver versions on page 47
Installation instru ctions for the in kernel QLogic dr iver for Linu x
2.4.x kernel on page 50
Installation Instructions for the in kernel QLogic driver in Linu x
2.6.x kernels on page 52
Supported in kernel driver versions
Note: QLogic CNAs are not sup por ted w ithin kernel dr ivers. Refer to the
Installation instru ctions for the out of kernel QLogic d river on page 57 for
more information.
Table 4 lists some examples of sup ported operating system s in kerneldriver versions.
Table 4 Supported FC a nd FCoE in kernel driver versions (page 1 of 3)
OS Driver version Supported adapters
1/2 Gb 4 Gb 8 Gb CNA
RHEL3 U2 6.07.02-RH2 SLES8 SP3 6.05.00
RHEL3 U4
RHEL3 U5
7.01.01-RH1
SLES8 SP4 7.03.00
RHEL3 U8
RHEL 3.9
Asianux 1.0 SP3
7.07.04b6
Miracle Linux SE 4.0RedFlag DC Server 5.0Haansoft Linux 2006 Server
8.00.03b1
Installing a nd Configuring the Linux Host with the Q Logic Driver
T bl 4 Supported FC a nd FCoE in kernel driver versions (page 2 of 3)
-
8/6/2019 EMC Linux Jan2010
48/202
48 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
RHEL4 U3Miracle Linux SE 4.0 SP1RedFlag DC Server 5.0 SP1Haansoft Linux 2006 Server SP1
8.01.02-d4
SLES9 SP3 8.01.02-sles
RHEL4 U4
Asianux 2.0 SP2
OEL 4 U4
8.01.04-d7
SLES10 GA 8.01.04-k
RHEL 4.5
OEL 4.5
8.01.04-d8
RHEL 4.6
OEL 4.6
8.01.07-d4
RHEL 4.7
Asianux 2.0 SP3
OEL 4.7
8.02.09-d0-rhel4.7-04
RHEL 4.8
OEL 4.8
8.02.09.02.04.08-d
RHEL5.0
Asianux 3.0
OEL 5.0
8.01.07-k1
SLES 9 SP4 8.01.07.15
SLES10 SP1 8.01.07-k3
RHEL 5.1
Asianux 3.0 SP1
OEL 5.1
8.01.07-k7
RHEL 5.2
OEL 5.2
8.02.00-k5-rhel5.2-03
Table 4 Supported FC a nd FCoE in kernel driver versions (page 2 of 3)
OS Driver version Supported adapters
1/2 Gb 4 Gb 8 Gb CNA
Installing a nd Configuring the Linux Host with the QLogic Driver
Table 4 Supported FC a nd FCoEin kernel driver versions (page 3 of 3)
-
8/6/2019 EMC Linux Jan2010
49/202
Fibre Cha nne l and FCo E in kernel d river versions 49
a. For model QLE8042 only.
What next? If the d river version is not listed in Table 4, go to Installationinstructions for the out of kernel QLogic driver on p age 57.
If the d river version is listed in Table 4, refer to the ap prop riate
section:
Installation instru ctions for the in kernel QLogic dr iver for Linu x2.4.x kernel on page 50
Installation Instructions for the in kernel QLogic driver in Linu x
2.6.x kernels on page 52
RHEL 5.2
OEL 5.2
8.02.00-k5-rhel5.2-04
Note: This driver is found in kernelerrata 2.6.18-92.1.6.el5 and higher.
SLES10 SP2 8.02.00-k6-sles10.2-02
RHEL 5.3
OEL 5.3
8.02.00.06.05.03-k
SuSE SLES 11 GA 8.02.01.03.11.0-k9 a
RHEL 5.4
OEL 5.4
8.03.00.10.05.04-k
RHEL 5.4 (errata kernels equal to orgreater than 2.6.18-164.2.1.el5)
OEL 5.4 (errata kernels equal to orgreater than 2.6.18-164.2.1.0.1.el5)
8.03.00.1.05.05-k
SuSE SLES 10 SP3 8.03.00.06.10.3-k4
Table 4 Supported FC a nd FCoE in kernel driver versions (page 3 of 3)
OS Driver version Supported adapters
1/2 Gb 4 Gb 8 Gb CNA
Installing a nd Configuring the Linux Host with the Q Logic Driver
-
8/6/2019 EMC Linux Jan2010
50/202
50 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Installation instructions for thein kernel QLogic driver for Linux 2.4.x kernel
The section contains the following in structions for enabling theQLogic driver:
Enabling the QLogic dr iver in RHEL 3.0 on page 50
Enabling the QLogic dr iver in SLES 8 on page 51
Enabling the QLogic driver in RHEL 3.0
To enable this driver, follow these steps:
1. Ensure that the / etc/ modu les.conf file references an entry for
each installed QLogic adap ter.
For each installed QLogic QLA23xx-series adap ter, add an entry:
alias scsi_hostadapterNqla2300
whereN is the sequen tial value of each QLogic adap ter installed
in the system, beginning w ith the number after the last host
adapter num ber entry in the file. (The first host ad apter entrybegins with zero.)
Example:
alias scsi_hostadapter1 qla2300alias scsi_hostadapter2 qla2300alias eth0 tg3options scsi_mod max_scsi_luns=255
scsi_allow_ghost_devices=1
2. Whenever / etc/ modu les.conf is modified, a new ramdisk should
be created to reflect the chan ges mad e. Create a new ram disk
image to includ e the newly ad ded references to the QLogic
adapters:
cd /bootmkinitrd -v initrd-$1.img $1
where $1 is the v2.4.x kernel version curren tly run ning.
Example:
mkinitrd -v initrd-2.4.21-27.ELsmp.img 2.4.21-27.ELsmp
3. Reboot the host.es and
Installing a nd Configuring the Linux Host with the QLogic Driver
Enabling the QLogic driver in SLES8
-
8/6/2019 EMC Linux Jan2010
51/202
Fibre Cha nne l and FCo E in kernel d river versions 51
Enabling the QLogic driver in SLES 8
In order for the driver to be loaded at boot time, the d river mu st be
listed in the / etc/ sysconfig/ kernel and / etc/ modu les.conf files andthe ramd isk must be up dated to reflect the changes.
To enable the d river:
1. Edit / etc/ sysconfig/ kernel:
vi /etc/sysconfig/kernel
a. Add a reference to the QLogic qla2300.o driver in the
INITRD_MODULES line:
INITRD_MODULES="scsi_mod sd_mod mptscsih qla2300reiserfs"
b. Save the changes and quit from vi .
2. Edit / etc/ modules.conf:
vi /etc/modules.conf
a. Add this entry for each installed QLogic adap ter:
alias scsi_hostadapterNqla2300
whereN is the sequential value of each QLogic adapter installed
in the system, beginning w ith the number after the last host
adapter num ber entry in the file. (The first host adap ter entry
begins with zero.)
Ensure that th e QLogic adap ter entries are listed after the internal
SCSI host ad apter entry in both files.
Example:
alias parport_lowlevel parport_pcalias scsi_hostadapter sym53c8xxalias scsi_hostadapter1 qla2300alias scsi_hostadapter2 qla2300
alias eth0 tlanoptions scsi_mod max_scsi_luns=255scsi_allow_ghost_devices=1
b. Save the changes and quit from vi .
3. Create a new ramdisk to reflect the changes made:
cd /bootmkinitrd -k vmlinuz-$1 -i initrd-$1
Installing a nd Configuring the Linux Host with the Q Logic Driver
where $1 is the v2.4.x kernel version curren tly run ning.
-
8/6/2019 EMC Linux Jan2010
52/202
52 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
y g
Example:
cd /bootmkinitrd -k vmlinuz-2.4.21-295-smp -i initrd-2.4.21-295-smp
4. Reboot the system.
Installation Instructions for the in kernel QLogic driver in Linux 2.6.x kernels
If you are installing the OS after the ad apter h as been installed in theserver, the OS will autom atically detect the ad apter, change the
configure file, and bu ild a RAM disk includ ing the d river.
If you h ave completed a fresh installation of the OS withou t the
adapter an d plan to install it at a later time, or are installing an
adapter in a server w ith an existing OS installed, refer to the
following sections to enable th is driver:
Enabling the QLogic driver in RHEL 4, next Enabling the QLogic dr iver in RHEL 5 on p age 53
Enabling the QLogic dr iver in SLES 9 on page 54
Enabling the QLogic driver in SLES10 and SLES 11 on page 54
Enabling the QLogic driver in RHEL 4
To enable this driver:
1. Ensure that the / etc/ modp robe.conf file references an entry for
each installed QLogic adap ter.
For each installed QLogic adapter, add an entry:
alias scsi_hostadapterNqla2xxx
whereN is the sequen tial value of each QLogic adap ter installed
in the system, beginning w ith the number after the last host
adapter num ber entry in the file. (The first host ad apter entry
begins with zero.), qla2xxx is the driver n ame for the ad apter
Example:
alias scsi_hostadapter3 qla2xxxalias scsi_hostadapter4 qla2322alias scsi_hostadapter5 qla2400alias scsi_hostadapter6 qla6312
Installing a nd Configuring the Linux Host with the QLogic Driver
Note: QLA2300 QLA2310 QLA2340 d QLA2342
-
8/6/2019 EMC Linux Jan2010
53/202
Fibre Cha nne l and FCo E in kernel d river versions 53
Note: QLA2300 manages QLA2310, QLA2340, and QLA2342.
QLA 2322 manages QLE2360 and QLE2362.
QLA2400 manages QLA2460, QLS2462, QLE2460, and QLE2462.QLA6312 manages QLE220.
2. Whenever / etc/ modprobe.conf is modified, a new ramdisk
shou ld be created to reflect the changes m ade. Create a new
ramd isk image to includ e the new ly add ed references to the
QLogic adapters:
cd /bootmkinitrd -v initrd-$1.img $1
where $1 is the v2.6.x kernel version curren tly running.
Example:
mkinitrd -v initrd-2.6.9-55.ELsmp.img 2.6.9-55.ELsmp
3. Reboot the host.
Enabling the QLogic driver in RHEL 5
To enable this driver:
1. Ensure that the / etc/ modprobe.conf file references an entry for
each installed QLogic adap ter.
For installed QLogic adapter, add an entry:
alias scsi_hostadapterNqla2xxx
whereN is the sequential value of QLogic ad apter insta lled in th e
system, beginning with the n um ber after the last host adapter
nu mber en try in the file. (The first host adapter en try begins w ith
zero.).
Example:
alias scsi_hostadapter1 qla2xxx
2. Whenever / etc/ modprobe.conf/ is modified, a new ramdisk
shou ld be created to reflect the changes m ade. Create a new
ramd isk image to includ e the new ly add ed references to the
QLogic adapters:
cd /bootmkinitrd -v initrd-$1.img $1
Installing a nd Configuring the Linux Host with the Q Logic Driver
where $1 is the v2.6.x kernel version curren tly run ning.
-
8/6/2019 EMC Linux Jan2010
54/202
54 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Example:
mkinitrd -v initrd-2.6.18-8.el5.img 2.6.18-8.el5
3. Reboot the host.
Enabling the QLogic driver in SLES 9
In order for the driver to be loaded at boot time, the driver mu st be
listed in the / etc/ sysconfig/ kernel and the ramdisk mu st be updated
to reflect the changes. To enable the d river:
1. Edit / etc/ sysconfig/ kernel:
vi /etc/sysconfig/kernel
a. Add a reference to the QLogic driver in the
INITRD_MODULES line:
INITRD_MODULES="reiserfs qla2xxx_conf qla2xxx"
b. Save the changes and quit from vi .
2. 2Create a new ram disk to reflect the changes mad e:
cd /bootmkinitrd -k vmlinuz-$1 -i initrd-$1
where $1 is the v2.6.x kernel version curren tly run ning.
Example:
cd /bootmkinitrd -k vmlinuz- 2.6.5-7.244-smp -i initrd- 2.6.5-7.244-smp
3. Reboot the system.
Enabling the QLogic driver in SLES10 a nd SLES 11
If the server install the OS withou t the ad apter, in ord er for the driver
to be loaded at boot time, the driver must be listed in the/ etc/ sysconfig/ kernel and the ramdisk must be up dated to reflect
the changes. To enable the d river:
1. Edit / etc/ sysconfig/ kernel:
vi /etc/sysconfig/kernel
a. Add a reference to the QLogic qla2300.ko driver in the
INITRD_MODULES line:
INITRD_MODULES="piix megaraid_sas processor thermal fan reiserfs qla2xxx"
Installing a nd Configuring the Linux Host with the QLogic Driver
b S th h d it f i
-
8/6/2019 EMC Linux Jan2010
55/202
Fibre Cha nne l and FCo E in kernel d river versions 55
b. Save the changes and quit from vi .
2. Create a new ramdisk to reflect the changes made:
cd /bootmkinitrd -k vmlinuz-$1 -i initrd-$1
where $1 is the v2.6.x kernel version curren tly running.
Example:
cd /boot
mkinitrd -k vmlinuz- 2.6.16.21-0.8-smp -i initrd-2.6.16.21-0.8-smp
3. Reboot the system.
Installing a nd Configuring the Linux Host with the Q Logic Driver
Fibre Channel and FCoE out of kernel driver versions
-
8/6/2019 EMC Linux Jan2010
56/202
56 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
Fibre Channel and FCoE out of kernel driver versions
The following installation information is contained in th is section:
Sup ported ou t of kernel driver versions on page 56
Installation instru ctions for the ou t of kernel QLogic dr iver on
page 57
Uninsta llation m ethod s for the QLogic v7.xx.xx/ v8.xx.xx
driver on page 73
QLogic SANsur fer and SANsurfer CLI on page 45
QLogic v7.x and v8.x series driver p aram eters on page 75
Supported out of kernel driver versions
Note: Only the QLogic v7.07.xx and the v8.01.xx dr iver p rovides su pp ort for
the 4 GB-capab le QLA24xx/ QLE24xx-series adap ters, not the less version
driver.
Table 5 lists the QLogic out of kernel driver versions supp orted w ith
correspon ding OS upd ates. These dr iver versions require manu ally
installation.
Table 5 Supported FC a nd FCoE out of kernel driver versions (page 1 of 2)
OS Driver version
RHEL 3 U2
RHEL 3 U3
RHEL 3 U4
RHEL 3 U5
7.03.00
SLES 8 SP3
SLES 8 SP4
7.03.00
RHEL 3 U6
RHEL 3 U7
7.07.05
RHEL 4
RHEL 4 U1
8.00.03b-1
SLES 9 SP1 8.00.03b-1
Installing a nd Configuring the Linux Host with the QLogic Driver
Table 5 Supported FC a nd FCoE out of kernel driver versions (page 2 of 2)
-
8/6/2019 EMC Linux Jan2010
57/202
Fibre Cha nne l and FCo E ou t o f kernel d river versions 57
Refer to the latest EMC Support Matrix for specific qu alified kernel
versions and distributions.
Note: The sup port stated in theEMC Support Matrix supersedes versions
listed in this d ocum ent.
Installation instructions for the out of kernel QLogic driver
This section contains the following information for installing the out
of kernel QLogic driver:
Dow nloading the QLogic v7.x/ v8.x-series driver for the
v2.4/ v2.6.x kernel on page 58 Preinstallation inst ructions for the QLogic v7.xx.xx/ v8.xx.xx
driver on page 58
Meth od 1: Installing the QLogic v7.xx.xx/ v8.xx.xx driver via the
QLogic DKMS RPM on page 60
Meth od 2: Installing the QLogic v7.xx.xx/ v8.xx.xx driver via the
QLogic installation script on p age 61
SLES 9 SP2
RHEL 4 U2
8.01.06
Note: Does not support the 8 Gb adapters.
SLES10 SP2 (FCoE adapters) 8.02.14.01
Note: Supports only the QLogic QLE8042 FCoE adapters.
RHEL 5.3 (FCoE adapters) 8.03.00.09.05.04-k
Note: Supports only QLE8140, QLE8142, QLE8150, and
QLE8152 FCoE adapters.
SLES 11 GA (FCoE adapters) 8.03.00.08.11.0-k4
Note: Supports only QLE8140, QLE8142, QLE8150, and
QLE8152 FCoE adapters.
OS Driver version
Installing a nd Configuring the Linux Host with the Q Logic Driver
Meth od 3: Installing th e QLogic v7.xx.xx driver via the QLogic
RPM on page 71
https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/https://elabnavigator.emc.com/ -
8/6/2019 EMC Linux Jan2010
58/202
58 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
RPM on page 71
Downloading the QLogic v7.x/v8.x-series driver for the v2.4/v2.6.x kernel
Use the following procedu re to dow nload the EMC-approved QLogic
dr iver from the QLogic website.
1. Use a web browser to access the EMC-app roved section of the
QLogic website at:
http://www.qlogic.com
2. Depending up on the EMC storage array being used, select theapp ropriate link from one of the tw o following categories:
EMC CLARiiON, EMC Symmetrixand EMC Celerra
supp orted software
EMC CLARiiON AX100 supported software
3. After selecting a category, find the ad apter model being used and
select the link to be transferred to th e page of resources for thatadapter.
4. Find the desired and sup ported d river for the kernel version and
distribution, and click th e associated Download link to save the
file.
Preinstallation instructions for the QLogic v7.xx.xx/ v8.xx.xx driver
Perform the following step s prior to the installation:
1. Stop all I/ O.
2. Unmou nt all filesystems attached to the QLogic driver.
3. If the Naviagent/ CLI is installed and enabled on the host, then
the Naviagent/ CLI service must be stopped.
To stop th e Naviagent/ CLI service, issue one of the tw o following
commands:
/etc/init.d/naviagentcli stop
or
service naviagentcli stop
4. If PowerPath is installed and enabled on the host, then the
PowerPath service mu st be stopped.
Installing a nd Configuring the Linux Host with the QLogic Driver
To stop the Pow erPath service, issue on e of the tw o following
commands:
-
8/6/2019 EMC Linux Jan2010
59/202
Fibre Cha nne l and FCo E ou t o f kernel d river versions 59
/etc/init.d/PowerPath stop
or
service PowerPath stop
5. If the QLogic SANsu rfer daemon qlremote is installed and
enabled on the host, then th e qlremote service must be stopp ed in
order for the d river to be removed from th e currently run ning
kernel.
To stop the qlremote service, issue one of the tw o following
commands:
/etc/init.d/qlremote stop
or
service qlremote stop
What next? Select a method to insta ll the d river onto the Linux host:
For the QLogic v7.xx.xx/ v8.xx.xx driver:
To create a m odu lar v7.xx.xx/ v8.xx.xx driver using the DKMS
RPM, refer to Meth od 1: Installing the QLogic v7.xx.xx/ v8.xx.xx
dr iver via the QLogic DKMS RPM on page 60.
Use the QLogic DKMS RPM to compile and install the mod ular
dr iver for Dell servers and attached to EMC storage arrays.This meth od requ ires no manu al edits for Dell servers attached to
EMC storage arrays. By installing the DKMS RPM, the necessary
files will be edited an d the d river will be comp iled an d installed
automatically.
To create a m odu lar v7.xx.xx/ v8.xx.xx driver using the
installation script, refer to Method 2: Installing the QLogic
v7.xx.xx/ v8.xx.xx driver via the QLogic installation scrip t onpage 61.
Use the QLogic installation script to compile and install the
mod ular d river onto the systems attached to EMC storage arrays.
This meth od requires no man ual edits for systems attached to
EMC storage arrays. By u sing the QLogic installation script, the
necessary files are edited an d th e driver is compiled and installed
automatically.
Installing a nd Configuring the Linux Host with the Q Logic Driver
To create a m odular v7.xx.xx driver u sing th e QLogic RMP, refer
toMeth od 3: Installing the QLogic v7.xx.xx driver v ia the
-
8/6/2019 EMC Linux Jan2010
60/202
60 EMC Host C onnec tivity with Q Log ic FC a nd iSCSI HBAs and FCo E CNAs fo r the Linux Environm en t
QLogic RPM on p age 71.
Use the QLogic RPM to comp ile and install the modular d river.
This meth od requ ires no manu al edits for systems attached to
EMC storage ar rays. By installing th e QLogic RPM, the necessary
files will be edited an d th e driver w ill be comp iled an d installed
automatically.
Me thod 1: Installing the QLogic v7.xx.xx/ v8.xx.xx driver via the QLo
top related