Updating Tonic

Tonic allows Admin users of self-hosted Kubernetes and Docker deployments to update to the newest version of Tonic.
Kubernetes setup
Before you update Tonic, we suggest that you do the following:
Have a system to regularly back up your Tonic PostgreSQL application database.
Source the latest version of Tonic from Quay as indicated in the sample yaml file and as instructed in Deploying with Helm. 

If you modify the helm charts to re-host Tonic images from quay.io to your own image repository, then before you run the in-application update, load the latest Tonic version images into your repository.

To view the current latest release version, see Release notes.
Update your helm charts to use the latest tag.

If you manage your helm charts in a repository that has a pinned version tag, then when you redeploy from your helm charts, Tonic reverts to the pinned version tag.
Ensure that your values.yaml file contains the following values. The examples below are also in the sample yaml file:

tonicai.web_server.features.host_integration_enabled: "true"  
tonicai.web_server.features.kubernetes_role: "default" 
tonicai.web_server.administrators: [admin_email]@company.com 
Docker setup
Before you update Tonic, we suggest that you do the following:
Have a system to regularly back up your Tonic PostgreSQL application database.
Source the latest version of Tonic from Quay as indicated in the sample Docker Compose repo and as instructed in Deploying with Docker Compose.

If you modify the helm charts to re-host Tonic images from quay.io to your own image repository, then before you run the in-application update, load the latest Tonic version images into your repository.

To view the current latest release version, see Release notes.
Update your docker-compose.yaml to use the latest tag. 
Uncomment the tonic_docker_acl section of docker-compose.yaml​
Uncomment the one-click update section of your environment file. In that section, fill in DOCKER_REPO_USERNAME and DOCKER_REPO_PASSWORD.
In the worker section of the environment file, add the following variables:
Set TONIC_HOST_INTEGRATION=DockerCompose
Set TONIC_HOST_INTEGRATION_ACL=https://tonic_docker_acl
Read through the One-Click Update and Host Integration section of the readme.
Completing the update
Before you launch an update:
Verify that there is enough system space for a second instance of the Tonic application.

While the new instance starts, the original instance is still live.

Once the new instance is running, the original is removed and the resources are freed up.
Check the release notes for any updates that might impact your configuration.
The option to update Tonic is on the System Status tab of the Admin Panel. Admin Panel is only available to admin users.
To display the Admin Panel, click the Tonic actions menu at the top right of the Tonic application, then select Admin Panel.
​
​
On the System Status tab, if you can update Tonic, a blue Update to Tonic <version> button displays. The button is only available if Tonic is not on the most recent version.
You cannot start the update until no Tonic jobs are running or are queued to run.
After you start the update, do not start other jobs until the update is complete.
You are given an estimated down time when you start the update, but the update typically takes less than ten minutes.
Any jobs that start during update process are silently terminated. This could leave your destination database in an unexpected state. If this happens, rerun the jobs.

Administering Tonic - Previous

Managing Tonic performance

Next - Using the Tonic API

API documentation

Last modified 21d ago

Copy link

Outline

Kubernetes setup

Docker setup

Completing the update