Upgrade to Stretch

From Roaring Penguin
Revision as of 14:03, 12 September 2017 by JohnMertz (talk | contribs)

Jump to: navigation, search


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 at Debian Upgrades.

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


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:
  2. Now upgrade the OS to Stretch:
    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:
    To check if mail is flowing use the following:
    tail -f /var/log/mail-daily/current.log or wherever they are to see if mail is flowing

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).

Database Upgrade Considerations

CanIt will continue to work fine with the old version of the PostgreSQL database, however a newer version is available in the Stretch repositories which offers performance improvements. We would encourage you to upgrade when you have available downtime.

The instructions from Database Update 9.0 article are correct for this upgrade as well, except that the new version is 9.6. Your existing version may vary anywhere from 9.0 to 9.4 depending on upgrade history. You can find your current version either by looking for the highest (probably only) directory listed with:

 ls /etc/postgresql/

or by looking for the version that is currently listed as installed (ii) by the Debian package manager:

 dpkg -l |grep postgres
 ii  postgresql-9.X   ...

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!