mirror of https://github.com/Icinga/icinga2.git
77 lines
2.2 KiB
Markdown
77 lines
2.2 KiB
Markdown
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: \*/
|