Patching a Tarball Installation

Onload User Guide (UG1586)

Document ID
Release Date
1.2 English

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.