h1. Debian/jessie notes

Some notes regarding dist-upgrades from wheezy to jessie with Foreman 1.8. Please note that this kind of upgrade is not officially supported by the Foreman project.

First of all, upgrade everything to the latest version available for wheezy, especially all Foreman related packages. Here it's presumed everything was configued with foreman-installer and no manual changes were made later. This means, a run of foreman-installer before the dist-upgrade should bring no changes in.

* The package *ruby-rdoc* is not upgradable, so it has to be removed, together with all dependent packages (including foreman-installer).

* Now all sources.list entries can be changed to jessie.

* *If using the PuppetLabs repository*, at the moment (2015-04-12) no jessie release packages are available, so use puppetlabs-release-testing.

* *If using Debian Puppet packages*, see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=782325 for a potential source of a (harmless) error.

* While the dist-upgrade manual answering regarding apache modules and disabling of the ssl module is necessary. Just do everything needed for the upgrade to succeed.

* Reboot into the new kernel.

* If using PostgreSQL on the same host as database server, install the 9.4 packages and migrate the database with the help of pg_upgradecluster

* Now foreman-installer can be installed and invoked again, configuring everything according to the old answers file.

* Everything should work again upgraded to Debian/jessie.