Upgrade

Before upgrading Obcerv components, you must ensure you have the latest helm charts and docker images. If you have chosen to maintain your own docker repository you must first ensure it is up to date with the ITRS repository, to do this follow the steps in Docker images.

When a new version of Obcerv is released, a new version of the Operator typically comes with it. The Operator must be upgraded first before upgrading any Obcerv instances in the cluster.

Before upgrading Obcerv, carefully review the release notes for important information about changes, enhancements, bug fixes, and known issues that may impact the upgrade process or software functionality.

  1. Update the Helm repository to get the new charts:

    helm repo update itrs
    
  2. Upgrade the operator:

    helm upgrade obcerv-operator itrs/obcerv-operator -n <namespace> --version 2.2.0 --wait
    
  3. Upgrade an Obcerv instance using the same configuration file used during installation:

    helm upgrade -f config.yaml <instance> itrs/obcerv -n <namespace> --version 2.2.0
    

    The Operator will stop, upgrade, and restart the workloads in the correct order. To monitor the progress, run:

    kubectl describe obcerv <instance> -n <namespace>
    

While the upgrade is in progress, the Obcerv status shows as DEPLOYING. Once completed, the status is set to DEPLOYED.

Note

You cannot downgrade an instance that has already been upgraded.

Note

When reinstalling the Obcerv Platform after a restore, you need to supply the exact same configuration values used in the restored snapshot. After modifying the configuration of the installed Platform, it is recommended to create a new snapshot and store a copy of the configuration.
["Obcerv"] ["User Guide", "Technical Reference"]

Was this topic helpful?