Program with ethtool

Alveo X3522 User Guide (UG1523)

Document ID
UG1523
Release Date
2023-08-25
Revision
1.4 English

To apply a .update file with ethtool:

  1. Apply the .update file to the first interface on the X3522:
    # ethtool -f enp1s0f0np0 xilinx/x3/x3522-bundle.update

    The ethtool command hands the filename to the driver, and the driver then calls the firmware to perform the update.

  2. Wait for the firmware to finish the update:
    • Ethtool blocks and does not report progress.
    • Completion is indicated by ethtool exiting, and the command line prompt appearing.
    Note: If you press Ctrl-C it halts ethtool, but the firmware continues to apply the update.
    Note: If the update fails, refer to the kernel message log for details. The error messages from ethtool -f are generic and can be misleading.
  3. Do a cold reboot of the server, during which the server must be physically disconnected from all power sources.
    CAUTION:
    If you are using a tool such as iDRAC/BMC, be aware that cold reboot or power cycle commands typically leave auxiliary power enabled. This will cause a partial update that puts the X3522 in an unpredictable or failed state. You must ensure you select options that remove all power from the server (including auxiliary power), and so are equivalent to disconnecting it.

    If in any doubt, physically disconnect the server.

  4. Confirm the version numbers are as expected:
    # ethtool -i enp1s0f0np0
    driver: xilinx_efct
    version: 1.2.3.0
    firmware-version: 1.16.1.8
    expansion-rom-version: 1.3.6.18
    bus-info: 0000:01:00.0
    supports-statistics: yes
    supports-test: yes
    supports-eeprom-access: no
    supports-register-dump: no
    supports-priv-flags: no