Elxflash User Manual
Contents
1. HBA lt model gt Port Type lt port tvpes MAC lt mac_address gt Firmware lt version gt Note On LightPulse adapters the query switch only displays boot code version information if the adapter has boot code installed Note When the query switch is used with an operational switch the query also includes an additional field called Supported Firmware or Supported Boot Code Elxflash User Manual Page 20 gt G EMULEX Ramdrive ramdrive Windows ElxflashOffline only Usage ramdrive lt drive letter gt The ramdrive switch is used to specify the drive for creating temporary and log files The default is drive X Remote remote ElxflashOnline only Usage remote The remote switch is used to enable updates on remote in band adapters Rewrite rewrite or e The rewrite switch updates the firmware and or boot code of each adapter if the currently installed versions are less than or equal to the rewrite versions This switch cannot be used with update or downgrade Example usage elxflash rewrite auto Rewrite the firmware and or boot code using auto discovery 1 The fwmatrix txt file is ignored You must place the desired rewrite versions of firmware and or boot code in their respective directories 2 If the rewrite versions are higher than or equal to the versions installed on the adapter then the rewrite versions are downloaded to the adapter 3 If multiple rewrite versions2. 6 elxflash fb rewrite a rewrite is ignored b Perform a Force Boot Code operation on all installed and supported adapters Unsupported Driver Elxflash will output an error similar to the following if an unsupported driver is installed on the system sh line 1 9810 Segmentation fault linlpcfg listhba gt temp txt elxflash no supported Emulex HBA s found Return Code 1 If an error similar to the above occurs verify that the correct version of the driver is installed The supported drivers and Linux distributions are listed in this document Updating Adapters without Boot Code Elxflash reports an adapter s Boot Code version as NONE when the adapter does not have boot code installed Elxflash will not update downgrade or rewrite the boot area if boot code is not present but firmware will still upgrade or downgrade without boot code You can force a boot code download using auto discovery or the fwmatrx txt file Elxflash User Manual Page 26
3. Elxflash User Manual Page 23 DE EMULEX 4 Status Messages GOOD ALL UPGRADES OK GOOD NO UPDATES NEEDED ERROR ALL UPGRADES FAILED ERROR SOME UPGRADES FAILED ERROR NO SUPPORTED HBA FOUND ERROR DIRECTORV NOT FOUND GOOD NO UPGRADES AVAILABLE NI Oh UI WYN Hi O l Elxflash uses two methods to compute the return status of a command Elxflash will take a very strict approach when an operation is performed using the fwmatrix txt file When an operation is performed using auto discovery Elxflash is less stringent Status Messages When Using the fwmatrix txt File If a supported adapter entry is found in the fwmatrix txt file an operation is conducted using the specified firmware and boot code versions A supported adapter is defined as an adapter with an entry in the fwmatrix txt file that is recognized by Elxflash The entry in fwmatrix txt must match Elxflash s internal identification 0 GOOD_ALL_UPGRADES_OK Returned if and only if all the supported adapters had a successful download performed 1 GOOD_NO_UPDATES_NEEDED Returned if and only if the supported adapters did not need an upgrade downgrade or rewrite operation 2 ERROR ALL UPGRADES FAILED Returned if all of the supported adapters failed to complete the requested download 3 ERROR SOME UPGRADES FAILED Returned if some of the supported adapters failed to complete the requested download 4 ERROR EMULEX APPS NOT INSTALLED Returned if E
4. rewrite or update Example usage elxflash auto update Update the firmware and boot code using the firmware and boot directories 1 The fwmatrix txt file is ignored You must place the desired versions of firmware in the firmware directory 2 Using the firmware subdirectory Elxflash automatically discovers the best matching firmware for each installed and supported adapter 3 If multiple versions of firmware and or boot code are found for an adapter Elxflash uses the highest version when performing the firmware download Elxflash User Manual Page 15 gt G EMULEX Downgrade downgrade or g The downgrade switch downgrades the firmware and or boot code of each adapter if the currently installed versions are higher than the downgrade versions This switch cannot be used with update or rewrite Example usage elxflash downgrade auto Downgrade the firmware and or boot code using auto discovery 1 The fwmatrix ixt file is ignored You must place the desired downgrade versions of firmware and or boot code in their respective directories 2 Ifthe downgrade versions are lower than the currently installed versions on the adapter then the downgrade versions are downloaded to the adapter 3 If multiple downgrade versions of firmware and or boot code are found for an adapter the next previous downgrade versions will be downloaded to the adapter 4 When performing the boot code downgrade operation Elxflash first t
5. Uninstalling To uninstall an ElxflashOnline Kit remove the elxflashOnline windows lt arch gt lt version gt lt rel gt directory that was created during installation Firmware and Boot Code Prefixes Table 3 provides the Emulex model names corresponding firmware and corresponding boot code filename prefixes Use the Elxflash Model name as the hbatvpe name argument in the string in the fwmatrix txt file The F W File Prefix column lists the 2 letters that begin the name of the appropriate firmware filename The Boot File Prefix column lists the 2 letters that begin the name of the boot code filename images xU Universal boot xB x86Boot xO OpenBoot xP Pair Boot x86 EFI xE EFIBoot Table 3 Firmware and Boot Code Prefixes Emulex Adapter Model Port Type F W File Prefix Boot File Prefix LP1050 FC MF MB MP ME LP1050DC FC MF MB MP ME LP10000 FC TD TU TB TO TE LP10000DC FC TD TU TB TO TE LP11000 FC BD BU BB BO BE LP11002 FC BF BU BB BO BE LP1150 FC JF JB JP JE LPe11000 FC ZD ZU ZB ZO ZE LPe11002 FC ZF ZU ZB ZO ZE Elxflash User Manual Page 11 Table 3 Firmware and Boot Code Prefixes Continued Emulex Adapter Model Port Type F W File Prefix Boot File Prefix LPe1150 FC WF WB WP WE LPe12000 FC UD UU UB UO UE LPe12002 FC UD UU UB UO UE LPe1250 FC OF OB OP OE LPe1205 FC UF UU UB UO UE OCE10102
6. Where lt description gt is Success or Error and lt n gt 0 for completion with no errors and a non zero error code for any error Note FCoE iSCSI and NIC only adapters require a system reboot to activate new firmware Elxflash User Manual Page 16 gt G EMULEX Note If the Preview switch is also used the Status lt description gt field is not displayed Force Firmware and Boot Code f or ff fb The Force Firmware and Boot Code switch forces a firmware and boot code download to an adapter regardless of the current version on the adapter When this switch is used a Force Firmware and Boot Code operation is performed regardless of any additional switches given on the command line Example usage elxflash f auto Force a firmware and boot code download using auto discovery 1 The fwmatrix txt file is ignored You must place the desired versions of firmware and boot code in their respective directories 2 If multiple versions of firmware and or boot code are found for an adapter Elxflash uses the highest versions when performing the firmware and boot code downloads elxflash f Force a firmware and boot code download using the fwmatrix txt file 1 For each installed and supported adapter force a download of firmware and boot code using the versions specified in the fwmatrix txt file LightPulse Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN l
7. ElxflashOffline installation run the Offline WinPE lt arch gt lt version gt lt rel gt exe The installer will uninstall the existing version and then install the updated version Uninstalling Run the Uninstall exe located in X Program Files Emulex Util elxApp Windows ElIxflashoOnline Kit Package Contents Kit Name e elxflashOnline windows lt version gt lt rel gt zip Root directory e elxflashOnline windows x64 e elxflashOnline windows x86 ElxflashOnline directory contents e boot the boot code subdirectory e firmware the firmware subdirectory e elxflash exe the elxflash executable Elxflash User Manual Page 10 DE EMULEX e fwmatrix txt a sample configuration file e lcrefish bat a sample batch file readme txt a readme with usage instructions Installing To install an ElxflashOnline Kit 1 Unzip the elxflashOnline windows lt version gt lt rel gt zip file 2 Copy the elxflashOnline windows lt arch gt lt version gt directory to the directory you choose Note To run Elxflash you must install the OneCommand Manager application and the adapter drivers These components are not included in the ElxflashOnline Kit Upgrading With an existing ElxflashOnline installation run the elxocmcore windows lt version gt lt rel gt exe The installer uninstalls the existing version and then installs the updated version Replace the previous ElxflashOnline directory with the new version
8. gt lt EMULEX Elxflash Version 5 1 User Manual One Network One Company P006127 01A Rev A Connect with Emulex DE EMULEX Copyright 2003 2010 Emulex All rights reserved worldwide No part of this document may be reproduced by any 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 r
9. n gt 0 for completion with no errors and a non zero error code for any error Note FCoE iSCSI and NIC only adapters require a system reboot to activate new firmware Verbose v Usage v The verbose switch displays progress messages and can be used with any switch When this switch is used the following information is displayed 1 A download summary for all adapters that had successful or failed downloads 2 Asummary of unsupported adapters if applicable 3 Aper adapter status message for each adapter that Elxflash did not update LightPulse Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update lt Boot Code Firmware gt Image lt image gt New lt version gt Old lt version gt Status lt description gt FCoE Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt iSCSI and NIC only Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt MAC lt mac_address gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Return Code lt n gt Where lt description gt is Success or Error and lt n gt 0 for completion with no errors and a non zero error code for any error
10. of firmware and or boot code are found for an adapter the highest versions are downloaded to the adapter 4 When performing the boot code rewrite operation Elxflash first tries to match by adapter family and boot type If a match is not found Elxflash then tries to match by boot type If matching by boot type and multiple versions of boot code are detected rewrite always chooses in the following order Universal U Pair P Open O EFI E and x86 B elxflash rewrite Rewrite the firmware and or boot code using the fwmatrix txt file 1 For each installed and supported adapter the current firmware and boot code versions are compared with the versions in fwmatrix txt 2 If the currently installed versions are less than or equal to the rewrite versions in fwmatrix txt then the rewrite versions of firmware and or boot code are downloaded to the adapter LightPulse Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update lt Boot Code Firmware gt Image lt image gt New lt version gt Old eversions Status lt description gt FCoE Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Elxflash User Manual Page 21 gt G EMULEX iSCSI and NIC only Adapter Download Summary lt date
11. versions of boot code in the boot directory 2 If multiple versions of boot code are found for an adapter Elxflash uses the highest version when performing the boot code download elxflash fb Force boot code using the fwmatrix txt file 1 For each installed and supported adapter force a download of boot code using the firmware version specified in the fwmatrix txt file LightPulse Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Boot Code Image lt image gt New lt version gt Old lt version gt Status lt description gt Return Code lt n gt Where lt description gt is Success or Error and lt n gt 0 for completion with no errors and a non zero error code for any error Note If the Preview switch is also used the Status lt description gt field is not displayed Force Firmware ff The Force Firmware switch forces a firmware download to an adapter regardless of what firmware the adapter currently has installed When this switch is used a Force Firmware operation is performed regardless of any additional switches given on the command line Example usage elxflash ff auto Force a firmware download using auto discovery 1 The fwmatrix txt file is ignored You must place the desired versions of firmware in the firmware directory 2 If multiple versions of firmware are found for an adapter Elxflash uses the highest version
12. BU503A4 PRG BU503A4 PRG JP503A4 PRG ZU503A4 PRG ZU503A4 PRG WP503A2 PRG UU503A4 PRG UU503A4 PRG Page 13 LPe1250 LPe1205 OCE10102 FCoE OCE10102 iSCSI OCE10102 NIC OCE11102 FCoE OCE11102 iSCSI OCE11102 NIC OF111A5 ALL UF111A5 ALL S1298000 UFI S1298000 UFI S1298000 UFI T2298000 UFI T2298000 UFI T298000 UFI OP503A4 PRG UU503A4 PRG Emulex Adapter Model Name Equivalence Table 4 Emulex Adapter Model Name Equivalence Emulex Model Elxflash hbatvpe Port Tvpe LP10000 LP10000 FC LP10000DC LP10000 FC LP1050 LP1050 FC LP1050DC LP1050 FC LP1050EX LP1050 FC LPe1150 LPe1150 FC LPe11002 LPe11002 FC LPe11004 LPe11004 FC LP1150 LP1150 FC LP11002 LP11002 FC LP1105 HP LPe12000 FC LP1050DC Mezzanine LP1050 FC LPe12000 LPe12000 FC LPe12002 LPe12002 FC LPe12004 LPe12004 FC LPe1250 LPe1250 FC LPe1205 Mezzanine LPe1205 FC OCE10102 OCE10102 FCoE FCoE OCE10102 OCE10102 iSCSI iSCSI OCE10102 OCE10102 NIC NIC Elxflash User Manual DE EMULEX Page 14 DE EMULEX Firmware images are available on the Emulex support site at http www emulex com Note OneConnect models FCoE iSCSI and NIC may share the same Emulex model name but may run different protocols For example an Emulex model OCE10102 can be an FCoE iSCSI or NIC board When the fwmatrix txt file is used the Elxflash hbatvpe must include the highest protocol being use
13. FCoE S N A OCE10102 iSCSI S N A OCE10102 NIC S N A OCE11102 FCoE T N A OCE11102 iSCSI T N A OCE11102 NIC T N A Elxflash User Manual DE EMULEX Page 12 Sample Configuration File Example FWMATRIX TXT gt G EMULEX This is a tab delimited file forming a table of firmware and boot code image file names associated with each HBA type Note All firmware image files are expected to be in the Note All boot code image files are expected to be in the sub directory named firmware sub directory named boot Note The firmware and boot code file names must follow the Emulex naming convention lt 2 letter type code gt lt major version digit gt lt 2 digit minor version gt lt 1 letter release code gt lt optional sub version gt lt extension gt These entries and the actual image filenames are case sensitive Note The HBA types are always Emulex model names hoatype LP9802 LP9802DC LP982 LP1050 LP1050DC LP10000 LP10000DC LP11000 LP11002 LP1150 LPe11000 LPe11002 LPe1150 LPe12000 LPe12002 Elxflash User Manual firmware HD192A1 ALL HF192A1 ALL LF192A1 ALL MF192A1 ALL MF192A1 ALL TD192A1 ALL TD192A1 ALL BD282A3 ALL BF282A3 ALL JF282A3 ALL ZD282A3 ALL ZF282A3 ALL WF282A3 ALL UD111A5 ALL UD111A5 ALL bootcode HU503A2 PRG HU503A2 PRG LP503A2 PRG MP503A4 PRG MP503A4 PRG TU503A4 PRG TU503A4 PRG
14. d on that model An adapter s hbatvpe can be seen by running the Query command For example elxflash q HBA OCE10102 iSCSI Port Tvpe iSCSI MAC 00 00 c9 5b 3b 99 PCI ID 702 Firmware 193011 HBA OCE10102 iSCSI Port Tvpe iSCSI MAC 00 00 c9 5b 3b 9b PCI ID 702 Firmware 193011 HBA OCE10102 iSCSI Port Tvpe NIC MAC 00 00 c9 5b 3b 98 PCI ID 700 Firmware 193011 HBA OCE10102 iSCSI Port Tvpe NIC MAC 00 00 c9 5b 3b 9a PCI ID 700 Firmware 193011 elxflash Operation complete Return Code 0 The OCE10102 shown above is an iSCSI adapter Elxflash Command Line Interface There are two supported modes for each Elxflash switch The first method relies on the fwmatrix txt file It is your responsibility to update the fwmatrix txt file firmware and boot code directories with the appropriate firmware and boot code images The second method is auto discovery When the auto switch is used with ff fb downgrade rewrite or update Elxflash auto discovers adapters and using the firmware and boot subdirectories performs the specified operation on each adapter Auto Discovery auto The auto discovery switch instructs Elxflash to ignore the fwmatrix txt file automatically discover local adapters and perform specified operations f ff fb downgrade rewrite or update using the firmware and boot directories The auto switch must be used with an additional operational switch i e f ff fb downgrade
15. de on an adapter if the rewrite version is equal to or higher than the version currently installed on the adapter e update Upgrade firmware and or boot code if the update version is greater than the version currently installed on an adapter Elxflash User Manual Page 1 Supported Platforms Table 1 ElxflashOffline Operating System X86 X64 PPC64 1A64 WinPE 2 x X X N A N A RHEL 5 4 X X L L RHEL 6 X X L L SLES 10 2 X X L L SLES 11 0 X X L L Table 2 ElxflashOnline Operating System X86 X64 PPC64 1A64 W2K3 SP2 X X N A N A W2K8 SP1 X X N A N A RHEL 5 4 X X L L RHEL 6 X X L L SLES 10 2 X X L L SLES 11 0 X X L L ESX 4 0 N A X N A N A Legend X LightPulse and OneConnect Adapters L LightPulse Adapters only Linux ElxflashOffline Kit Package Contents Kit Name e elxflashOffline lt platforms gt lt version gt lt rel gt tgz Dependencies e Libni Root directory e iscsi drivers e lpfc drivers nic drivers Elxflash User Manual DE EMULEX Page 2 e ja64 e i386 e x86_64 e ppc64 e install sh e uninstall sh iscsi_drivers directory e ia64 e i386 e x86_64 e ppc64 iscsi_drivers arch directories e thel 5 4 e thel 5 5 e rhel 5 6 e sles 10 2 e sles 10 3 e sles 11 0 4 EMULEX iscsi drivers arch os directories supported architectures and operati
16. esponsibility 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 Elxflash User Manual Page ii aiig eliade g et E E E E E E E E E E E E E E E E 1 Key Featiifes ss 1 Supported Platforms geeiert g a a g akal EAEE k a akk 2 Linux ElxflashOffline kt 2 Package Contents Lara n nanna nn nA Anna ann nnnnznnnnnnn 2 INStANING b ka bb ba b bkA baka a 4 para Le tute DEE 5 Uninstalling Am aaa A OOOO AAAA AEEA 5 Linux ElxflashOnline kt 5 Package Contents ii si iii ee ees EN SEENEN lee 5 la Dt Le EE 6 WG AGING DEET 6 MANS ln EE 6 Linux ElxflashOffline Inbox NICK 7 Package Contents A H la lt Le EE 8 Upgrading BEE 8 Uninstalling manna nnnn mnn 8 VMware ElxflashOnline Kit L nanna nannti 8 Package Coments ARA Mi re ce tcc ee cee ect eee 8 la D Uli Le WT 9 Knmetallmeg ees eege 9 Windows ElxflashOffline kint 9 Package Contents ission aac 9 la ll Le DEE 10 Bla eigse lials M T TTT cecuduen A E TE 10 Dinner 10 Windows ElxflashOnline kt 10 Package Contents nn nnn nn nanna ann nanna mnn nn nna 10 UVSC a A 11 UPO O EE 11 MIPS TANNING DT 11 Firmware and Boot Code Prefixes 2 nn nn n nar
17. gt lt time gt HBA lt model gt Port Type lt port_type gt MAC lt mac_address gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Return Code lt n gt Where lt description gt is Success or Error and lt n gt 0 for completion with no errors and a non zero error code for any error Note FCoE iSCSI and NIC only adapters require a system reboot to activate new firmware Note If the Preview switch is also used the Status lt description gt field is not displayed Update update The update switch updates the firmware and or boot code of each adapter if the currently installed versions are less than the update versions This switch cannot be used with downgrade or rewrite Example usage elxflash update auto Upgrade the firmware and or boot code using auto discovery 1 The fwmatrix txt file is ignored You must place the desired update versions of firmware and or boot code in their respective directories 2 Ifthe update versions are higher than the currently installed versions on the adapter then the update versions are downloaded to the adapter 3 If multiple update versions of firmware and or boot code are found for an adapter the highest versions are downloaded to the adapter 4 When performing the boot code update operation Elxflash first ties to match by adapter family and boot type If a match is not found Elxflash then tries to ma
18. it run the uninstall script located on the root of the installation kit The uninstall script executes specific actions depending on what switches are used 1 uninstall sh Uninstall ElxflashOffline and Elxlinlpcfg 2 Juninstall sh f Uninstall ElxflashOffline Elxlinlpcfg and Ipfc driver 3 uninstall sh n Uninstall ElxflashOffline Elxlinlpcfg and be2net drivers 4 uninstall sh s Uninstall ElxflashOffline Elxlinlpcfg and be2iscsi drivers 5 uninstall sh u Uninstall ElxflashOffline Elxlinlpcfg be2net be2iscsi and Ipfc drivers 6 uninstall sh h Display a summary of all available switches Example cd elxflashoffline lt platforms gt lt version gt lt rel gt uninstall sh Linux ElxflashOnline Kit Package Contents Kit Name e elxflashOnline lt platforms gt lt version gt lt rel gt tgz Dependencies e Libni Root directory e ia64 e i386 e x86_64 e ppc64 Elxflash User Manual Page 5 gt G EMULEX Arch directories e rhel 5 e rhel 6 e sles 10 e sles 11 e sles il spi Arch os directories e elxflashOnline lt version gt lt rel gt tgz ElxflashOnline tgz contents e boot the boot code subdirectory e firmware the firmware subdirectory e elxflash the Elxflash executable e fwmatrix txt a sample configuration file e lcrefish s h a sample scripting file readme txt a readme with usage instructions Installing To install an Elxfla
19. ith the versions specified in fwmatrix txt 2 Ifthe update versions in fwmatrix txt are higher than the currently installed versions Elxflash provides a download preview of firmware and or boot code for each adapter that can be updated LightPulse Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update lt Boot Code Firmware gt Image lt image gt New lt version gt Old lt version gt Status Preview FCoE Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status Preview iSCSI and NIC only Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt MAC lt mac_address gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status Preview Query q Usage q The query switch displays an adapter s model WWN or MAC address PCI_ID firmware and boot code versions Query can be used with any switch LightPulse Adapter Status Summary HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Firmware lt version gt Boot Code lt version gt Boot Code enable lt status gt FCoE Adapter Status Summary HBA lt model gt Port Type lt port_type gt WWN lt wwn gt s Firmware lt version gt iSCSI and NIC only Adapter Status Summary
20. linlpcfg readme txt a readme with usage instructions e Jusr sbin linlpcfg flash used by Elxflash for HP UCNA firmware downloads Installing To install an ElxflashOffline Kit 1 Untar the installation tar ball 2 Run the install script located on the root of the installation kit The install script determines the correct architecture and distribution and performs the following operations 1 Installs the packaged Ipfc driver only if an Ipfc driver RPM is not currently installed 2 Installs the packaged be2net driver only if a be2net driver RPM is not currently installed 3 Installs the packaged be2iscsi driver only if a be2iscsi driver RPM is not currently installed Elxflash User Manual Page 4 DE EMULEX 4 Attempts to upgrade the existing ElxflashOffline and Elxlinlpcfg RPMs If there are no existing ElxflashOffline or Elxlinlpcfg RPMs the install script installs the packaged ElxflashOffline and Elxlinlpcfg RPMs Example tar zxvf elxflashoOffline lt platforms gt lt version gt lt rel gt tgz cd elxflashoffline lt platforms gt lt version gt lt rel gt install sh Upgrading With an existing ElxflashOffline installation run the install sh script to upgrade the ElxflashOffline and Elxlinlpcfg RPMs Note During an upgrade only the ElxflashOffline and Elxlinlpcfg RPMs are upgraded Existing Ipfc be2net and be2iscsi driver RPMs are not upgraded Uninstalling To uninstall an ElxflashOffline K
21. lxflash cannot find HBACMD This return code applies only to ElxFlashOnline 5 ERROR_NO_SUPPORTED_HBA_FOUND Returned if the installed adapter has no entry in fwmatrix txt or if the entry in the fwmatrix txt does not match Elxflash s internal identification of the adapter Status Messages When Using Auto Discovery Elxflash takes a less stringent approach to reporting status messages when used with auto discovery An error message is returned only when Elxflash reports a failure during a download or if the firmware and boot directories cannot be located 0 GOOD_ALL_UPGRADES_ Ok Returned if one some or all of the discovered adapters had a successful download performed 1 GOOD NO UPDATES NEEDED a Returned if one some or all of the discovered adapters did not need an upgrade down grade or rewrite operation b This should never be returned during a force firmware or force boot code download operation Elxflash User Manual Page 24 gt G EMULEX 2 ERROR_ALL_UPGRADES_FAILED Returned if all of the discovered adapters that had a download attempted failed during the operation 3 ERROR_SOME_UPGRADES_FAILED Returned if some of the discovered adapters that had a download attempted failed during the operation 4 ERROR_EMULEX_APPS_NOT_INSTALLED Returned if Elxflash cannot find HBACMD This return code applies only to ElxFlashOnline 6 ERROR_DIRECTORY_NOT_FOUND Returned if the firmware and or boot directories are
22. missing Depending on the operation auto discovery expects the firmware and or boot directories to exist as subdirectories in the root of the package directory 7 GOOD NO UPGRADES AVAILABLE Returned if none of the discovered adapters had a matching image in the firmware and or boot directories In this case only a matching image is an image that the adapter will accept regardless of the download operation being performed Elxflash User Manual Page 25 DE EMULEX ft Troubleshooting The Force Firmware ff Force Boot fb and the Force Firmware and Boot Code f switches take precedence over the downgrade upgrade and rewrite switches If ff fo or f are used the downgrade upgrade and rewrite switches are ignored The following examples illustrate this behavior 1 elxflash ff update a update is ignored b Perform a Force Firmware operation on all installed and supported adapters 2 elxflash fb update a update is ignored b Performa Force Boot Code operation on all installed and supported adapters 3 elxflash ff downgrade a downgrade is ignored b Perform a Force Firmware operation on all installed and supported adapters 4 elxflash fb downgrade a downgrade is ignored b Perform a Force Boot Code operation on all installed and supported adapters 5 elxflash ff rewrite a rewrite is ignored b Perform a Force Firmware operation on all installed and supported adapters
23. ng systems only e be2iscsi lt version gt lt rel gt lt arch gt rpm nic_drivers directory e ia64 e i386 e x86_64 e ppc64 nic_drivers arch directories e thel 5 4 e thel 5 5 e thel 6 0 e sles 10 2 e sles 10 3 e sles 11 0 e sles 11 1 nic_drivers arch os directories Supported architectures and operating systems only e be2net lt version gt lt rel gt lt arch gt rpm Ipfc drivers directory e Rev8 2 O X e Rev8 2 8 X e Rev8 3 5 X Elxflash User Manual Page 3 gt G EMULEX 4 Arch directories e rhel 5 e thel 6 e sles 10 e sles 11 e sles il spi Arch os directories e elxflashOffline lt version gt lt rel gt lt arch gt rpm e elxlinlpcfg lt version gt lt rel gt lt arch gt rpm Application installation directory e usr sbin linlpcfg Elxlinlpcfg RPM contents e etc init d mili2dcontrol e lusr lib libdfc a e Jusr lib libdfc so e lusr lib libdfc so X e lusr lib libdfc so X X X e Jusr lib libmili2 s0 e lusr sbin linlpefg linlpcfg used by Elxflash to communicate with the driver e Jusr sbin linlpcfg mili2d ElxflashOffline RPM contents e lusr sbin linlpcfg boot the boot code subdirectory e lusr sbin linlpefg firmware the firmware subdirectory e lusr sbin linlpcfg elxflash the Elxflash executable e Jusr sbin linlpcfg fwmatrix txt a sample configuration file e usr sbin linlpcfg Icreflsh sh a sample scripting file e usr sbin
24. nnnnn mnn nn 11 Sample Configuration File nanna 13 Elxflash Command Line Interface nn 15 Auto Discovery auto 15 Downgrade downgrade or 0 16 Force Firmware and Boot Code f or mb 17 Force Boot Code At E 18 Force Firmware M enera ia annn naana RARR 18 Help M Or Qian i a a Meee a a aaa Eaa a aes 19 Bee VIOQ RE 19 MOTA IT 19 QUST UG AT PI 20 Ramdrive ramdrive Windows ElxflashOffline onlv 21 Remote remote ElxflashOnline only LL nn 21 Rewrite rewrite or Zei 21 Update update 22 Viet EE 23 Elxflash User Manual Page iii EH WSS SAG CS apt A e at 24 Status Messages When Using the fwmatrix txt File 24 Status Messages When Using Auto Discovery nn nnnnnn na 24 Troubleshooting kA 26 Unsupported Driver 26 Updating Adapters without Boot Code 26 Elxflash User Manual Page iv GG EMULEX Introduction This document explains how to prepare Elxflash kits for Linux and Windows pre boot environments Elxflash uses a command line interface allowing you to build scripts for automated and unattended firmware and boot code download solutions for Emulex LightPulse Host Bus Adapters HBAs and OneConnect Universal Converged Network Adapters UCNAs You can download firmware and boot code on local and remote machines simultaneously Elxflash version 5 1 uses auto discovery auto which relieves you from having to maintain the fwmatrix txt configuration file When auto discovery is invoked El
25. ownload preview of all adapters that Elxflash can update using either auto discovery or the fwmatrix txt file The preview switch can be used with any of the operational switches such as force firmware force boot downgrade rewrite and update When the preview switch is used Elxflash displays a download summary but it will not actually perform the download Each adapter s download preview will display the adapter s old and new image version The old image version represents the image version that is currently on the adapter The new image version represents the image version that Elxflash would use during an actual download Example usage elxflash preview auto update Preview an upgrade of firmware and or boot code using auto discovery 1 The fwmatrix txt file is ignored You must place the desired update versions of firmware and or boot code in their respective directories 2 Ifthe update versions are higher than the currently installed versions on the adapter Elxflash provides a download preview for each adapter that can be updated Elxflash User Manual Page 19 DE EMULEX 3 If multiple update versions of firmware and or boot code are found for an adapter Elxflash provides a download preview using the highest versions elxflash preview Preview an upgrade of firmware and or boot code using the fwmatrix txt file 1 For each installed and supported adapter the current firmware and boot code versions are compared w
26. rectorv Example rm rf elxflashOnline esx lt version gt lt rel gt Windows ElxflashOffline Kit Package Contents Kit Name e Offline WinPE lt version gt lt rel gt zip Root directorv e setupelxAIl x64 e setupelxAIl x86 Contents e XiProgram Files Emulex Util elxApp libdfc dll e XiProgram Files Emulex Util elxApp MILI2DLL dll e XiProgram Files Emulex Util elxApp MILI2Service exe e XiProgram Files Emulex Util elxApp WinLpCfg exe Elxflash User Manual Page 9 gt G EMULEX e XiProgram Files Emulex Util elxApp boot the boot code subdirectory e XiProgram Files Emulex Util elxApp firmware the firmware subdirectory e XiProgram Files Emulex Util elxApp WorkDir Contains the FCoE iSCSI and NIC drivers e XiProgram Files Emulex Util elxApp elxflash exe the Elxflash executable e XiProgram Files Emulex Util elxApp fwmatrix txt a sample configuration file e XiProgram Files Emulex Util elxApp lcreflsh bat a sample batch file e XiProgram Files Emulex Util elxApp readme txt a readme with usage instructions Installing To install an ElxflashOffline Kit 1 Unzip the Offline WinPE lt version gt lt rel gt zip 2 Change the directory to the correct architecture subdirectory 3 Run the Offline WinPE lt arch gt lt version gt lt rel gt exe The following components will be installed e The LightPulse drivers e The OneConnect FCoE iSCSI and NIC drivers e WinLpCfg e Elxflash Upgrading With an existing
27. ries to match by adapter family and boot type If a match is not found Elxflash then tries to match by boot type If matching by boot type and multiple versions of boot code are detected downgrade always chooses in the following order Universal U Pair P Open O EFI E and x86 B elxflash downgrade Downgrade the firmware and or boot code using the fwmatrix txt file 1 For each installed and supported adapter the current firmware and boot code versions are compared with the versions specified in fwmatrix txt 2 Ifthe downgrade versions in fwmatrix txt are lower than the currently installed versions then the downgrade versions of firmware and or boot code are downloaded to that adapter LightPulse Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update lt Boot Code Firmware gt Image lt image gt New lt version gt Old eversions Status lt description gt FCoE Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt iSCSI and NIC only Adapter Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt MAC lt mac_address gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Return Code lt n gt
28. river e pciutils e pciutils devel e ethtool RHEL 6 Dependencies e inbox be2net driver e pciutils e pciutils libs e ethtool SLES 11 SP1 Dependencies e inbox be2net driver e pciutils e ethtool Root directory e i386 e x86_64 e ppc64 Arch directories e rhel 5 e rhel 6 e sles il spi Arch os directories e elxflashOffline lt version gt lt rel gt lt arch gt rpm ElxflashOffline RPM contents e firmware the firmware subdirectory e elxflash the Elxflash executable Elxflash User Manual gt G EMULEX Page 7 gt G EMULEX e fwmatrix txt a sample configuration file s lcrefish s h a sample scripting file readme txt a readme with usage instructions Installing To install an ElxflashOffline Kit 1 Untar the ElxflashOffline tar ball 2 Execute an RPM install of the RPM that matches the target architecture and operating system Example tar zxvf elxflashoffline inbox _NIC lt platforms gt lt version gt lt rel gt tgz cd elxflashOffline lt platforms gt lt version gt lt rel gt lt arch gt lt os gt rpm iv elxflashoffline lt version gt lt rel gt lt arch gt rpm Upgrading To upgrade an ElxflashOffline Kit 1 Untar the ElxflashOffline tar ball 2 Execute an RPM upgrade of the RPM that matches the target architecture and operating system Example tar zxvf elxflashOffline lt platforms gt lt version gt lt rel gt tgz cd elxflashOffline l
29. shOnline Kit 1 Untar the elxflashOnline tar ball that matches the target architecture and operating system 2 Copy the elxflashOnline lt version gt lt rel gt directory to the directory you choose Example tar zxvf elxflashOnline lt platforms gt lt version gt lt rel gt tgz cd elxflashOnline lt platforms gt lt version gt lt rel gt lt arch gt lt os gt tar zxvf elxflashOnline lt version gt lt rel gt tgz Note To run Elxflash vou must install the OneCommand Manager application and the adapter drivers These components are not included in the ElxflashOnline Kit Upgrading With an existing ElxflashOnline installation run the install sh script to upgrade the ElxflashOnline RPM Note During an upgrade only the ElxflashOnline RPM is upgraded Existing Ipfc be2net be2iscsi and OCManager RPMs are not upgraded Uninstalling To uninstall an ElxflashOnline Kit remove the elxflashOnline lt platforms gt lt version gt lt rel gt directory that was created during installation Example rm rf elxflashOnline lt platforms gt lt version gt lt rel gt Elxflash User Manual Page 6 Linux ElxflashOffline Inbox NIC Kit Package Contents Kit Name e Kit Name elxflashOffline_inbox_NIC lt platforms gt lt version gt lt rel gt tgz RHEL 5 4 Dependencies e DUP Driver Update Package 2 101 377r be2net driver e pciutils e pciutils devel e ethtool RHEL 5 5 Dependencies e inbox be2net d
30. t platforms gt lt version gt lt rel gt lt arch gt lt os gt rpm Uhv elxflashoOffline lt version gt lt rel gt lt arch gt rpm Uninstalling To uninstall an ElxflashOffline Kit uninstall the RPM Example rpm ev elxflashOffline lt version gt lt rel gt VMware ElxflashOnline Kit Package Contents Kit Name e elxflashOnline esx lt version gt lt rel gt tgz Root directory e esx4 os directory e elxflashOnline esxN lt version gt lt rel gt tgz Elxflash User Manual Page 8 gt G EMULEX ElxflashOnline tgz contents e boot the boot code subdirectory e firmware the firmware subdirectory e elxflash the Elxflash executable e fwmatrix txt a sample configuration file e lcrefish s h a sample scripting file readme txt a readme with usage instructions Installing To install an ElxflashOnline Kit untar the elxflashOnline tar ball that matches the target operating system Example tar zxvf elxflashOnline esx lt version gt lt rel gt tgz cd elxflashOnline esx lt version gt lt rel gt lt os gt tar zxvf elxflashOnline esx4 lt version gt lt rel gt tgz cd elxflashOnline esx4 lt version gt lt rel gt Note To run Elxflash you must install the OneCommand Manager application Core Kit for ESX 4 0 and the adapter drivers These components are not included in the ElxflashOnline Kit Uninstalling To uninstall an ElxflashOnline Kit delete the installation di
31. t wwn gt Update lt Boot Code Firmware gt Image lt image gt New lt version gt Old eversions Status lt description gt FCoE Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt iSCSI and NIC only Adapter Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt MAC lt mac_address gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Return Code lt n gt Where lt description gt is Success or Error and lt n gt 0 for completion with no errors and a non zero error code for any error Note FCoE iSCSI and NIC only adapters require a system reboot to activate new firmware Note If the Preview switch is also used the Status lt description gt field is not displayed Elxflash User Manual Page 17 gt G EMULEX Force Boot Code fb The Force Boot Code switch forces a boot code download to an adapter regardless of what boot code the adapter currently has installed When this switch is used a Force Boot Code operation will be performed regardless of any additional switches given on the command line Example usage elxflash fb auto Force a boot code download using auto discovery 1 The fwmatrix txt file is ignored You must place the desired
32. tch by boot type If matching by boot type and multiple versions of boot code are detected rewrite always chooses in the following order Universal U Pair P Open O EFI E and x86 B elxflash update Upgrade the firmware and or boot code using the fwmatrix txt file 1 For each installed and supported adapter the current firmware and boot code versions are compared with the versions specified in fwmatrix txt 2 Ifthe update versions in fwmatrix txt are higher than the currently installed versions then the update versions of firmware and or boot code are downloaded to that adapter LightPulse Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update lt Boot Code Firmware gt Image lt image gt New lt version gt Old lt version gt Status lt description gt FCoE Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Elxflash User Manual Page 22 DE EMULEX iSCSI and NIC only Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt MAC lt mac_address gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Return Code lt n gt Where lt description gt is Success or Error and lt
33. when performing the firmware download elxflash ff Force firmware using the fwmatrix txt file 1 For each installed and supported adapter force a download of firmware using the firmware version specified in the fwmatrix txt file Elxflash User Manual Page 18 gt G EMULEX LightPulse and FCoE Adapter Download Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt WWN lt wwn gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt iSCSI and NIC only Adapter Summary lt date gt lt time gt HBA lt model gt Port Type lt port_type gt MAC lt mac_address gt Update Firmware Image lt image gt New lt version gt Old lt version gt Status lt description gt Return Code lt n gt Where lt description gt is Success or Error and lt n gt 0 for completion with no errors and a non zero error code for any error Note FCoE iSCSI and NIC only adapters require a system reboot to activate new firmware Note If the Preview switch is also used the Status lt description gt field is not displayed Help h or Usage h or The help switch displays a help message detailing instructions on how to use Elxflash Log log Usage log lt logfile txt gt The log switch appends the output of Elxflash to a text file Log can be used with any switch Preview p The preview switch provides you with a d
34. xflash automatically discovers local adapters and performs selected operations such as ff force firmware fb force boot upgrade 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 the auto discovery approach Elxflash has retained the ability to update the firmware and 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 or boot code entries in addition to placing the corresponding firmware and boot code images into their respective directories The fwmatrix txt file enables all operations that are used with auto discovery For simplicity this document refers to HBAs and UCNAs as adapters Key Features Elxflash version 5 1 key features include e auto Auto discover adapters and do not use the fwmatrix txt configuration file e downgrade Downgrade firmware and or boot code if the downgrade version is less than the version that is currently installed on an adapter e fb Force a boot code download on an adapter e ff Force a firmware download on an adapter e Ip Preview a download of firmware and or boot code e rewrite Explicitly re flash the firmware and or boot co
Download Pdf Manuals
Related Search