nagiosql/doc/INSTALLATION_deDE.txt

///////////////////////////////////////////////////////////////////////////////
//
// NagiosQL
//
///////////////////////////////////////////////////////////////////////////////
//
// (c) 2005-2018 by Martin Willisegger
//
// Project   : NagiosQL
// Component : Installations HowTo
// Website   : https://sourceforge.net/projects/nagiosql/
// Version   : 3.4.0
// GIT Repo  : https://gitlab.com/wizonet/NagiosQL
//
///////////////////////////////////////////////////////////////////////////////

====================
= Vorraussetzungen =
====================

  * Webserver z.B. Apache 2.x
  * MySQL/MariaDB 5.x oder neuer
  * Nagios 2.x/3.x/4.x oder Nagios kompatible Monitoringsoftware
	* PHP 5.5.0 oder groesser, inklusive:
    * PHP Module: Session
    * PHP Module: MySQLi
    * PHP Module: gettext
    * PHP Module: filter
    * PHP Module: FTP (optional)
    * PECL Erweiterung: SSH (optional)
  * Javascript im Webbrowser zugelassen
  * Empfohlener Webbrowser: Mozilla Firefox

===================
= Neuinstallation =
===================

  1. Download und entpacken von NagiosQL 3.4 in einem Apache zugaenglichen Verzeichnis.
  2. Der Installationsassistent wird automatisch durch Eingabe von install/index.php gestartet.
  3. Die gewuenschte Sprache auswaehlen (siehe Appendix 2.)
  4. Zum Installieren von NagiosQL den Anweisungen folgen.

==================
= AKTUALISIERUNG =
==================

  1. Aktualisierungen von NagiosQL 1.x und 2.x sind leider nicht moeglich, bitte einfach eine neue Installation starten und
     dann die Nagios Konfiguration durch den Import einbinden.
  2. Aktualisierungen von NagiosQL 3.x
    a. Download und entpacken von NagiosQL 3.4 in ein NEUES Apache zugaenglichen Verzeichnis (DocumentRoot auf neues Verzeichnis
	   aendern)
	b. Wird dieselbe Apachekonfiguration verwendet (altes NagiosQL Verzeichnis wegkopieren, neues NagiosQL Verzeichnis bekommt
	   denselben Namen), sollte der Apache Demon vor dem Upgrade neu gestartet werden.
    c. Verschiebe die alte config/settings.php Datei in das neue NagiosQL 3.4 Verzeichnis config/
	d. Die alte Datenbank manuell sichern (z.Bsp. mit mysqldump)
    e. Der Installationsassistent wird durch den Aufruf von install/index.php gestartet
    f. Die gewuenschte Sprache waehlen (siehe auch Appendix 1.) und den Anweisungen folgen

=================
= Konfiguration =
=================
  1. NagiosQL
      a. Loggen Sie sich in Ihre neue NagiosQL Installation ein.
      b. Ueberpruefen Sie die automatisch gesetzten Einstellungen unter: Administration => Einstellungen
      c. Konfigurieren Sie die individuellen Nagios Einstellungen unter: Administration => Domains
  2. Nagios
    a. Ueberpruefen Sie, dass der Webserver Benutzer die Berechtigungen besitzt, die Nagios Ordner zu lesen und ggf. zu schreiben. Zum Testen "nagios -v" als Webserver Benutzer ausfuehren.
       Tip: Den Webserver Benutzer der Gruppe Nagios zufuegen und der Gruppe die noetigen Rechte geben.
    b. Aendern Sie alle "cfg_dir" und "cfg_file" Definitionen in der "nagios.cfg" wie folgt:

          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/timeperiods.cfg
          
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/commands.cfg
          
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/contacts.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/contactgroups.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/contacttemplates.cfg

          cfg_dir=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/hosts
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/hosttemplates.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/hostgroups.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/hostextinfo.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/hostescalations.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/hostdependencies.cfg          
                    
          cfg_dir=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/services
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/servicetemplates.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/servicegroups.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/serviceextinfo.cfg          
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/serviceescalations.cfg
          cfg_file=<BASISORDNER WIE IN DER DOMAINKONFIGURATION>/servicedependencies.cfg

================
==== Pruefen ====
================
Oeffnen Sie nach erfolgter Installation die Support Seite unter Administration um die Installation zu pruefen und allfaellige Korrekturen festzustellen.                
				      
================
=== Probleme ===
================
Zur Zeit gibt es keine bekannten Probleme. Support erreicht man ueber das Forum (https://sourceforge.net/projects/nagiosql/) oder fuer Programmfehler den Bugtracker (http://dev.nagigosql.org)

================
=== APPENDIX ===
================
  1. Zum Umstellen der Sprache muss das gewuenschte Encoding in den locales verfuegbar sein, z.B. de_DE.utf8. Das laesst sich an der Console ueber den Aufruf von "locale -a" herausfinden.
  2. Bei Problemen mit der Sprachdarstellung oder fehlender Uebersetzung waehrend der Installation kann ein Apache Restart helfen