Difference between revisions of "Upgrade to Stretch"

From Roaring Penguin
Jump to: navigation, search
(Upgrade to Buster)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
===Note===
 
===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 [https://www.roaringpenguin.com/wiki/index.php/Debian_Upgrades here].
+
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).
 
 
 
=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==
 
== Upgrade Debian Jessie to Stretch==
 
 
<ol>
 
<ol>
 
<li>Make sure your existing CanIt installation is up-to-date:
 
<li>Make sure your existing CanIt installation is up-to-date:
 
:<tt>upgrade-canit-appliance</tt>
 
:<tt>upgrade-canit-appliance</tt>
<li>Now upgrade the OS to Jessie:
+
<li>Now upgrade the OS to Stretch:
 
:<tt>upgrade-canit-appliance stretch</tt>
 
:<tt>upgrade-canit-appliance stretch</tt>
 
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).
 
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).
<li>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:
+
<li>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:
 
:<tt>dpkg-reconfigure grub-pc</tt>
 
:<tt>dpkg-reconfigure grub-pc</tt>
<li>Reboot the machine:
+
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.
 +
<li>At this point the new version of CanIt is running, but Debian is not yet using it's new kernel. This requires a reboot:
 
:<tt>reboot</tt>
 
:<tt>reboot</tt>
 +
</ol>
 
To check if mail is flowing use the following:
 
To check if mail is flowing use the following:
:<tt>tail -f /var/log/mail-daily/current.log or wherever they are to see if working</tt>
+
:<tt>tail -f /var/log/mail-daily/current.log</tt>
</ol>
+
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 modify the steps as follows, starting with the DataBase machine:
+
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:
 
<ol style="list-style-type:lower-roman">
 
<ol style="list-style-type:lower-roman">
<li>Stop CanIt on all cluster members before each command:
+
<li>First download the packages before installing them to minimize downtime by running the command with the following flag after it:
 +
:<tt>--download-only</tt>
 +
eg:
 +
:<tt>upgrade-canit-appliance --download-only</tt>
 +
<li>Stop CanIt on all cluster members:
 
:<tt>/etc/init.d/canit-system stop-gracefully</tt>
 
:<tt>/etc/init.d/canit-system stop-gracefully</tt>
<li>After the command in step (4) above, run:
+
<li>Run the actual command listed for that step above.
 +
<li>After the command above, run:
 
:<tt>/etc/init.d/canit-system start</tt>
 
:<tt>/etc/init.d/canit-system start</tt>
<li>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).
 
 
</ol>
 
</ol>
 +
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==
 
==Upgrade to Buster==
  
Stretch is the current Stable release of Debian and Roaring Penguin does not support the 'Testing' release of Debian. 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.
+
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 <b>the upgrade to Stetch MUST be done before you can upgrade to it!</b>
 
When Buster is eventually released be aware that <b>the upgrade to Stetch MUST be done before you can upgrade to it!</b>

Latest revision as of 14:13, 26 September 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 at Debian Upgrades.

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

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!