3.1. Konfigurationsüberblick
Zurück | Kapitel 3. Icinga konfigurieren | Weiter

## 3.1. Konfigurationsüberblick

### 3.1.1. Einführung

Es gibt verschiedene Konfigurationsdateien, die Sie erstellen oder editieren müssen, bevor Sie irgendetwas überwachen können. Haben Sie Geduld! Icinga zu konfigurieren kann eine Weile dauern, besonders wenn Sie ein Neuling sind. Sobald Sie herausgefunden haben, wie die Dinge funktionieren, werden Sie feststellen, dass es die Mühe wert ist. :-)

Anmerkung: Beispiel-Konfigurationsdateien werden im /usr/local/icinga/etc/-Verzeichnis installiert, wenn Sie der Schnellstart-Installationsanleitung folgen.

### 3.1.2. Dateinamen

Die Namen und Positionen dieser Konfigurationsdateien können von Ihnen nach Belieben festgelegt werden, aber es hat sich eingebürgert, die Dateien `icinga.cfg`, `resource.cfg` und `cgi.cfg` im Hauptkonfigurationsverzeichnis abzulegen.

Die Namen der Objektdefinitionsdaten können den Typ der Definitionen enthalten (`contacts.cfg, commands.cfg`, `timeperiods.cfg`, `notifications.cfg`), den Typ der Hardware (`printer.cfg`, `switch.cfg`) oder das zu beschreibende Objekt (`localhost.cfg`). Wenn Ihre Installation keine dieser Dateien enthält, dann ist das kein Grund zur Panik. Wenn Sie ein web-basiertes Konfigurations-Tool, ein datenbankgetriebenes Script, oder Ihren bevorzugten Editor benutzen, dann können die Dateien pro geographischer Lage (Land, Filiale, ...) in separaten Verzeichnissen abgelegt sein mit einer Datei pro physischer oder logischer Einheit (Raum, Rack, Applikation, Entwicklung, ...) oder abhängig vom Konzept, das für Sie am besten geeignet ist.

### 3.1.3. Hauptkonfigurationsdatei

Die Hauptkonfigurationsdatei enthält eine Reihe von Direktiven, die die Arbeitsweise des Icinga-Daemon beeinflussen. Diese Konfigurationsdatei wird vom Icinga-Daemon und den CGIs gelesen. Hier werden Sie in Ihr Konfigurationsabenteuer starten wollen.

Dokumentation zur Hauptkonfigurationsdatei finden Sie hier.

### 3.1.4. Ressource-Datei(en)

Ressource-Dateien können zur Speicherung von benutzerdefinierten Makros genutzt werden. Der Hauptgrund für Ressource-Dateien liegt darin, dass sie genutzt werden können, um sensible Informationen (wie z.B. Passworte) zu speichern, ohne dass sie für CGIs zugänglich sind, weil diese Dateien nicht von den CGIs gelesen werden.

Sie können eine oder mehrere optionale Ressource-Dateien mit Hilfe der resource_file-Direktive in Ihrer Hauptkonfigurationsdatei angeben.

### 3.1.5. Objektdefinitionen-Dateien

Objektdefinitionen-Dateien werden genutzt, um Hosts, Services, Hostgruppen, Kontakte, Kontaktgruppen, Befehle usw. zu definieren. Hier definieren Sie, welche Dinge Sie überwachen wollen und wie Sie diese überwachen wollen.

Sie können eine oder mehrere Objektdefinitionen-Dateien mit Hilfe der cfg_file- und/oder cfg_dir-Direktiven in Ihrer Hauptkonfigurationsdatei angeben, aber es wird empfohlen lediglich eine der beiden Direktiventypen zu nutzen (also entweder cfg_dir oder cfg_file bis Sie die Auswirkungen verstanden haben, wenn Sie beide gleichzeitig verwenden).

Eine Einführung zu Objektdefinitionen und wie sie in Beziehung zu einander stehen, finden Sie hier.

Ihre Objektkonfigurationsdateien können wiederum andere Dateien einschließen mit Hilfe der include_file- oder include_dir-Direktiven. Sie können lediglich außerhalb der eigentlichen Objektdefinitionen auftreten und verhalten sich analog zu den cfg_file=- und cfg_dir=-Direktiven in der Hauptkonfigurationsdatei.

### 3.1.6. CGI-Konfigurationsdatei

Die CGI-Konfigurationsdatei enthält eine Reihe von Direktiven, die die Arbeitsweise der CGIs beeinflussen. Sie enthält auch einen Verweis auf die Hauptkonfigurationsdatei, so dass die CGIs wissen, wie Sie Icinga konfiguriert haben und wo Ihre Objektdefinitionen gespeichert sind.

Dokumentation zur CGI-Konfigurationsdatei finden Sie hier.

Zurück | Nach oben | Weiter
Kapitel 3. Icinga konfigurieren | Zum Anfang | 3.2. Optionen der Hauptkonfigurationsdatei

© 2009-2013 Icinga Development Team, http://www.icinga.org