From e954a0e64b4e22e927ff41730c92f87e69d8f650 Mon Sep 17 00:00:00 2001 From: Michael Friedrich Date: Sat, 3 Dec 2016 13:42:22 +0100 Subject: [PATCH] Docs: Add a note about removing "conf.d" on the client for "top down command endpoint" setups fixes #13395 --- doc/6-distributed-monitoring.md | 30 +++++++++++++++++++++++------- 1 file changed, 23 insertions(+), 7 deletions(-) diff --git a/doc/6-distributed-monitoring.md b/doc/6-distributed-monitoring.md index 3555e710b..04cf8b28f 100644 --- a/doc/6-distributed-monitoring.md +++ b/doc/6-distributed-monitoring.md @@ -603,6 +603,16 @@ for syncing check commands later: global = true } +You don't need any local configuration on the client except for +CheckCommand definitions which can be synced using the global zone +above. Therefore disable the inclusion of the `conf.d` directory +in `/etc/icinga2/icinga2.conf`. + + [root@icinga2-client1.localdomain /]# vim /etc/icinga2/icinga2.conf + + // Commented out, not required on a client as command endpoint + //include_recursive "conf.d" + Edit the `api` feature on the client `icinga2-client2.localdomain` in the `/etc/icinga2/features-enabled/api.conf` file and make sure to set `accept_commands` and `accept_config` to `true`: @@ -988,13 +998,7 @@ configuration file. **Steps on each client**: -Comment or remove the `include recursive "conf.d"` line. - - [root@icinga2-client1.localdomain /]# vim /etc/icinga2/icinga2.conf - - //include_recursive "conf.d" - -In addition to that add a [global zone](6-distributed-monitoring.md#distributed-monitoring-global-zone-config-sync) +Add a [global zone](6-distributed-monitoring.md#distributed-monitoring-global-zone-config-sync) for syncing check commands later: [root@icinga2-client1.localdomain /]# vim /etc/icinga2/zones.conf @@ -1003,6 +1007,16 @@ for syncing check commands later: global = true } +You don't need any local configuration on the client except for +CheckCommand definitions which can be synced using the global zone +above. Therefore disable the inclusion of the `conf.d` directory +in `/etc/icinga2/icinga2.conf`. + + [root@icinga2-client1.localdomain /]# vim /etc/icinga2/icinga2.conf + + // Commented out, not required on a client as command endpoint + //include_recursive "conf.d" + Edit the `api` feature on the client `icinga2-client2.localdomain` in the `/etc/icinga2/features-enabled/api.conf` file and make sure to set `accept_commands` and `accept_config` to `true`: @@ -1827,6 +1841,8 @@ zone. The configuration validation will terminate with an error. The zone object configuration must be deployed on all nodes which should receive the global configuration files: + [root@icinga2-master1.localdomain /]# vim /etc/icinga2/zones.conf + object Zone "global-templates" { global = true } -- 2.49.0