mirror of https://github.com/Icinga/icinga2.git
81 lines
2.3 KiB
Plaintext
81 lines
2.3 KiB
Plaintext
Icinga 2 Configuration
|
|
======================
|
|
|
|
:keywords: Icinga, documentation, index
|
|
:description: Main index of Icinga 2 documentation
|
|
|
|
Configuration Introduction
|
|
--------------------------
|
|
|
|
In Icinga 2 configuration is based on objects. There's no difference in defining
|
|
global settings for the core application or for a specific runtime configuration
|
|
object.
|
|
|
|
There are different types for the main application, its components and tools.
|
|
The runtime configuration objects such as hosts, services, etc are defined using
|
|
the same syntax.
|
|
|
|
Each configuration object must be unique by its name. Otherwise Icinga 2 will
|
|
bail early on verifying the parsed configuration.
|
|
|
|
Main Configuration
|
|
------------------
|
|
|
|
Starting Icinga 2 requires the main configuration file called "icinga2.conf".
|
|
That's the location where everything is defined or included. Icinga 2 will only
|
|
know the content of that file and included configuration file snippets.
|
|
|
|
----
|
|
# /usr/bin/icinga2 -c /etc/icinga2/icinga2.conf
|
|
----
|
|
|
|
NOTE: You can use just the main configuration file and put everything in there.
|
|
Though that is not advised because configuration may be expanded over time.
|
|
Rather organize runtime configuration objects into their own files and/or
|
|
directories and include that in the main configuration file.
|
|
|
|
Configuration Syntax
|
|
--------------------
|
|
|
|
/* TODO */
|
|
|
|
Details on the syntax can be found in the chapter
|
|
icinga2-config-syntax.html[Configuration Syntax]
|
|
|
|
|
|
Configuration Types
|
|
-------------------
|
|
|
|
/* TODO */
|
|
|
|
Details on the available types can be found in the chapter
|
|
icinga2-config-types.html[Configuration Types]
|
|
|
|
|
|
Configuration Templates
|
|
-----------------------
|
|
|
|
Icinga 2 ships with the *Icinga Template Library (ITL)*. This is a set of
|
|
predefined templates and definitions available in your actual configuration.
|
|
|
|
NOTE: Do not change the ITL's files. They will be overridden on upgrade. Submit
|
|
a patch upstream or include your very own configuration snippet.
|
|
|
|
Include the basic ITL set in your main configuration like
|
|
|
|
----
|
|
include <itl/itl.conf>
|
|
----
|
|
|
|
NOTE: Icinga 2 recognizes the ITL's installation path and looks for that
|
|
specific file then.
|
|
|
|
Having Icinga 2 installed in standalone mode make sure to include
|
|
itl/standalone.conf as well (see sample configuration).
|
|
|
|
----
|
|
include <itl/standalone.conf>
|
|
----
|
|
|
|
/* vim: set syntax=asciidoc filetype=asciidoc: */
|