Revision as of 15:15, 15 August 2017

Note

Debian upgrades must be performed one version change at a time. If you don't know which version you are on, or which version is next, you can find information on the entire upgrade path here.

This upgrade should only be performed if you are already running Jessie (8).

Experimental

Running CanIt on Debian Stretch seems to be working very well thus far despite significant changes to core packages (including PHP, PostgreSQL and other core utilities).

Both CanIt appliance ISOs and upgrades of existing Jessie installs have been tested successfully and except for a few minor issues which have been patched and pushed out, everything is working fine. That said, support for Stretch is still very new and it has not yet been widely deployed. We are still considering it to be experimental.

Upgrade Debian Jessie to Stretch

1. Make sure your existing CanIt installation is up-to-date:

   upgrade-canit-appliance

2. Now upgrade the OS to Jessie:

   upgrade-canit-appliance stretch

   Then you'll see messages scroll by, as the machine downloads, unpacks, and re-starts assorted services. (This all only delays mail during the re-start phase).
3. Grub errors which caused problems during the Wheezy to Jessie upgrade do not see to be an issue this time around, but to be safe it is best to make sure it is properly configured anyways:

   dpkg-reconfigure grub-pc

4. Reboot the machine:

   reboot

   To check if mail is flowing use the following:

   tail -f /var/log/mail-daily/current.log or wherever they are to see if working

NOTE: The above commands are for a single machine. If you are upgrading a cluster, then you should modify the steps as follows, starting with the DataBase machine:

1. Stop CanIt on all cluster members before each command:

   /etc/init.d/canit-system stop-gracefully

2. After the command in step (4) above, run:

   /etc/init.d/canit-system start

3. Also, all commands should be run in parallel. That is, run (i) and then (1) on all machines, then (i) and (2) on all machines, and so on, finishing with (ii).

Upgrade to Buster

Stretch is the current Stable release of Debian and Roaring Penguin does not support the 'Testing' release. The Testing version, Buster, should not be expected until around 2020 (Debian's release cadence tends to be approximately 3 years). Stretch will be supported for many years after Buster becomes the Stable release.

When Buster is eventually released be aware that the upgrade to Stetch MUST be done before you can upgrade to it!