Statistics
| Branch: | Tag: | Revision:

root / doc / cluster-merge.rst @ 18e2b6e4

History | View | Annotate | Download (1.9 kB)

1 38dda022 René Nussbaumer
================
2 38dda022 René Nussbaumer
Merging clusters
3 38dda022 René Nussbaumer
================
4 38dda022 René Nussbaumer
5 38dda022 René Nussbaumer
With ``cluster-merge`` from the ``tools`` directory it is possible to
6 38dda022 René Nussbaumer
merge two or more clusters into one single cluster.
7 38dda022 René Nussbaumer
8 38dda022 René Nussbaumer
If anything goes wrong at any point the script suggests you rollback
9 38dda022 René Nussbaumer
steps you've to perform *manually* if there are any. The point of no
10 38dda022 René Nussbaumer
return is when the master daemon is started the first time after merging
11 38dda022 René Nussbaumer
the configuration files. A rollback at this point would involve a lot of
12 38dda022 René Nussbaumer
manual work.
13 38dda022 René Nussbaumer
14 38dda022 René Nussbaumer
For the internal design of this tool have a look at the `Automated
15 38dda022 René Nussbaumer
Ganeti Cluster Merger <design-2.1.rst>` document.
16 38dda022 René Nussbaumer
17 38dda022 René Nussbaumer
18 38dda022 René Nussbaumer
Merge Clusters
19 38dda022 René Nussbaumer
==============
20 38dda022 René Nussbaumer
21 38dda022 René Nussbaumer
The tool has to be invoked on the cluster you like to merge the other
22 38dda022 René Nussbaumer
clusters into.
23 38dda022 René Nussbaumer
24 38dda022 René Nussbaumer
The usage of ``cluster-merge`` is as follows::
25 38dda022 René Nussbaumer
26 38dda022 René Nussbaumer
  cluster-merge [--debug|--verbose] [--watcher-pause-period SECONDS] <cluster> \
27 38dda022 René Nussbaumer
  <cluster...>
28 38dda022 René Nussbaumer
29 38dda022 René Nussbaumer
You can provide multiple clusters. The tool will then go over every
30 38dda022 René Nussbaumer
cluster in serial and perform the steps to merge it into the invoking
31 38dda022 René Nussbaumer
cluster.
32 38dda022 René Nussbaumer
33 38dda022 René Nussbaumer
These options can be used to control the behaviour of the tool:
34 38dda022 René Nussbaumer
35 38dda022 René Nussbaumer
``--debug``/``--verbose``
36 38dda022 René Nussbaumer
  These options are mutually exclusive and increase the level of output
37 38dda022 René Nussbaumer
  to either debug output or just more verbose output like action
38 38dda022 René Nussbaumer
  performed right now.
39 38dda022 René Nussbaumer
``--watcher-pause-period``
40 38dda022 René Nussbaumer
  Define the period of time in seconds the watcher shall be disabled,
41 38dda022 René Nussbaumer
  default is 1800 seconds (30 minutes).
42 38dda022 René Nussbaumer
43 38dda022 René Nussbaumer
44 38dda022 René Nussbaumer
Rollback
45 38dda022 René Nussbaumer
========
46 38dda022 René Nussbaumer
47 38dda022 René Nussbaumer
If for any reason something in the merge doesn't work the way it should
48 38dda022 René Nussbaumer
``cluster-merge`` will abort, provide an error message and optionally
49 38dda022 René Nussbaumer
rollback steps. Please be aware that after a certain point there's no
50 38dda022 René Nussbaumer
easy way to rollback the cluster to its previous state. If you've
51 38dda022 René Nussbaumer
reached that point the tool will not provide any rollback steps.
52 38dda022 René Nussbaumer
53 38dda022 René Nussbaumer
If you end up with rollback steps, please perform them before invoking
54 38dda022 René Nussbaumer
the tool again. It doesn't keep state over invokations.
55 38dda022 René Nussbaumer
56 38dda022 René Nussbaumer
57 38dda022 René Nussbaumer
.. vim: set textwidth=72 :
58 38dda022 René Nussbaumer
.. Local Variables:
59 38dda022 René Nussbaumer
.. mode: rst
60 38dda022 René Nussbaumer
.. fill-column: 72
61 38dda022 René Nussbaumer
.. End: