root / doc / cluster-merge.rst @ 6f547f96
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: |