Patching a Tarball Installation

This section describes how a patch should be applied when Onload was installed from a tarball. It uses OpenOnload as an example, but the same procedures apply to any other Onload distributions in this format.

1. Copy the patch to a directory on the server where Onload is already installed.
2. Go to the Onload directory:

   # cd onload-<version>

3. Apply the patch. For example:

   # patch -p1 < ~/<path>/<name of patch file>.patch

4. Uninstall the old Onload drivers:

   # onload_uninstall

5. Build and re-install the Onload drivers:

   # ./scripts/onload_install

6. Load the network and Onload kernel drivers:
   • If you are using the sfc network driver (for 8000 series or X2 series adapters), just use the onload_tool command:

     # onload_tool reload

     This replaces any previously loaded sfc network driver with the sfc driver from the Onload distribution.

   • Otherwise you must reload the network driver yourself, and also the auxiliary driver. For example if you are using the xilinx_efct driver with an X3 series adapter:

     # modprobe -r xilinx_efct
     # modprobe -r auxiliary
     # modprobe auxiliary
     # modprobe xilinx_efct
     # onload_tool reload --onload-only

7. Confirm success:

   # onload
   OpenOnload <version>
   Copyright 2019-2022 Xilinx, 2006-2019 Solarflare Communications, 2002-2005 Level 5 Networks
   Built: <date> <time> (release)
   Kernel module: <version>

   If a Kernel module version is shown, this confirms that the Onload kernel module is installed and loaded.