Statistics
| Branch: | Tag: | Revision:

root / UPGRADE @ 88b58ed6

History | View | Annotate | Download (10.7 kB)

1 35dd762d Michael Hanselmann
Upgrade notes
2 35dd762d Michael Hanselmann
=============
3 35dd762d Michael Hanselmann
4 e1ff0de1 Iustin Pop
.. highlight:: shell-example
5 35dd762d Michael Hanselmann
6 35dd762d Michael Hanselmann
This document details the steps needed to upgrade a cluster to newer versions
7 35dd762d Michael Hanselmann
of Ganeti.
8 35dd762d Michael Hanselmann
9 35dd762d Michael Hanselmann
As a general rule the node daemons need to be restarted after each software
10 35dd762d Michael Hanselmann
upgrade; if using the provided example init.d script, this means running the
11 35dd762d Michael Hanselmann
following command on all nodes::
12 35dd762d Michael Hanselmann
13 e1ff0de1 Iustin Pop
    $ /etc/init.d/ganeti restart
14 35dd762d Michael Hanselmann
15 35dd762d Michael Hanselmann
16 35dd762d Michael Hanselmann
2.1 and above
17 35dd762d Michael Hanselmann
-------------
18 35dd762d Michael Hanselmann
19 35dd762d Michael Hanselmann
Starting with Ganeti 2.0, upgrades between revisions (e.g. 2.1.0 to 2.1.1)
20 35dd762d Michael Hanselmann
should not need manual intervention. As a safety measure, minor releases (e.g.
21 35dd762d Michael Hanselmann
2.1.3 to 2.2.0) require the ``cfgupgrade`` command for changing the
22 35dd762d Michael Hanselmann
configuration version. Below you find the steps necessary to upgrade between
23 35dd762d Michael Hanselmann
minor releases.
24 35dd762d Michael Hanselmann
25 35dd762d Michael Hanselmann
To run commands on all nodes, the `distributed shell (dsh)
26 35dd762d Michael Hanselmann
<http://www.netfort.gr.jp/~dancer/software/dsh.html.en>`_ can be used, e.g.
27 35dd762d Michael Hanselmann
``dsh -M -F 8 -f /var/lib/ganeti/ssconf_online_nodes gnt-cluster --version``.
28 35dd762d Michael Hanselmann
29 35dd762d Michael Hanselmann
#. Ensure no jobs are running (master node only)::
30 35dd762d Michael Hanselmann
31 e1ff0de1 Iustin Pop
    $ gnt-job list
32 35dd762d Michael Hanselmann
33 6c28c480 Bernardo Dal Seno
#. Pause the watcher for an hour (master node only)::
34 6c28c480 Bernardo Dal Seno
35 6c28c480 Bernardo Dal Seno
    $ gnt-cluster watcher pause 1h
36 6c28c480 Bernardo Dal Seno
37 35dd762d Michael Hanselmann
#. Stop all daemons on all nodes::
38 35dd762d Michael Hanselmann
39 e1ff0de1 Iustin Pop
    $ /etc/init.d/ganeti stop
40 35dd762d Michael Hanselmann
41 35dd762d Michael Hanselmann
#. Backup old configuration (master node only)::
42 35dd762d Michael Hanselmann
43 e1ff0de1 Iustin Pop
    $ tar czf /var/lib/ganeti-$(date +\%FT\%T).tar.gz -C /var/lib ganeti
44 35dd762d Michael Hanselmann
45 35dd762d Michael Hanselmann
#. Install new Ganeti version on all nodes
46 35dd762d Michael Hanselmann
#. Run cfgupgrade on the master node::
47 35dd762d Michael Hanselmann
48 e1ff0de1 Iustin Pop
    $ /usr/lib/ganeti/tools/cfgupgrade --verbose --dry-run
49 e1ff0de1 Iustin Pop
    $ /usr/lib/ganeti/tools/cfgupgrade --verbose
50 35dd762d Michael Hanselmann
51 35dd762d Michael Hanselmann
   (``cfgupgrade`` supports a number of parameters, run it with
52 35dd762d Michael Hanselmann
   ``--help`` for more information)
53 35dd762d Michael Hanselmann
54 fe05a931 Michele Tartara
#. Upgrade the directory permissions on all nodes::
55 fe05a931 Michele Tartara
56 fe05a931 Michele Tartara
    $ /usr/lib/ganeti/ensure-dirs --full-run
57 fe05a931 Michele Tartara
58 91cdc18f Michele Tartara
#. Create the (missing) required users and make users part of the required
59 3449551d Michele Tartara
   groups on all nodes::
60 91cdc18f Michele Tartara
61 91cdc18f Michele Tartara
    $ /usr/lib/ganeti/tools/users-setup
62 91cdc18f Michele Tartara
63 1ce2f51f Klaus Aehlig
   This will ask for confirmation. To execute directly, add the ``--yes-do-it``
64 1ce2f51f Klaus Aehlig
   option.
65 1ce2f51f Klaus Aehlig
66 35dd762d Michael Hanselmann
#. Restart daemons on all nodes::
67 35dd762d Michael Hanselmann
68 e1ff0de1 Iustin Pop
    $ /etc/init.d/ganeti restart
69 35dd762d Michael Hanselmann
70 35dd762d Michael Hanselmann
#. Re-distribute configuration (master node only)::
71 91fb0d18 Bernardo Dal Seno
72 91fb0d18 Bernardo Dal Seno
    $ gnt-cluster redist-conf
73 91fb0d18 Bernardo Dal Seno
74 e43f849c Guido Trotter
#. If you use file storage, check that the ``/etc/ganeti/file-storage-paths``
75 c7ec6a25 Michele Tartara
   is correct on all nodes. For security reasons it's not copied
76 c7ec6a25 Michele Tartara
   automatically, but it can be copied manually via::
77 e43f849c Guido Trotter
78 e43f849c Guido Trotter
   $ gnt-cluster copyfile /etc/ganeti/file-storage-paths
79 e43f849c Guido Trotter
80 91fb0d18 Bernardo Dal Seno
#. Restart daemons again on all nodes::
81 91fb0d18 Bernardo Dal Seno
82 91fb0d18 Bernardo Dal Seno
    $ /etc/init.d/ganeti restart
83 91fb0d18 Bernardo Dal Seno
84 91fb0d18 Bernardo Dal Seno
#. Enable the watcher again (master node only)::
85 91fb0d18 Bernardo Dal Seno
86 91fb0d18 Bernardo Dal Seno
    $ gnt-cluster watcher continue
87 91fb0d18 Bernardo Dal Seno
88 91fb0d18 Bernardo Dal Seno
#. Verify cluster (master node only)::
89 91fb0d18 Bernardo Dal Seno
90 91fb0d18 Bernardo Dal Seno
    $ gnt-cluster verify
91 91fb0d18 Bernardo Dal Seno
92 91fb0d18 Bernardo Dal Seno
Reverting an upgrade
93 91fb0d18 Bernardo Dal Seno
~~~~~~~~~~~~~~~~~~~~
94 91fb0d18 Bernardo Dal Seno
95 91fb0d18 Bernardo Dal Seno
For going back between revisions (e.g. 2.1.1 to 2.1.0) no manual
96 91fb0d18 Bernardo Dal Seno
intervention is required, as for upgrades.
97 91fb0d18 Bernardo Dal Seno
98 91fb0d18 Bernardo Dal Seno
Starting from version 2.8, ``cfgupgrade`` supports ``--downgrade``
99 91fb0d18 Bernardo Dal Seno
option to bring the configuration back to the previous stable version.
100 91fb0d18 Bernardo Dal Seno
This is useful if you upgrade Ganeti and after some time you run into
101 91fb0d18 Bernardo Dal Seno
problems with the new version. You can downgrade the configuration
102 91fb0d18 Bernardo Dal Seno
without losing the changes made since the upgrade. Any feature not
103 91fb0d18 Bernardo Dal Seno
supported by the old version will be removed from the configuration, of
104 91fb0d18 Bernardo Dal Seno
course, but you get a warning about it. If there is any new feature and
105 91fb0d18 Bernardo Dal Seno
you haven't changed from its default value, you don't have to worry
106 91fb0d18 Bernardo Dal Seno
about it, as it will get the same value whenever you'll upgrade again.
107 91fb0d18 Bernardo Dal Seno
108 91fb0d18 Bernardo Dal Seno
The procedure is similar to upgrading, but please notice that you have to
109 91fb0d18 Bernardo Dal Seno
revert the configuration **before** installing the old version.
110 91fb0d18 Bernardo Dal Seno
111 91fb0d18 Bernardo Dal Seno
#. Ensure no jobs are running (master node only)::
112 91fb0d18 Bernardo Dal Seno
113 91fb0d18 Bernardo Dal Seno
    $ gnt-job list
114 91fb0d18 Bernardo Dal Seno
115 91fb0d18 Bernardo Dal Seno
#. Pause the watcher for an hour (master node only)::
116 91fb0d18 Bernardo Dal Seno
117 91fb0d18 Bernardo Dal Seno
    $ gnt-cluster watcher pause 1h
118 91fb0d18 Bernardo Dal Seno
119 91fb0d18 Bernardo Dal Seno
#. Stop all daemons on all nodes::
120 91fb0d18 Bernardo Dal Seno
121 91fb0d18 Bernardo Dal Seno
    $ /etc/init.d/ganeti stop
122 91fb0d18 Bernardo Dal Seno
123 91fb0d18 Bernardo Dal Seno
#. Backup old configuration (master node only)::
124 91fb0d18 Bernardo Dal Seno
125 91fb0d18 Bernardo Dal Seno
    $ tar czf /var/lib/ganeti-$(date +\%FT\%T).tar.gz -C /var/lib ganeti
126 91fb0d18 Bernardo Dal Seno
127 91fb0d18 Bernardo Dal Seno
#. Run cfgupgrade on the master node::
128 91fb0d18 Bernardo Dal Seno
129 91fb0d18 Bernardo Dal Seno
    $ /usr/lib/ganeti/tools/cfgupgrade --verbose --downgrade --dry-run
130 91fb0d18 Bernardo Dal Seno
    $ /usr/lib/ganeti/tools/cfgupgrade --verbose --downgrade
131 91fb0d18 Bernardo Dal Seno
132 91fb0d18 Bernardo Dal Seno
   You may want to copy all the messages about features that have been
133 91fb0d18 Bernardo Dal Seno
   removed during the downgrade, in case you want to restore them when
134 91fb0d18 Bernardo Dal Seno
   upgrading again.
135 91fb0d18 Bernardo Dal Seno
136 91fb0d18 Bernardo Dal Seno
#. Install the old Ganeti version on all nodes
137 f3c7b51c Michele Tartara
138 f3c7b51c Michele Tartara
   NB: in Ganeti 2.8, the ``cmdlib.py`` file was split into a series of files
139 f3c7b51c Michele Tartara
   contained in the ``cmdlib`` directory. If Ganeti is installed from sources
140 f3c7b51c Michele Tartara
   and not from a package, while downgrading Ganeti to a pre-2.8
141 f3c7b51c Michele Tartara
   version it is important to remember to remove the ``cmdlib`` directory
142 f3c7b51c Michele Tartara
   from the directory containing the Ganeti python files (which usually is
143 f3c7b51c Michele Tartara
   ``${PREFIX}/lib/python${VERSION}/dist-packages/ganeti``).
144 f3c7b51c Michele Tartara
   A simpler upgrade/downgrade procedure will be made available in future
145 f3c7b51c Michele Tartara
   versions of Ganeti.
146 f3c7b51c Michele Tartara
147 91fb0d18 Bernardo Dal Seno
#. Restart daemons on all nodes::
148 91fb0d18 Bernardo Dal Seno
149 91fb0d18 Bernardo Dal Seno
    $ /etc/init.d/ganeti restart
150 91fb0d18 Bernardo Dal Seno
151 91fb0d18 Bernardo Dal Seno
#. Re-distribute configuration (master node only)::
152 35dd762d Michael Hanselmann
153 e1ff0de1 Iustin Pop
    $ gnt-cluster redist-conf
154 35dd762d Michael Hanselmann
155 35dd762d Michael Hanselmann
#. Restart daemons again on all nodes::
156 35dd762d Michael Hanselmann
157 e1ff0de1 Iustin Pop
    $ /etc/init.d/ganeti restart
158 35dd762d Michael Hanselmann
159 6c28c480 Bernardo Dal Seno
#. Enable the watcher again (master node only)::
160 6c28c480 Bernardo Dal Seno
161 6c28c480 Bernardo Dal Seno
    $ gnt-cluster watcher continue
162 6c28c480 Bernardo Dal Seno
163 35dd762d Michael Hanselmann
#. Verify cluster (master node only)::
164 35dd762d Michael Hanselmann
165 e1ff0de1 Iustin Pop
    $ gnt-cluster verify
166 35dd762d Michael Hanselmann
167 35dd762d Michael Hanselmann
168 35dd762d Michael Hanselmann
2.0 releases
169 35dd762d Michael Hanselmann
------------
170 35dd762d Michael Hanselmann
171 35dd762d Michael Hanselmann
2.0.3 to 2.0.4
172 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~
173 35dd762d Michael Hanselmann
174 35dd762d Michael Hanselmann
No changes needed except restarting the daemon; but rollback to 2.0.3 might
175 35dd762d Michael Hanselmann
require configuration editing.
176 35dd762d Michael Hanselmann
177 35dd762d Michael Hanselmann
If you're using Xen-HVM instances, please double-check the network
178 35dd762d Michael Hanselmann
configuration (``nic_type`` parameter) as the defaults might have changed:
179 35dd762d Michael Hanselmann
2.0.4 adds any missing configuration items and depending on the version of the
180 35dd762d Michael Hanselmann
software the cluster has been installed with, some new keys might have been
181 35dd762d Michael Hanselmann
added.
182 35dd762d Michael Hanselmann
183 35dd762d Michael Hanselmann
2.0.1 to 2.0.2/2.0.3
184 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~~~~~~~
185 35dd762d Michael Hanselmann
186 35dd762d Michael Hanselmann
Between 2.0.1 and 2.0.2 there have been some changes in the handling of block
187 35dd762d Michael Hanselmann
devices, which can cause some issues. 2.0.3 was then released which adds two
188 35dd762d Michael Hanselmann
new options/commands to fix this issue.
189 35dd762d Michael Hanselmann
190 35dd762d Michael Hanselmann
If you use DRBD-type instances and see problems in instance start or
191 35dd762d Michael Hanselmann
activate-disks with messages from DRBD about "lower device too small" or
192 35dd762d Michael Hanselmann
similar, it is recoomended to:
193 35dd762d Michael Hanselmann
194 35dd762d Michael Hanselmann
#. Run ``gnt-instance activate-disks --ignore-size $instance`` for each
195 35dd762d Michael Hanselmann
   of the affected instances
196 35dd762d Michael Hanselmann
#. Then run ``gnt-cluster repair-disk-sizes`` which will check that
197 35dd762d Michael Hanselmann
   instances have the correct disk sizes
198 35dd762d Michael Hanselmann
199 35dd762d Michael Hanselmann
1.2 to 2.0
200 35dd762d Michael Hanselmann
----------
201 35dd762d Michael Hanselmann
202 35dd762d Michael Hanselmann
Prerequisites:
203 35dd762d Michael Hanselmann
204 35dd762d Michael Hanselmann
- Ganeti 1.2.7 is currently installed
205 35dd762d Michael Hanselmann
- All instances have been migrated from DRBD 0.7 to DRBD 8.x (i.e. no
206 35dd762d Michael Hanselmann
  ``remote_raid1`` disk template)
207 35dd762d Michael Hanselmann
- Upgrade to Ganeti 2.0.0~rc2 or later (~rc1 and earlier don't have the needed
208 35dd762d Michael Hanselmann
  upgrade tool)
209 35dd762d Michael Hanselmann
210 35dd762d Michael Hanselmann
In the below steps, replace :file:`/var/lib` with ``$libdir`` if Ganeti was not
211 35dd762d Michael Hanselmann
installed with this prefix (e.g. :file:`/usr/local/var`). Same for
212 35dd762d Michael Hanselmann
:file:`/usr/lib`.
213 35dd762d Michael Hanselmann
214 35dd762d Michael Hanselmann
Execution (all steps are required in the order given):
215 35dd762d Michael Hanselmann
216 35dd762d Michael Hanselmann
#. Make a backup of the current configuration, for safety::
217 35dd762d Michael Hanselmann
218 e1ff0de1 Iustin Pop
    $ cp -a /var/lib/ganeti /var/lib/ganeti-1.2.backup
219 35dd762d Michael Hanselmann
220 35dd762d Michael Hanselmann
#. Stop all instances::
221 35dd762d Michael Hanselmann
222 e1ff0de1 Iustin Pop
    $ gnt-instance stop --all
223 35dd762d Michael Hanselmann
224 35dd762d Michael Hanselmann
#. Make sure no DRBD device are in use, the following command should show no
225 35dd762d Michael Hanselmann
   active minors::
226 35dd762d Michael Hanselmann
227 e1ff0de1 Iustin Pop
    $ gnt-cluster command grep cs: /proc/drbd | grep -v cs:Unconf
228 35dd762d Michael Hanselmann
229 35dd762d Michael Hanselmann
#. Stop the node daemons and rapi daemon on all nodes (note: should be logged
230 35dd762d Michael Hanselmann
   in not via the cluster name, but the master node name, as the command below
231 35dd762d Michael Hanselmann
   will remove the cluster ip from the master node)::
232 35dd762d Michael Hanselmann
233 e1ff0de1 Iustin Pop
    $ gnt-cluster command /etc/init.d/ganeti stop
234 35dd762d Michael Hanselmann
235 35dd762d Michael Hanselmann
#. Install the new software on all nodes, either from packaging (if available)
236 35dd762d Michael Hanselmann
   or from sources; the master daemon will not start but give error messages
237 35dd762d Michael Hanselmann
   about wrong configuration file, which is normal
238 35dd762d Michael Hanselmann
#. Upgrade the configuration file::
239 35dd762d Michael Hanselmann
240 e1ff0de1 Iustin Pop
    $ /usr/lib/ganeti/tools/cfgupgrade12 -v --dry-run
241 e1ff0de1 Iustin Pop
    $ /usr/lib/ganeti/tools/cfgupgrade12 -v
242 35dd762d Michael Hanselmann
243 35dd762d Michael Hanselmann
#. Make sure ``ganeti-noded`` is running on all nodes (and start it if
244 35dd762d Michael Hanselmann
   not)
245 35dd762d Michael Hanselmann
#. Start the master daemon::
246 35dd762d Michael Hanselmann
247 e1ff0de1 Iustin Pop
    $ ganeti-masterd
248 35dd762d Michael Hanselmann
249 35dd762d Michael Hanselmann
#. Check that a simple node-list works::
250 35dd762d Michael Hanselmann
251 e1ff0de1 Iustin Pop
    $ gnt-node list
252 35dd762d Michael Hanselmann
253 35dd762d Michael Hanselmann
#. Redistribute updated configuration to all nodes::
254 35dd762d Michael Hanselmann
255 e1ff0de1 Iustin Pop
    $ gnt-cluster redist-conf
256 e1ff0de1 Iustin Pop
    $ gnt-cluster copyfile /var/lib/ganeti/known_hosts
257 35dd762d Michael Hanselmann
258 35dd762d Michael Hanselmann
#. Optional: if needed, install RAPI-specific certificates under
259 35dd762d Michael Hanselmann
   :file:`/var/lib/ganeti/rapi.pem` and run::
260 35dd762d Michael Hanselmann
261 e1ff0de1 Iustin Pop
    $ gnt-cluster copyfile /var/lib/ganeti/rapi.pem
262 35dd762d Michael Hanselmann
263 35dd762d Michael Hanselmann
#. Run a cluster verify, this should show no problems::
264 35dd762d Michael Hanselmann
265 e1ff0de1 Iustin Pop
    $ gnt-cluster verify
266 35dd762d Michael Hanselmann
267 35dd762d Michael Hanselmann
#. Remove some obsolete files::
268 35dd762d Michael Hanselmann
269 e1ff0de1 Iustin Pop
    $ gnt-cluster command rm /var/lib/ganeti/ssconf_node_pass
270 e1ff0de1 Iustin Pop
    $ gnt-cluster command rm /var/lib/ganeti/ssconf_hypervisor
271 35dd762d Michael Hanselmann
272 35dd762d Michael Hanselmann
#. Update the xen pvm (if this was a pvm cluster) setting for 1.2
273 35dd762d Michael Hanselmann
   compatibility::
274 35dd762d Michael Hanselmann
275 e1ff0de1 Iustin Pop
    $ gnt-cluster modify -H xen-pvm:root_path=/dev/sda
276 35dd762d Michael Hanselmann
277 35dd762d Michael Hanselmann
#. Depending on your setup, you might also want to reset the initrd parameter::
278 35dd762d Michael Hanselmann
279 e1ff0de1 Iustin Pop
    $ gnt-cluster modify -H xen-pvm:initrd_path=/boot/initrd-2.6-xenU
280 35dd762d Michael Hanselmann
281 35dd762d Michael Hanselmann
#. Reset the instance autobalance setting to default::
282 35dd762d Michael Hanselmann
283 e1ff0de1 Iustin Pop
    $ for i in $(gnt-instance list -o name --no-headers); do \
284 e1ff0de1 Iustin Pop
       gnt-instance modify -B auto_balance=default $i; \
285 e1ff0de1 Iustin Pop
      done
286 35dd762d Michael Hanselmann
287 35dd762d Michael Hanselmann
#. Optional: start the RAPI demon::
288 35dd762d Michael Hanselmann
289 e1ff0de1 Iustin Pop
    $ ganeti-rapi
290 35dd762d Michael Hanselmann
291 35dd762d Michael Hanselmann
#. Restart instances::
292 35dd762d Michael Hanselmann
293 e1ff0de1 Iustin Pop
    $ gnt-instance start --force-multiple --all
294 35dd762d Michael Hanselmann
295 35dd762d Michael Hanselmann
At this point, ``gnt-cluster verify`` should show no errors and the migration
296 35dd762d Michael Hanselmann
is complete.
297 35dd762d Michael Hanselmann
298 35dd762d Michael Hanselmann
1.2 releases
299 35dd762d Michael Hanselmann
------------
300 35dd762d Michael Hanselmann
301 35dd762d Michael Hanselmann
1.2.4 to any other higher 1.2 version
302 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
303 35dd762d Michael Hanselmann
304 35dd762d Michael Hanselmann
No changes needed. Rollback will usually require manual edit of the
305 35dd762d Michael Hanselmann
configuration file.
306 35dd762d Michael Hanselmann
307 35dd762d Michael Hanselmann
1.2.3 to 1.2.4
308 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~
309 35dd762d Michael Hanselmann
310 35dd762d Michael Hanselmann
No changes needed. Note that going back from 1.2.4 to 1.2.3 will require manual
311 35dd762d Michael Hanselmann
edit of the configuration file (since we added some HVM-related new
312 35dd762d Michael Hanselmann
attributes).
313 35dd762d Michael Hanselmann
314 35dd762d Michael Hanselmann
1.2.2 to 1.2.3
315 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~
316 35dd762d Michael Hanselmann
317 35dd762d Michael Hanselmann
No changes needed. Note that the drbd7-to-8 upgrade tool does a disk format
318 35dd762d Michael Hanselmann
change for the DRBD metadata, so in theory this might be **risky**. It is
319 35dd762d Michael Hanselmann
advised to have (good) backups before doing the upgrade.
320 35dd762d Michael Hanselmann
321 35dd762d Michael Hanselmann
1.2.1 to 1.2.2
322 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~
323 35dd762d Michael Hanselmann
324 35dd762d Michael Hanselmann
No changes needed.
325 35dd762d Michael Hanselmann
326 35dd762d Michael Hanselmann
1.2.0 to 1.2.1
327 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~
328 35dd762d Michael Hanselmann
329 35dd762d Michael Hanselmann
No changes needed. Only some bugfixes and new additions that don't affect
330 35dd762d Michael Hanselmann
existing clusters.
331 35dd762d Michael Hanselmann
332 35dd762d Michael Hanselmann
1.2.0 beta 3 to 1.2.0
333 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~~~~~~~~
334 35dd762d Michael Hanselmann
335 35dd762d Michael Hanselmann
No changes needed.
336 35dd762d Michael Hanselmann
337 35dd762d Michael Hanselmann
1.2.0 beta 2 to beta 3
338 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~~~~~~~~~
339 35dd762d Michael Hanselmann
340 35dd762d Michael Hanselmann
No changes needed. A new version of the debian-etch-instance OS (0.3) has been
341 35dd762d Michael Hanselmann
released, but upgrading it is not required.
342 35dd762d Michael Hanselmann
343 35dd762d Michael Hanselmann
1.2.0 beta 1 to beta 2
344 35dd762d Michael Hanselmann
~~~~~~~~~~~~~~~~~~~~~~
345 35dd762d Michael Hanselmann
346 35dd762d Michael Hanselmann
Beta 2 switched the config file format to JSON. Steps to upgrade:
347 35dd762d Michael Hanselmann
348 35dd762d Michael Hanselmann
#. Stop the daemons (``/etc/init.d/ganeti stop``) on all nodes
349 35dd762d Michael Hanselmann
#. Disable the cron job (default is :file:`/etc/cron.d/ganeti`)
350 35dd762d Michael Hanselmann
#. Install the new version
351 35dd762d Michael Hanselmann
#. Make a backup copy of the config file
352 35dd762d Michael Hanselmann
#. Upgrade the config file using the following command::
353 35dd762d Michael Hanselmann
354 e1ff0de1 Iustin Pop
    $ /usr/share/ganeti/cfgupgrade --verbose /var/lib/ganeti/config.data
355 35dd762d Michael Hanselmann
356 35dd762d Michael Hanselmann
#. Start the daemons and run ``gnt-cluster info``, ``gnt-node list`` and
357 35dd762d Michael Hanselmann
   ``gnt-instance list`` to check if the upgrade process finished successfully
358 35dd762d Michael Hanselmann
359 35dd762d Michael Hanselmann
The OS definition also need to be upgraded. There is a new version of the
360 35dd762d Michael Hanselmann
debian-etch-instance OS (0.2) that goes along with beta 2.
361 9ff4f2c0 Michael Hanselmann
362 9ff4f2c0 Michael Hanselmann
.. vim: set textwidth=72 :
363 9ff4f2c0 Michael Hanselmann
.. Local Variables:
364 9ff4f2c0 Michael Hanselmann
.. mode: rst
365 9ff4f2c0 Michael Hanselmann
.. fill-column: 72
366 9ff4f2c0 Michael Hanselmann
.. End: