Emulex EMULEX manual CLI Mode emlxdrv

Page 31

The display comprises three parts: the current driver configuration table, a list of available commands and the emlxdrv prompt.

The driver configuration table contains the following columns of data:

Driver: Indicates which driver (emlxs, lpfc or "-" if none ) is currently configured to bind or attach to a specific adapter alias.

Alias: Indicates the specific adapter alias associated with a set of Emulex HBA models. Driver bindings can be made only with a specific adapter alias and not with a specific adapter model.

Present: Indicates whether this specific type of adapter is currently present in the host system. Emlxdrv allows you to bind a driver to adapters that are not currently present in the system but that may be present at some point in the future.

Boot: Indicates whether this specific type of adapter is currently providing connectivity to the system's boot disk. This is important because emlxdrv does not allow you to change the driver binding to an adapter currently providing connectivity to the boot disk. If the driver binding needs to be changed to a boot device, the system must first be configured to boot through an adapter of another type. This procedure is not in the scope of this document.

Sun: Indicates whether this specific type of adapter is branded and sold directly by Sun Microsystems.

Models: Provides a list of Emulex HBA models that are identified by a common adapter alias. Driver bindings can be made only with a specific adapter alias and not with a specific adapter model.

After the driver configuration table is a list of available commands. For a detailed explanation of each command and its arguments, see Command Descriptions (emlxdrv) on page 28.

Below the command list is an emlxdrv> prompt. From this point, the utility is prompt driven. When the prompt is displayed, you must enter one of the commands in the list. The current driver configuration table and the available command list are displayed automatically after each command is issued.

Some commands require an additional <alias> argument. You must specify one of the valid adapter aliases listed in the current driver configuration table. Each alias is shared by multiple adapter models. Driver bindings can be made only with an adapter alias and not with a specific adapter model.

To exit the program, enter q.

CLI Mode (emlxdrv)

The emlxdrv utility program can be run in CLI mode by typing the name of the program followed by a valid command and any required command arguments. For example, you can update the a device binding by entering all the information on one line at the operating system prompt:

# emlxdrv set_emlxs f980

Updating f980 ...

Done.

Driver

Alias

Present

Boot

Sun

Models

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

emlxs

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

FCA Utilities Reference Manual

Page 27

Image 31
Contents FCA Utilities FCA Utilities Reference Manual Introduction Hba Using the emlxdrv UtilitySolaris Fibre Channel Stack Fibre Channel OverviewSolaris Software Stack Enter y. The following message is displayed Installing the UtilitiesRemoving the Utilities Using the emlxuremove Script Removing the Utilities Package Manually Installing the Utilities Package ManuallyTo remove the emlxu utilities package, do the following Updating the Utilities Package Manually Update the emlxu utilities by doing the followingModes of Operation emlxadm Interactive Mode emlxadmCLI Mode emlxadm Command Descriptions emlxadmGetdevlist GetnumdevsGetlogiparams wwpn FCA Utilities Reference Manual Getsymnname GethostparamsGetsympname Setsympname stringDevremove wwpn Devlogin wwpnDevlogout Getstate wwpnDownloadfw filename GetbootrevDownloadfcode filename GetfwrevForcedump Downloadboot filenameDownloads the specified boot image file to the HBA Example GetdumpsizeGettopology Resetlink wwpn or zero for local linkResethard ResethardcoreType PID Parmgetlist Returns the total number of configurable parameters ExampleReturns a list of configurable parameters Example ParmgetnumFCA Utilities Reference Manual Gets the value of a specified parameter in the driver Parmget labelMsgbuf all or number -i interval Parmset label valueExample This example attempts to set a static parameter Getportattrs index, wwn or all GethostattrsDisplays all of the current host HBA API attributes Example Seagate ST39103FC = Seagate ST39103FC Getpath index Displays a help menu of utility commands ExampleExits the utility program Example Hba Repeats the last command ExampleModes of Operation emlxdrv Interactive Mode emlxdrvEmlxdrv utility program can be run in two modes Interactive CLI Mode emlxdrv Setemlxsall Command Descriptions emlxdrvSetemlxs alias SetemlxssunSetlpfcnonsun Setlpfc aliasCleardev alias Clearnonsun ClearlpfcClearemlxs ClearsunClearall Emlxdrv q Exiting