To upgrade to a new Event Gateway version, choose one of the following paths:
- Upgrade both the control plane and data planes: Recommended. This gives you access to all new features.
- Upgrade only the data planes: This allows you to take advantage of data plane improvements but doesn’t let you access any new configurations.
Prerequisites
- Review Event Gateway release notes
- Review Event Gateway breaking changes
1. Upgrade data planes
- In the Konnect sidebar, navigate to Event Gateway.
- Click a control plane.
- In the Event Gateway sidebar, click Data Plane Nodes.
-
Provision a data plane node running the new version.
Confirm the new node appears in the list, shows a Connected status, and was last seen Just Now.
- Repeat for each node you need to replace.
-
When the new nodes are connected and functioning, disconnect and shut down the old nodes.
You can’t shut down data plane nodes from the Konnect UI. Old nodes will also remain listed as
Connectedfor a few hours after they have been removed or shut down. -
Verify traffic flows through the new node by accessing a virtual cluster configured on the control plane.
For example:
kafkactl -C kafkactl.yaml --context my-vc list topicsCopied!
2. Upgrade control plane
- In the Konnect sidebar, navigate to Event Gateway.
- Click the control plane you want to upgrade.
- From the Actions dropdown menu, select Edit Event Gateway.
-
Set Minimum supported data plane version to the version you want to use.
This change cannot be reverted manually. Confirm you want to upgrade before saving.
- Click Save.
At this point, you will have access to all of the new features on the control plane. Your data planes will behave as follows:
- Any data planes running the new version or above will receive new control plane configurations.
- Any remaining data planes below the new minimum control plane version will continue to appear as
Connectedbut will no longer receive configuration and will show an incompatibility warning.