Upgrade a Data Plane Node to a New Version
You can upgrade data plane nodes to a new Kong Gateway version by bringing
up new data plane nodes, and then shutting down the old ones. This is the best
method for high availability, as the new node starts processing data before the
old node is removed. It is the cleanest and safest way to upgrade with no
We recommend running one major version (2.x or 3.x) of a data plane node per control plane, unless you are in the middle of version upgrades to the data plane. Mixing versions may cause compatibility issues.
Read through the Kong Gateway upgrade considerations for the version that you’re upgrading to.
Upgrade a data plane node
To upgrade a data plane node to a new version, follow these steps:
Open Gateway Manager, choose a control plane,
and provision a new data plane node through the Gateway Manager.
Make sure that your new data plane node appears in the list of nodes,
displays a Connected status, and that it was last seen Just Now.
Once the new data plane node is connected and functioning, disconnect
and shut down the nodes you are replacing.
You can’t shut down data plane nodes from within Gateway Manager. Old
nodes will also remain listed as
Connected in Gateway Manager for a
few hours after they have been removed or shut down.
Test passing data through your new data plane node by accessing your proxy
For example, with the hostname
localhost and the route path