nagiosql/doc/INSTALLATION_enGB.txt

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

================
= REQUIREMENTS =
================

  * Webserver like Apache 2.x
  * MySQL/MariaDB 5.x or greater
  * Nagios 2.x/3.x/4.x or Nagios compatible monitoring software
  * PHP 5.5.0 or greater including:
    * PHP Module: Session
    * PHP Module: MySQLi
    * PHP Module: gettext
    * PHP Module: filter
    * PHP Module: FTP (optional)
    * PECL Extension: SSH (optional)
  * Javascript activated in Webbrowser
  * Recommended Webbrowser: Mozilla Firefox

================
NEW INSTALLATION
================

  1. Download and extract NagiosQL 3.4 to a directory within your Apache Document Root
  2. Start the Installation Wizard by opening install/index.php
  3. Switch to your preferred language (see Appendix 1.)
  4. Follow the instructions to install NagiosQL

================
=== UPGRADES ===
================

  1. Upgrade from NagiosQL 1.x and 2.x are not possible, you should better start at "New Installation" and after the installation is done,
     import Nagios configuration files with NagiosQL
  2. Upgrade from NagiosQL 3.x
    a. Download and extract NagiosQL 3.4 to a NEW directory and change your Apache DocumentRoot to the new directory
	b. If the same Apache configuration is used (old NagiosQL directory moved away and new NagiosQL directory moved to the old
	   DocumentRoot), you should restart the apache demon before upgrade
    b. Move your old config/settings.php file to the new NagiosQL 3.4 config/ folder
	c. Backup your old NagiosQL database (as example with mysqldump)
    d. Start the Installation Wizard by opening install/index.php
    e. Switch to your preferred language (see Appendix) and follow the instructions


=================
= CONFIGURATION =
=================
  1. NagiosQL
    a. Login to your new installed NagiosQL
    b. Verify automatically detected settings at Administration => Settings
    c. Configure your Nagios Installation at Administration => Domains
  2. Nagios
    a. Verify that the webserver user has sufficent permission to the required Nagios directories. You could check that, if you execute "nagios -v" as the webserver user.
    b. Verify that all required directories and files (defined in 1.c "Configuration") exists and have sufficent permissions for the webserver user
    c. Replace all existing cfg_dir and cfg_file definitions in nagios.cfg by:
    
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/timeperiods.cfg
          
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/commands.cfg
          
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/contacts.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/contactgroups.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/contacttemplates.cfg

          cfg_dir=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/hosts
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/hosttemplates.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/hostgroups.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/hostextinfo.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/hostescalations.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/hostdependencies.cfg          
                    
          cfg_dir=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/services
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/servicetemplates.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/servicegroups.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/serviceextinfo.cfg          
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/serviceescalations.cfg
          cfg_file=<BASE DIRECTORY DEFINED IN DOMAIN CONFIGURATION/servicedependencies.cfg

================
==== Checks ====
================
After installation - go to administration - support and check your installation. This page shows the most common errors.   

================
=== PROBLEMS ===
================
There are currently no known issues. If you having questions, please visit our forum https://sourceforge.net/projects/nagiosql/. If you probably found a bug, please help us and open a new bug report at http://dev.nagigosql.org

================
=== APPENDIX ===
================
  1. To enable multilanguage support, you must have the encoding installed in your locales, e.g. en_GB.utf8. If you want to see which encodings your system provides, try "locale -a".
  2. If you have problems with language presentation or lack of translation during installation, an apache restart may help