Mellanox Firmware Tools (MFT) Release Notes for Linux.book
Contents
1. Tool Issue Description Workaround To P 8 itrace No support for For Mellanox HCA cards Use the nomap flag N A host memory without on board memory for MemFree cards with access on Mem MemFree with a Red Hat Red Hat OS Free adapter cards OS running attempts to with Red Hat OS access the trace messages area in host memory may fail Consequently the application may crash or no trace messages will be printed without any error message 9 wqdump Flag dump Running wqdump with N A Future ICM may pro dump ICM option may release duce a large file produce a large file 10 CTRL C does not CTRL C stops wqdump Restart the driver to clear Future clear semaphores but does not clear release the semaphores release semaphores 11 Support for Running wqdump with N A Future ignore is not ignore ignores only the release complete QPC gateway lock but does not ignore the OB gateway 12 mlxburn vpd set keyword Setting an empty keyword Do not set an empty key Future Setting a key is not reported as an error word release word value that is but will prevernt further If you already set an either empty or using of the empty keyword You can longer than 255 vpd set keyword flag set the empty keyword characters Setting a keyword value again using the longer than 255 characters vpd set keyword is not reported as an error but may corrupted the vpd 13 Running multiple Running multiple VPD N A Fut2. 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 Expan sion 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 pre vious 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 Con nectX 2 InfiniScale IV and BridgeX devices Debug tools Updated the mlxi2c utility Added the mget temp utility which reads the temperature of the ConnectX ConnectX 2 InfiniScale IV and BridgeX devices 10 Mellanox Technologies Rev 2 7 1a 3 Bug Fixes Table 9 lists the bugs fixed in this release Table 9 Fixed Bugs List in version 2 7 1a Component Tool Issue Description mstdump Running mstdump on a ConnectX 3 device may cause the Fixed firmware to hang Mellanox Technologies 11 J Rev 2 7 1a Known Issues 4 Known Issues Table provides a list of known bugs and limitations in regards to this release of the Mellanox Firmware Tools Table 10 K
3. burning firmware via Command Line interface on SwitchX devices Mlxburn Added option to add or replace a single keyword in the VPD writable section 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 8 Mellanox Technologies J Rev 2 7 1a 25 Changes in Version 2 6 2 Table 7 Changes and New Features in version 2 6 2 Component Tool Description MFT installation change RPM based installation Applications are installed using a pre compiled binary RPM Kernel modules are distributed as a source RPM and compiled by the installation script 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 Directory usr mst is not created For example the mread mwrite and mcra tools that were pre viously 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 i2c bus run gt mlxi2c d dev scan instead of gt isw d lt dev gt flint Added support fo
4. 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 3 Changes in Version 2 7 0a This release includes bug fixes only Mellanox Technologies 7 J Rev 2 7 1a Changes and New Features 24 Changes in Version 2 7 0 Table 6 Changes and New Features in version 2 7 0 Component Tool Description 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 pro vided see flint changes MFT tools cannot run on a device with hardware access disabled This feature is enabled only with supporting firmware Removed support for Itanium 1264 flint Added the following commands enable disable access to the hardware set change the key used to enable access to the hardware The 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
5. 6 RHEL6 UP3 SLES10 2 6 16 60 0 84 1 smp SLES10 SP4 SLESII 2 6 27 19 5 default 2 6 32 12 0 7 default SLES11 SP1 3 0 13 0 27 default SLES11 SP2 Kernel org 1 2 6 35 and 2 6 36 1 OSes that are not tested 6 Mellanox Technologies Rev 2 7 1a 2 Changes and New Features 2 1 Changes in Version 2 7 1a Table 4 Changes and New Features in version 2 7 1a Component Tool Description Added the mcg 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 1s used by the device to steer Ethernet packets and Multicast IB packets to the cor rect 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 In band access is supported using OFED 1 5 X and higher access on OFED 1 4 Infiniband driver 2 2 Changes in Version 2 7 1 Table 5 Changes and New Features in version 2 7 1 Component Tool Description General Added mlxconfig tool This tool sets firmware configurations for Mellanox adapters These configurations are nonvolatile they apply over device reboots For further details please run mlxconfig h The tool is at beta level mget
6. Mellanox TECHNOLOGIES Mellanox Firmware Tools MFT for Linux Release Notes Rev 2 7 1a Last Modified January 06 2013 www mellanox com Rev 2 7 1a 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 POSSIBILIT
7. Y OF SUCH DAMAGE 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 972 0 4 959 3245 Copyright 2013 Mellanox Technologies All Rights Reserved Mellanox Mellanox logo BridgeX ConnectX CORE Direct InfiniBridge InfiniHost InfiniScale PhyX SwitchX Virtual Protocol Interconnect and Voltaire are registered trademarks of Mellanox Technologies Ltd Connect IBTM FabricIT MLNX OS MetroX ScalableHPC Unbreakable Link UFM and Unified Fabric Manager are trademarks of Mellanox Technologies Ltd All other trademarks are property of their respective owners 2 Mellanox Technologies Rev 2 7 1a Table of Contents Tabl of Contents AE dere arse a beeen EE RE ei ER ED Ge 3 Listof Tables is iS BEE outs DS EE iE ee eee he RR EN ES EUREN EE Ee 4 Chapter 1 Overview x osx WE AE OE RE DR OCURRE QUK RR IR aaa ee ee 5 Tol Package TOOIS AE ERAS dd x ea CR N GE RAN A Ra ORE unc td 5 1 2 Software Dependencies 2000 000s 6 1 3 Supported Operating Systems and Platforms 6 Chapter 2 Changes and New Features ee Ek RE RR RR RR RR ee 7 2 1 Changes in Version 2 7 18 suk ye Vie sage git RR Ge De mace 7 2 2 Changes
8. ad The flint help display lists the Expansion ROM read command as rrrom instead of mst In band access does not work with OFED 1 5 Fixed Mellanox Technologies 17 J Rev 2 7 1a History of Bug Fixes 5 6 Fixed Bugs in Version 2 6 0 Table 16 Fixed Bugs in version 2 6 0 Component Tool Issue Description mlxburn Bad exit status upon a successful query operation When running mlxburn with a query flag it may return an exit value of 1 for a success ful operation nofs img flag does not take effect for ConnectX image Fixed generation flint Image with blank GUIDs is treated as a valid image by the Mellanox devices can flint v run verify not boot from an image including blank GUIDs In this new release flint v will indicate an error Locked HCA Flash semaphore when IB driver is down Fixed by OFED 1 4 mst mst status sometimes displays the same device twice on Fixed hosts with multiple HCAs mst ib add allows specifying a non existing ib device Fixed 18 Mellanox Technologies
9. arallel the tool may dis play warnings in the fol lowing format mcg Oxlbff5 next points to non exist ing mcg index Ox1lb7f5 And the displayed data may be incorrect 19 Running the tool If the mcg tool is running It is recommended to run Future while the steering while steering entries are the tool when the steer release table is modified added or removed from the ing table is in a static is not supported device the tool may dis mode play warnings in the fol lowing format mcg Oxlbff5 next points to non exist ing mcg index Ox1lb7f5 And the displayed data may be incorrect 20 Port rules mis The tool shows the rules of N A Future match port 1 in port2 line and release vice versa Mellanox Technologies 15 J Rev 2 7 1a History of Bug Fixes 5 5 1 5 2 5 3 16 Mellanox Technologies History of Bug Fixes Fixed Bugs in version 2 7 1 Table 11 lists the bugs fixed in this release Table 11 Fixed Bugs List in version 2 7 1 Component Tool Issue Description flint Accessing the SwitchX flash by MFT has a bug while read Fixed ing on PPC64 platform therefore the SwitchX cannot be updated via the PPC64 machine mlxburn The flag fw dir is not supported when burning SwitchX Fixed devices mstdump Running mstdump on a SwitchX device may cause it to Fixed malfunction All Tools in x86 machines display N A in the svn
10. e 6 Changes and New Features in version 2 7 0 ii iese es Se Ge ees ee ee se es ee 8 Table 7 Changes and New Features in version 2 6 2 ee iese ee Ge ee se ee es ee see 9 Table 8 Changes and New Features in version 2 6 0 0 es Se eee eee eee eens 10 Table 9 Fixed Bugs List in version 2 7 14 llle 11 Table 10 Known Bugs and Limitations iis ie Ee EE SE Ge Se Ee eens 12 Table 11 Fixed Bugs List in version 2 7 1 0 ee ee ee Ge Ge Se en 16 Table 12 Fixed Bugs List in version 2 7 08 siese SE ee Ge Se ee ee ee Ge se ee ee ee se 16 Table 13 Fixed Bugs List in version 2 7 0 0 ccc ccc cece e 16 Table 14 Fixed Bugs List in version 2 6 2 0 ccc cece cect nent eens 17 Table 15 Fixed Bugs List in version 2 6 1 0 0 0 0 ccc cece een een ee 17 Table 16 Fixed Bugs in version 2 6 0 0 0 0 cece ccc ee 18 4 Mellanox Technologies J Rev 2 7 1a 1 Overview These are the release notes for Rev 2 7 1a of the Mellanox Firmware Tools MFT package for Linux The release notes include This Overview section which includes the subsections Package Tools on page 5 Software Dependencies on page 6 Supported Operating Systems and Platforms on page 6 Changes and New Features on page 7 Changes in Version 2 7 1a on page 7 Changes in Version 2 7 1 on page 7 Changes in Version 2 7 0a on page 7 Changes in Version 2 7 0 on page 8 Changes
11. in Version 2 6 2 on page 9 Changes in Version 2 6 1 on page 10 Changes in Version 2 6 0 on page 10 Known Issues on page 12 Bug Fixes on page 11 History of Bug Fixes on page 16 1 1 Package Tools The following is a list of the available tools in the package together with a brief description of what each tool performs The tools apply to single Switch Systems or adapter cards but not to clusters Table 1 Mellanox Firmware Tools MFT Available Tools mlxburn This tool provides the following functions Generation of a standard or customized Mellanox firmware image for burning in bin binary or img format Burning an image to the Flash EEPROM attached to a Mellanox HCA or switch device Querying the firmware version loaded on an Mellanox network adapter Displaying the VPD Vital Product Data of an Mellanox network adapter flint This tool burns a firmware binary image or an expansion ROM image to the Flash device of a Mellanox network adapter bridge switch device It includes query func tions to the burnt firmware image and to the binary image file spark This tool burns a firmware binary image to the EEPROM s attached to an InfiniSca lelII amp switch device It includes query functions to the burnt firmware image and to the binary image file The tool accesses the EEPROM and or switch device via an I2C compatible interface or via vendor specific MADs over the InfiniBand fabric In Band
12. in Version 2 7 1 du RR Su EE Resta SOC HE eR ne OR is MEd 7 2 3 Changes in Version 2 7 0a ics suce RR ERA xRE RETREAT E 7 2 4 Changes in Version AT ORE EE ER DE SE Dee MP EE EG 8 25 Changes in Version 2 6 2 EE EE ES RE ER Se EE EE ER nnn 9 2 0 Changes in Version 2 6 1 essit e m RR dee tes 10 2 7 Changes in Version 2 600 2 Gaur seed PERE ges P ru dede i 10 Chapter 3 Bug Fixes 22222 oss 9900006 RE ER BERE RR Se Ses 11 Chapter 4 KnownlIssueS iss ER RR RR RR RR RR RR RR RR RR RR Re ee 12 Chapter 5 History of Bug Fixes ss ss se ee ee ee ee RR RR RR RR Re Re ee 16 5 1 Fixed Bugs in version Z7 15 c ME BE ees e SUELE eta 16 5 2 Fixed Bugs in version 2 7 DA di sober rect bad lere ee ed 16 9 3 Fixed Bugs in versioni 2 tO so ceu Peer eel mp tbe Sp Vus our d 16 5 4 Fixed Bugs in version 2 6 2 EES RE ER Ede Ee nne 17 5 5 Fixed Bugs in version 2 6 Vi ooa sce eer eoe Sale tied 17 5 6 Fixed Bugs in Version 2 0 0 rblAIwo ya Rae ie DE 18 Mellanox Technologies 3 J Rev 2 7 1a List of Tables Table 1 Mellanox Firmware Tools MFT Available Tools ss 0 00 cece cece eens 5 Table 2 MFT Software Dependencies on Linux iss ccc Gee ee ee ee ee ee 6 Table 3 Linux Operating Systems and Platforms 2 sie ee Se se eee eee esee 6 Table 4 Changes and New Features in version 2 7 18 ii ies es cece eee se ee 7 Table 5 Changes and New Features in version 2 7 1 2 0 cece Se Ge ee se ee 7 Tabl
13. nown Bugs and Limitations Is installed installed in the machine as it tries to search for non existing RPMs follow RPMS mft 2 7 1a 1 x86 64 rpm to RPMS mft 2 7 1a 1 ofedl4 x86 64 rpm RPMS mft 2 7 1a 1 x86 rpm to RPMS mft 2 7 1a 1 ofed14 x86 rpm RPMS mft 2 7 1a 1 ppc6 4 rpm to RPMS mft 2 7 1a 1 ofedl4 ppc64 r pm Tool Issue Description Workaround w pea l Install prefix instal MFT cannot be installedin N A Future script lation flag is not a path different than the release supported default usr 2 Installation fails The installation script fails Change the names ofthe Future when OFED 1 4 if OFED v1 4 or older is user space RPM as release 12 Mellanox Technologies Rev 2 7 1a Table 10 Known Bugs and Limitations Tool Issue Description Workaround T ae 3 flint Burning query When running mlxburn Use qq flag to performa N A mlxburn ing via an flint via an MTUSB 1 quick query and MTUSB 1 may device a burn query com no flash verify to take up to 35 min mand may take up to 12 perform a quick burn utes minutes to complete with Please note out any messages dis no flash verify played This is mainly due does not verify if the to an extensive firmware image is burnt image query that runs by default 4 Burning an image On some host machines Use the MTUSB 1 c
14. on N A to a ConnectX that use PCIe spread spec nection to burn the image adapter in Flash trum the tool may not be recovery mode able to recognize the Con may fail nectX device s PCI CONFO or the image burn may not complete success fully Note This is not an issue for ConnectX 2 devices 5 flint Running the sg Setting the GUIDs on an N A Future set guids com image file which was gen release mand on astriped erated using the image file exp rom and containing alarge striped image flags will expansion rom fail when the expansion image may fail rom size is larger than 400KB Current rom sizes are much smaller thus it is not expected to cause an actual Issue 6 SwitchX A1 After firmware upgrade or N A Future unmanaged downgrade the unman release rebootthroughthe aged SwitchX A1 should power cycle be rebooted through the power cycle and not via swreset 7 spark Parallel in band Parallel tool runs which Reboot the machine and N A tool runs with an target multiple devices and rerun with correct LIDs HCA or with a mistakenly include non non existing InfiniScale III LIDs may LID s may hang hang spark and the driver the driver and the tool Mellanox Technologies 13 J Rev 2 7 1a Known Issues Table 10 Known Bugs and Limitations ing ConnectX 3 A adapter card ConnectX 3 A1 adapter card instead of fw dir
15. r 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 IS4 device on ISSOXX sys tems Mellanox Technologies 9 J Rev 2 7 1a Changes and New Features 2 6 Changes in Version 2 6 1 MTF version 2 6 1 includes bug fixes only 2 7 Changes in Version 2 6 0 Table 8 Changes and New Features in version 2 6 0 Component Tool Description MFT installation change Added the options without image generation disable dc and without kernel which allow for a partial installation in order to avoid problems 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
16. tool Debug utili A set of debug utilities e g itrace mstdump mlxi2c and i2c ties Mellanox Technologies 5 J Rev 2 7 1a Overview 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 40 or later 1 2 Software Dependencies Table 2 MFT Software Dependencies on Linux Software Package Required Version Kernel sources Machine s kernel version OFED MLNX OFED L 1 5 0 or higher Perl 5 6 or later 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 on OFED installation visit http www mella nox com and under OFED 1 3 Supported Operating Systems and Platforms MFT is supported on the following platforms x86 x86 64 ppc64 Table 3 Linux Operating Systems and Platforms Operating System Kernels RedHat EL5 2 6 18 194 e15 RHELS UPS 2 6 18 238 e15 RHELS UP6 2 6 18 274 e15 RHELS UP7 2 6 18 308 el5 RHELS UP8 RedHat EL6 2 6 32 71 e16 RHEL6 2 6 32 131 0 15 e16 RHEL6 UP1 2 6 32 220 e16 RHEL6 UP2 2 6 32 279 e1
17. ure VPD access com access commands in paral release mands in parallel lel on the same device may cause the commands to fail VPD access commands should be run one at a time 14 fw dir flag The flag fw dir is not Specify the firmware file Future issues when burn supported when burning by using the flag fw release 14 Mellanox Technologies Rev 2 7 1a Table 10 Known Bugs and Limitations Tool Issue Description Workaround T DT 15 Mst Mst driver mod The uninstall operation Run mst stop before unin Future ule remains leaves device files under stall release loaded when dev mst uninstalling MFT 16 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 adevice with zero ibnetdiscover tool system GUID in the fabric 17 mst ib add com When an IB subnet man Verify a subnet manager Future mand may add ager is not running in the is running and that all the release inaccessible in fabric some of the ports ports are in ACTIVE state band devices may be in INIT 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 18 meg Parallel execu When multiple instances of Avoid running mcg in Future tion is not sup the mcg tool are running in parallel release ported p
18. version field Fixed instead of displaying the svn version Fixed Bugs in version 2 7 0a Table 12 lists the bugs fixed in this release Table 12 Fixed Bugs List in version 2 7 0a Component Tool Issue Description flint Burning the firmware into ConnectX 3 A1 adapter using Fixed the MST CR device resulted in failure Mst ib add mst ib add fails to add in band devices when the IB driver Fixed is newer than MLNX OFED LINUX 1 5 3 0 Fixed Bugs in version 2 7 0 Table 13 lists the bugs fixed in this release Table 13 Fixed Bugs List in version 2 7 0 Component Tool Issue Description MIxi2c mlxi2c scan fails the first time when using mtusb Fixed flint The sg set guids command on a VPI device may burn Fixed MACs GUIDs with value Oxff If the striped_image flag is used in a burn command Fixed image burn will fail or burn a corrupt image Rev 2 7 1a 5 4 Fixed Bugs in version 2 6 2 Table 14 lists the bugs fixed in this release Table 14 Fixed Bugs List in version 2 6 2 Component Tool Issue Description mst Occasionally mst restart locked the flash semaphore Fixed mst ib add added non Mellanox device to the in band Fixed device list 5 5 Fixed Bugs in version 2 6 1 Table 15 lists the bugs fixed in this release Table 15 Fixed Bugs List in version 2 6 1 Component Tool Issue Description flint Typo in flint help description of Expansion ROM re
Download Pdf Manuals
Related Search