Upgrade to Stretch

From Roaring Penguin
Revision as of 15:50, 22 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. We have had troubles with some appliances failing to install the Grub bootloader after the Jessie upgrade, so be sure to generate it again for all hard drives:
    dpkg-reconfigure grub-pc
    Should Grub fail to be installed, the system will not be able to load after a reboot. The only way to recover is to configure Grub with a rescue disk.
  4. At this point the new version of CanIt is running, but Debian is not yet using it's new kernel. This requires a reboot:

To check if mail is flowing use the following:

tail -f /var/log/mail-daily/current.log

or wherever the logs are stored (/var/log/mail.log if the log-indexer is not installed).

NOTE: The above commands are for a single machine. If you are upgrading a cluster, then you should run each on all machines before moving onto the next step, starting with the DataBase machine. Also modify the steps as follows:

For steps 1:

  1. First download the packages before installing them to minimize downtime by running the command with the following flag after it:
    upgrade-canit-appliance --download-only
  2. Stop CanIt on all cluster members:
    /etc/init.d/canit-system stop-gracefully
  3. Run the actual command listed for that step above.
  4. After the command above, run:
    /etc/init.d/canit-system start

Repeat for step 2.

Then run steps 3 and 4.

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!