Getting Sample Configuration Files - UG1739

AMD Solarflare X4 Series Ethernet Adapter User Guide (UG1739)
Document ID
UG1739
Release Date
2025-10-24
Revision
1.0 English

The sample configuration files are supplied in an RPM or DEB package that includes the following:

  • Sample configuration files for each available X4 series adapter.
  • A firmware bundle for each available X4 series adapter, that is compatible with the sample configuration files.
  • A filesystem bootloader for use on all X4 series adapters

The package installs the files beneath the /usr/lib/firmware directory. This is the conventional Linux location for storing such files.

To get the package and install it on your host ready for use, do the following:

  1. Download one of the following packages from the product website (see Product Website) to the /tmp directory on the host for the X4 series adapter:
    • XN-203124-LS AMD Solarflare X4 Firmware RPM, recommended for Fedora-based Linux such as RHEL.
    • XN-203125-LS AMD Solarflare X4 Firmware DEB, recommended for Debian-based Linux such as Ubuntu.
  2. Change directory to /tmp:
    cd /tmp
  3. Install the sample configuration files from the package:
    • For an RPM package:
      rpm -ivh ./<package_name>.rpm
    • For a DEB package:
      apt install ./<package_name>.deb

The sample configuration files are now installed in the /usr/lib/firmware/amdsolarflare/config-examples directory ready for loading onto the adapter. The following table describes them:

Sample Configuration File Description
cfg_default.ini Reset to firmware defaults
sample_template.ini Sample template with description for each field
x4522/auto/cfg_auto.ini Auto firmware variant with 1 port per SFP cage (X4522)
x4522/full_featured/cfg_ff.ini Full featured firmware variant with 1 port per SFP cage (X4522)
x4522/full_featured/cfg_ff_throughput.ini Full featured firmware variant with 1 port per SFP cage that is optimized for throughput (X4522)
x4522/low_latency/cfg_ll.ini Low latency firmware variant with 1 port per SFP cage (X4522)
x4542/auto/cfg_2port_auto.ini Auto firmware variant with 1 port per QSFP cage (X4542)
x4542/auto/cfg_4port_auto.ini Auto firmware variant with 4 ports on QSFP cage 0, and QSFP cage 1 administratively shutdown (X4542)
x4542/full_featured/cfg_2port_ff.ini Full featured firmware variant with 1 port per QSFP cage (X4542)
x4542/full_featured/cfg_2port_ff_throughput.ini Full featured firmware variant with 1 port per QSFP cage that is optimized for throughput (X4542)
x4542/full_featured/cfg_4port_ff.ini Full featured firmware variant with 4 ports on QSFP cage 0, and QSFP cage 1 administratively shutdown (X4542)
x4542/low_latency/cfg_2port_ll.ini Low latency firmware variant with 1 port per QSFP cage (X4542)
x4542/low_latency/cfg_4port_ll.ini Low latency firmware variant with 4 ports on QSFP cage 0, and QSFP cage 1 administratively shutdown (X4542)