== Nutzungshinweise zu Icinga2 ==

{{{Icinga2}}} ist der vom Projekt IT-Zukunft-Schule verwendete Monitoring-Service zur Fernüberwachung der System an Projektstandorten.

=== Einbinden von Icinga2-Nodes ===

Auf dem einzubindenden {{{Host-System}}} per SSH anmelden.

{{{Icinga2}}} installieren

{{{
sudo apt-get install icinga2
}}}

und dann den {{{Icinga2 Node Wizard}}} starten

{{{
sudo icinga2 node wizard
}}}

Der {{{Icinga2 Node Wizard}}} wird nun die nötigen Informationen abfragen, um die Verbindung zum {{{Icinga2 Master}}} herzustellen.

Die zu tätigenden Eingaben sind immer in der Zeile unter der Abfrage eingerückt dargestellt.

{{{
Please specify if this is a satellite setup ('n' installs a master setup) [Y/n]:
 y
Please specify the common name (CN) [<jetziger CN der Maschine>]: 
 <HOST>.<SCHULE> 
Master Common Name (CN from your master setup):
 monitoring.itzks
Do you want to establish a connection to the master from this node? [Y/n]: 
 y
Please fill out the master connection information:
Master endpoint host (Your master's IP address or FQDN): 
 monitoring.itzks
Master endpoint port [5665]: 
[Enter]
Add more master endpoints? [y/N]: 
 N
Please specify the master connection for CSR auto-signing (defaults to master endpoint host):
Host [monitoring.itzks]: 
 [Enter]
Port [5665]: 
 [Enter]
}}}

Nun wird der {{{Icinga2 Node Wizard}}} versuchen, eine Verbindung zum {{{Icinga2 Master}}} herzustellen.
Ist dies erfolgreich, werden die {{{Zertifikat Informationen}}} des {{{Icinga2 Masters}}} zur Überprüfung dargestellt und die Abfrage 

{{{
Is this information correct [y/N]:
}}} 

folgt.

Sind die Informationen korrekt und werden bestätigt, folgt nur eine Abfrage 

{{{
Please specify the request ticket generated on your Icinga2 Master.
}}}

Nun in einem weiteren Terminal per SSH auf dem {{{vidar}}} einloggen und sich mit 

{{{
sudo icinga2 pki ticket --cn '<HOST>.<SCHULE>'
}}}

die vom System generierte Zeichenfolge anzeigen lassen.
Diese kopieren und als Antwort auf die Abfrage einfügen.

Weitere Abfragen folgen.

Die zu tätigenden Eingaben sind immer in der Zeile unter der Abfrage eingerückt dargestellt.

{{{
Please specify the API bin host/port (optional):
Bind Host []:
 [Enter]
Bind Port []:
 [Enter]
Accept config from master [y/N]:
 y
Accept commands from master [y/N]:
 y
}}}

Danach Icinga2 auf dem Node neu starten

{{{
sudo invoke-rc.d icinga2 restart
}}}

und auf dem {{{vidar}}} nach einiger Zeit mittels

{{{
sudo icinga2 node update-config
sudo invoke-rc.d icinga2 restart
}}}

den neuen Node einbinden. 

'''Hinweis:''' Dieses Vorgehen wird in der nächsten größeren Version von Icinga2 nicht mehr aktuell sein.

=== Austragen von Icinga2-Nodes ===

Auf {{{vidar}}} (hier läuft der {{{Icinga2}}}-Master) per SSH einloggen.

Zuerst per 

{{{
sudo icinga2 node remove <Names des Satellites; meist <HOST>.<SCHULE>>
}}}

den Node/Satellite aus Icinga2-Überwachung entfernen.

'''Hinweis:''' Nach dem Entfernen wird allerdings eventuell immer noch in der Icinga2 WebGUI der Node/Satellite als "nicht verbunden" angezeigt.

Zum vollständigen Austragen von {{{host}}} und {{{endpoint}}} diese Änderungen vormerken (Icinga2 regelt so etwas über ein internes commit-System)

{{{
sudo icinga2 repository host remove name=<Names des Hosts>
sudo icinga2 repository endpoint remove name=<Name des Endpoints>
}}}

Dann die vorgemerkten Änderungen durchführen

{{{
sudo icinga2 repository commit
}}}

Icinga2 neu starten

{{{
sudo invoke-rc.d icinga2 restart
}}}