Package: release-notes Severity: normal Dear Maintainer,
Bug #783186 affects Wheezy to Jessie upgrades and should ideally be documented in the release notes. The attached patch adds the relevant paragraph, together with a paragraph with general notes on Ganeti cluster upgrades, to the release notes. Regards, Apollon
Index: en/issues.dbk =================================================================== --- en/issues.dbk (revision 10823) +++ en/issues.dbk (working copy) @@ -932,4 +932,40 @@ Perl by running <command>perl -V</command>. </para> </section> +<section id="ganeti-upgrade-issues"> + <title>Upgrade considerations for Ganeti clusters</title> + + <section id="ganeti-upgrade-DRBD-UUIDs"> + <!-- Wheezy to Jessie (#783186) --> + <title>Problem upgrading Ganeti clusters with DRBD-backed instances</title> + <para> + The version of <systemitem role="package">ganeti</systemitem> (2.12.0-3) + released with Jessie does not support migrations from installations + running 2.5 or earlier (including Wheezy) in cases where there are + instances with DRBD disks. It is hoped that this issue will be fixed + in a point release, and recommended that you do not upgrade affected + Ganeti clusters in the meantime. You can find more information about + this issue at <ulink url="&url-bts;783186">Debian Bug#783186</ulink>. + </para> + </section> + <section id="ganeti-upgrade-general"> + <title>General notes on upgrading Ganeti clusters</title> + <para> + Ganeti does not support mixed-version clusters. As such, all of a + cluster's nodes must run the same version of <systemitem + role="package">ganeti</systemitem>. Also, depending on the hypervisor + used, instance live migrations between Wheezy and Jessie hypervisor + versions may not work. + </para> + <para> + The recommended procedure to upgrade a Ganeti cluster from Wheezy to + Jessie is to stop all instances, upgrade and reboot all nodes, upgrade + the Ganeti cluster configuration using <systemitem + role="package">ganeti</systemitem>'s <command>cfgupgrade</command> and + then start the instances again. This will ensure that all instances run + with Jessie's hypervisor version and that all nodes run the same + versions of Ganeti and DRBD. + </para> + </section> +</section> </chapter>