Upgrading Docker gateways

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 Gateway version.

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

    If the upgrade requires a new license, set this in <new license ID>.

    Set the properties as follows:

    • backendURL Set to the value that you used for the EEM_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 for PATH_TO_CERTIFICATES property when you installed your gateway.

    If you made additional configuration changes to your Docker gateway, 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.