From: Gunnar Beutner <gunnar.beutner@netways.de>
Date: Tue, 25 Sep 2012 11:46:28 +0000 (+0200)
Subject: Added documentation for the example config file.
X-Git-Tag: v0.0.1~72^2~1
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8c491cb54543ea9b94606d9349cd23cc58f45615;p=icinga2

Added documentation for the example config file.
---

diff --git a/icinga-app/config/icinga2.conf.dist b/icinga-app/config/icinga2.conf.dist
index a60477b95..07f1022a6 100644
--- a/icinga-app/config/icinga2.conf.dist
+++ b/icinga-app/config/icinga2.conf.dist
@@ -1,29 +1,59 @@
-local object IcingaApplication "icinga" {
+/**
+ * Icinga 2 configuration file
+ * - this is where you define settings for the Icinga application including
+ * which hosts/services to check.
+ *
+ * The docs/icinga2-config.txt file in the source tarball has a detailed
+ * description of what configuration options are available.
+ */
 
+/**
+ * Global configuration settings
+ */
+local object IcingaApplication "icinga" {
+  macros = {
+    plugindir = "/usr/lib/nagios/plugins"
+  }
 }
 
+/**
+ * The checker component takes care of executing service checks.
+ */
 local object Component "checker" {
 
 }
 
+/**
+ * The delegation component assigns services to checkers. You need to load
+ * this component even if your Icinga setup only consists of a single instance.
+ */
 local object Component "delegation" {
 
 }
 
+/**
+ * The compat component periodically updates the status.dat and objects.cache
+ * files. These are used by the Icinga 1.x CGIs to display the state of
+ * hosts and services.
+ */
 local object Component "compat" {
 
 }
 
+/**
+ * This template defines some basic parameters for services that use
+ * external plugins for their checks.
+ */
 abstract object Service "nagios-service" {
   methods = {
     check = "native::PluginCheck"
-  },
-
-  macros = {
-    plugindir = "/usr/lib/nagios/plugins"
   }
 }
 
+/**
+ * The service template for ping checks. In an Icinga 1.x environment
+ * this would be defined as a check command.
+ */
 abstract object Service "ping" inherits "nagios-service" {
   check_command = "$plugindir$/check_ping -H $address$ -w $wrta$,$wpl$% -c $crta$,$cpl$%",
 
@@ -35,6 +65,9 @@ abstract object Service "ping" inherits "nagios-service" {
   }
 }
 
+/**
+ * And finally we define some host that should be checked.
+ */
 object Host "localhost" {
   services = { "ping" },