Skip to content

On Premise

This documentation describes how to perform the version upgrade operation of an on-premise Traefik Enterprise cluster.

Backing Up the Outdated Cluster

First, follow the documentation on backing up a cluster to generate a backup archive, which will be used to configure a new cluster.

Upgrading traefikee and teectl

The teectl and traefikee tools must be upgraded before starting the cluster version upgrade: follow the installing teectl guide to install the latest version of teectl and use the on-premise install guide to get the latest version of the traefikee binary.

Run teectl version and traefikee version to ensure the correct versions are installed.

Major Version Upgrade

To upgrade a cluster to a new major version, install a new one running in parallel with the outdated cluster. Once the new cluster is reachable, the outdated cluster can be uninstalled.

In order to install a second cluster without conflicting with the existing one, it has to be installed under a different cluster name. This means all teectl commands must specify the --cluster option with the new cluster name.

Version upgrade from v1 to v2

To update a v1 cluster to v2, first make sure that the existing cluster is running at least version v1.3. Back it up and then use the cluster migration tool to transform the v1 backup into a v2 backup that can be used in the upgrade procedure.

  1. Run the same traefikee commands as you did for your previous Traefik Enterprise installation, with a different --api.addr option for the traefikee controller command.
  2. Wait for your cluster to be reachable.
  3. Redirect traffic to the new cluster. You could do this by updating the external DNS entry to point to the new load balancer service's IP, for example, or by editing your L4 load balancer configuration.
  4. Ensure that your applications are reachable through the new cluster.
  5. Interrupt all processes of the previous cluster in order to uninstall it.

The new cluster should now be operating properly, and the upgrade process should not have dropped any application traffic. The outdated cluster can safely be removed.

Minor and Hotfix Version Upgrades

To upgrade a cluster to a new minor or hotfix version, replace the nodes from your cluster one-by-one, following the installation guide for the new version, starting with the controllers. Once all the nodes have been replaced, update your teectl version as well and verify that it is able to communicate with the cluster.