Allow burnin to use an iallocator in instance creation
[ganeti-local] / tools / README.drbd8-upgrade
1 The DRBD0.7 to DRBD8 upgrade script is just for converting the actual
2 metadata format and Ganeti configuration.
3
4 Before running the script, the following steps need to be done:
5   - make sure all disks (remote_raid1) are fully synced and working
6     correctly
7   - shutdown all instances and make sure no operations on the cluster
8     will be done until the end of the upgrade
9   - remove the drbd 0.7 kernel module and userspace tools
10   - install the drbd8 kernel module and userspace tools
11   - run the upgrade script (no arguments)
12
13 After the upgrade, it is recommended to run ‘gnt-instance
14 activate-disks’ for all instances and make sure the disks have started
15 correctly.
16
17 Currently there are some race conditions in the activate-disks that are
18 triggered by the metadata conversion process. We're investigating these,
19 but there is no data loss or risk; activating drbd manually (as
20 secondaries on both sides) is enough to give the peers the chance to
21 reestablish connections and sync fully.
22
23 The script also saves the metadata from each device on the master under
24 the path it's run from as files named "metadump-$node-$lv_name". In case
25 of script failure, it should be possible to restore the original state
26 of the cluster by formatting and restoring the metadata on the drbd
27 devices and using the save copy of the config file. For this, it is
28 recommended to save the output of the script.