Upgrading Docker gateways
The steps to upgrade a Docker Event Gateway depend on the version of Event Endpoint Management the gateway is from.
Upgrading Docker gateways from 11.4.2 or earlier
The following steps apply to all gateways from Event Endpoint Management version 11.4.2 or earlier.
To upgrade a Docker Event Gateway, delete the existing Docker gateway and replace it with one that uses the Docker image of your target Event Gateway version.
-
Prepare the Docker
run
command for your upgraded gateway. For example:docker run \ -e backendURL="<manager endpoint>" \ -e swid="EA/CP4I" \ -e KAFKA_ADVERTISED_LISTENER="<gateway endpoint>" \ -e BACKEND_CA_CERTIFICATES="-----BEGIN CERTIFICATE-----\nMIID..." \ -e GATEWAY_PORT=8443 \ -p 8443:8443 \ -e LICENSE_ID="<new license ID>" \ -e ACCEPT_LICENSE="true" \ -d icr.io/cpopen/ibm-eventendpointmanagement/egw:11.6.1
Set the properties as follows:
backendURL
Set to the value that you used for theEEM_BACKEND_URL
property when you installed your gateway.KAFKA_ADVERTISED_LISTENER
Set to the value that you used when you installed your gateway.BACKEND_CA_CERTIFICATES
Set to the value that you used forPATH_TO_CERTIFICATES
property when you installed your gateway.LICENSE_ID
If a new license ID is required for the target version, then set this here. Otherwise, use the existing license ID.
If you made other configuration changes to your Docker gateway, ensure that your Docker command includes those changes.
- Uninstall the previous gateway as described in uninstalling a Docker Event Gateway.
- Run the Docker command that you prepared in step 1.
Upgrading Docker gateways from 11.5.0 or later
These steps apply to all gateways from Event Endpoint Management version 11.5.0 or later. If your gateway was originally deployed from an earlier version, see the steps for upgrading gateways from 11.4.2 or earlier.
To upgrade a Docker Event Gateway, delete the existing Docker gateway and replace it with one that uses the Docker image of your target Event Endpoint Management version.
-
Edit your backup of the Docker
run
command that you generated when you installed the gateway, and update the following properties:a. The image reference. Set the image reference to your target version. For example:
-d icr.io/cpopen/ibm-eventendpointmanagement/egw:11.6.1
b. If the new version requires an updated licence ID, then update
LICENCE_ID
.c. If you made additional configuration changes to your Docker gateway since installation, then ensure that your Docker command includes those changes.
- Uninstall the previous gateway as described in uninstalling a Docker Event Gateway.
- Run the Docker command that you prepared in step 1.
Upgrading Kubernetes Deployment gateways
To upgrade a Kubernetes Deployment Event Gateway, edit the Kubernetes Deployment and update the following properties:
-
The Docker image name that is specified in
spec.template.spec.containers.egw.image
. Set the image name to the target Event Endpoint Management version. For example:icr.io/cpopen/ibm-eventendpointmanagement/egw:11.6.1
-
If the target version requires a new license ID, update
spec.template.spec.containers.egw.LICENSE_ID
.
The gateway pod restarts when the image name is updated.