Upgrading Deployed Agents

This procedure describes how to upgrade the Helix Control-M/Agents that you deployed when you set up the previous version of Control-M for Kubernetes.

If you have multiple Agent deployed (as recommended), the deployed Agents are updated one by one without downtime.

Begin

  1. Update the controlm repository that contains the Helm charts obtained from the Control-M Repository by running the following command:
    helm repo update controlm 

    Note

    Alternatively, if you use your own local repository, obtain the updated Helm chart from https://controlm-charts.s3.us-west-2.amazonaws.com/helix-controlm-agent-9.21.205.tgz.

  2. Run the helm list command and identify the release that is currently running.

  3. Run the helm upgrade command to upgrade to the newest Agent version, as in the following example:
    helm upgrade <releaseName> controlm/helix-controlm-agent --version 9.21.205 --set image.tag=9.21.205-k8s-openjdk <all other parameters from the original installation>

    where <releaseName> is the name of the release that is currently running, as determined in the previous step.

    Example:

    helm upgrade <releaseName> controlm/helix-controlm-agent --version 9.21.205 --set image.tag=9.21.205-k8s-openjdk  \
    --set server.name=IN01 --set api.endpoint=https://controlm-tenant-aapi.us2.controlm.com/automation-api \
    --set api.token=b25QcmVuOjc0Z6E4MGWyLTQ2ZjYtNDFkYS06NWQzLWNiNTQ4ZjIwODMzWg== \
    --set agent.tag=Admin --set pvc.storageClass=efs-sc

    Note

    Alternatively, you can use the --reuse-values switch to reuse the values from the previous release, instead of including all other parameters that you used in your original installation, as in the following example:
    helm upgrade <releaseName> controlm/helix-controlm-agent --version 9.21.205 --set image.tag=9.21.205-k8s-openjdk --reuse-values

    The upgrade is performed in the background. This might take several minutes.

  4. Monitor the status of the rollout by running the following command:
    kubectl rollout status statefulset/<releaseName>-sts

Note

If you need to roll back the upgrade, do the following:

  1. Use the helm history command to check which revision of the Helm chart you want to roll back to, as in the following example:
    helm history helix-controlm-agent
  2. Run the helm rollback command, with the following syntax:
    helm rollback <releaseName> [revisionNumber]

 

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