Upgrading operator-managed Event Gateways on other Kubernetes platforms

Edit online

On other Kubernetes platforms, update the Helm repository and then upgrade the Event Endpoint Management operator by using the Helm chart.

Pre-upgrade checks and preparation

Complete the following steps to prepare for upgrade on other Kubernetes platforms.

Identify the name, namespace, and chart of your Event Endpoint Management operator:

Log in to your Kubernetes cluster as a cluster administrator by setting your kubectl context.
Run the following command:
```
helm list --all-namespaces
```
If you have several Helm releases installed, you can filter for eem, for example:
```
helm list --all-namespaces | grep eem
```

Take note of the NAME, NAMESPACE, and CHART values for ibm-eem-operator and ibm-eem-operator-crd:

NAME     NAMESPACE	REVISION	UPDATED                                	STATUS  	CHART                                   	APP VERSION     
eem-crd  eemns   	1       	2025-08-29 02:10:55.343886423 -0800 PST	deployed	ibm-eem-operator-crd-11.7.3             	26955880-704cca1
eem-op   eemns  	1         	2025-08-29 02:11:08.814270035 -0800 PST	deployed	ibm-eem-operator-11.7.3                 	26955880-704cca1

Check the latest chart version that you can upgrade to:
1. Update the Helm repository:
```
helm repo update ibm-helm
```
2. Confirm the version of the chart that you are upgrading to:
```
helm show chart ibm-helm/ibm-eem-operator
```
  Check the version: value in the output, for example: version: 11.8.0

Upgrading by using Helm

You can upgrade your Event Endpoint Management operator and Event Gateway on other Kubernetes platforms by using Helm.

Upgrade the Helm release that manages your Event Endpoint Management Custom Resource Definitions (CRDs):
```
helm -n <EEM CRD namespace> upgrade <EEM CRD name> ibm-helm/ibm-eem-operator-crd
```
Replace <EEM CRD namespace> and <EEM CRD name> with the NAMESPACE and NAME values that you identified in the Pre-upgrade checks and preparation.
Upgrade the Helm release of your operator installation.
```
helm -n <EEM operator namespace> upgrade <EEM operator name> ibm-helm/ibm-eem-operator 
```
Replace <EEM operator namespace> and <EEM operator name> with the NAMESPACE and NAME values that you identified in the Pre-upgrade checks and preparation.
If you are upgrading from 11.6.x, then update the spec.license.license field in the custom resources of your Event Gateway instances to the license ID for 11.7.0 and later. The instances will not upgrade until the license ID is updated.
1. Retrieve the names of your Event Gateway instances:
```
kubectl -n <namespace> get eventgateways.events.ibm.com
```
2. For each instance, update the license:
```
kubectl -n <namespace> patch eventgateways.events.ibm.com <gateway instance name> --patch '{"spec":{"license":{"license":"<license ID>"}}}' --type=merge
```
Verify that your upgrade completed:
```
helm list -n <namespace>
```
Confirm that the CHART column shows your target version for your Event Endpoint Management CRDs and operator.
Verify the version of your Event Gateway:
```
kubectl -n <namespace> get eventgateways.events.ibm.com
```
Review the output and confirm that status.phase=Running and status.versions.reconciled=<target version>.