EMC Linux Jan2010

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


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.


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


4/202


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


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


6/202


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


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



Configuring a CLARiiON boot device for iSCSI 5.x ................. 174

Preparing the CLARiiON storage array ................................ 174



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


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/202


Contents


9/202


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/


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/


11/202


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:

[email protected]

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


12/202


Preface


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


14/202


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/


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/


16/202


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


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


18/202


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


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/


20/202


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


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/


22/202


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


page 25


page 25

2 Verify theBIOS version

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 BIOS onpage 35

If wrongversion isinstalled



Upgrading the adapter BIOS onpage 35

If correctversion isinstalled

Proceed to step 4. Proceed to step 4. Proceed to step 4.


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



For iSCSI, refer to


24/202


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



For iSCSI, refer to


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


26/202


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


27/202


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


28/202


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


29/202


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


30/202


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









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/


31/202


most u p-to-date information on wh ich servers supp ort these

adapters.

Installa tion Steps


32/202


3


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


34/202


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



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.



36/202


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.



37/202


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



38/202


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



39/202


* 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



Table 3 QLogic BIOS settings for Fibre Channel HBAs (page 2 of 2)

EMC recommended settings

QLogic default No Multipath functionality With Multipath functionality



40/202


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.



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.



42/202


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


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


44/202


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


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



46/202


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.



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


T bl 4 Supported FC a nd FCoE in kernel driver versions (page 2 of 3)


48/202


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 FCoEin kernel driver versions (page 3 of 3)


49/202


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






50/202


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


Enabling the QLogic driver in SLES8


51/202


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


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


3. Create a new ramdisk to reflect the changes made:

cd /bootmkinitrd -k vmlinuz-$1 -i initrd-$1




52/202


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


For each installed QLogic adapter, add an entry:

alias scsi_hostadapterNqla2xxx

whereN is the sequen tial value of each QLogic adap ter installed


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


Note: QLA2300 QLA2310 QLA2340 d QLA2342


53/202


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:


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


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:





54/202


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:



a. Add a reference to the QLogic driver in the


INITRD_MODULES="reiserfs qla2xxx_conf qla2xxx"


2. 2Create a new ram disk to reflect the changes mad e:



Example:

cd /bootmkinitrd -k vmlinuz- 2.6.5-7.244-smp -i initrd- 2.6.5-7.244-smp


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:



a. Add a reference to the QLogic qla2300.ko driver in the


INITRD_MODULES="piix megaraid_sas processor thermal fan reiserfs qla2xxx"


b S th h d it f i


55/202



2. Create a new ramdisk to reflect the changes made:


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



Fibre Channel and FCoE out of kernel driver versions


56/202


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


Table 5 Supported FC a nd FCoE out of kernel driver versions (page 2 of 2)


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


Meth od 3: Installing th e QLogic v7.xx.xx driver via the QLogic

RPM on page 71


58/202


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.


To stop the Pow erPath service, issue on e of the tw o following

commands:


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.


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


60/202


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

Date post:	07-Apr-2018
Category:	Documents
Upload:	phani-gadivemula
View:	224 times
Download:	0 times

EMC Linux Jan2010

Documents