Mellanox Firmware Tools (MFT) Release Notes for Linux.book
Contents
1. Tool Issue Description Workaround To be Fixed l Burning tools Runing burning Burning tools lock hard do not run the burning Future mlxfwman tools and restart ware resources used by the tools while restarting Release ager flint and ing the driver at firmware booting the driver mlxburn the same time may cause the machine to hang 2 Forcefully kill If a burning process is Run flint d Future ing burning tool killed forcefully such as device Release may interrupt by kill 9 in Linux subse clear semaphore subsequent runs quent runs of burning tools or reboot of burning tools will not function as they require hardware resources cleanup 3 mlxburn Slow VPDaccess Reading the VPD using the N A Future for ConnectX 3 rw flag or pro release graming the VPD may take up to 5 mins 4 flint Long firmware The firmware update pro N A Future update process in cess in Connect IBTM may release Connect IB take up to a minute 5 Failure to set The sg command on Con Set the GUIDs only N A GUIDs on Con nect IB fails if the flag when firmware is not nect IB override_cache_repla active driver is not cement is not used loaded by using the flag override cach rep lacement 6 Remote MTUSB Attempting to access Avoid working in par Future devices do not Remote MTUSB device allel through those release support parallel for parallel does not work interfaces access2. nfiniHost 4X nfiniHost III Ex nfiniHost III Lx 4X nfiniScale nfiniScale III 2 7 2b All Added support for WinPE 4 0 OS 2 7 2 General It is no longer required to run mst start stop when using WinMFT tools The service is automatically loaded unloaded when an MFT tool is run ning The mst service installation was removed from the setup Added support for SwitchX silicon devices flint Added support for Atmel AT25DFxx flash family Added support for burning firmware via Command Line Interface CLI on SwitchX devices mget temp mget temp displays a more accurate temperature reading for Con nectX 2 and ConnectX 3 devices by using the adapter s specific ther mal calibration data 24 Mellanox Technologies Rev 3 7 1 Table 11 Changes New Features Windows Version Component Tool Description 2 71 General Added support for Mellanox ConnectX 3 silicon device Added the I2CBridge Dimax s Driver for USB to I2C Adapter as part of the WinMFT installation package However the I2CBridge is not installed by default MFT installation change Removed the isw tool The isw tool functionality was replaced by the mlxi2c tool For example to scan the devices on the i2c bus run gt mlxi2c d lt dev gt scan instead of gt isw d lt dev gt flint Added support for flash type SST25VF016B
3. safe firmware update flow without the risk of firmware or driver hang ing mlxfwmanager Added support for the mlxfwmanager utility at Beta level mlxuptime Added support for the mlxuptime utility at Beta level Mellanox Technologies 19 Rev 3 7 1 History of Changes and New Features Component Tool Description 3 0 0 General Added support for Connect IB device at beta level Added support for ConnectX 3 Pro device at beta level Added support for Ubuntu operating system Added support for running tools against PCI device domain bus dev fn like 0000 1a 00 0 or 1a 00 0 and devices used by OFED driver like mlx4 0 Flint Added support for new flashes types N25Q0XX Micron and W25Xxx Winbond mlxdump Added support for the mlxdump utility at beta level mlxmceg Renamed mcg to mlxmcg spark spark was removed from MFT version 3 0 0 Supported Devices The following adapter cards and switch systems are no longer supported in MFT version 3 0 0 InfiniHost 4X InfiniHost III Ex InfiniHost III Lx 4X nfiniScale nfiniScale III 2 7 1a Added the meg tool Beta level The mcg tool displays the current multicast groups and flow steering rules configured in the device Target users Developers of Flow Steering aware applications This tool dumps the internal steering table which is used by the device to steer E
4. MFT tools cannot run on a device with hardware access disabled This feature is enabled only with supporting firmware Removed support for Itanium 1 64 flint Added the following commands enable disable access to the hardware set change the key used to enable access to the hardware 2 7 0 flint ROM section in the image now contains multiple boot images Therefore the flint was modified to display information for all of the images in the ROM section Added support to display burn UEFI ROM Added support for burning firmware via Command Line interface on SwitchX devices Mlxburn Added option to add or replace a single keyword in the VPD writable sec tion vpd_set_keyword flag Added the option to set a binary VPD field data MFT installation Added the option without kernel which allows user to install MFT without the mst kernel Mellanox Technologies 21 Rev 3 7 1 History of Changes and New Features Version Component Tool Description 2 6 2 MFT installation RPM based installation change Applications are installed using a pre compiled binary RPM Kernel modules are distributed as a source RPM and compiled by the installa tion script e Fast installation process Removed prerequisite libraries expat and zlib devel The package tools libraries and headers are now installed under prefix bin or prefix lib and prefix include dirs D
5. well 7 wqdump On Connect IB wqdump does not support N A Future wqdump doesnot WQEs receiving of 1024B release support WQEs receiving of 1024B Rev 3 7 1 Known Issues Table 9 Known Bugs Limitations Tool Issue Description Workaround To be Fixed 8 mst Mst ib add may The failure occurs when Run mst ib add dis N A fail when there is the mst ib add uses the cover tool ibdiagnet a device with Ibnetdiscover tool Zero system GUID in the fab ric 9 mst ib add When an IB subnet man Verify a subnet man Future command may ager is not running in the agerisrunning and that release add inaccessible fabric some of the ports all the ports are in in band devices may be in INIT state ACTIVE state Devices that are accessed via these ports are added to the in band device list even though they are inaccessi ble to in band traffic 10 Lacking mst status v does For mlxtrace fwtrace Future MLNX OFED not show MLNX OFED only release device name device name mlx4 mlx5 Run the tool in FIFO when running in XEN server machines mode instead of MEM mst status Hence the MFT tools can Other tools v in XEN server not be run on these N A machines devices Also mlxtrace fwtrace on Connect IB in MEM mode can not work since it is using these devices 11 MFT uninstall may On Windows mst remote If you still see old remote Future
6. Added support for flash type M25PX16 e The ROM section in the image now contains multiple boot images Therefore flint was modified to display information for all of the images in the ROM section e Added support to display burn UEFI ROM Added an option to set the VSD and GUIDs in a binary image file This is useful for production to prepare images for pre assembly flash burning These new commands are supported by Mellanox 4th generation devices Added an option to set the VSD and GUIDs on an already burnt device These commands sg sv re burn the existing image with the given GUIDs or VSD When the sg command is applied on a device with blank Oxff GUIDs it updates the GUIDs without re burning the image mst Added support for using ibnetdiscover in the mst ib add command mlxburn Added support for VPD read write 2 6 0 All Added Mellanox ConnectX 2 and BridgeX support 4 3 Changes and New Features in VMware ESXi Table 12 Changes and New Features in VMware ESXi Version Component Tool Description 3 7 0 mlxfwmanager Added online firmware update flint Added concurrency support to query firmware 3 6 0 mlxconfig Added mlxconfig tool for changing non volotaile configuration on device Burning Tools Added support for micron flash in flint and updated production burn flow on Connect IB Mellanox Technologies 25 Rev 3 7 1 Histor
7. not remove all devices added by the mst devices after installing a release remote devices remote add command may new WinMFT you can still be present after uninstall either run mst restart or ing MFT remove the devs directory manually resides under the WinMFT install direc tory 12 mst ib add uses discover tool optionis N A Future only ibnetdis not used to choose the release cover to discover intended tool the cluster The discover tool argument is intended only for parsing purpose thus the topology file must be specified when using the discover tool 14 Mellanox Technologies Rev 3 7 1 Table 9 Known Bugs Limitations Tool Issue Description Workaround To be Fixed 13 mtusb device is When i2c diolan u2c Stop the 12c diolan u2c N A not shown in the driver is installed it takes driver MST list some ownership over the mtusb times device and prevents mst to load it consequently pre vents access to MFT tools 14 Install script Kernel mft Xenserver machine does 1 Prepare the kernel mft installation fails not have an rpmbuild com RPMiin the DDK server of the xenserver installed in xenserver mand which is used to Vout Ern machine recompile the kernel mft ning install sh source RPM in installation rebuild srpm phase therefore MFT 2 Install the kernel mft installation fails binary RPM gene
8. parallel Access Future parallel access to lel on the same device may to device Release a interrupt one another and device from mul may cause the device to be tiple MFT tools in an undefined state is not supported 30 Live fish device The MFT driver is not a N A Future mode is notsup native VMware driver thus Release ported inVM it can not take ownership ware ESXi 5 5 of the PCI device in live fish mode 31 MFT tools do not The MFT driver is not a Install and load Future work when the native VMware driver MLNXOFED Release MLNX OFED thus it can access the Mel ESXi driver ESXi driver is lanox PCI device only after which is part of inbox not the MLNX OFED ESXi drivers in ESXi 5 5 installed or driver marks it as accessi loaded ble by vmkliunx drivers in VMware ESXi 5 5 Mellanox Technologies 17 Rev 3 7 1 Known Issues Table 9 Known Bugs Limitations Tool Issue Description Workaround To be Fixed 32 General MTUSB Remote MFT does not support N A Future and Inband MTUSB devices nor Release devices are not remote ETH and IB supported in devices in FreeBSD and FreeBSD and VMware ESXi VMware ESXi 33 Running MFT MFT tools use the same Avoid running more Future tools in parallel hardware resources and than one MFT toolata Release may not work therefore might interrupt time with the same the work of each other device 34 UPMF Genera U
9. MAGE Mellanox TECHNOLOGIES Mellanox Technologies Mellanox Technologies Ltd 350 Oakmead Parkway Suite 100 Beit Mellanox Sunnyvale CA 94085 PO Box 586 Yokneam 20692 U S A Israel www mellanox com www mellanox com Tel 408 970 3400 Tel 972 0 74 723 7200 Fax 408 970 3403 Fax 4972 0 4 959 3245 O Copyright 2014 Mellanox Technologies All Rights Reserved Mellanox Mellanox logo BridgeX ConnectX amp Connect IB amp CoolBox amp CORE Direct InfiniBridge InfiniHost InfiniScale amp MetroX amp MLNX OS TestX PhyX ScalableHPC SwitchX amp UFM Virtual Protocol Interconnect and Voltaire are registered trademarks of Mellanox Technologies Ltd ExtendX FabricIT HPC X Mellanox Open Ethernet Mellanox PeerDirect Mellanox Virtual Modular Switch MetroDX Unbreakable Link are trademarks of Mellanox Technologies Ltd All other trademarks are property of their respective owners 2 Mellanox Technologies Rev 3 7 1 Table of Contents Table of Contents strena eo etaed tre anne eae eI caret 3 LisEof Tables kx tae eer Oh eed a Se eee Ed E RR 4 Chapter 1 Overview x osx ie are a os A IR Re ta ul a 5 Tol Package id sx ea Ro A eR A unc td 5 1 2 Software Dependencies 7 1 2 1 Linux Software Dependencies 7 1 2 2 Windows
10. Mellanox TECHNOLOGIES Connect Accelerate Outperform Mellanox Firmware Tools MFT Release Notes Rev 3 7 1 www mellanox com Rev 3 7 1 NOTE THIS HARDWARE SOFTWARE OR TEST SUITE PRODUCT PRODUCT S AND ITS RELATED DOCUMENTATION ARE PROVIDED BY MELLANOX TECHNOLOGIES AS IS WITH ALL FAULTS OF ANY KIND AND SOLELY FOR THE PURPOSE OF AIDING THE CUSTOMER IN TESTING APPLICATIONS THAT USE THE PRODUCTS IN DESIGNATED SOLUTIONS THE CUSTOMER S MANUFACTURING TEST ENVIRONMENT HAS NOT MET THE STANDARDS SET BY MELLANOX TECHNOLOGIES TO FULLY QUALIFY THE PRODUCTO S AND OR THE SYSTEM USING IT THEREFORE MELLANOX TECHNOLOGIES CANNOT AND DOES NOT GUARANTEE OR WARRANT THAT THE PRODUCTS WILL OPERATE WITH THE HIGHEST QUALITY ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT ARE DISCLAIMED IN NO EVENT SHALL MELLANOX BE LIABLE TO CUSTOMER OR ANY THIRD PARTIES FOR ANY DIRECT INDIRECT SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES OF ANY KIND INCLUDING BUT NOT LIMITED TO PAYMENT FOR PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHER IN CONTRACT STRICT LIABILITY OR TORT INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY FROM THE USE OF THE PRODUCT S AND RELATED DOCUMENTATION EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DA
11. Rev 3 7 1 Version Component Tool Description 2 6 0 MFT installation change Added the options without image generation disable dc and with out kernel which allow for a partial installation in order to avoid prob lems with SW dependencies Now allows a non root user to prepare MFT RPMs All Added Mellanox ConnectX 2 and BridgeX support flint Added a CRC check for the full image Support for query burn of clp gpxe ROM Prevents burning a ConnectX 2 image onto a ConnectX device and vice versa Added a logging option to flint For the ConnectX device family only Added commands for an independent burn read remove of an Expansion ROM image For firmware versions earlier than 2 7 000 It is possible to read the ROM image or to replace an already existing ROM image by the burn command However burning a new ROM image in case a previous image did not exist is not possible nor is it possible to remove an existing ROM image mlxburn Added the fw dir option which looks for a suitable FW file in the given directory Support for generating a non fail safe image for ConnectX ConnectX 2 InfiniScale IV and BridgeX devices Debug tools Updated the mlxi2c utility Added the mget temp utility which reads the temperature of the Con nectX ConnectX 2 InfiniScale IV and BridgeX devices 4 2 Changes and New Features in Windows Table 11 Changes a
12. Software 7 1 2 3 FreeBSD Software 8 1 2 4 VMware ESXi Software Dependencies 8 1 3 Supported Operating Systems and Platforms 9 1 3 1 Linux Supported Operating Systems 9 1 3 2 Windows Supported Operating Systems 10 1 3 3 FreeBSD Supported Operating Systems 11 1 3 4 VMware ESXi Supported Operating Systems 11 1 4 Supported Flash 11 Chapter 2 Changes and New Features 12 2 1 Changes in Version 3 7 1 12 Chapter 3 Known Issues ss ss es es ee ul A AR rr rr ewe ee ee 13 Chapter 4 History of Changes and New Features 19 4 1 Changes and New Features in Linux 19 4 2 Changes and New Features in Windows 23 4 3 Changes and New Features in VMware ESXi 25 4 4 Changes and New Features in FreeBSD 26 Chapter 5 History of Bug Fixes 27 Mellanox Technologies 3 Rev 3 7 1 List of Tables Table 1 Firmware Tools MFT Available Tools 5 Table 2 Software Dependen
13. Windows PE 4 0 x64 Windows PE 4 0 x86 Windows PE 5 0 x64 10 Mellanox Technologies Rev 3 7 1 Windows 5 0 x86 Windows Server 2008 R2 x64 e Windows 8 1 x64 1 3 3 FreeBSD Supported Operating Systems Supported Operating Systems and Service Packs FreeBSD 10 0 x86 FreeBSD 9 1 x64 FreeBSD 10 0 x64 1 3 4 VMware ESXi Supported Operating Systems e VMware ESXi Supported Operating Systems ESXi 5 1 ESXi 5 5 1 4 Supported Flash Types MFT supports the following Flash types Table 7 Supported Flash Types Vendor Flash Family Tested P N Micron M25Pxx M25P16 M25PXxx M25PX16 N25Qxxx N25Q032 Winbond W25Xxx W25QxxBV W25Q32BV Microchip SST SST25VFxx SST25VF016B Spansion S25FLxxxP S25FLIxxK S25FL116K Atmel AT25DFxxx AT25DF161 Macronix MX25L16XXX 1 Were not tested in QA Mellanox Technologies 11 Rev 3 7 1 Changes and New Features 2 Changes New Features 2 1 Changes in Version 3 7 1 Table 8 Changes in Version 3 7 1 Component Tool Description Bug Fixes See Section 5 History of Bug Fixes on page 27 12 Mellanox Technologies Rev 3 7 1 3 Mellanox Technologies 13 Known Issues The following table provides a list of known bugs and limitations in regards to this release of the Mellanox Firmware Tools Table 9 Known Bugs and Limitations
14. a PPC64 machine US 7 mlxburn The flag fw dir is not supported when burning SwitchX 2 7 0a 2 7 1 devices mstdump Running mstdump on a SwitchX device may cause it to mal 2 7 0a 2 7 1 function flint Burning the firmware into ConnectX 3 A1 adapter using 2 6 2 2 7 0a the MST CR device resulted in failure mst In band access is not supported in Windows MFT 2 6 0 2 71 All No MTUSB 1 support for 64 bit architecture in Windows 2 6 0 2 71 MFT mst ib add mst ib add fails to add in band devices when the IB driver 2 7 0 2 7 0a is newer than MLNX OFED LINUX 1 5 3 0 MIxi2c mlxi2c scan fails the first time when using mtusb 2 6 2 2 7 0 flint The sg set guids command on a VPI device may burn 2 6 2 2 7 0 MACs GUIDs with value Oxff If the striped image flag is used in a burn command 2 6 2 2 7 0 image burn will fail or burn a corrupt image mst Occasionally mst restart locked the flash semaphore 2 6 1 2 6 2 mst ib add added non Mellanox device to the in band device 2 6 1 2 6 2 list flint Typo 1n flint help description of Expansion ROM read The 2 6 0 2 6 1 flint help display lists the Expansion ROM read command as rrrom instead of rrom 30 Mellanox Technologies Rev 3 7 1 Table 14 History of Fixed Bugs List Component Tool Issue Discovered Fixed in in Rev Rev mst In band access does not work with OFED 1 5 2 6 0 2 6 1 Mellanox Technologies 31
15. cies on Linux 7 Table 3 Software Dependencies on Windows 7 Table 4 Software Dependencies on FreeBSD 8 Table 5 Software Dependencies on VMware ESXi 8 Table 6 Linux Operating Systems and Platforms 9 Table 7 Supported Flash Types 0 0 cece cece ccc een teen teen an 11 Table 8 Changes Version 3 7 1 daane ee 12 Table 9 Known Bugs and Limitations 13 Table 10 History of Changes and New Features 19 Table 11 Changes and New Features in Windows 23 Table 12 Changes and New Features in VMware ESXi 25 Table 13 Changes and New Features in 5 26 Table 14 History of Fixed Bugs List 0 0 0 ct ene eens 27 4 Mellanox Technologies Rev 3 7 1 1 Overview These are the release notes for Rev 3 7 1 of the Mellanox Firmware Tools MFT 1 1 Mellanox Technologies 5 This release supports the following operating systems Linux Windows VMware ESXi and FreeBSD Please see the supported platform table for further details The tools functionality is identical in all op
16. d there Burning tools Burning tools may cause machine reboots in some ConnectX 3 7 0 3 7 1 cards Mixfwmanager Updating a non failsafe image is not supported 3 6 0 3 7 0 Mixfwmanager Killing an WinMFT process may interrupt subsequent runs 3 6 0 3 7 0 of WinMFT tools Mixfwmanager Mixfwmanager_pci does not work in VMware 3 6 0 3 7 0 All MFT supports only one connected MTUSB 1 device at a 2 7 2b 3 7 0 time mlxuptime The displayed configured frequency may present wrong 3 5 0 3 7 0 results mst mst remote feature does not work when the client machine is 3 6 0 3 7 0 windows and the server machine is Linux mst Devices in livefish mode in FreeBSD does not appear in mst 3 6 0 3 7 0 status mlxburn Cannot read vpd when accessing via PCI device in the for 3 1 0 3 7 0 mat domain bus dev fn flint First flint run may fail after Ctrl C 3 5 0 3 6 0 flint Flint Connect IB burn corrupts the flash when burning a 3 1 0 3 6 0 verbatim full flash dump as the firmware image flint Flint Connect IB burning using the vsd flag is not func 3 5 0 3 6 0 tional flint Occasionally CTRL C causes flint to hang in WinPE OS 2 7 2b 3 6 0 flint Unexpected behavior when running swreset on flint 2 7 2b 3 6 0 flint CTRL C does not clear semaphores 2 7 2b 3 6 0 flint Connect IB burning Flint supports VSD of up to 128 3 5 0 3 6 0 chars flint wbne command causes endiannes swap 3 5 0 3 6 0 flint On Windows Power Shell Ctrl C does not function properl
17. der directory name includes directory with spaces whitespace 24 Running Online Online firmware update N A Future updates down may fail if many processes release loads in parallel try to do so in parallel may fail 16 Mellanox Technologies Rev 3 7 1 Table 9 Known Bugs Limitations Tool Issue Description Workaround To be Fixed 25 mlxfwmanage Mlxfwmanger mlxfwmanager pci fails to N A Future r pci ci fails to detect detect devices in virtual release devices that were machines of RedHat KVM passed through lt Where the pci address of from RedHat the device has dev func KVM 00 0 gt 26 mlxfwreset Mlxfwreset fails On some machines where Reboot the machine Future when resetting the Express capability reg after firmware release the PCI ister address contains hex upgrade digit such as b0 the mlxfwreset fails due to a parsing issue 27 Mlxfwreset does Mlxfwreset fails due to Reboot the machine Future not workin ARM some missing filesin ARM after burning firmware release system machines instead of using mlxf wreset 28 General Accessing device Accessing the hardware Work with pciconf Future by crdevice register by mapping its device Release does not work in memory is not supported in ARM ARM architecture thus pci device will not be shown in MST devices list 29 On FreeBSD The tools running in paral Avoid
18. eate and burnanew Windows firmware VMware ESXi Debug and itrace Extracts and prints trace messages generated by the All Diagnostics firmware of a ConnectX family adapter devices tiliti J fwtrace Extracts and prints trace messages generated by the Linux firmware of a Connect IB family adapter devices mlxtrace Dumps trace messages generated by the device All hardware Rev 3 7 1 Overview Table 1 Mellanox Firmware Tools MFT Available Tools Sheet 2 of 2 Category Tool Description Package Type mlxdump Dumps device internal configuration registers The All dump file can be used by Mellanox Support for hardware troubleshooting mlxmeg Displays the current multicast groups and flow All steering rules configured in the device Target users Developers of Flow Steering aware applications wqdump Dumps the current QP contexts and Work Queues All of a ConnectX Connect IB family network adapter mera Reads writes a single word from to a device config All uration register space 12 Generates an 12c transaction using an mtusb usb to All i2c adapter or using the device internal i2c compati ble master mlxi2c Scans the i2c bus All Routes the i2c bus of an externally managed Infiniscalel V SwitchX system to connect to the switch silicon mget temp Reads the hardware temperature from Mellanox All Technologies devices internal sensors ConnectX family adapter cards Conn
19. ect IB BridgeX devices 4th generation switches and prints the reading in Celsius degrees pckt drop Corrupts the next transmitted packet from a Con All nectX and Connect IB family adapter port mlxuptime Prints Mellanox devices up time and measured All configured core clock frequency at Beta level mlxfwreset Load Firmware after firmware update on ISFU Linux capable devices 5th generation devices mlxmdio Used to read write MDIO registers Clause 45 on All boards with externally managed PHY Detailed installation instructions along with complete descriptions of the various tools in the package can be found in the Mellanox Firmware Tools User s Manual Document no 2329 Rev 1 90 or later 6 Mellanox Technologies Rev 3 7 1 1 2 Software Dependencies 1 2 1 Linux Software Dependencies Table 2 MFT Software Dependencies on Linux Software Package Required Version Kernel sources Machine s kernel version OFED MLNX_OFED 1 5 0 or higher Perl 5 6 or later Python 2 6 and above Isusb rpmbuild xz 1 OFED can be downloaded from http www openfabrics org Note that installing OFED is not required if you wish to install MFT without In Band capabilities 2 For the mst ib add command to run one of the OFED packages ibutils or ibutils2 or infiniband diags should be installed and available in the PATH For details
20. erating systems unless otherwise noted Package Tools The following is a list of the available tools in the package together with a brief description of each tool The tools apply to single switch systems or adapter cards The MFT tools do not pro vide cluster wide functionality Table 1 Mellanox Firmware Tools MFT Available Tools Sheet 1 of 2 Category Tool Description Package Type MST Service mst Starts stops the register access driver Linux and All VMware ESXi only Lists the available mst devices FW Update mlxburn This tool provides the following functions Linux and Configu Generating a standard or customized Mellanox firm Windows ration ware image for burning in bin format FreeBSD Burning an image to the Flash attached to a Mellanox HCA or switch device Querying the firmware version loaded on a Mellanox device Displaying the Vital Product Data VPD of a Mella nox network adapter flint This tool burns a firmware binary image or an All expansion ROM image to the Flash of a Mellanox network adapter bridge switch device It includes query functions to the burnt firmware image and to the binary image file mlxfwmanager The mlxfwmanager is a Mellanox firmware update Linux and query utility It provides a simple single Windows firmware update functionality VMware ESXi mlxconfig Allows the user to change some of the device con Linux figurations without having to cr
21. f stuck In case of flint it can cause locked semaphore Mikxtrace can cause driver issues and the tool may stuck 18 Mellanox Technologies Rev 3 7 1 4 History of Changes and New Features 4 1 Changes and New Features in Linux Table 10 History of Changes and New Features Version Component Tool Description 3 7 0 mlxfwmanager Added online firmware update mlxburn Added concurrency support to VPD read flint Added concurrency support to query firmware General Added support for Arm platform and Power8 mlxfwreset Firmware reset for Connect IB 3 6 0 mlxconfig Added mlxconfig tool for changing non volotaile configuration on device Burning Tools Added support for micron flash in flint and updated production burn flow on Connect IB 3 5 0 flint wqdump Redesigned the flint and wqdump utility to make their look and feel more user friendly flint Added support for brom in Connect IB mlxmdio Added support for the mlxmdio utility mlxfwmanager Added support for Connect IB 3 1 0 General The MFT package now has 2 installation flavours standard default mode and OEM The OEM mode provides the following extra function ality Tools for creating mlxfwmanager package Several features for flint that are used in Connect IB production Flint Added support for burning Connect IB via firmware interface The override cache replacement flag is not needed This provides
22. handling the error well 3 0 0 When trying to burn a FW ROM that contains a unified product version to a device where the firmware has no prod uct version the flint tool allows keeping the device ROM instead of burning the new FW ROM as is 3 0 0 itrace Access the trace messages area in host memory may fail when using Mellanox HCA cards without on board memory MemFree running on Red Hat Fedora and OEL OSs Consequently the application may crash or no trace mes sages will be printed 3 0 0 mlxdump Activating counter gateways in ConnectX 3 via an inband device causes firmware to hang dead lock 3 0 0 Installation Installing MFT with a different prefix than usr causes mlx mcg fwtrace and mstdump to not work On Fedora OS in addition to the above tools mst and mlx burn do not work either 3 0 0 mget temp Running mget temp against ConnectX 3 Pro even after initializing the diode results in high temperature e g 120 3 0 0 On certain boards where the external oscillator is connected only to one port the other port s thermal sensor will not func tion 3 0 0 On SwitchX A0 the YU sensor reports the wrong tempera ture 3 0 0 mlxmceg for merly mcg Installing MFT with a different prefix than usr causes mlx mcg to not work 3 0 0 fwtrace Occasionally the fwtrace executable may stop working and display the following output Cannot open self
23. ibdr may not add all nodes in a cluster 3 1 0 3 5 0 when the ports are inactive mst mtusb is not supported in Windows 2012 3 0 0 3 5 0 itrace Running the itrace tool when the driver is not loaded or when 3 1 0 3 5 0 the driver failed to load may cause the server to crash flint Setting the GUIDs on an image file which was generated 2 6 2 3 5 0 using the and striped image flags fails when the expansion rom size is larger than 400KB Current rom sizes are much smaller thus it is not expected to cause an actual issue mlxtrace mlxtrace not functional when using the PCI format device 3 1 0 3 5 0 against Connect IBTM wqdump CTRL C stops wqdump but does not clear release sema 2 6 2 3 5 0 phores Running wqdump with 1gnore ignores only the QPC gate 2 6 2 3 5 0 way lock but does not ignore the OB gateway 28 Mellanox Technologies Rev 3 7 1 Table 14 History of Fixed Bugs List Component Tool Issue Discovered in Rev Fixed in Rev mlxburn Setting an empty keyword is not reported as an error but will prevernt further using of the vpd set keyword flag Setting a keyword value longer than 255 characters is not reported as an error but may corrupted the vpd 3 0 0 3 1 0 The flag fw_dir is not supported when burning Con nectX 3 Pro adapter card 3 0 0 flint When a read write operation over mtusb remote device fails while running flint flint may crash hence not
24. irectory usr mst is not created For example mread mwrite and mcra tools that were previ ously installed by default under usr mst bin now are installed under usr bin Removed the InfiniScale and InfiniBridge tools Removed the Infinivision tool set Removed the isw tool The isw tool functionality was replaced by the mlxi2c tool For example to scan the devices on the 12 bus run gt mlxi2c d dev scan instead of gt isw d lt dev gt flint Added support for flash type SST25VF016B Added support for flash type M25PX16 Added an option to set the VSD and GUIDs in a binary image file This is useful for production to prepare images for pre assembly flash burning These new commands are supported by Mellanox 4th generation devices Added an option to set the VSD and GUIDs on an already burnt device These commands sg and sv re burn the existing image with the given GUIDs or VSD When the sg command is applied on a device with blank Oxff GUIDs it updates the GUIDs without re burning the image mst Added support for using ibutils2 ibdiagnet and ibnetdiscover in the mst ib add command Removed the uar msix and ddr devices from the mst device list Debug tools Added support for routing I2C bus to the 154 device on ISSOXX systems 2 6 1 Bug Fixes See Section 5 History of Bug Fixes on page 27 22 Mellanox Technologies
25. nd New Features in Windows Version Component Tool Description 3 7 0 mlxfwmanager Added online firmware update mlxburn Added concurrency support to VPD read flint Added concurrency support to query firmware General Removed support for x86 in Windows fwtrace Added fwtrace tool to windows 3 6 1 mlxconfig Added mlxconfig tool for changing non volotaile configuration on device Burning Tools Added support for micron flash in flint and updated production burn flow on Connect IB Mellanox Technologies 23 Rev 3 7 1 History of Changes and New Features Table 11 Changes and New Features Windows Version Component Tool Description 3 5 0 flint wqdump Redesigned the flint and wqdump utility to make their look and feel more user friendly flint Added support for brom in Connect IB mlxfwmanager Added support for Connect IB General Added support for Connect IBTM device at beta level Added support for ConnectX 3 Pro device The package contains only the flint FW update tool Other debug tools were removed flint Added support for new flashes types N25Q0XX Micron and W25Xxx Winbond mlxdump Added support for the mlxdump utility at beta level mlxmeg Renamed mcg to mlxmcg spark spark was removed from MFT version 3 0 0 Supported Devices The following adapter cards and switch systems are no longer supported in MFT version 3 0 0
26. on OFED installation visit http www mella nox com and under OFED 3 Required for the mlxmcg tool only Required for the mtusb device usage 5 For creating UPMF update package for Mellanox firmware B 1 2 2 Windows Software Dependencies Table 3 MFT Software Dependencies on Windows Software Package Required Version Mellanox WinOF VPI 3 0 0 and later 1 WinOF is required only for In Band access The package can be downloaded from www mellanox com gt Prod ucts gt Software gt InfiniBand VPI Drivers gt Windows SW Drivers Mellanox Technologies 7 Rev 3 7 1 Overview 1 2 3 FreeBSD Software Dependencies Table 4 MFT Software Dependencies on FreeBSD Software Package Required Version Perl For FreeBSD 10 0 x64 5 16 For others 5 14 In order for the tools in the package to work bash should be installed in bin bash aa In case bash is installed in a different path you should make a soft link to it in bin bash gt ln s bash path bin bash 1 2 4 VMware ESXi Software Dependencies Table 5 MFT Software Dependencies on VMware ESXi Software Package Required Version Python 2 6 and above 8 Mellanox Technologies Rev 3 7 1 1 3 Supported Operating Systems and Platforms 1 3 1 Linux Supported Operating Systems MFT is supported on the following platforms x86 x86 64 ppc64 ppc64le arm and ppc Table 6 Linu
27. pdate Package for Mella use mlxfwmanager Future tion is not sup nox Firmware cannot be tool and MFA to Release ported in created by using MFT tools update firmware VMware ESXi for VMware ESXi and and FreeBSD FreeBSD 35 mlxfwreset Running running Do not run Future mlxfwmanager_p mlxfwmanager_pci with mlxfwmanager pciin Release ci with other mft mfttools in parallel causes parallel with other tools in parallel read write corruption and MFT tools fails yields unexpected behaivour 36 Some tools are Fwtrace and mlxfwreset Reboot the machine Future missing in MFT for Connect IB are miss instead of running Release package for PPC inginthe MFT package for mlxfwreset after firm 64 platform PPC ware upgrade 37 mft uninstall mft uninstall mft unsinatl uses wrong Remove the packages Future sh fails in some indication to determine if manually Release Ubuntu machines the installed MFT package dpkg purge mft is Debian or RPM there dpkg purge ker fore it may try to remove nel mft dkms rpm files in Ubuntu Debian where deb files are installed 38 All Stopping restart While running one of the Avoid stopping mst Future ing mst service burning tools or debug service while running Release while tool is ging tools stopping the tools running may restarting the mst service cause some may cause some issues issues with the with the device or driver device or driver or can cause the tool to or the tool itsel
28. race running it in MEM mode to the tool with CTRL Z with CTRL Z can cause causes the firm issues to the device and to ware and the tool the firmware to hang 19 Performance activates a hard Use the flag Future decreases after ware component which stop on exit release running mlxtrace may lead to decreasing the packet rate of the HCA 20 WinMFT Downgrading is Downgrading WinMFT to Remove MFT prior to N A Installation currently not sup an older version might cor installing any earlier ported rupt the installation dir versions of MFT 21 mlxfwman mlxfwmanager mlxfwmanager pciscansa Two options Future ager package and single PCIe device on each Run the tool from release mlxfwmanager p bus Ina KVM guest OS the hypervisor rather ci may not detect multiple PCIe pass through than from the guest devices in a vir devices may be mapped to OS tualized environ the same bus thus Add to the com ment in Linux mlxfwmanager pcireports mand line d No devices found or spec bus dev fn of the ified specified targeted PCI device 22 mlxfwreset On some Connect IB board Use old update flow Future sometimes fails types driver fails to load i e reboot machine release to load firmware after loading new firmware properly using mlxfwreset 23 mlx mfa gen mlx mfa gen fails to cal Do not use spaces in Future can not create culate CRC when MFA s the directory name release MFA file un
29. rated in stage one in the xenserver normal machine by rpm i lt kernel mft binary RPM gt 3 Install MFT by install sh without kernel 15 fwtrace For EMC only fwtrace does not work with Run the tool with the Future fwtrace does Connect IB devices if f string db release work with Con f option is not provided file gt flag nect IBTM devices unless external strings db file is pro vided 16 mlxmeg for Running the tool Ifthe mcg tool is running It is recommended to Future merly mcg while the steering while steering entries are run the tool when the release table is modified added or removed from the steering table is ina is not supported device the tool may dis static mode play warnings in the fol lowing format mcg Oxlbff5 next points to non exist ing mcg index Ox1b7f5 And the displayed data may be incorrect Mellanox Technologies 15 Rev 3 7 1 Known Issues Table 9 Known Bugs Limitations Tool Issue Description Workaround To be Fixed 17 mlxtrace Running mlx In this mode mlxtrace may N A Future trace over an cause memory corruption release mtusb connected on the target machine to an HCA NIC which causes it to hang in a Windows target machine may cause the target machine to hang 18 MFT for ESXi Terminating the tool when Do not send CTRL Z N A Exiting mlxt
30. thernet packets and Multicast IB packets to the correct destination QPs Each line in the table shows a single filter and a list of destination QPs Packets that match the filter are steered to the list of destination QPs Removed support for In band access on OFED 1 4 Infiniband driver In band access is supported using OFED 1 5 X and higher General Added mlxconfig tool This tool sets firmware configurations for Mellanox adapters These con figurations are nonvolatile they apply over device reboots For further details please run mlxconfig h The tool is at beta level mget temp mget temp displays a more accurate temperature for ConnectX 2 devices by using chip specific thermal calibration data flint Added support for Atmel AT25DFxx flash family Cleared error messages displayed when trying to burn firmware image of a diferent device For example when burning ConnectX 2 firmware image on ConnectX 3 device 2 7 0a Bug Fixes See Section 5 History of Bug Fixes on page 27 20 Mellanox Technologies Rev 3 7 1 Component Tool Description 2 7 0 General Added support for Mellanox ConnectX 3 and SwitchX silicon devices Added Secure host feature which enables ConnectX family devices to block access to its internal hardware registers The hardware access in this mode is allowed only if a correct 64 bits key is provided see flint changes
31. usr bin fwtrace or archive usr bin fwtrace pkg 3 0 0 wqdump wqdump uses certain hardware gateways which are used by the firmware Thus when it accesses the device via the firm ware and owns the hardware gateways it causes issues for the firmware and does not work 3 0 0 Mellanox Technologies 29 Rev 3 7 1 History of Bug Fixes Table 14 History of Fixed Bugs List Discovered Fixed in Component Tool Issue in Rey Rev Install script MFT cannot be installed in a path different than the default 2 7 1a 3 0 0 usr The installation script fails if OFED v1 4 or older is installed 2 7 1a 3 0 0 in the machine as it tries to search for non existing RPMs flint After firmware upgrade or downgrade the externally man 2 7 1a 3 0 0 aged SwitchX A1 should be rebooted through power cycle and not via flint swreset command mlxburn The flag fw dir is not supported when burning ConnectX 2 7 1a 3 0 0 3 A1 adapter card mst The uninstall operation leaves device files under dev mst 2 7 1a 3 0 0 mlxmeg The tool shows the rules of port 1 in port2 line and vice versa 2 7 1a 3 0 0 formerly mcg mstdump Running mstdump on a ConnectX 3 device may cause the 2 7 0 2 7 1a firmware to hang flint Accessing the SwitchX flash by MFT has a bug while read 2 7 0a 2 7 1 ing on PPC64 platform therefore the SwitchX cannot be 270a 271 updated vi
32. x Operating Systems and Platforms Operating System Kernels RedHat EL6 2 6 32 71 16 RHEL6 2 6 32 131 0 15 e16 RHEL6 UP1 2 6 32 220 16 RHEL6 UP2 2 6 32 279 16 RHEL6 2 6 32 358 16 RHEL6 2 6 32 431 16 RHEL6 UPS RedHat EL7 3 10 28 105 17 RHEL 7 SLES 10 2 6 16 60 0 54 5 smp SLES 10 SP3 SLES 11 2 6 27 19 5 default SLES 11 2 6 32 12 0 7 default SLES 11 UP1 3 0 13 0 27 default SLES 11 UP2 3 0 76 0 11 default SLES 11 UP3 SLES 12 3 12 22 2 default SLES 12 Kernel org 3 10 28 3 11 10 3 12 9 3 13 1 3 14 3 3 15 6 Ubuntu 12 04 12 04 4 13 04 13 10 14 04 Mellanox Technologies 9 Rev 3 7 1 Overview Table 6 Linux Operating Systems Platforms Operating System Kernels Debian 6 0 7 6 0 8 7 1 7 2 7 4 7 5 7 6 Fedora 14 16 17 18 19 20 Citrix Xenserver 6 1 6 2 OEL6 2 2 6 32 279 16 2 6 32 279 19 1 16 OEL6 3 2 6 32_279 e16 2 6 32 279 19 1 el6 2 6 32 279 22 1 16 OEL6 4 2 6 32 358 16 OEL 6 5 3 8 13 16 2 1el6uek 1 Did not pass QA and Verification 1 3 2 Windows Supported Operating Systems Supported Operating Systems and Service Packs Windows 7 x64 Windows Server 2012 x64 Windows Server 2012 R2 x64 Windows PE 3 0 x86 Windows PE 3 0 x64 e
33. y 3 5 0 3 6 0 flint On FreeBSD burning new firmware on a device with corrupt 3 5 0 3 6 0 empty firmware does not work Mellanox Technologies 27 Rev 3 7 1 History of Bug Fixes Table 14 History of Fixed Bugs List Discovered Fixed in Component Tool Issue in Rey Rev mst Occasionally if a node has a LID set to 0 the mst ib add 3 1 0 3 6 0 use ibdr command will not add that nodes to the mst device list mst On Windows mst may not show any devices 3 5 0 3 6 0 mlxmeg mlxmceg fails on PPC 3 5 0 3 6 0 formerly mcg itrace On Windows Ctrl C does not exit gracefully 3 5 0 3 6 0 All On Windows Power Shell MFT might not work on mst 3 5 0 3 6 0 devices that contain a comma All On Windows x64 some tools are 32 bit binaries 3 5 0 3 6 0 mst The mst cr device is not functional on VMware VMware 2 7 1 3 5 1 ESXi When running it the following message is received You cannot access the HW configurations by mt4099 pci_crO device in ESXi flint Running the sg set guids command on a striped image 2 7 1 3 5 1 file containing a large expansion rom image may fail mst mst status does not show the mtusb 1 when adding in band 3 0 0 3 5 0 devices mst mst shows all devices when connected to Flex10 remotely 3 0 0 3 5 0 mst mst does not display a message when there is no HCA device 3 0 0 3 5 0 connected to the machine mst mst ib add use
34. y of Changes and New Features Table 12 Changes New Features in VMware ESXi Version Component Tool Description 3 5 1 package content Added support for the following tools mst mlxfwmanager itrace mlx trace mlxdump mlxmcg wqdump mcra mget_temp pckt_drop mlxup time flint Added support for ConnectX 3 Pro Redesigned the utility to make its look and feel more user friendly mstdump Added support for ConnectX 3 Pro 3 5 0 flint wqdump Redesigned the flint and wqdump utility to make their look and feel more user friendly flint Added support for brom in Connect IB 4 4 Changes and New Features in FreeBSD Table 13 Changes and New Features in FreeBSD Version Component Tool Description 3 7 0 flint Added concurrency support to query firmware mlxburn Added mlxburn to MFT for FreeBSD 3 6 0 mtserver Added support for mstserver in FreeBSD 3 5 0 FreeBSD Added support for FreeBSD operating system at beta level 26 Mellanox Technologies Rev 3 7 1 5 History of Bug Fixes Table 14 lists the history of bugs fixed Table 14 History of Fixed Bugs List Discovered Fixed in Component Tool Issue in Rev Rev Installation Kernel installation failed in fbk13 Operating System 3 7 0 3 7 1 Install script and MFT installation failed in PPC64LE when TCL is not 3 7 0 3 7 1 mlxburn installe
Download Pdf Manuals
Related Search