Session Cookie Lifetime

instance: Nur "instance" ist als Unterelement zulässig. Dieser Knoten ordnet einem Host (s.u.) einen Instanznamen zu, der durch den Wert des Attributs "name" festgelegt ist:

 <instance name="%icinga instance name%">%host name%</instance>

defaultHost: definiert den Host, der für Aktionen benutzt wird, wenn kein Host angegeben ist. Dies nur für einige Module wichtig und es betrifft nicht Icinga-Webs Standardleistungsumfang.

 <defaultHost>localhost</defaultHost>

Der Host muss im hosts-Abschnitt definiert werden.

access: Icinga-Web (und Module, wenn sie korrekt geschrieben sind) greifen nicht direkt auf System-Ressourcen zu, sondern über ein Console-Interface, das sich um die Sicherheit kümmert. Im Zugriffsabschnitt definieren Sie, welche System-Ressources von dieser Behandlungsroutine aufgerufen werden dürfen und wo sie sich befinden. Außerdem geben Sie System-Ressourcen einen Ressourcen-Namen. Der Console-Handler bspw. greift auf die Icinga-Pipe nur über den Ressource-Namen "icinga_pipe" zu.

Der Zugriffsabschnitt hat vier zulässige Unterelemente: 'readwrite', 'read', 'write' und 'execute', die die Zugriffsebene für darunterliegende Ressourcen definieren. Ressourcen selbst werden unter den Tags 'folders' oder 'files' definiert und mit 'resource' eingeschlossen: Das folgende Beispiel erlaubt Schreib-/Lesezugriff auf Icingas objects-Ordner. Schreiben, Lesen und Ausführen funktionieren analog, das 'readwrite'-Tag wird jeweils durch das entsprechende Tag ausgetauscht.

host: definiert einen einzelnen Host und gibt ihm einen Namen, der benutzt werden kann, um auf diesen Host zu referenzieren (wie z.B. im "instance"-Abschnitt).

 <!-- Example for ssh connection with user/password auth -->
 <host name="vm_host1">
    <type>ssh</type>
    <ssh-config>
       <host>localhost</host>
       <port>22</port>
       <auth>
          <type>password</type>
          <user>john_doe</user>
          <password>foobar</password>
       </auth>
    </ssh-config>

    <access useDefaults="true" />
 </host>

Das 'host'-Tag hat eine Reihe von Unterelementen:

type: Entweder "local" oder "ssh". Definiert, ob Befehl direkt auf der Maschine ausgeführt werden, auf der Icinga-Web läuft, oder via ssh.

access: sh. den "access"-Abschnitt weiter oben. Zusätzlich kann 'useDefaults' gesetzt werden, um dem Command-Interface mitzuteilen, dass alle Standardzugriffsdefinitionen benutzt werden sollen (wenn sie nicht in diesem Abschnitt überschrieben werden).

ssh-config: (nur falls type:ssh) Dies legt fest, wie auf den Host per ssh zugegriffen werden soll. Es gibt drei Authentifizierungsmethoden für ssh: 'none', 'password' oder 'key', die im folgenden Abschnitt erläutert werden. Unabhängig davon, welche Methode Sie wählen, müssen die 'host'- und 'port'-Einträge für jeden Host gesetzt werden.

Auth type: none

Dies teilt der Console-Verbindung mit, dass nur ein Benutzername für die Authentifizierung verwendet wird:

 <ssh-config>
    <host>localhost</host>
    <port>22</port>
    <auth>
       <type>none</type>
       <user>john_doe</user>
    </auth>
 </ssh-config>

In diesem Beispiel wird nur der Benutzername 'john_doe' für die Authentifizierung geliefert. Dies kann sinnvoll sein, wenn Ihre Maschinen automatische Schlüssel-Authentifizierung benutzen.

Auth type: password

Dies teilt der Console-Verbindung mit, dass Benutzername und Passwort für die Authentifizierung verwendet werden:

 <ssh-config>
    <host>localhost</host>
    <port>22</port>
    <auth>
       <type>password</type>
       <user>john_doe</user>
       <password>foobar</password>
    </auth>
 </ssh-config>

In diesem Beispiel werden nur der Benutzername 'john_doe' und das Passwort 'foobar' für die Authentifizierung verwendet.

Auth type: key

	Wichtig
	Experimentell! Probieren Sie es aus und öffnen Sie ein Ticket, wenn Sie Probleme haben!

Dies teilt der Console-Verbindung mit, eine Schlüsseldatei für die Authentifizierung zu benutzen, die optional mit einem Password geschützt ist

 <ssh-config>
    <host>localhost</host>
    <port>22</port>
    <auth>
       <type>key</type>
       <user>testuser</user>
       <private-key>/usr/local/icinga-web/app/modules/Api/lib/.ssh/host1_rsa</private-key>
       <password>secret123</password>
    </auth>
 </ssh-config>

Hier wird der private Schlüssel benutzt, der im 'private-key'-Tag definiert wird. Sie sollten und müssen diesen Pfad nicht im host-Zugriffsabschnitt definieren!

Datenbank-Identifier

<db:database name="%Database name%" class="%Handler%">
   ...
</db:database>

Mit dem db:database-Tag informieren Sie Icinga Web, dass es sich um eine Datenbankdefinition handelt. Dieses Tag muss zwei Attribute haben:

dsn (Data Source Name):

Definiert die Anmeldeinformationen, den Typ und Standort der Datenbank:

Für MySQL, PostgreSQL und Oracle:

<db:database ...>
    ...
    <ae:parameter name="dsn">%driver%://%username%:%password%@%host%:%port%/%database name%</ae:parameter>
    ...
</db:database>

Für sqlite3:

<db:database ...>
    ...
    <ae:parameter name="dsn">sqlite:///%path to your db file%</ae:parameter>
    ...
</db:database>

	Anmerkung
	SQLite-Datenbanken müssen für den Webserver-Benutzern les- und beschreibbar sein, außerdem das Verzeichnis, in dem sich die Datei befindet.

charset

<db:database ...>
    ...
    <ae:parameter name="charset">utf8</ae:parameter>
    ...
</db:database>

Im Allgemeinen sollte Ihr Datenbank-Zeichensatz utf8 sein.

manager_attributes, load_models, models_directory

<db:database ...>
    ...
    <ae:parameter name="manager_attributes">
        <ae:parameter name="Doctrine_Core::ATTR_MODEL_LOADING">CONSERVATIVE</ae:parameter>
    </ae:parameter>
    ...
</db:database>

Sie können beruhigt diesen Abschnitt ignorieren und ihn einfach kopieren. Er enthält lediglich Doctrine-spezifische Einstellungen (insbesondere wie Datenbankmodelle geladen werden und wo sie zu finden sind. Wenn Sie mehr wissen möchten, dann schauen Sie in die doctrine documentation).

date_formate

Dies ist erforderlich, um sauber auf Oracle-Datenbanken zuzugreifen. Es setzt das für die Datenbank zu benutzende Datumsformat.

<db:database ...>
    ...
    <ae:parameter name="date_format"><![CDATA[YYYY-MM-DD HH24:MI:SS]]></ae:parameter>
    ...
</db:database>

Caching

<db:database ...>
    ...
    <ae:parameter name="caching">
        <ae:parameter name="enabled">false</ae:parameter>
        <ae:parameter name="driver">apc</ae:parameter>
        <ae:parameter name="use_query_cache">true</ae:parameter>
        <ae:parameter name="use_result_cache">true</ae:parameter>
        <ae:parameter name="result_cache_lifespan">60</ae:parameter>
    </ae:parameter>
<db:database>

Wenn Sie apc oder memcache benutzen, dann können Sie entweder Datenbankabfragen oder -ergebnisse zwischenspeichern. Während das Zwischenspeichern von Abfragen eigentlich nie eine schlechte Sache ist (solange Sie nicht entwickeln), ist das Zwischenspeichern von Ergebnissen ein ziemlich spezieller Fall - denn Sie könnten veraltete Daten aus Ihrer Datenbank bekommen. Also benutzen Sie es bitte nie für Ihre Icinga-Datenbank!

Datenbank-Identifier

Der Icinga-Datenbank-Identifier muss "IcingaDoctrineDatabase" als 'class'-Attribut und 'icinga' als Datenbankname benutzen, also:

<db:database name="icinga" class="IcingaDoctrineDatabase">
...
</db:database>

dsn

Sie können die gleichen Anmeldeinformationen wie in der ido2db.cfg benutzen, aber als Sicherheitsgründen ist es sehr ratsam, einen Benutzer nur mit Leserechten für Icinga-Web anzulegen. Nachfolgend ein Beispiel, welche Werte aus der ido2db.cfg passen.

    <ae:parameter name="dsn">mysql://db_user:db_pass@db_host:db_port/db_name</ae:parameter>

prefix

Definiert den Präfix wie in ido2db.cfg angegeben

<db:database name="icinga" class="IcingaDoctrineDatabase">
...
    <ae:parameter name="prefix">icinga_</ae:parameter>
...
</db:database>

Für Oracle benutzen Sie einen leeren Wert

<db:database name="icinga" class="IcingaDoctrineDatabase">
...
    <ae:parameter name="prefix"></ae:parameter>
...
</db:database>

use_retained

Whether to use retained or original data dumps (see the value in idomod.cfg)

<db:database name="icinga" class="IcingaDoctrineDatabase">
...
     <ae:parameter name="use_retained">true</ae:parameter>
</db:database>