Troubleshooting
| 
     Issue  | 
                
     Cause  | 
                
     Solution  | 
        
| 
     Adapter is no longer identified by the operating system after firmware upgrade  | 
                
     Happens due to burning the wrong firmware on the adapter, firmware corruption or adapter's hardware failure.  | 
                
     Power cycle the server. If the issue persists, extract the adapter and contact Support  | 
        
| 
     Server is booting in loop/not completing boot after performing adapter firmware upgrade  | 
                
     Happens due to burning the wrong firmware on the adapter, firmware corruption or adapter's hardware failure.  | 
                
     Extract the adapter and contact Support  | 
        
| 
     Some of the 5th generation (Group II) devices are represented with only one mst device (dev/mst/mt4113_pciconfx) in the output of mst status  | 
                
     For 5th generation (Group II) devices, there is only one method available for accessing the hardware. For example, Connect-IB device is represented bydev/mst/mt4113_pciconfx mst device  | 
                
     When querying a 5th generation (Group II) device, use the conf mst device (for example: dev/mst/mt4113_pciconfx)  | 
        
| 
     Enabling hardware access after configuring new secure host key, fails  | 
                
     The new configuration of the secure host key was not loaded by the driver  | 
                
     Restart the driver before enabling the hardware access again  | 
        
| 
     MFT tools fail on PCI device with the following errors: 
  | 
                
     Tools PCI semaphore might be locked due to unexpected process shutdown.  | 
                
     Run the following command: # mcra -c <mst_pci_device> *Supported on MFT-4.4.0 and newer versions.  | 
        
| 
     Issue  | 
                
     Cause  | 
                
     Solution  | 
        
| 
     Server not booting after enabling SRIOV with high number of VFs  | 
                
     Setting number of VFs larger than what the Hardware and Software can support may cause the system to cease working  | 
                
     To solve this issue: 
  | 
        
| 
     When Querying for current configuration on ConnectX-3/ ConnectX-3Pro, some of the parameters are shown as “N/A”  | 
                
     The current firmware on the device does not support showing the device's default configuration  | 
                
     Update to the latest firmware  | 
        
| 
     After resetting configuration using the tool on 5th generation (Group II) devices, the configuration's value does not change  | 
                
     Firmware loads the default configuration only upon reboot  | 
                
     Reboot the server  | 
        
| 
     Issue  | 
                
     Cause  | 
                
     Solution  | 
        
| 
     Unable to install the tool package on ESXi platform and the following message is printed on the screen: Got no data from process  | 
                
     Insufficient privileges  | 
                
    
 Note: an additional reboot will be required after completing the installation  | 
        
| 
     Unable to install kernel-mft in Linux due to compilation error that contains the following message: 'error: conflicting types for 'compat_sigset_t''  | 
                
     CONFIG_COMPAT might not be enabled in the kernel configuration.  | 
                
     Set the CONFIG_COMPAT to “y” in the kernel .config file, and rebuild the kernel.  | 
        
| 
     Issue  | 
                
     Cause  | 
                
     Solution  | 
        
| 
     The following message is printed on screen when performing firmware update: An update is needed for the flash layout. The operation is not failsafe and terminating the process is not allowed.  | 
                
     A flash alignment operation is required.  | 
                
     Approve the alignment, avoid process interrupt.  | 
        
| 
     Firmware update fails with the following message: -E- Burning FS4 image failed: Bad parameter Note: This is a rare scenario.  | 
                
     Firmware compatibility issue.  | 
                
     Re-run the burn command with --no_fw_ctrl flag.  | 
        
| 
     The following message is printed on screen when performing firmware update: Shifting between different image partition sizes requires current image to be re-programmed on the flash. Once the operation is done, reload FW and run the command again Note: This is a rare scenario.  | 
                
     Firmware compatibility issue.  | 
                
     Re-load firmware and re-run the burn command.  | 
        
| 
     The following message is printed on screen when trying to query/burn a Connect-IB device: -E- Cannot open Device: /dev/mst/mt4113_pciconf0. B14 Operation not permitted MFE_CMDIF_GO_BIT_BUSY  | 
                
     Using an outdated firmware version with the Connect-IB adapter.  | 
                
    
 For example: flint -d /dev/mst/mt4113_pciconf0 -ocr q  | 
        
| 
     The following message is reported on screen when trying to remove the expansion ROM using the 'drom' option: -E- Remove ROM failed: The device FW contains common FW/ROM Product Version - The ROM cannot be removed separately.B9  | 
                
     Updating only the EXP_ROM (FlexBoot) for recent firmware images which requires adding the 'allow_rom_change' option.  | 
                
     Allow “-allow_rom_change” option to the “flint” command. For example: flint -d <mst_device> - allow_rom_change drom  | 
        
| 
     Burning command fails and the following message is printed on screen: -E- Can not open 06:00.0: Can not obtain Flash semaphore (63). You can run "flint -clear_semaphore - d <device>" to force semaphore unlock. See help for details.  | 
                
     Semaphore can be locked for any of the following reasons: 
  | 
                
     If no other process is taking place at the same time run the following command: flint -d <device> -- clear_semaphore OR Reboot the machine.  | 
        
| 
     Burning tool fails with the following message: –E– Unsupported binary version (2.0) please update to latest MFT package.  | 
                
     The binary version is incompatible with the burning tool.  | 
                
     Update MFT to the latest package.  | 
        
| 
     mlxburn tool fails to generate a firmware image and displays the following message: –E– Unsupported MLX file version (2.0) please update to latest MFT package.  | 
                
     The MLX file version is incompatible with the image generation tool (mlxburn).  | 
                
     Update MFT to the latest package.  | 
        
| 
     mlxburn tool fails to generate a firmware image and displays the following message -E- Perl Error: Image generation tool uses mic (tool) version 1.5.0 that is not supported for creating a bin file for this FW version. FW requires mic version 2.0.0 or above. Please update MFT package.  | 
                
     The MLX file version is incompatible with the image generation tool (mlxburn).  | 
                
     Update MFT to the latest package.  | 
        
| 
     Burning tool fails with an error mentioning Firmware time stamping e.g -E- Burning FS3 image failed: Stamped FW version missmatch: 12.16.0212 differs from 12.16.0230  | 
                
     The device was set with a timestamp for a different firmware version than the one being burnt or the image is stamped with an older timestamp  | 
                
     Either set a newer timestamp on the image than there is on the device, or reset the timestamp completely. flint -d <device> ts reset flint -i <image> ts reset  | 
        
| 
     Burning the image on Controlled FW (default update method: fw_ctrl in 'flint -d <device> query full' output), fails with: -E- Burning FS3 image failed: The Digest in the signature is wrong.  | 
                
     The image was changed without calculating the new digest on it with 'flint -i <img.bin> sign'.  | 
                
     Run 'flint -i <img.bin> sign', and retry.  | 
        
| 
     Issue  | 
                
     Cause  | 
                
     Solution  | 
        
| 
     Changing device setting such as ROM/ GUIDS using the relevant flint commands result in failure with the following error: -E- <Operation> failed: Unsupported operation under Secure FW  | 
                
     Secure Firmware does not allow changes to the device data unless burning new Secure Firmware image.  | 
                
     N/A  | 
        
| 
     Burning tool fails with the following error: -E- Burning FS3 image failed: The component is not signed.  | 
                
     The image is not signed with an RSA authentication.  | 
                
     Contact Support to receive a signed firmware image.  | 
        
| 
     Burning tool fails with the following error: -E- Burning FS3 image failed: Rejected authentication.  | 
                
     The image authentication is rejected.  | 
                
     Contact Support to receive a signed firmware image.  | 
        
| 
     Burning tool fails with the following error: -E- Burning FS3 image failed: Component is not applicable.  | 
                
     The image does not match the device (Wrong ID).  | 
                
     Contact Support to receive the firmware image for the device.  | 
        
| 
     Burning tool fails with the following error: -E- Burning FS3 image failed: The FW image is not secured.  | 
                
     The image is not secured and is not accepted by the device.  | 
                
     Contact Support to receive a signed firmware image.  | 
        
| 
     Burning tool fails with the following error: -E- Burning FS3 image failed: There is no Debug Token installed.  | 
                
     The debug firmware was burnt before the debug token was installed on the device.  | 
                
     Install the debug token using mlxconfig and then re-burn the firmware.  | 
        
| 
     Burning firmware on a secure device fails with one of the following messages: 
  | 
                
     The image was not secured in a the proper way.  | 
                
     Ask for a secure image with the right keys that match the device.  | 
        
| 
     Secure Firmware fails when using flint brom and drom commands.  | 
                
     flint brom and drom commands are not supported.  | 
                
     N/A  | 
        
| 
     mlxdump and wqdump debug utilities do not work in Secure Firmware  | 
                
     A customer support token was not applied.  | 
                
     N/A  | 
        
| 
     When the CR space is in read only mode, the tracers may demonstrate an unexpected behavior.  | 
                
     A writing permission is required for them to work properly.  | 
                
     N/A  | 
        
| 
     Applying token on the device fails with one of the following messages: 
  | 
                
     The token was not generated or signed in the proper way.  | 
                
     Refer to the section Create Tokens for Secure Firmware and NV LifeCycle to learn how to generate and sign tokens.  | 
        
| 
     Burning the firmware using the “--use_dev_rom” flag has no effect and the ROM is replaced with the one on the image.  | 
                
     Controlled firmware does not support changing boot image component.  | 
                
     Use “--no_fw_ctrl”.  |