Loading a Configuration File with amdsfboot - Loading a Configuration File with amdsfboot - UG1739

AMD Solarflare X4 Series Ethernet Adapter User Guide (UG1739)

Document ID
UG1739
Release Date
2026-07-01
Revision
1.2 English

To load a configuration file onto X4 series Ethernet adapters with amdsfboot:

  1. To reconfigure all X4 series Ethernet adapters on the host, use the following command:
    $ amdsfboot --sudo \
    --config amdsolarflare/config-examples/<adapter>/<firmware>/<config>.ini

    For example:

    $ amdsfboot --sudo \
    --config amdsolarflare/config-examples/x4522/auto/cfg_auto.ini
    Note: You can instead reconfigure a specific X4 series Ethernet adapter on the host. To do so, add the --adapter option to the command:
    $ amdsfboot --sudo --adapter <interface> \
    --config amdsolarflare/config-examples/<adapter>/<firmware>/<config>.ini

    The amdsfboot utility uses devlink to hand the filename to the driver, and the driver then calls the current firmware to perform the update.

  2. Wait for the current firmware to finish the update, viewing the progress report from amdsfboot. For example:
    $ amdsfboot --sudo \
    --config amdsolarflare/config-examples/x4522/auto/cfg_auto.ini
    AMD Solarflare configuration utility: v<n>.<n>.<n>
    
    enp1s0f0: writing new config
    Checking update
    Starting update
    Erasing 100%
    Writing 100%
    Finishing update
    Update complete
    Stored configuration for enp1s0f0:
     [global]
     cxl = false
     port_mode = [1x1/10/25/40/50/100G][1x1/10/25/40/50/100G]
     firmware_variant = auto
     vf_count = 0
     msix_limit = 2048
     vf_msix_limit = 1
     vi_count = 8192
     rx_dc_size = 64
     tx_dc_size = 16
     rx_event_merge_timeout = 1500
     rx_event_merge_max_events = 15
     tx_event_merge_timeout = 1400
     tx_event_merge_qempty_timeout = 700
     tx_event_merge_max_events = 15
     
     [derived]
     ;pf_count = 2
    
    
    enp1s0f1: skipping, configuration shared with enp1s0f0
    Power cycle the system to apply configuration changes
    Note: Some of the above output might be omitted if you are using an older version of the underlying devlink command.
    Note: If you press Ctrl-C it halts amdsfboot and its progress reports, but the current firmware continues to apply the update.
    Note: If the update fails, refer to the kernel message log for details. The error messages from the underlying devlink command are generic and can be misleading.
  3. 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.
    • Physically disconnect the server from all power sources for at least 10 seconds.

Now confirm that the reconfiguration succeeded by checking that the configuration of the X4 series Ethernet adapter is as expected.