Broadcom Emulex Drivers Version 10.6 for Solaris User User guide

P011396-01A Rev. A Connect • Monitor • Manage

Emulex Drivers

Version 10.6

for Solaris

User Manual

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

2

means or translated to any electronic medium without the prior written consent of Emulex.

Information furnished by Emulex is believed to be accurate and reliable. However, no responsibility is assumed by

Emulex for its use; or for any infringements of patents or other rights of third parties which may result from its use. No

license is granted by implication or otherwise under any patent, copyright or related rights of Emulex.

Emulex, the Emulex logo, Emulex BladeEngine, Emulex InSpeed, Emulex LightPulse, Emulex OneCommand, Emulex

OneConnect, and SLI are registered trademarks, and Emulex Advanced-8, Emulex Connect, Emulex CrossLink,

Emulex Engine, Emulex Edge, Emulex ExpressLane, Emulex GreenState, Network Xceleration, Emulex OneCore,

Emulex Pilot, Emulex SURF, Emulex Universal Multi-Channel, Emulex vEngine, Emulex Virtual Fabric, Emulex

Virtual Network Exceleration, Emulex vPath, Emulex vScale, AutoPilot, AutoPilot Installer, and BlockGuard are

trademarks, of Emulex. All other brands or product names referenced herein are trademarks or registered trademarks

of their respective companies or organizations.

Emulex provides this manual "as is" without any warranty of any kind, either expressed or implied, including but not

limited to the implied warranties of merchantability or fitness for a particular purpose. Emulex may make

improvements and changes to the product described in this manual at any time and without any notice. Emulex

assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties that may

result. Periodic changes are made to information contained herein; although these changes will be incorporated into

new editions of this manual, Emulex disclaims any undertaking to give notice of such changes.

Emulex, 3333 Susan Street

Costa Mesa, CA 92626

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

Table of Contents

3

Table of Contents

List of Tables .......................................................................................6

1. Introduction .....................................................................................7

Supported Operating Systems ...................................................................... 7

Supported Adapters and Firmware ................................................................ 7

Abbreviations .......................................................................................... 8

2. Installing and Uninstalling .................................................................. 10

Installing the Drivers for Solaris 10.............................................................. 10

FCoE Out-of-Box Driver (elxfc) ................................................................10

NIC Out-of-Box Driver (elxnic) .................................................................10

Uninstalling the Drivers for Solaris 10 .......................................................... 11

FCoE Driver .......................................................................................11

NIC Driver .........................................................................................11

Installing the Drivers for Solaris 11.............................................................. 12

FCoE Out-of-Box Driver (elxfc) ................................................................12

Option 1: Remote Repository Installation........................................................ 12

Option 2: P5P Archive Installation ................................................................ 12

NIC Out-of-Box Driver (elxnic) .................................................................13

Option 1: Remote Repository Installation........................................................ 13

Option 2: p5p Archive Installation ................................................................ 14

Uninstalling the Drivers for Solaris 11 .......................................................... 14

FCoE Driver .......................................................................................14

Scripted Removal .................................................................................... 14

Manual Removal...................................................................................... 15

NIC Driver .........................................................................................15

Scripted Removal .................................................................................... 15

3. Utilities for Solaris Drivers ................................................................. 16

OneCommand Manager Application.............................................................. 16

emlxadm Utility...................................................................................... 16

emlxdrv Utility....................................................................................... 16

4. FCoE Driver Configuration.................................................................. 17

Editing the FCoE Configuration File (elxfc.conf) ............................................. 17

Changing Driver Parameters....................................................................17

Configuring NPIV Support .......................................................................17

Enabling NPIV Support on Solaris 10 .............................................................. 17

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

Table of Contents

4

Enabling NPIV Support on Solaris 11 .............................................................. 18

NPIV Limitations ..................................................................................... 18

NPIV and Operating System Virtualization ....................................................... 18

Using VPorts with Oracle VM Server for Solaris Containers or Oracle VM

Server for 86.......................................................................................... 19

FCoE Configuration File Parameters ............................................................ 19

5. NIC Driver Configuration.................................................................... 23

Using the NIC Configuration File (elxnic.conf) ................................................ 23

Changing Driver Parameters....................................................................23

NIC Configuration File Parameters ............................................................23

Configuring the NIC Interface ..................................................................26

Removing the NIC Interface using elxnic .....................................................26

Multi-ring Mode and the Effect of ddi_msix_alloc_limit ...................................27

Solaris 10 .............................................................................................. 27

Solaris 11 .............................................................................................. 28

Changing Interrupt Priorities...................................................................29

Using the dladm Utility for Solaris 11 ........................................................... 30

Configuring the NIC Interface Using dladm ..................................................30

Tunable Parameters ................................................................................. 30

Private (or Unlisted) Parameters .................................................................. 31

Creating a Virtual NIC Using dladm ...........................................................31

6. Troubleshooting .............................................................................. 33

Solaris 11 elxfc Driver Installation Situation.................................................33

7. FCoE Driver Console and Log Messages .................................................. 34

Setting Notices, Warnings, and Error Logging Levels ........................................ 34

Log Messages ......................................................................................... 34

Types of Log Messages Logged in the System File ..........................................34

Log Message Severity Levels ...................................................................35

Log Message Example ...........................................................................36

Log Messages for the FCoE Driver................................................................ 37

Miscellaneous Events (Message IDs: 0001–0099).............................................37

Driver Events (Message IDs: 0100–0199) ......................................................38

Adapter Initialization Events (Message IDs: 0200–0299) ...................................40

Memory Management Events (Message IDs: 0300–0399)....................................41

Service Level Interface Events (Message IDs: 0400–0499) .................................43

Mailbox Events (Message IDs: 0500–0599) ....................................................47

Node Events (Message IDs: 0600–0699) .......................................................48

Link Events (Message IDs: 0700–0799) ........................................................50

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

Table of Contents

5

ELS Events (Message IDs: 0800–0899) .........................................................51

General I/O Packet Events (Message IDs: 0900–0999) ......................................53

FCP Traffic Events (Message IDs: 1000–1099)................................................55

IP Traffic Events (Message IDs: 1200–1299) ..................................................56

Solaris SFS Events (Message IDs: 1300–1399).................................................57

IOCTL Events (Message IDs: 1400–1499) ......................................................59

Firmware Download Events (Message IDs: 1500–1599) .....................................60

Common Transport Events (Message IDs: 1600–1699) ......................................62

FCSP Events (Message IDs: 1700–1799) .......................................................63

FCF Events (Message IDs: 1800–1899) .........................................................65

8. NIC Driver Log Messages .................................................................... 67

Setting MOD_MASK and SEVERITY................................................................ 67

Log Messages for the NIC Driver.................................................................. 68

For Solaris 10 .....................................................................................68

For Solaris 11 .....................................................................................73

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

List of Tables

6

List of Tables

Table 4-1 FCoE Configuration File Parameters ...................................................19

Table 5-1 NIC Configuration File Parameters .....................................................24

Table 5-2 Effect of “ddi_msix_alloc_limit” across CPU Cores for Solaris 10 .................27

Table 5-3 Effect of “ddi_msix_alloc_limit” across CPU Cores for Solaris 11 .................28

Table 6-1 Solaris 11 elxfc Driver Installation Situation and the Resolution ..................33

Table 7-1 Setting Types of Console and Log Messages for the FCoE Driver ..................34

Table 7-2 Log Message Types for the FCoE Driver ................................................34

Table 7-3 Severity Levels of FCoE Driver Log Messages .........................................35

Table 8-1 MOD_MASK Information for NIC Driver Log Messages ................................67

Table 8-2 Severity Level Information for NIC Driver Log Messages ............................67

Table 8-3 Log Messages for the NIC Driver for Solaris 10........................................68

Table 8-4 Log Messages for the NIC Driver for Solaris 11........................................73

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

1. Introduction

Supported Operating Systems

7

1. Introduction

This document provides information for using the Emulex

®

Fibre Channel over

Ethernet (FCoE) out-of-box drivers for Solaris StorEdge SAN Foundation Software

(SFS), which is part of the SFS (Leadville) stack. The module name for this FCoE driver

is “elxfc”.

This document also provides information for using the Emulex network interface card

(NIC) out-of-box driver for Solaris, which operates the NIC function of the Emulex

OneConnect

®

adapters. The module name for this NIC driver is “elxnic”.

Supported Operating Systems

One of the following operating systems must be installed:

 Solaris 10 (x64)

 Solaris 11 (x64)

Notes

 For the FCoE (elxfc) driver, Solaris 11.1 or 11.2 is required. For earlier updates of

Solaris 11, use the earlier version of elxfc posted on the Emulex website.

 For the most current FC driver, see the latest Oracle updates.

 For the NIC (elxnic) driver, Solaris 10 and Solaris 11 are supported. Emulex

recommends using the latest Oracle updates.

 SPARC is not supported.

See the Emulex website for the latest supported operating systems.

Supported Adapters and Firmware

For adapters that are compatible with the Emulex FCoE and NIC drivers, see the

driver's Downloads page on the Emulex website.

For compatible firmware versions, see the Downloads page for the specific adapter.

The NIC driver supports the Solaris Ethernet stack, including NIC virtualization

(Crossbow), vSwitch, and vRouter.

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

1. Introduction

Abbreviations

8

Abbreviations

APIC advanced programmable interrupt controller

ASCII American Standard Code for Information Interchange

CLI command line interface

CNA Converged Network Adapter

CPU central processing unit

DHCHAP Diffie-Hellman Challenge Handshake Authentication Protocol

DR dynamic reconfiguration

FC Fibre Channel

FCA Fibre Channel adapter

FCIO FC input/output

FC-IP Fibre Channel over IP

FCoE Fibre Channel over Ethernet

FCTL FC transport library

FW firmware

Gbps gigabits per second

GFC gigabit Fibre Channel

GUID Globally Unique Identifier

HBA host bus adapter

HW hardware

IOCTL input/output control

IOV I/O virtualization

IPS Solaris Image Packaging System

IRM interrupt resource management

IRQ interrupt request

LACP Link Aggregation Control Protocol

MSI-X message signaled interrupts – extended

MTU maximum transmission unit

NIC network interface card

NPIV N_Port ID Virtualization

OS operating system

PCI Peripheral Component Interconnect

PF physical function

POST power-on self-test

SCSI Small Computer System Interface

SFS SAN Foundation Software

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

1. Introduction

Abbreviations

9

SLI Service Level Interface

SR-IOV single root I/O virtualization

tar tape archive

UMC universal multi-channel

VF virtual function

VLAN virtual local area network

VM virtual machine

VPort virtual port

vRouter virtual router

vSwitch virtual switch

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

2. Installing and Uninstalling

Installing the Drivers for Solaris 10

10

2. Installing and Uninstalling

This section details the procedures for installing and uninstalling the Solaris drivers.

Installing the Drivers for Solaris 10

FCoE Out-of-Box Driver (elxfc)

To install the FCoE out-of-box driver:

1. Log in as “root”.

2. Download the platform-specific FCoE out-of-box driver from the Emulex website to

a convenient directory. The file is a regular tar file.

3. Extract the installation image from the tar file. For example:

cd <location of driver package>

tar xvf elxfc_kit-10.6.xx.yy-s10-i386.tar

4. Install the driver kit. For example:

cd <location of driver package>

pkgadd -d ./

5. Reboot the system.

Note: The emlxdrv utility must be used to bind the adapter to the elxfc driver. For

more information on the emlxdrv utility, see the latest Emulex Solaris FCA

Utilities User Manual, which is available on the Emulex website.

NIC Out-of-Box Driver (elxnic)

To install the NIC out-of-box driver:

1. Log in as “root”.

2. Download the platform-specific NIC out-of-box driver from the Emulex website to

a convenient directory. The file is a regular tar file.

3. Extract the installation image from the tar file. For example:

cd <location of driver package>

tar xvf elxnic_kit-10.6.xx.yy-s10-i386.tar

4. Install the driver kit. For example:

cd <location of driver package>

pkgadd -d./

5. Reboot the system.

Binding a Driver to a Device-id Instance

Because the out-of-box NIC driver (elxnic) and the inbox NIC driver (oce) support the

same set of device-ids, only one driver can be attached to a device-id instance. By

default, the oce driver claims all the device-ids. Therefore, when installing the elxnic

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

2. Installing and Uninstalling

Uninstalling the Drivers for Solaris 10

11

driver on top of the oce driver, the elxnic driver installation fails. To re-establish the

device-id to driver bindings:

1. Unbind the oce driver using the emlxdrv utility. For more information on the

emlxdrv utility, see the latest Emulex Solaris FCA Utilities User Manual.

2. Retry the elxnic installation.

This ensures a successful package installation and will automatically bind the NIC

driver.

Uninstalling the Drivers for Solaris 10

FCoE Driver

To uninstall the FCoE out-of-box driver:

1. Log in as “root”.

2. Remove the out-of-box driver by typing

pkgrm <OOB_pkg_name>

For example:

pkgrm EMLXelxfc

3. Reboot the system.

NIC Driver

To uninstall the NIC out-of-box driver:

1. Log in as “root”.

2. Remove the out-of-box driver by typing

pkgrm <nic_pkg_name>

For example:

pkgrm EMLXelxnic

3. Reboot the system.

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

2. Installing and Uninstalling

Installing the Drivers for Solaris 11

12

Installing the Drivers for Solaris 11

This section details the procedures for installing the drivers for Solaris 11.

FCoE Out-of-Box Driver (elxfc)

You can install the FCoE out-of-box driver (for S11.1) using one of two options:

 Remote Repository Installation

 P5P Archive Installation

Option 1: Remote Repository Installation

1. Log in as “root”.

2. Add the Emulex IPS repository to the publisher list. For example:

$ pkg set-publisher -O http://<Emulex provided URL> emulex

3. List all available versions of elxfc. For example:

$ pkg list -af elxfc

NAME (PUBLISHER) VERSION IFO

driver/network/elxfc (emulex) 10.4.xx.yy-0 ---

4. On the system whose output was displayed in step 3, the following command will

install version 10.4.xx.y.x-0:

$ pfexec pkg install elxfc

By default, the newest version of elxfc that is compatible with the rest of the image

will be installed. To install a specific version of elxfc, append the package version to

the package name as follows:

$ pfexec pkg install [email protected]

In instances where two publishers provide packages of the same name, specify the

publisher name as follows:

$ pfexec pkg install //emulex/elxfc

After the installation of elxfc has completed, Solaris must be configured to discover

and bind the elxfc driver to Emulex adapters. Use the Emulex utility emlxdrv to

configure these device bindings. See “Utilities for Solaris Drivers” on page 16 for

more information.

5. Reboot the system:

$ reboot

Option 2: P5P Archive Installation

You can use a scripted installation or a manual installation.

Scripted Installation

1. Log in as “root”.

2. Download the p5p tar file from the Emulex website.

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

2. Installing and Uninstalling

Installing the Drivers for Solaris 11

13

3. Untar the archive:

$ tar -xvf elxfc_p5p-10.4.xx.yy-s11.tar

4. Run the installation script:

$ ./elxfc_install

5. Reboot the system:

$ reboot

Manual Installation

1. Log in as “root”.

2. Download the p5p tar file from the Emulex website.

3. Extract the p5p archive from the tar file:

$ tar -xvf elxfc_p5p-2.10.4.x-s11.tar

4. Run the following command to install the package:

$ pfexec pkg install –g elxfc_2.10.4.x-s11.p5p

5. Reboot the system:

$ reboot

Note: The emlxdrv utility must be used to bind the adapter to the elxfc driver. For

more information on the emlxdrv utility, see the latest Emulex Solaris FCA

Utilities User Manual.

NIC Out-of-Box Driver (elxnic)

You can install the NIC out-of-box driver using one of two options:

 remote repository installation

 p5p archive installation

Option 1: Remote Repository Installation

1. Log in as “root”.

2. Add the Emulex IPS repository to the publisher list. For example:

pkg set-publisher -O <Emulex provided URL> emulex

3. List all available versions of elxnic For example:

pkg list -af elxnic

NAME (PUBLISHER) VERSION IFO

driver/nic/elxnic (emulex) 10.4.xx.x-0 i--

driver/nic/elxnic (emulex) 10.4.xy.x-0 ---

4. Install the elxnic driver:

pfexec pkg install elxnic

By default, the latest version of elxnic that is compatible with the rest of the image

will be installed. To install a specific version of elxnic, append the package version

to the package name as follows:

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

2. Installing and Uninstalling

Uninstalling the Drivers for Solaris 11

14

$ pfexec pkg install [email protected]

In instances where two publishers provide packages of the same name, specify the

publisher name as follows:

$ pfexec pkg install //emulex/elxnic

After the installation of elxnic has completed, you must configure Solaris to

discover and bind the elxnic driver to Emulex adapters. Use the Emulex utility

emlxdrv to configure these device bindings. See “Utilities for Solaris Drivers” on

page 16 for more information.

5. Reboot the system.

Option 2: p5p Archive Installation

1. Log in as “root”.

2. Download the p5p tar file from the Emulex website.

3. Untar the archive:

tar -xvf elxnic_p5p-10.4.xx.yy-s11.tar

4. Run the installation script:

./elxnic_install

5. Reboot the system:

reboot

Binding a Driver to a Device-id Instance

Because the out-of-box NIC driver (elxnic) and the inbox NIC driver (oce) support the

same set of device-ids, only one driver can be attached to a device-id instance. By

default, the oce driver claims all of the device-ids. Therefore, when installing the elxnic

driver on top of the oce driver, the elxnic driver installation fails. To re-establish the

device-id to driver bindings:

1. Unbind the oce driver using the emlxdrv utility. For more information on the

emlxdrv utility, see the latest Emulex Solaris FCA Utilities User Manual, which is

available on the Emulex website.

2. Retry the elxnic installation.

This ensures a successful package installation and will automatically bind the NIC

driver.

Uninstalling the Drivers for Solaris 11

FCoE Driver

You can uninstall the FCoE out-of-box driver by using scripted removal or manual

removal.

Scripted Removal

1. Log in as “root”.

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

2. Installing and Uninstalling

Uninstalling the Drivers for Solaris 11

15

2. Run the following command to remove elxfc from the system:

$ ./elxfc_remove

3. Reboot the system. Type

$ reboot

The script is included in the downloadable p5p tar file that can be retrieved from the

Emulex website. The scripted uninstall also cleans up the files in the installation

directory.

Manual Removal

1. Log in as “root”.

2. Run the following command to remove elxfc from the system:

$ pkg uninstall elxfc

3. Reboot the system:

$ reboot

NIC Driver

To uninstall the NIC out-of-box driver:

1. Log in as “root”.

2. Remove the out-of-box driver by typing

pkg uninstall <driver_name>

For example:

pkg uninstall elxnic

3. Reboot the system.

Scripted Removal

1. Log in as “root”.

2. Run the following command to remove elxnic driver by typing

./elxnic_remove

3. Reboot the system.

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

3. Utilities for Solaris Drivers

OneCommand Manager Application

16

3. Utilities for Solaris Drivers

Emulex provides three utilities to facilitate configuring and using the Solaris drivers:

 emlxdrv utility (included in the FCA utilities)

 emlxadm utility (included in the FCA utilities)

 OneCommand

®

Manager application

Note: When you install the OneCommand Manager application, also install the

Solaris FCA Utilities.

OneCommand Manager Application

The OneCommand Manager application provides the functionality of the emlxadm

utility along with additional features, allowing you to remotely manage multiple

systems. It offers a choice of a graphical user interface and a scriptable command-line

interface. It is a direct-user interface to the FCIO interface provided by the Oracle

StorEdge SFS. The FCIO interface provides an Oracle-common IOCTL interface to the

FCTL, which manages the FCA drivers for each FCoE adapter attached to the host

system. The OneCommand Manager application also directly interfaces with the

Emulex network driver, allowing you to manage the NIC function of Emulex adapters.

For more information, see the OneCommand Manager Application User Manual, which is

available on the Emulex website.

emlxadm Utility

The emlxadm utility changes driver parameters through a local interactive or CLI

mode. It can also update firmware on non-Oracle branded devices. For more

information, see the Solaris FCA Utilities User Manual.

emlxdrv Utility

The emlxdrv utility is used for binding (associating) the Emulex Solaris FCoE and NIC

drivers to the various models of Emulex adapters. If the driver binding configuration is

changed, the host system must be rebooted for the new configuration to take effect.

The out-of-box drivers (elxfc and elxnic) and their respective inbox drivers (emlxs and

oce) support the same set of Emulex adapter device-ids. Because only one driver can be

bound to a specific device-id, the inbox driver initially binds to all device-ids by

default. In order to install an out-of-box driver on top of an inbox driver, you must use

the emlxdrv utility to establish the device-id to driver bindings.

For more information, see the Solaris FCA Utilities User Manual.

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

4. FCoE Driver Configuration

Editing the FCoE Configuration File (elxfc.conf)

17

4. FCoE Driver Configuration

The module name for the Emulex SFS FCA out-of-box driver is “elxfc”. You can

configure the Emulex SFS FCA driver parameters by

 Editing the configuration file (elxfc.conf), which is described in this section.

 Using the Emulex FCA utilities: emlxadm and emlxdrv. For more information,

see the Solaris FCA Utilities User Manual.

 Using the OneCommand Manager application. For more information, see the

OneCommand Manager Application User Manual.

Editing the FCoE Configuration File (elxfc.conf)

The configuration file contains all the parameters necessary to initialize the Emulex SFS

FCA out-of-box driver.

Changing Driver Parameters

The configurable driver parameters are defined in Table 4-1, FCoE Configuration File

Parameters, on page 19.

To change driver parameters:

1. Open the configuration file in a text editor.

2. Change the parameters to the desired settings.

3. Save the file.

4. If the driver is already loaded, you must unload and reload the driver to implement

your changes. For more information, see “Installing and Uninstalling” on page 10.

To determine the requirement for the parameter change to take effect, see the

“Activation” column in Table 4-1, FCoE Configuration File Parameters, on page 19.

Configuring NPIV Support

This section details the procedure for configuring NPIV support.

Enabling NPIV Support on Solaris 10

To enable NPIV support in the driver:

1. Log in as “root”, or “su” to root.

2. Set enable-npiv=1 in the configuration file.

3. The FC port (fp) driver parameters are updated when the Emulex emlxu utilities

package (EMLXemlxu) is installed. Entries from 2–254 can be added to the

/kernel/drv/fp.conf file. For example:

name="fp" class="fibre-channel" port=0;

name="fp" class="fibre-channel" port=1;

name="fp" class="fibre-channel" port=2;

name="fp" class="fibre-channel" port=3;

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

4. FCoE Driver Configuration

Editing the FCoE Configuration File (elxfc.conf)

18

name="fp" class="fibre-channel" port=4;

name="fp" class="fibre-channel" port=5;

name="fp" class="fibre-channel" port=6;

name="fp" class="fibre-channel" port=7;

name="fp" class="fibre-channel" port=8;

name="fp" class="fibre-channel" port=9;

The first two lines are listed by default because ports 0 and 1 are required. The

above example shows that ports 2–9 have been added to support up to 10 virtual

ports. The port number of each entry must increment by 1 in sequential order,

without gaps in the number sequence. That is, you cannot have “

name="fp"

class="fibre-channel" port=7;”

and then have the next line be “name="fp"

class="fibre-channel" port=10;

”.

4. Reboot the system.

To create, delete, and list virtual ports after a system reboot, see the OneCommand

Manager Application User Manual.

Enabling NPIV Support on Solaris 11

To enable NPIV support in the driver:

1. Log in as “root”, or “su” to root.

2. The “enable-npiv” parameter is set to 0 by default. To enable NPIV, set enable-npiv

to 1 in the configuration file.

See Chapter 6 of the Solaris Express SAN Configuration and Multipathing Guide, which is

available on the Oracle website.

NPIV Limitations

The following limitations apply to NPIV:

 Due to the limitation of the Solaris SFS stack, deleting a virtual port causes that

virtual port to go offline.

 FC-IP is not supported on virtual ports.

 The Emulex LightPulse

®

LPe12000 family of adapters can support up to 255

virtual ports.

 You cannot delete a virtual port with a mounted file system.

NPIV and Operating System Virtualization

Solaris has several operating system virtualization solutions, including Oracle VM for

x86 and Solaris containers. Devices configured to be seen on an Emulex FCoE port

(either a physical port or a virtual port) can be used with any of these operating system

virtualization solutions. It is recommended that you consult the latest document on

these technologies to learn the best use of resources related to NPIV technology.

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

4. FCoE Driver Configuration

FCoE Configuration File Parameters

19

Using VPorts with Oracle VM Server for Solaris Containers or

Oracle VM Server for 86

To use NPIV with Solaris containers or Oracle VM Server for x86 (formerly xVM) user

domains:

1. Create virtual ports for the domains or containers to which you want to present

dedicated storage.

2. Discover and attach the targets to the virtual ports.

3. Assign the target to the domain or container. The attachment runs through the

virtual port that provides the path to the target.

FCoE Configuration File Parameters

Notes

 All adapter-specific parameters have an elxfcX prefix, where “X” is the driver

instance number. For example, setting “elxfc0-link-speed=4” makes “4 Gbps”

the link speed setting for the “0” instance of the elxfc driver.

 All parameters are adapter-specific.

 If you want to override a driver parameter for a single driver-loading session,

you can specify it as a parameter to the modload command. The following

example is for 64-bit platforms:

modload /kernel/drv/amd64/elxfc automap=0

 The OneCommand Manager application reflects the configuration file driver

parameters. For more information, see the OneCommand Manager Application

User Manual.

 The “Activation” column in Table 4-1 shows the requirement for the parameter

change to take effect. Activation requirements include adapter reset, dynamic

reset (no reset is necessary), link reset, and reboot.

Table 4-1 lists the FCoE configuration file parameters.

Table 4-1 FCoE Configuration File Parameters

Parameter Description Activation

ack0 Indicates whether the adapter uses or attempts to use ACK0 for

Class 2.

• 0 = The adapter only uses ACK1 when running Class 2 traffic

(default).

• 1 = The adapter attempts to use ACK0 when running Class 2

traffic to a device.

If the device does not support ACK0, then the adapter uses ACK1.

Adapter

reset

Emulex Drivers Version 10.6 for Solaris User Manual P011396-01A Rev. A

4. FCoE Driver Configuration

FCoE Configuration File Parameters

20

adisc-support Sets the driver level support for the FC ADISC login I/O recovery

method.

• 0 = No support. Flushes active I/Os for all FCP target devices at

link down.

• 1 = Partial support. Flushes I/Os for non-FCP2 target devices at

link down

• 2 = Full support. Holds active I/Os for all devices at link down.

Dynamic

assign-alpa If multiple adapter instances on the same host are on the same loop,

set this property differently for each adapter.

Possible values are 0x00–0x0ef. A 0x00 setting (default) means no

preference.

Note: This property is only applicable if the topology is set to loop.

Link reset

console-errors Verbose mask for driver error messages to the console. Possible

values are 0x0000000–0xFFFFFFFF. The default value is 0x0000000.

Dynamic

console-notices Verbose mask for driver notice messages to the console. Possible

values are 0x0000000–0xFFFFFFFF. The default value is 0x0000000.

Dynamic

console-

warnings

Verbose mask for driver warning messages to the console. Possible

values are 0x0000000–0xFFFFFFFF. The default value is 0x0000000.

Dynamic

cr-count Specifies a count of I/O completions after an interrupt response is

generated. The possible values are 1–255. The default value is 1.

Note: This property is disabled if cr-delay=0.

Link reset

cr-delay Specifies a count in milliseconds after which an interrupt response is

generated if cr-count has not been satisfied. Possible values are

0–63. The default value is 0.

Note: If cr-delay=0, the Coalesce Response parameter (cr_count) is

disabled.

Link reset

enable-auth DHCHAP support in the driver.

• 0 = Disabled (default)

•1 = Enabled

Link reset

enable-npiv NPIV support in the driver.

• 0 = Disabled-remove all vports first

• 1 = Enabled (requires SLI-3 and later)

Adapter

reset

linkup-delay Sets the driver wait period (seconds) for a link up after adapter

initialization. Possible values are 0–60. The default value is 10.

Adapter

reset

log-errors Verbose mask for driver error messages to the messages file. Possible

values are 0x0000000–0xFFFFFFFF. The default value is 0xFFFFFFFF.

Dynamic

log-notices Verbose mask for driver notice messages to the messages file.

Possible values are 0x0000000–0xFFFFFFFF. The default value is

0xFFFFFFFF.

Dynamic

log-warnings Verbose mask for driver warning messages to the messages file.

Possible values are 0x0000000–0xFFFFFFFF. The default value is

0xFFFFFFFF.

Dynamic

Table 4-1 FCoE Configuration File Parameters (Continued)

Parameter Description Activation

Page is loading ...

Broadcom Emulex Drivers Version 10.6 for Solaris User User guide

Related papers

Other documents