Update guide

I have a Toucan Toco stack installed. How do I update it?

Upgrade the Toucan app

Toucan Toco release every week a new version of the Toucan Toco backend and frontend. The packages are automatically available on get-package.toucantoco.com when they are ready.

Note

You may prefer to use the monthly packages (once a month, a more battle-tested release is published)

About Toucan Toco versions

Please note each brick of the Toucan Toco stack (backend and frontend) has its own version.

To be compatible, the major version number should be the same, for example:

  • Backend in v26.0.2 and Frontend in v26.0.7 are compatible, as they are both v26
  • Backend in v25.2.10 and Frontend in v25.1.5 are compatible, as they are both v25
  • Backend in v25.2.11 and Frontend in v26.0.7 are not compatible, as one is v25 and the other is v26

Upgrade the Front-End

As the Toucan Toco front-end package is just a bunch of static files, the upgrade procedure only consists in downloading the latest package, and replacing the old files.

Upgrade the Back-End: using docker

Just download the latest docker image and use it instead of the previous one.

Warning

Review the “Breaking changes” section (below) carefully.

Upgrade the Back-End: using the ansible package

To upgrade Toucan Toco’s backend, simply re-run the Ansible playbooks. Ansible will handle any new configurations by itself and only execute what is needed.

The usual workflow to update the Toucan Toco backend is as following:

  • Download the latest version of the backend
  • Re-use your installation configuration file (cf: laputa/shipping/group_vars/production)
  • Review the installation documentation and the “Breaking changes” section (below) carefully, this will ensure you do not miss new configuration parameters
  • Relaunch the installation command make fulldeploy stage=production
  • That’s all

Please note, there will be a tiny downtime during the restart of the Toucan Toco backend.

Breaking changes

v56.1.0 Chou Bruxellensis

Warning

The MongoDB backend migrates from 3.6 to 4.0

I manage my own MongoDB

Please refer to the official documentation to upgrade your backend.

I don’t manage my own MongoDB

If you use the Toucan Toco shipping script to manage the MongoDB installation and configuration (when "mongo_flag: enable"), everything will be upgraded auto-magically.

Warning

Please ensure that your current version is strictly superior to 44.4.0. otherwise, upgrade first to the 44.4.0 version

v44.4.0 Helpless Supernova

Warning

The MongoDB backend migrates from 3.4 to 3.6

I manage my own MongoDB

Please refer to the official documentation to upgrade your backend.

I don’t manage my own MongoDB

If you use the Toucan Toco shipping script to manage the MongoDB installation and configuration (when "mongo_flag: enable"), everything will be upgraded auto-magically.