root / README.admin @ 2b837adf
History | View | Annotate | Download (1.6 kB)
1 | 03353341 | Vangelis Koukis | README.admin - Administration notes |
---|---|---|---|
2 | 03353341 | Vangelis Koukis | |
3 | 03353341 | Vangelis Koukis | This file contains notes related to administration of a working Synnefo |
4 | 03353341 | Vangelis Koukis | deployment. This document should be read *after* README.deploy, which contains |
5 | 03353341 | Vangelis Koukis | step-by-step Synnefo deployment instructions. |
6 | 03353341 | Vangelis Koukis | |
7 | 03353341 | Vangelis Koukis | |
8 | 03353341 | Vangelis Koukis | Reconciliation mechanism |
9 | 03353341 | Vangelis Koukis | ======================== |
10 | 03353341 | Vangelis Koukis | |
11 | 03353341 | Vangelis Koukis | On certain occasions, such as a Ganeti or RabbitMQ failure, the VM state in the |
12 | 03353341 | Vangelis Koukis | system's database may differ from that in the Ganeti installation. The |
13 | 03353341 | Vangelis Koukis | reconciliation process is designed to bring the system's database in sync with |
14 | 03353341 | Vangelis Koukis | what Ganeti knows about each VM. |
15 | 03353341 | Vangelis Koukis | |
16 | 03353341 | Vangelis Koukis | The administrator can trigger reconciliation manually, by issuing a Ganeti |
17 | 03353341 | Vangelis Koukis | OP_INSTANCE_QUERY_DATA command, using gnt-instance info. |
18 | 03353341 | Vangelis Koukis | |
19 | 271baf11 | Nikos Skalkotos | Alternatively, the reconciliation process can be triggered for all VMs using the |
20 | 271baf11 | Nikos Skalkotos | command |
21 | 03353341 | Vangelis Koukis | |
22 | 03353341 | Vangelis Koukis | ./manage.py reconcile --all |
23 | 03353341 | Vangelis Koukis | |
24 | 03353341 | Vangelis Koukis | It is advised, though not strictly necessary, to run the reconciliation process |
25 | 271baf11 | Nikos Skalkotos | periodically, through cron. To avoid overloading the Ganeti master, the periodic |
26 | 271baf11 | Nikos Skalkotos | reconciliation process takes a staggered approach to updating the VMs, which is |
27 | 271baf11 | Nikos Skalkotos | configured through the following parameters: |
28 | 03353341 | Vangelis Koukis | |
29 | 271baf11 | Nikos Skalkotos | * The settings.py RECONCILIATION_MIN parameter, which specifies the maximum time |
30 | 271baf11 | Nikos Skalkotos | a VM can remain ``non-reconciled''. (default: 30 mins) |
31 | 03353341 | Vangelis Koukis | |
32 | 271baf11 | Nikos Skalkotos | * The --interval option to the reconcile command, which declares the interval |
33 | 271baf11 | Nikos Skalkotos | time between reconciliation attempts (default: 1 min) |
34 | 03353341 | Vangelis Koukis | |
35 | 03353341 | Vangelis Koukis | On each invocation of the reconcile command, the system will trigger a |
36 | 271baf11 | Nikos Skalkotos | reconciliation for ((num_all_vms/RECONCILIATION_MIN) * interval) machines. |
37 | 271baf11 | Nikos Skalkotos | Obviously the lower the interval value and the higher the setting of |
38 | 271baf11 | Nikos Skalkotos | RECONCILIATION_MIN, the less load is going to be put on Ganeti. |