Upgrade to Jessie

From Roaring Penguin
Jump to: navigation, search

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

This upgrade should only be performed if you installed from, or already run the Upgrade to Wheezy (Debian 7).

Upgrade Debian Wheezy to Jessie

  1. Make sure your existing CanIt installation is up-to-date:
    upgrade-canit-appliance
  2. Now upgrade the OS to Jessie:
    upgrade-canit-appliance jessie
    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 now seen or heard of multiple cases where the Jessie upgrade causes the CanIt packages to get uninstalled. If this happens you will be able to recover by reinstalling the appropriate 'distro' package for your version. This would require either:
    apt-get install canit-domain-pro-distro
    or
    apt-get install canit-pro-distro
    This should re-install all of the necessary dependencies. When prompted, select the "Package Maintainer's version" of Apache2 and PHP. When finished, run:
    canit-prepare-system
  4. Another problem that seems to be universal is that the Grub bootloader will not be written to the boot sector of the hard drive and so the machine would not know how to load after reboot. This is remedied by generating it again for all hard drives with:
    dpkg-reconfigure grub-pc
    You can just press enter to accept the first field requested as being blank and the second as 'quiet'. For the disk selection use the spacebar and arrow keys to select all available devices, then press enter. 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.
  5. At this point the new version of CanIt is running, but Debian is not yet using it's new kernel. This requires a reboot:
    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:
    --download-only
    eg:
    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.

Upgrade to Stretch

Jessie is now the old-stable version of Debian. There is another wiki discussing the Upgrade to Stretch, which is the current stable release. The upgrade to Jessie MUST be done before you can upgrade to Stretch!

Jessie will still receive security updates from Debian for several years (probably 2020 or 2021, but this has yet to be announced) and will get new CanIt packages for years after that. You are under no immediate need to upgrade at this time, however running the newest stable software is always recommended, so it would be wise to upgrade when it is convenient.