Loading a Configuration File - UG1739

To load a configuration file, use the standard Linux devlink command:

• The sfc net driver must be loaded.
• You must be logged in as root.
• Pathnames you give are relative to the /usr/lib/firmware directory.

To load a configuration file with devlink:

1. List the AMD Solarflare PCIe devices:

   # lspci -D -d 1924:
   0000:01:00.0 Ethernet controller: AMD Solarflare Device 0c03
   0000:01:00.1 Ethernet controller: AMD Solarflare Device 0c03

2. Note the PCIe address of the first interface on the X4 series adapter that you want to update.

   In the above example, the address of the first interface is 0000:01:00.0.

   Note: The PCIe address includes the domain (0000) before the bus, device, and function (01:00.0).
3. Load the configuration file to the PCIe address that you noted in step 2:

   # devlink dev flash pci/<domain>:<bus>:<device>.<function> \
             file amdsolarflare/config-examples/<adapter>/<firmware>/<config>.ini

   For example:

   # devlink dev flash pci/0000:01:00.0 \
             file amdsolarflare/config-examples/x4522/auto/cfg_auto.ini

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

4. Wait for the current firmware to finish the update, viewing the progress report from devlink:

   # devlink dev flash pci/0000:01:00.0 \
             file amdsolarflare/config-examples/x4522/auto/cfg_auto.ini
   Checking update
   Starting update
   Erasing 100%
   Writing 100%
   Finishing update
   Update complete

   Note: Older versions of devlink might not output a progress report.
   Note: If you press Ctrl-C it halts devlink 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 devlink dev flash 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.
   • 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.