Broadcom Elxflash and LpCfgManagement UtilitiesVersion 10.4 User guide

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

Elxflash and LpCfg

Management Utilities

Version 10.4

User Manual

Elxflash and LpCfg Management Utilities User Manual P011038-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, AutoPilot Installer, AutoPilot Manager, BlockGuard, Connectivity Continuum,

Convergenomics, Emulex Connect, Emulex Secure, EZPilot, FibreSpy, HBAnyware, InSpeed, LightPulse, MultiPulse,

OneCommand, OneConnect, One Network. One Company., SBOD, SLI, and VEngine are trademarks of Emulex. All

other brand 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

Note: References to OCe11100 series products also apply to OCe11100R series products.

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

Table of Contents

3

Table of Contents

1. Introduction.....................................................................................8

Elxflash Offline Kit....................................................................................8

Elxflash Utility .........................................................................................9

Command Syntax......................................................................................9

Supported Platforms................................................................................ 10

Abbreviations ........................................................................................ 10

2. Installation.....................................................................................12

Platform Prerequisites ............................................................................. 12

Linux...............................................................................................12

Elxflash Offline and Elxflash Standalone Kits....................................................12

ElxflashOffline Kit for NIC Only....................................................................12

Windows...........................................................................................13

FreeBSD ...........................................................................................13

Installing the ElxflashOffline Kit for Linux ..................................................... 13

Updating...........................................................................................14

Uninstalling .......................................................................................14

Installing the ElxflashOffline NIC Only Kit for Linux ......................................... 14

Updating...........................................................................................14

Uninstalling .......................................................................................14

Installing the ElxflashOffline Kit for Windows PE............................................. 15

Updating...........................................................................................15

Uninstalling .......................................................................................15

Extracting the Driver Files from the ElxflashOffline Kit for Windows.................... 15

Extracting the ElxflashStandalone Kit (Linux and Windows) ............................... 16

Installing the ElxflashOffline Kit for FreeBSD ................................................. 17

Updating...........................................................................................17

Uninstalling .......................................................................................17

Firmware and Boot Code .......................................................................... 18

3. Elxflash Utility Command Line Interface................................................19

Auto-Discovery (/auto) ............................................................................. 19

Downgrade (/downgrade or /g) ................................................................... 20

Force Firmware and Boot Code (/f) ............................................................. 21

Force Boot Code (/fb) .............................................................................. 22

Force Firmware (/ff)................................................................................ 23

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

Table of Contents

4

Firmware Matrix Directory Change (/fmd) ..................................................... 24

Firmware Flash Override (/fo).................................................................... 24

Help (/h or /?)........................................................................................ 25

Image Directory Change (/id) ..................................................................... 25

Image Version Display (/iv)........................................................................ 25

Log (/log).............................................................................................. 26

Preview (/p) .......................................................................................... 26

Process FC HBAs Only (/fc) ........................................................................ 27

Processing UCNAs (/ucna) ......................................................................... 27

Query (/q)............................................................................................. 28

Ramdrive (/ramdrive) - (Windows Offline Adapter Management Utility only) .......... 28

Rewrite (/rewrite or /e)............................................................................ 29

Silent (/s).............................................................................................. 30

Discover CNAs using SysFS (/sysfs)............................................................... 31

Update (/update).................................................................................... 31

Verbose (/v) .......................................................................................... 33

VPD (/vpd) ............................................................................................ 34

4. LpCfg Utility Command Line Interface...................................................35

Running the LpCfg Utility from the Command Prompt ...................................... 35

Running the LpCfg Utility Included with the ElxflashStandalone Kit ..................... 36

Windows...........................................................................................36

Linux...............................................................................................37

Supported Commands ...........................................................................39

Viewing the Syntax for Commands (help or ?)...............................................42

Resetting an Adapter (reset)...................................................................42

Running the Power-on Self Test (posttest) ..................................................42

Viewing Adapter Information ..................................................................... 43

Viewing Emulex Conventional Names Instead of VPD (- /c)...............................43

Viewing the LpCfg Utility Version Information (version)...................................43

Viewing VPD ......................................................................................43

Viewing Boot Device Information (readbootdevice)........................................43

Viewing BootBIOS Versions (listboot) .........................................................44

Viewing Adapter Attributes (hbaattr) ........................................................44

Viewing All Adapters in the System (listhba)................................................44

Viewing the WWN of All Adapters in the System (listwwn) ...............................44

Viewing the MAC Address (listmac) ...........................................................45

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

Table of Contents

5

Reading the MAC Address (readmac) .........................................................45

Viewing Firmware Program Revisions (listrev) ..............................................45

Viewing Selected Configuration Regions (readconfig) .....................................46

Firmware and Boot Code Download Commands............................................... 46

Downloading a File (download)................................................................46

Accessing the Flash Device Directly (directdownload).....................................47

World Wide Name Commands..................................................................... 47

Writing WWN and Updating NVPARMS (writewwn) .........................................47

Saving WWN Data to a File (savewwn) .......................................................48

Restoring WWN and Updating NVPARMS (restorewwn).....................................49

Restoring NVPARMS (restorenvwwn)..........................................................49

Restoring the IEEE address (restoredefwwn) ................................................49

Boot Code Commands .............................................................................. 49

Enabling or Disabling BootBIOS or Boot Code (enableboot or disableboot).............50

Selecting a Boot Device (setbootdevice).....................................................50

Enabling or Disabling Boot Devices (enablebootdevice or disablebootdevice).........51

Read All Alternative Boot Devices (readaltboot) ...........................................51

Selecting One or More Alternate Boot Devices (setaltboot)...............................51

Configuration Commands .......................................................................... 52

Updating Configuration Regions (config).....................................................52

Update by Name .....................................................................................52

Update by Number...................................................................................52

Personality Commands ............................................................................. 53

Viewing Personality Information (personalityInfo) .........................................53

Changing Personality Information (changePersonality)....................................53

Diagnostic Tests ..................................................................................... 53

Running the External Loopback Test (extloopback)........................................54

Running the Internal Loopback Test (intloopback) .........................................54

Running the PCI Loopback Test (pciloopback) ..............................................55

Running the DMATest............................................................................56

Using Script Files.................................................................................... 56

Creating Script Files.............................................................................56

Script File Commands ...........................................................................57

Repeating a Series of Commands (repeat).......................................................57

Updating Non-volatile WWNN (scriptwwnn) .....................................................58

Updating Non-volatile WWPN (scriptwwpn) .....................................................58

Updating Volatile WWNN (scriptvwwnn) .........................................................59

Updating Volatile WWPN (scriptvwwpn) .........................................................60

Creating a Log (logfile) .........................................................................60

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

Table of Contents

6

VLAN Commands .................................................................................61

Reading VLAN Priorities (readvlanprops).........................................................61

Restoring the Default Values for the VLAN ID and VLAN Priorities

(restorevlanprops)...................................................................................61

Changing the VLAN ID and VLAN Priority on a Specified Adapter’s NIC

Function (writevlanprops)..........................................................................61

5. Elxflash Utility Status Messages ...........................................................63

6. LpCfg Error Codes............................................................................65

7. Troubleshooting ..............................................................................68

Unsupported Driver................................................................................. 68

Updating Adapters without Boot Code.......................................................... 69

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

List of Tables

7

List of Tables

Table 4-1 Supported Commands for LpCfg ........................................................39

Table 5-1 Elxflash Status Messages .................................................................63

Table 6-1 LPCfg Error Codes.........................................................................65

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

1. Introduction

Elxflash Offline Kit

8

1. Introduction

This document explains how to use the adapter management utility kits for Linux,

FreeBSD, and Windows pre-boot environments.

Elxflash Offline Kit

The ElxflashOffline kits allow you to configure Emulex

®

adapters before you install or

boot a server operating system. You can also use the Elxflash Standalone kit, which

allows you to update firmware on Emulex adapters without installing any tools. See

“Running the LpCfg Utility Included with the ElxflashStandalone Kit” on page 36 for

more information.

The Elxflash Offline kit includes:

 linlpcfg and elxflash for FreeBSD

 linlpcfg and elxflash for Linux

 winlpcfg and elxflash for Windows

The winlpcfg and the linlpcfg are management utilities for adapter configuration and

diagnostics for Windows and Linux respectively. linlpcfg is also used for the FreeBSD

operating system. The LpCfg utility can also download firmware, but you must

manually select which adapters to update.

Elxflash is a firmware download utility. When the /auto switch is used, Elxflash

automatically chooses the “best” image to download. When the fwmatrix.txt file is

used, you choose which images to apply to the adapters.

Additionally, Linux has an offline utility for network interface card (NIC) adapters

only. This utility uses operating system-provided features and utilities to discover

universal converged network adapters (CNAs) and download firmware. This utility

relies on the inbox driver for supported distributions and only supports CNAs. See

“ElxflashOffline Kit for NIC Only” on page 12 for more information.

Note: The Offline utility, except for the standalone version, must be installed on your

system before you can run it. While the standalone utility does not need to be

installed before it is run, you must go to the directory into which the standalone

utility was extracted and run it from the command prompt.

See “LpCfg Utility Command Line Interface” on page 35 for further information on the

offline utility.

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

1. Introduction

Elxflash Utility

9

Elxflash Utility

The Elxflash utility uses a command line interface allowing you to build scripts for

automated and unattended firmware and boot code download solutions for Emulex

LightPulse

®

Fibre Channel (FC) host bus adapters (HBAs), LightPulse FC and Fibre

Channel over Ethernet/network interface card (FCoE/NIC), and Emulex OneConnect

®

CNAs that are in production systems. You can also download firmware and boot code

on local and remote machines simultaneously.

The Elxflash Standalone kit, which allows you to update firmware on Emulex adapters

without needing to install any tools, is also available. See “Running the LpCfg Utility

Included with the ElxflashStandalone Kit” on page 36 for more information.

The Elxflash utility uses auto-discovery (/auto) so you do not need to maintain the

fwmatrix.txt configuration file. When auto-discovery is invoked, the utility

automatically discovers local adapters and performs selected operations such as: /ff

(force firmware), /fb (force boot), /update, /downgrade, and /rewrite.

When using auto-discovery you must populate the firmware and boot subdirectories

with image files for specific adapter models. Auto-discovery requires the use of Emulex

defined firmware and boot code file names in their respective directories.

If you do not want to use auto-discovery, the Elxflash utility can update the firmware

or boot code of an adapter using the fwmatrix.txt configuration file. When using the

fwmatrix.txt file, you must update each supported adapter's type, firmware, and boot

code entries and place the corresponding firmware and boot code images into their

respective directories. The fwmatrix.txt file enables all operations that are used with

auto-discovery.

Command Syntax

In all cases, the commands are given with the prefix os. When you enter any command,

you must replace os with either:

 ./lin – for the Linux LpCfg utility commands, for use on Linux and FreeBSD

machines.

 win – for the WinPE LpCfg utility commands, for use on WinPE machines.

The LpCfg utility commands are not case-sensitive, nor are their arguments. You can

enter them in upper, lower, or mixed case. However, for Linux operating systems,

Emulex recommends using linlpcfg (all lowercase) for the utility commands (for

example, ./linlpcfg listhba).

The LpCfg utility commands require both:

 One space between the command name and the first argument.

 One space between additional arguments.

Note: Do not put a space before or after the equal sign within an argument.

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

1. Introduction

Supported Platforms

10

WWN values are reported and specified with two 4-byte hexadecimal words – WWN

word 0 (w0) and WWN word 1 (w1). To make the full WWN, concatenate the w0 and

w1 values.

For detailed information on using the command line interface, see chapter 3., “Elxflash

Utility Command Line Interface,” on page 19 and chapter 4., “LpCfg Utility Command

Line Interface,” on page 35.

Supported Platforms

For supported adapters, and supported versions of operating systems and platforms,

see the Emulex website.

Abbreviations

BIOS basic input-output system

CNA converged network adapter

EFI Extensible Firmware Interface

EROM erasable read-only memory

FC Fibre Channel

FCoE Fibre Channel over Ethernet

HBA host bus adapter

HEX hexadecimal

IEEE Institution of Electrical and Electronics Engineers

GUI graphical user interface

iSCSI internet Small Computer System Interface

LUN logical unit number

MAC media access control

MILI Management Interface Library

ms milliseconds

NIC network interface card (or controller)

PCI peripheral controller interface

PCI_ID PCI device identification number

POST power-on self test

ROM read-only memory

SAN storage area network

UCNA universal converged network adapters

VPD vital product data

WWN world wide name

WWNN world wide node name

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

1. Introduction

Abbreviations

11

WWPN world wide port name

XML extensible markup language

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

2. Installation

Platform Prerequisites

12

2. Installation

This chapter details prerequisites and procedures for installing and uninstalling the

ElxflashOffline kit for: Linux, Windows, and FreeBSD. It also describes the updating

procedure for each supported operating system.

Platform Prerequisites

The utilities included in the ElxflashOffline kit for Linux and FreeBSD have

prerequisites that must be installed prior to installing the utilities. The Windows

operating system does not have prerequisites.

Linux

The Linux platform requires additional software, such as libraries, to run the different

versions of the utility. This section provides the prerequisites.

Note: The Linux driver must be installed on the system for the applications to work

properly.

Elxflash Offline and Elxflash Standalone Kits

The following software must be installed to run the different versions of the utility.

 libnl

 ethtool

 lspci

 libsysfs (optional)

ElxflashOffline Kit for NIC Only

RHEL 5.6 and later

 NIC driver

 ethtool

 libsysfs

RHEL 6.1, RHEL 7.0 and later

 NIC driver

 ethtool

 libsysfs

 pcutils-libs

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

2. Installation

Installing the ElxflashOffline Kit for Linux

13

SLES 11 SP1 and later

 NIC driver

 ethtool

 sysfsutils

 pcituils

CentOS 6.1, CentOS 7.0, and later

 NIC driver

 ethtool

 libsysfs

 pcutils-libs

Windows

There are no prerequisites for Windows.

FreeBSD

The FreeBSD platform requires additional software, such as libraries, to run the

Elxflash utilities. These prerequisites are listed below and provided by the operating

system.

 libstdc++

 libm

 libc

 libgcc

Note: BASH is required to run the install and uninstall scripts. If it is not installed, you

must install the BASH package, which is part of the FreeBSD distribution.

Installing the ElxflashOffline Kit for Linux

The ElxflashOffline Kit for Linux uses an install script to install the elxflash and linlpcfg

utilty RPM packages. The install script determines the correct architecture and

distribution, and updates the existing ElxflashOffline and Elxlinlpcfg RPM packages. If

there are no existing ElxflashOffline or Elxlinlpcfg RPM packages, the install script

installs the packaged ElxflashOffline and Elxlinlpcfg RPM packages.

To install the ElxflashOffline Kit for Linux:

1. Untar the installation tarball.

2. Run the install script located on the root of the installation kit.

Example:

$ tar zxvf elxflashOffline-linux-<version>-<rel>.tgz

$ cd elxflashOffline-linux-<version>-<rel>

$ ./install.sh

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

2. Installation

Installing the ElxflashOffline NIC Only Kit for Linux

14

Updating

To update an existing ElxflashOffline Kit for a Linux installation, run the install.sh

script to update the ElxflashOffline and Elxlinlpcfg RPM packages.

Uninstalling

The ElxflashOffline Kit for Linux uses an uninstall script to uninstall the utility. The

uninstall script executes specific actions depending on the switches that are used.

 ./uninstall.sh – Uninstalls the ElxflashOffline and Elxlinlpcfg RPM packages.

 ./uninstall.sh -h – Displays a summary of all available switches

To uninstall the ElxflashOffline Kit for Linux, run the uninstall script located on the

root of the installation kit.

Example:

$ cd elxflashOffline-linux-<version>-<rel>

$ ./uninstall.sh

Installing the ElxflashOffline NIC Only Kit for Linux

The install script determines the correct architecture and distribution, and upgrades the

existing ElxflashOffline (NIC only) RPM package. If there is no existing ElxflashOffline

RPM package, the install script installs the packaged ElxflashOffline RPM package.

To install the ElxflashOffline NIC Only Kit:

1. Untar the installation tarball.

2. Run the install script located in the root directory of the installation kit.

Example:

$ tar zxvf elxflashOffline_NIC_Only-linux-<version>-<rel>.tgz

$ cd elxflashOffline_NIC_Only-linux-<version>-<rel>.tgz

$ ./install.sh

Updating

To update the ElxflashOffline_NIC_Only kit, run the install.sh script to upgrade the

ElxflashOffline RPM package.

Uninstalling

To uninstall the ElxflashOffline_NIC_Only kit, run the uninstall script located in the

root directory of the installation kit.

The uninstall script executes specific actions depending on the switches used.

 ./uninstall.sh – Uninstalls ElxflashOffline RPM package

 ./uninstall.sh -h – Displays a summary of all available switches

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

2. Installation

Installing the ElxflashOffline Kit for Windows PE

15

Example:

$ cd elxflashOffline_NIC_Only-linux-<version>-<rel>.tgz

$ ./uninstall.sh

Installing the ElxflashOffline Kit for Windows PE

To install the ElxflashOffline kit for Windows PE:

1. Unzip the Offline-WinPE-<version>-<rel>.zip.

2. Change the directory to the correct architecture subdirectory.

3. Run setupElxAll-<arch>.exe.

The following components are installed:

 Storport CNA driver

 Storport Fibre Channel (FC) driver

 OneConnect iSCSI and NIC drivers

 winLpCfg – Elxflash Offline

Note: The setupElxAll-<arch>.exe file is compatible only with WinPE. It does not

function with any version of Windows Server.

Updating

To update an existing ElxflashOffline kit installation, run the same steps for installing

the ElxflashOffline kit for Windows PE above.

The installer uninstalls the existing version and then installs the updated version.

Uninstalling

To uninstall the ElxflashOffline kit for Windows PE, run the following commands:

X:\>cd "X:\ProgramData\Tarma Installer\{AE1F1CA1-B626-4447-9208-14607187EC3D}"

X:\>setup.exe /remove

Extracting the Driver Files from the ElxflashOffline

Kit for Windows

To extract the driver files from the ElxflashOffline kit, you can use the installer or the

command line. When extracting these files, all files, both x64 and x86, are extracted to

<Drive>:\My Documents\Emulex\Drivers. This location is hard-coded and cannot be

changed.

Note: Extracting all the drivers takes an additional 28 MB. By default, Windows PE

allocates only 32 MB of writeable memory. The size of the writable memory

may be increased when building the WinPE ISO image.

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

2. Installation

Extracting the ElxflashStandalone Kit (Linux and Windows)

16

You can extract the driver files using the GUI mode by running the installer or you can

use the command line in silent mode.

To extract the drivers from the ElxflashOffline kit for Windows:

GUI Mode

1. Run the installer.

2. From the Installation Options screen, select Extract All Drivers, and deselect

Install elxApp_Drivers (64-bit).

3. Click Install to continue.

Silent Mode

From the command line, type

start/wait SetupElxAll-x64.exe/q2 extract=2

Note: Values for the “extract” parameter are:

 0 —Install the package; do not extract drivers. (DEFAULT)

 1 —Install the package; extract drivers

 2 —Do not install the package; extract drivers.

Extracting the ElxflashStandalone Kit (Linux and

Windows)

The ElxflashStandalone kit is not installed; you must extract it from its zip file. After

you extract the utility, the following directories are created. The Linux executable files

are extracted to the lx\ directory, or the Windows executable files are extracted to the

win\ directory.

 boot\

 firmware\

 lx\

 win\

In Windows, for example, three directories are visible in the kit's root directory after

you extract the standalone utility. The top level “boot” directory and “firmware”

directory are the default directories in which Elxflash looks for boot code and firmware

images. Ensure that firmware and boot code are located in these directories.

# dir

07/05/2012 07:02 PM <DIR> .

07/05/2012 07:02 PM <DIR> ..

07/02/2012 03:14 PM <DIR> boot

07/02/2012 03:14 PM <DIR> firmware

07/02/2012 03:15 PM <DIR> win

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

2. Installation

Installing the ElxflashOffline Kit for FreeBSD

17

The ElxflashStandalone kit has the same dependencies as the ElxflashOffline kits. See

“Platform Prerequisites” on page 12.

Note: Update or uninstall procedures for the ElxflashStandalone kit are not available.

When a new version is available, you extract it, replacing the older version.

Installing the ElxflashOffline Kit for FreeBSD

The ElxflashOffline kit installation for FreeBSD uses an install script. The install script

determines the correct architecture and distribution and performs the following

operations:

 Installs the Elxflash utility and linlpcfg

 Temporarily mounts /proc

Note: For security reasons, /proc is not mounted by default; however, Elxflash and

linlpcfg require that /proc be mounted in order to run. Verify /proc is mounted

before running Elxflash or linlpcfg.

To install the ElxflashOffline kit for FreeBSD:

1. Untar the installation tarball.

2. Run the install script located in the root directory of the installation kit.

For example:

# tar xvf elxflashOffline-FreeBSD-<version>-<rel>.tgz

# cd elxflashOffline-FreeBSD-<version>-<rel>

# ./install.sh

Updating

To update the ElxflashOffline kit for FreeBSD, uninstall the old version and then unzip

the new version.

Uninstalling

To uninstall the ElxflashOffline kit for FreeBSD:

Run the uninstall script located in the root directory of the installation kit.

For example:

# cd elxflashOffline-FreeBSD-<version>-<rel>

# ./uninstall.sh

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

2. Installation

Firmware and Boot Code

18

Firmware and Boot Code

Firmware images are available on the Emulex support site at:

http://www.emulex.com. All firmware image files are expected to be in the

sub-directory named “firmware”. All boot code image files are expected to be in the

sub-directory named ”boot”. The HBA types are always Emulex model names.

Note: OneConnect models (FCoE, iSCSI, and NIC) may share the same Emulex model

name, but can run different protocols. For example, an Emulex model OCe10102

can be an FCoE, iSCSI, or NIC CNA.

When the fwmatrix.txt file is used, the Elxflash model name must include the highest

protocol being used on that model. An adapter's Elxflash model name can be seen by

running the /query command.

Notes:

 On an FCoE/NIC adapter, the highest protocol is FCoE. On an iSCSI/NIC

adapter, the highest protocol is iSCSI.

 Ensure that there are no spaces in the fwmatrix.txt model name to avoid a

firmware update failure.

For example:

# ./elxflash /q

HBA=OCe11100-iSCSI, Port Type=iSCSI, MAC=00:00:C9:AD:AD:21, PCI ID=712, VID=19A2,

SSID=E702, SVID=10DF, Firmware=4.0.493.0, Boot Code=2.0.21.768

HBA=OCe11100-iSCSI, Port Type=iSCSI, MAC=00:00:C9:AD:AD:25, PCI ID=712, VID=19A2,

SSID=E702, SVID=10DF, Firmware=4.0.493.0, Boot Code=2.0.21.768

HBA=OCe11100-iSCSI, Port Type=NIC, MAC=00:00:C9:AD:AD:20, PCI ID=710, VID=19A2,

SSID=E702, SVID=10DF, Firmware=4.0.493.0, Boot Code=2.0.21.768

HBA=OCe11100-iSCSI, Port Type=NIC, MAC=00:00:C9:AD:AD:24, PCI ID=710, VID=19A2,

SSID=E702, SVID=10DF, Firmware=4.0.493.0, Boot Code=2.0.21.768

elxflash.exe: All required queries succeeded - Return Code=0

Note: The OCe11100 CNA in the example above is an iSCSI adapter, which has the

Elxflash model name of OCe11100-iSCSI.

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

3. Elxflash Utility Command Line Interface

Auto-Discovery (/auto)

19

3. Elxflash Utility Command Line Interface

Two supported modes for each Elxflash utility switch are available. The first mode

relies on the fwmatrix.txt file. It is your responsibility to update the firmware and boot

code directories with the appropriate firmware and boot code images.

Note: Ensure that there are no spaces in the fwmatrix.txt model name to avoid a

firmware update failure.

The second mode is auto-discovery. When the /auto switch is used with the following

switches, the Elxflash utility automatically discovers adapters and, using the firmware

and boot subdirectories, performs the specified operation on each adapter.

 /f

 /fb

 /ff

 /downgrade

 /rewrite

 /update

Auto-Discovery (/auto)

Usage: /auto

The auto-discovery switch instructs the Elxflash utility to ignore the fwmatrix.txt file,

automatically discover local adapters, and perform specified operations employing an

additional switch using the firmware and boot directories.

The /auto switch must be used with an additional operational switch such as:

 /f

 /ff

 /fb

 /downgrade

 /rewrite

 /update

Example usage:

./elxflash /auto /update – Updates the firmware and boot code using the firmware

and boot directories.

 The fwmatrix.txt file is ignored. You must place the desired versions of

firmware in the firmware directory.

 Using the firmware subdirectory, the Elxflash utility automatically discovers

the best matching firmware for each installed and supported adapter.

 If multiple versions of firmware or boot code are found for an adapter, the

Elxflash utility uses the most recent version when performing the firmware

download.

Elxflash and LpCfg Management Utilities User Manual P011038-01A Rev. A

3. Elxflash Utility Command Line Interface

Downgrade (/downgrade or /g)

20

Downgrade (/downgrade or /g)

Usage: /downgrade or /g

The downgrade switch downgrades the firmware or boot code of each adapter if the

currently installed versions are more recent than the downgrade versions. This switch

cannot be used with the /update or /rewrite commands.

Example usage:

./elxflash /downgrade /auto – Downgrades the firmware or boot code using

auto-discovery.

 The fwmatrix.txt file is ignored. You must place the desired downgrade

versions of firmware or boot code in their respective directories.

 If the downgrade versions are older than the currently installed versions on the

adapter, then the downgrade versions are downloaded to the adapter.

 If multiple downgrade versions of firmware or boot code are found for an

adapter, the next-previous downgrade versions are downloaded to the adapter.

 When performing the boot code downgrade operation, the Elxflash utility first

tries to match by adapter family and boot type. If a match is not found, the

Elxflash utility then tries to match by boot type. If the utility matches by boot

type and multiple versions of boot code are detected, downgrade chooses the

downgrade file in the following order:

1. Universal (U)

2. Pair (P)

3. Open (O)

4. EFI (E)

5. x86 (B)

./elxflash /downgrade – Downgrades the firmware or boot code using the fwmatrix.txt

file.

 For each installed and supported adapter, the current firmware or boot code

versions are compared with the versions specified in fwmatrix.txt.

 If the downgrade versions in fwmatrix.txt are older than the currently installed

versions, the downgrade versions of firmware or boot code are downloaded to

that adapter.

FC Adapter Download Summary

HBA=<model>, Port Type=<port_type>, WWN=<wwn>,

Update=<Boot Code|Firmware>, Image=<image>, New=<version>,

Old=<version>, Status=<description>

Page is loading ...

Broadcom Elxflash and LpCfgManagement UtilitiesVersion 10.4 User guide

Related papers

Other documents