Merge pull request #7295 from Icinga/bugfix/docs-initial-sync

Docs: Clarify on when a manual initial cluster sync is needed
This commit is contained in:
Michael Friedrich 2019-07-08 13:55:15 +02:00 committed by GitHub
commit de31243563
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 1 deletions

View File

@ -2801,6 +2801,13 @@ object Endpoint "icinga2-master2.localdomain" {
### Initial Sync for new Endpoints in a Zone <a id="distributed-monitoring-advanced-hints-initial-sync"></a>
> **Note**
>
> This is required if you decide to change an already running single endpoint production
> environment into a HA-enabled cluster zone with two endpoints.
> The [initial setup](06-distributed-monitoring.md#distributed-monitoring-scenarios-ha-master-clients)
> with 2 HA masters doesn't require this step.
In order to make sure that all of your zone endpoints have the same state you need
to pick the authoritative running one and copy the following content:
@ -2808,9 +2815,12 @@ to pick the authoritative running one and copy the following content:
* Internal config package for runtime created objects (downtimes, comments, hosts, etc.) at `/var/lib/icinga2/api/packages/_api`
If you need already deployed config packages from the Director, or synced cluster zones,
you can also sync the entire `/var/lib/icinga2` directory. This directory should also be
you can also sync the entire `/var/lib/icinga2/api/packages` directory. This directory should also be
included in your [backup strategy](02-getting-started.md#install-backup).
Do **not** sync `/var/lib/icinga2/api/zones*` manually - this is an internal directory
and handled by the Icinga cluster config sync itself.
> **Note**
>
> Ensure that all endpoints are shut down during this procedure. Once you have