Upgrading Event Gateways

Upgrading operator-managed gateways

If you have operator-managed gateways, their upgrade is done by the Event Endpoint Management operator when you upgrade the Event Manager. Verify that your gateway instances upgraded successfully by following these steps:

  1. Log in to the Event Endpoint Management UI by using your login credentials.
  2. Click Administration > Event Gateways.

After you verify the upgrade, update your gateways to support multi-topic subscriptions as described in configuring gateways for applications.

Upgrading Docker gateways

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.

  1. 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.8.0
    

    b. If you made additional configuration changes to your Docker gateway since installation, then ensure that your Docker command includes those changes.

  2. Uninstall the previous gateway as described in uninstalling a Docker Event Gateway.
  3. Run the Docker command that you prepared in step 1.
  4. Update your gateway to support multi-topic subscriptions as described in configuring gateways for applications.

Upgrading Kubernetes Deployment gateways

To upgrade a Kubernetes Deployment Event Gateway, edit the Kubernetes Deployment and update 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.8.0

The gateway pod restarts when the image name is updated.

After the upgrade is complete, update your gateways to support mutli-topic subscriptions as described in configuring gateways for applications.