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.


Upgrading to version 1.3.2 is mandatory for those using previous versions of the Obcerv Platform. Depending on your configuration, the upgrade process may take some time to complete.
  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 1.4.2 --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 1.3.2

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

    kubectl describe obcerv <instance> -n <namespace>


During the upgrade process, please note that:

  • The helm chart will run a job prior to the upgrade, which will bring down the Final Entity Stream (FES).

  • If you encounter an Operator error (such as having an invalid config) and stop the process without successfully upgrading, you need to scale back the FES manually by running:

    kubectl -n <namespace> scale deployment final-entity-stream --replicas=1 

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


You cannot downgrade an instance that has already been upgraded.
["Obcerv"] ["User Guide", "Technical Reference"]

Was this topic helpful?