Performing Maintenance on the loadbalancer Service

If there is a maintenance activity available on the loadbalancer service, you can upgrade the loadbalancer using the self-service maintenance feature. The following guide describes the steps required to upgrade and downgrade the load balancer.

Performing an Upgrade

Upgrading the loadbalancer is not designed to stop or start any other service containers.

It is recommended that you upgrade all loadbalancer services as soon as a maintenance activity is available. You can upgrade the loadbalancer service from either the cluster overview page or on the loadbalancer service details page

From the cluster overview page

1. Click the "Actions" dropdown on the cluster manager node indicating an action notification.
2. Click the "See Maintenance" option in the actions dropdown.
3. Click the "Start Now" button in the maintenance modal.
4. As the maintenance begins, you will see the manager node status as "Updating" and the worker nodes status as "Waiting for manager"
5. When the upgrade has completed, all nodes and containers will reappear in the nodes table.

From the loadbalancer service details page

1. Navigate to the cluster's services page by clicking the "Manage Docker" button in the desired cluster to perform the upgrade.
2. Click the "loadbalancer" service name link or the "View" button on the row for the loadbalanacer service.
3. In the service details page, click "Upgrade to Traefik 2.10"
4. Confirm the upgrade action in the modal by clicking the "Upgrade" button.
5. You will return to the services page and a toast notification will indicate that the load balancer is being upgraded.
6. When the upgrade has completed, you will be able to navigate to the new loadbalancer's service details page.

Performing a Downgrade

The option to downgrade the loadbalancer is only available for a limited time after performing the maintenance activity to upgrade the service.

If you require downgrading the loadbalancer service and it is not available to do so in MedStack Control, please contact our support team.

1. Navigate to the cluster's services page by clicking the "Manage Docker" button in the desired cluster to perform the upgrade.
2. Click the "loadbalancer" service name link or the "View" button on the row for the loadbalanacer service.
3. In the service details page, click "Downgrade to Traefik 1.7"
4. Confirm the downgrade action in the modal by clicking the "Downgrade" button.
5. You will return to the services page and a toast notification will indicate that the load balancer is being downgraded.
6. When the downgrade has completed, you will be able to navigate to the new loadbalancer's service details page.

After completing the upgrade

Once the upgrade has been completed and the application handles client traffic as accepted, you can remove the "acme" Docker volume which contains certificates used by the previous version of the load balancer.

The Traefik 2 load balancer stores certificates in the newly created "acme_2" Docker volume.