Emulex EMULEX manual Modes of Operation emlxdrv, Interactive Mode emlxdrv

Page 30

Using the emlxdrv Utility

The emlxdrv utility is intended to be used for binding (associating) the Emulex emlxs (Leadville Fibre Channel) driver and the Emulex lpfc (traditional non-Leadville Fibre Channel) driver to the various models of Emulex Fibre Channel HBAs. This allows both drivers to coexist in the same host and attach to mutually exclusive Emulex Fibre Channel HBA models. In other words, the emlxs driver can be configured to attach and operate one set of HBA models, while the lpfc driver can be configured to attach and operate a different set of HBA models. However, Solaris does not allow both drivers to attach and operate the same model of HBA even if there are multiple HBAs of that model present. If the driver binding configuration is changed, the host system must usually be rebooted in order for the new configuration to take effect.

Modes of Operation (emlxdrv)

The emlxdrv utility program can be run in two modes:

Interactive

CLI

Interactive Mode (emlxdrv)

Run the emlxdrv utility program in interactive mode by typing the name of the program without any command line arguments:

# emlxdrv

After it is started, the emlxdrv program scans the host system and prepares a driver configuration table consisting of bindings (associations) between the emlxs and lpfc drivers and a list of Emulex Fibre Channel HBA models. After the table is prepared, the utility displays the following:

EMLXDRV Driver Management Utility, Version 1.00j

COPYRIGHT © 2004-2005 Emulex. All rights reserved.

Driver

Alias

Present

Boot

Sun

Models

-----------------------------------------------------------------

-

lpfs

no

no

no

LP8000S and LP9002S (SBUS)

-

f800

no

no

no

LP8000 and LP8000DC

lpfc

f900

yes

no

no

LP9002, LP9002C, LP9002DC, and LP9402DC

lpfc

f980

no

no

no

LP9802 and LP9802DC

emlxs

fa00

yes

no

no

LP10000, LP10000DC and LP10000ExDC

emlxs

fd00

no

no

no

LP11000 and LP11002

emlxs

fe00

no

no

no

LPe11000 and LPe11002

emlxs

f0a5

no

no

no

2G Blade Adapter (emlxs only)

emlxs

fc00

yes

no

yes

LP10000-S and LP10000DC-S

emlxs

fc20

no

no

yes

LPe11000-S and LPe11002-S

Available commands:

-----------------------------------------------------------------

set_emlxs <Alias>

- Sets emlxs

driver to bind

to

the

specified device(s)

set_emlxs_sun

- Sets emlxs

driver to bind

to

all

Sun devices

set_emlxs_all

- Sets emlxs

driver to bind

to

all

devices

set_lpfc <Alias>

- Sets lpfc

driver to bind to the specified device(s)

set_lpfc_nonsun

- Sets lpfc

driver to bind

to

all

non-Sun devices

clear_dev <Alias>

- Clears driver binding to the

specified device(s)

clear_lpfc

- Clears all

lpfc driver bindings

 

clear_emlxs

- Clears all

emlxs driver bindings

 

clear_sun

- Clears driver bindings to

all Sun devices

clear_nonsun

- Clears driver bindings to

all non-Sun devices

clear_all

- Clears driver bindings to

all devices

q

- Exits this

program.

 

 

 

emlxdrv>

FCA Utilities Reference Manual

Page 26

Image 30
Contents FCA Utilities FCA Utilities Reference Manual Introduction Using the emlxdrv Utility HbaFibre Channel Overview Solaris Fibre Channel StackSolaris Software Stack Installing the Utilities Enter y. The following message is displayedRemoving the Utilities Using the emlxuremove Script Installing the Utilities Package Manually Removing the Utilities Package ManuallyTo remove the emlxu utilities package, do the following Update the emlxu utilities by doing the following Updating the Utilities Package ManuallyInteractive Mode emlxadm Modes of Operation emlxadmCommand Descriptions emlxadm CLI Mode emlxadmGetnumdevs GetdevlistGetlogiparams wwpn FCA Utilities Reference Manual Setsympname string GethostparamsGetsympname GetsymnnameGetstate wwpn Devlogin wwpnDevlogout Devremove wwpnGetfwrev GetbootrevDownloadfcode filename Downloadfw filenameGetdumpsize Downloadboot filenameDownloads the specified boot image file to the HBA Example ForcedumpResethardcore Resetlink wwpn or zero for local linkResethard GettopologyType PID Parmgetnum Returns the total number of configurable parameters ExampleReturns a list of configurable parameters Example ParmgetlistFCA Utilities Reference Manual Parmget label Gets the value of a specified parameter in the driverParmset label value Msgbuf all or number -i intervalExample This example attempts to set a static parameter Gethostattrs Getportattrs index, wwn or allDisplays all of the current host HBA API attributes Example Seagate ST39103FC = Seagate ST39103FC Displays a help menu of utility commands Example Getpath indexExits the utility program Example Repeats the last command Example HbaInteractive Mode emlxdrv Modes of Operation emlxdrvEmlxdrv utility program can be run in two modes Interactive CLI Mode emlxdrv Setemlxssun Command Descriptions emlxdrvSetemlxs alias SetemlxsallSetlpfc alias SetlpfcnonsunCleardev alias Clearsun ClearlpfcClearemlxs ClearnonsunClearall Emlxdrv q Exiting