From: Gunnar Beutner Date: Thu, 12 Feb 2015 09:29:21 +0000 (+0100) Subject: Update documentation X-Git-Tag: v2.3.0~224 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=cfe986e9c5dd71db34dacada45adfe03eab5712e;p=icinga2 Update documentation --- diff --git a/doc/10-addons-plugins.md b/doc/10-addons-plugins.md index 231cf12b8..486273c6a 100644 --- a/doc/10-addons-plugins.md +++ b/doc/10-addons-plugins.md @@ -1,45 +1,36 @@ # Icinga 2 Addons and Plugins -## Addons +## PNP -### Graphing Addons - -#### PNP - -[PNP](http://www.pnp4nagios.org) must be configured using the +[PNP](http://www.pnp4nagios.org) is a graphing addon. If you're planning to use +it you have to configure it to use the [bulk mode with npcd and npcdmod](http://docs.pnp4nagios.org/pnp-0.6/modes#bulk_mode_with_npcd_and_npcdmod) -hence Icinga 2's [PerfdataWriter](4-advanced-topics.md#performance-data) acts as npcdmod. NPCD will collect -the rotated performance data files. +in combination with Icinga 2's [PerfdataWriter](4-advanced-topics.md#performance-data). NPCD collects the performance +data files which Icinga 2 generates. -#### inGraph +## inGraph [inGraph](https://www.netways.org/projects/ingraph/wiki) requires the ingraph-collector addon to be configured to point at the perfdata files. Icinga 2's [PerfdataWriter](4-advanced-topics.md#performance-data) will write to the performance data spool directory. -#### Graphite +## Graphite There are Graphite addons available for collecting the performance data files as well. But natively you can use the [GraphiteWriter](4-advanced-topics.md#graphite-carbon-cache-writer) feature. -#### Icinga Reporting +## Icinga Reporting By enabling the DB IDO feature you can use the Icinga Reporting package. - -### Visualization - -#### NagVis +## NagVis By using either Livestatus or DB IDO as a backend you can create your own network maps based on your monitoring configuration and status data using [NagVis](http://www.nagvis.org). -### Web Interfaces - -As well as the Icinga supported web interfaces (Classic UI 1.x, Web 1.x, Web 2) there are a -number of community provided web interfaces too: +## Thruk -* [Thruk](http://www.thruk.org) based on the [Livestatus](12-livestatus.md#setting-up-livestatus) feature +[Thruk](http://www.thruk.org) is an alternative web interface which can be used with Icinga 2. ## Plugins diff --git a/doc/2-getting-started.md b/doc/2-getting-started.md index 94655e31d..55d2a7117 100644 --- a/doc/2-getting-started.md +++ b/doc/2-getting-started.md @@ -24,7 +24,7 @@ and distribution you are running. Packages for distributions other than the ones listed above may also be available. Please contact your distribution packagers. -### Installing Requirements for Icinga 2 +### Package Repositories You need to add the Icinga repository to your package management configuration. Below is a list with examples for the various distributions. diff --git a/doc/3-monitoring-basics.md b/doc/3-monitoring-basics.md index 443680123..9ef9b31ec 100644 --- a/doc/3-monitoring-basics.md +++ b/doc/3-monitoring-basics.md @@ -93,7 +93,7 @@ The `hostalive` command is one of several built-in check commands. It sends ICMP echo requests to the IP address specified in the `address` attribute to determine whether a host is online. -A number of other [built-in check commands](#plugin-check-comamnds) are also +A number of other [built-in check commands](7-icinga-template-library.md#plugin-check-commands) are also available. In addition to these commands the next few chapters will explain in detail how to set up your own check commands. diff --git a/doc/4-advanced-topics.md b/doc/4-advanced-topics.md index 9ff630295..e7fa23b5a 100644 --- a/doc/4-advanced-topics.md +++ b/doc/4-advanced-topics.md @@ -273,9 +273,6 @@ a forced service check: Oct 17 15:01:25 icinga-server icinga2: Executing external command: [1382014885] SCHEDULE_FORCED_SVC_CHECK;localhost;ping4;1382014885 Oct 17 15:01:25 icinga-server icinga2: Rescheduling next check for service 'ping4' - -### External Command List - A list of currently supported external commands can be found [here](19-apendix.md#external-commands-list-detail). Detailed information on the commands and their required parameters can be found diff --git a/doc/8-cli-commands.md b/doc/8-cli-commands.md index 98b07caad..cc7389b52 100644 --- a/doc/8-cli-commands.md +++ b/doc/8-cli-commands.md @@ -1,4 +1,4 @@ -## Icinga 2 CLI Commands +# Icinga 2 CLI Commands Icinga 2 comes with a number of CLI commands which support bash autocompletion. @@ -76,7 +76,7 @@ options. Icinga home page: -### Icinga 2 CLI Bash Autocompletion +## Icinga 2 CLI Bash Autocompletion Bash Auto-Completion (pressing ``) is provided only for the corresponding context. @@ -101,18 +101,18 @@ Debian/Ubuntu: # apt-get install bash-completion -### Icinga 2 CLI Global Options +## Icinga 2 CLI Global Options -#### Libraries +### Libraries Instead of loading libraries using the [`library` config directive](16-language-reference.md#library) you can also use the `--library` command-line option. -#### Constants +### Constants [Global constants](16-language-reference.md#constants) can be set using the `--define` command-line option. -#### Config Include Path +### Config Include Path When including files you can specify that the include search path should be checked. You can do this by putting your configuration file name in angle @@ -128,7 +128,7 @@ Using the `--include` command-line option additional search directories can be added. -### CLI command: Console +## CLI command: Console The CLI command `console` can be used to evaluate Icinga config expressions, e.g. to test `assign where` rules. @@ -148,7 +148,7 @@ use the `rlwrap` program if you require those features: $ rlwrap icinga2 console -### CLI command: Daemon +## CLI command: Daemon The CLI command `daemon` provides the functionality to start/stop Icinga 2. Furthermore it provides the [configuration validation](8-cli-commands.md#config-validation). @@ -182,7 +182,7 @@ Furthermore it provides the [configuration validation](8-cli-commands.md#config- Report bugs at Icinga home page: -#### Config Files +### Config Files Using the `--config` option you can specify one or more configuration files. Config files are processed in the order they're specified on the command-line. @@ -191,14 +191,14 @@ When no configuration file is specified and the `--no-config` is not used Icinga 2 automatically falls back to using the configuration file `SysconfDir + "/icinga2/icinga2.conf"` (where SysconfDir is usually `/etc`). -#### Config Validation +### Config Validation The `--validate` option can be used to check if your configuration files contain errors. If any errors are found the exit status is 1, otherwise 0 is returned. More details in the [configuration validation](8-cli-commands.md#config-validation) chapter. -### CLI command: Feature +## CLI command: Feature The `feature enable` and `feature disable` commands can be used to enable and disable features: @@ -216,7 +216,7 @@ The `feature list` command shows which features are currently enabled: Enabled features: api checker livestatus mainlog -### CLI command: Node +## CLI command: Node Provides the functionality to install and manage master and client nodes in a [remote monitoring ](9-monitoring-remote-systems.md#icinga2-remote-client-monitoring) or @@ -260,7 +260,7 @@ nodes in a [remote monitoring ](9-monitoring-remote-systems.md#icinga2-remote-cl Icinga home page: -### CLI command: Object +## CLI command: Object The `object` CLI command can be used to list all configuration objects and their attributes. The command also shows where each of the attributes was modified. @@ -294,7 +294,7 @@ More information can be found in the [troubleshooting](13-troubleshooting.md#lis -### CLI command: Pki +## CLI command: Pki Provides the CLI commands to @@ -337,7 +337,7 @@ This functionality is used by the [node setup/wizard](8-cli-commands.md#cli-comm Icinga home page: -### CLI command: Repository +## CLI command: Repository Provides the functionality to manage the Icinga 2 configuration repository in `/etc/icinga2/repository.d`. All changes are logged and must be committed or @@ -392,7 +392,7 @@ cleared after review. -### CLI command: Variable +## CLI command: Variable Lists all configured variables (constants) in a similar fasion like [object list](8-cli-commands.md#cli-command-object). @@ -422,9 +422,6 @@ Lists all configured variables (constants) in a similar fasion like [object list Icinga home page: - - - ## Enabling/Disabling Features Icinga 2 provides configuration files for some commonly used features. These