====== Nagios installieren ======

Diese Howto beschreibt, wie man [[http://www.nagios.org/|Nagios]] auf seinem Server installiert. Nagios ist ein Tool, mit dem man Hosts und Services überwachen kann - sprich: Prüfen, ob alles läuft...

Diese Anleitung gilt für Debian 5.0 (Lenny). Wer noch Debian 4.0 (Etch) verwendet, für den gilt diese Anleitung ebenfalls. Es muss jedoch **zwingend** anstelle von "nagios3" lediglich "nagios2" verwendet werden, da in etch die neue Nagios-Version nicht mit dabei ist.

===== 1. Installation des Nagios-Pakets =====

Zunächst muss man das Paket "nagios3" installieren:

  # apt-get update && apt-get install nagios3

===== 2. Notwendige Dateien und Ordner für das Webinterface erstellen =====

Die Standard-Konfigurationsdatei von Nagios für den Apache-Webserver kann unter ispCP nicht eingesetzt werden, weil hier alle Webseiten unter dem Pfad /var/www liegen müssen.

Daher muss man zunächst dort ein Verzeichnis erstellen, **/var/www/nagios** und den Inhalt des Verzeichnisses /usr/share/nagios2/htdocs dort hinein kopieren:

  # mkdir -p /var/www/nagios/htdocs
  # cp -R /usr/share/nagios3/htdocs/* /var/www/nagios/htdocs/

Dieses Verzeichnis muss als Besitzer den User www-data haben:

  # chown -R www-data.www-data /var/www/nagios

Jetzt kann die Apache-Konfigurationsdatei '''/etc/apache2/sites-available/nagios3.conf''' mit dem folgenden Inhalt erstellt werden:

  #
  # nagios Virtual Host Webinterface
  #
  
  <VirtualHost xxx.xxx.xxx.xxx:80>                       <-- hier muss die Server-IP angegeben werden
          ServerAdmin     admin@yourdomain.com           <-- hier deine E-Mail-Adresse
          DocumentRoot    /var/www/nagios/htdocs
  
          ServerName      nagios.yourdomain.com          <-- hier deine Domain
  
          ErrorLog        /var/log/apache2/nagios.yourdomain.com-error.log  <-- dito
          CustomLog       /var/log/apache2/nagios.yourdomain.com-access.log combined  <-- dito
  
          ScriptAlias /cgi-bin/nagios3 /var/www/nagios/cgi-bin
          ScriptAlias /nagios2/cgi-bin /var/www/nagios/cgi-bin
  
          <Directory /var/www/nagios>
                  Options FollowSymLinks
  
                  DirectoryIndex index.html
  
                  AllowOverride AuthConfig
                  Order Allow,Deny
                  Allow From All
  
                  AuthName "Nagios Access"
                  AuthType Basic
                  AuthUserFile /etc/nagios3/htpasswd.users
                  require valid-user
          </Directory>
  
          <Directory "/usr/lib/cgi-bin/nagios3">
                  Options ExecCGI
  
                  AllowOverride None
                  Order allow,deny
                  Allow from all
  
                  AuthName "Nagios Access"
                  AuthType Basic
                  AuthUserFile /etc/nagios2/htpasswd.users
                  Require valid-user
          </Directory>
  
  </VirtualHost>

Diese Konfiguration muss noch aktiviert werden:

  # a2ensite nagios3.conf

Um eine Subdomain wie //nagios.yourdomain.com// verwenden zu können muss noch die Dateien **/etc/apache2/sites-available/ispcp.conf** und **/etc/ispcp/apache/working/ispcp.conf** bearbeitet werden. Im VHost-Abschnitt für //yourdomain.com// muss in folgender Zeile das //*.yourdomain.com// gelöscht werden:

  ServerAlias     www.yourdomain.com yourdomain.com *.yourdomain.com

Abschließend muss noch der Apache-Server angewiesen werden, die Konfiguration neu zu laden:

  # /etc/init.d/apache2 reload

===== 3. Nagios-Konfigurationsdateien anpassen =====

In der Datei **/etc/nagios3/cgi.cfg** müssen jetzt noch die Werte für //physical_html_path// und //url_html_path// wie folgt geändert werden:

  physical_html_path=/var/www/nagios/htdocs
  url_html_path=/

===== 4. Passwortschutz-Datei erstellen =====

Nun muss eine Passwort-Datei für Nagios erstellt und unter /etc/nagios3/htpasswd.users abgelegt werden:

# htpasswd -c /etc/nagios3/htpasswd.users nagiosadmin
New password:
Re-type new password:

===== 5. Fertig =====

Das war schon alles - unter [[http://nagios.yourdomain.com]] müsste jetzt das Webinterface von Nagios erscheinen in das man sich mit dem Benutzernamen **nagiosadmin** und dem oben angegebenen Passwort einloggen kann.

Die Konfiguration von Nagios selbst wird im Verzeichnis /etc/nagios3/ vorgenommen, die Nagios-Dokumentation ist hier zu finden: [[http://nagios.sourceforge.net/docs/3_0/]]