Bug#783196: release-notes: please add notes on upgrading Ganeti clusters
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>
Reply to: