Troubleshooting and Messages


Use the following information to troubleshoot issues that are reported in messages.

Pre-Installation Messages

The following messages are issued before installation or upgrade of the Helm chart, if requirements are not met. If you receive any of these messages, the installation or upgrade is aborted, and you must resolve the issues and then retry to install or upgrade.

Install|Upgrade "<release-name>" failed: pre-install|pre-upgrade hooks failed: 1 error occurred: * job <release-name>-checkreq-helm-img failed: PodFailurePolicy

Explanation: Verification of whether the Agent image version matches the Helm chart version ended in status failed. Installation or upgrade is aborted.

Corrective Action: Do the following:

  1. Check the job's pod logs for specific validation failures, using the following command:
    kubectl logs -n <namespace> <release-name>-checkreq-helm-img
    Look for the following message:

    Information

    Validation failed: Control-M for Kubernetes Image version (<IMAGE_VERSION>) does not match the Helm chart version (<CHART_VERSION>). Align the versions to proceed with installation or upgrade.

  2. Ensure that the Agent image version matches the Helm chart version, and try again.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Control-M