Troubleshooting Kernel Modules and the KMM - Troubleshooting Kernel Modules and the KMM - UG1656

Onload Operator for Kubernetes User Guide (UG1656)

Document ID
UG1656
Release Date
2024-04-26
Revision
1.0 English

Determine whether:

  • The Module CR (named *-module) Onload components have not been auto-generated due to:
    • An invalid Onload CR.
    • An Onload Operator reconciler error, which is present in its log.
  • KMM Operator is not a compatible version or is not operating due to invalid values in the Onload CR which is passed through to KMM, such as:
    • spec.onload.kernelMapping.regexp which does not compile or does not match the' kernel versions of any nodes.
    • spec.onload.kernelMapping.kernelModuleImage is not fully configured, for example:
      • It is missing the literal ${KERNEL_FULL_VERSION} KMM template variable due to being inadvertently pre-rendered by other configuration management.
      • It is referring to a registry that is not configured or operational.
    • The in-cluster build of the KMM is failing because of either of the following:
      • spec.onload.kernelMapping.build.buildArgs.ONLOAD_SOURCE is missing or mismatched to onload-user image.
      • ONLOAD_BUILD_PARAMS is invalid or also mismatched to the build of Onload in onload-user image.