Program with ethtool - UG1523

Alveo X3522 User Guide (UG1523)

Document ID
UG1523
Release Date
2024-10-18
Revision
1.5 English

To apply a .update file with ethtool:

  1. Get the current bundle version for the first interface on the X3522:
    # cat /sys/class/net/enp1s0f0np0/device/versions
  2. Note the bundle version that is output.
  3. 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.

  4. 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.
  5. Do a cold reboot of the server using one of the following methods:
    • Use a tool such as iDRAC/BMC to issue a cold reboot or power cycle command.
      CAUTION:
      When using this method of cold reboot:
      • If you are updating from a bundle version that is less than 1.25.101.3090 (see step 2), you must repeat the entire update a second time for it to complete successfully.

        (Because the auxiliary power remains enabled, the first update is only partial, and puts the X3522 in an unpredictable or failed state. A second update is required to complete the process.)

      • If you are updating from bundle version 1.25.101.3090 or later this limitation does not apply, and a single update is sufficient.

    • Physically disconnect the server from all power sources for at least 10 seconds.
      Note: When using this method of cold reboot, a single update is sufficient for all bundle versions.
  6. 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