From: Michael Friedrich Date: Thu, 9 Aug 2018 10:22:55 +0000 (+0200) Subject: Update doc anchors X-Git-Tag: v2.10.0~65^2~5 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=cd94b7731e110fbbadd5b861063866ea495c4063;p=icinga2 Update doc anchors --- diff --git a/doc/06-distributed-monitoring.md b/doc/06-distributed-monitoring.md index 15353de90..04d091716 100644 --- a/doc/06-distributed-monitoring.md +++ b/doc/06-distributed-monitoring.md @@ -116,7 +116,8 @@ you still need a [Host](09-object-types.md#objecttype-host) object. In case you are using the CLI commands later, you don't have to write this configuration from scratch in a text editor. -The [ApiListener] object is used to load the SSL certificates and specify restrictions, e.g. +The [ApiListener](09-object-types.md#objecttype-apilistener) object is +used to load the TLS certificates and specify restrictions, e.g. for accepting configuration commands. It is also used for the [Icinga 2 REST API](12-icinga2-api.md#icinga2-api) which shares @@ -2795,12 +2796,14 @@ Add the global zone `global-templates` in case it did not exist. ## Using Multiple Environments -In some cases it might be useful to run multiple Icinga instance on the same host. Two potential scenarios include: +In some cases it can be desired to run multiple Icinga instances on the same host. +Two potential scenarios include: -* running different versions of the same monitoring configuration (e.g. production and testing) -* running disparate sets of checks for entirely unrelated monitoring environments (e.g. infrastructure and applications) +* Different versions of the same monitoring configuration (e.g. production and testing) +* Disparate sets of checks for entirely unrelated monitoring environments (e.g. infrastructure and applications) -Configuration is controlled via constants and attributes of the [ApiListener]. +The configuration is done with global constants and attributes of the +[ApiListener](09-object-types.md#objecttype-apilistener) object. Constant | Attribute ---------------|---------- @@ -2808,10 +2811,10 @@ ApiEnvironment | environment ApiBindHost | bind_host ApiBindPort | bind_port -In any case the constant is default value for the attribute, so that a direct configuration in the [ApiListener] object -has more precedence. The constants have been created to allow the values to be set from the command line on startup. +In any case the constant is default value for the attribute and the direct configuration in the ApiListener object +has more precedence. The constants have been added to allow the values being set from the CLI on startup. -When Icinga establishes a TLS connection to another cluster instance it automatically uses the [SNI extension] +When Icinga establishes a TLS connection to another cluster instance it automatically uses the [SNI extension](https://en.wikipedia.org/wiki/Server_Name_Indication) to signal which endpoint it is attempting to connect to. On its own this can already be used to position multiple Icinga instances behind a load balancer. @@ -2825,6 +2828,3 @@ Middleware like loadbalancers or TLS proxies can read the SNI header and route t I.e., it uses a single externally-visible TCP port (usually 5665) and forwards connections to one or more Icinga instances which are bound to a local TCP port. It does so by inspecting the environment name that is sent as part of the SNI extension. - -[ApiListener]: 09-object-types.md#objecttype-apilistener -[SNI Extension]: https://en.wikipedia.org/wiki/Server_Name_Indication