debmon/nagiosql
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Imported Upstream version 3.2.0

Browse Source
This commit is contained in:
Mario Fetka
2017-05-22 11:24:21 +02:00
commit c4f4701ef1
381 changed files with 97590 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
doc/CHANGELOG Executable file
View File

@@ -0,0 +1,23 @@
CHANGELOG 3.2.0
---------------
- [OK] Enable/Disable regardless of register
- [OK] HTML reworking
- [OK] Domain separation (Data / Configuration)
- [OK] Additional user settings
o Language
o Standard domain
- [OK] Better HTML/CSS implementation for IE (scroll fields)
- [OK] Configuration name is stored as free variable inside the configuration file
- [OK] New support page with additional checks
- [OK] New/reworked installer
- [OK] Servicegroup support for servicedependencies and serviceescalations
- [OK][BUG] Reworked service selection in servicedependencies and serviceescalations
- [OK][BUG] Reworked right management (menu access / read rights)
OPEN in 3.2.0
-------------
- YUI3 - YUI3 is still BETA
- Reworking templates for better integration
- Support for different time zones of remote systems (timestamp/file_stamp)
- PosgresQL support (comes with 3.2.x)

110
doc/INSTALLATION_deDE.txt Normal file
View File

@@ -0,0 +1,110 @@
///////////////////////////////////////////////////////////////////////////////
//
// NagiosQL
//
///////////////////////////////////////////////////////////////////////////////
//
// (c) 2008-2012 by Martin Willisegger
//
// Project : NagiosQL
// Component: Installations HowTo
// Website : http://www.nagiosql.org
// Date : $LastChangedDate: 2012-03-12 08:30:07 +0100 (Mon, 12 Mar 2012) $
// Author : $LastChangedBy: martin $
// Version : 3.2.0
// Revision : $LastChangedRevision: 1288 $
// SVN-ID : $Id: INSTALLATION_deDE.txt 1288 2012-03-12 07:30:07Z martin $
//
///////////////////////////////////////////////////////////////////////////////
====================
= Vorraussetzungen =
====================
* Webserver z.B. Apache 2.x
* MySQL 5.x oder neuer
* Nagios 2.x/3.x oder Nagios kompatible Monitoringsoftware
* PHP 5.2.0 oder groesser, inklusive:
* PHP Module: Session
* PHP Module: MySQL
* 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.2 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.2 in ein NEUES Apache zugaenglichen Verzeichnis (DocumentRoot auf neues Verzeichnis
aendern)
b. Wird dieselbe Apachekonfiguration verwendet (altes NagiosQL Verzeichnis wegkopiert, 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.2 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 (http://www.nagiosql.org/forum.html) 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

110
doc/INSTALLATION_enGB.txt Normal file
View File

@@ -0,0 +1,110 @@
///////////////////////////////////////////////////////////////////////////////
//
// NagiosQL
//
///////////////////////////////////////////////////////////////////////////////
//
// (c) 2008-2012 by Martin Willisegger
//
// Project : NagiosQL
// Component: Installation HowTo
// Website : http://www.nagiosql.org
// Date : $LastChangedDate: 2012-03-12 08:30:07 +0100 (Mon, 12 Mar 2012) $
// Author : $LastChangedBy: martin $
// Version : 3.2.0
// Revision : $LastChangedRevision: 1288 $
// SVN-ID : $Id: INSTALLATION_enGB.txt 1288 2012-03-12 07:30:07Z martin $
//
///////////////////////////////////////////////////////////////////////////////
================
= REQUIREMENTS =
================
* Webserver like Apache 2.x
* MySQL 5.x or greater
* Nagios 2.x/3.x or Nagios compatible monitoring software
* PHP 5.2.0 or greater including:
* PHP Module: Session
* PHP Module: MySQL
* 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.2 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.2 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.2 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 http://www.nagiosql.org/forum.html. 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

36
doc/LICENSE Normal file
View File

@@ -0,0 +1,36 @@
NagiosQL License - based on BSD License
Copyright (c) 2005-2012, Martin Willisegger
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software
must display the following acknowledgement:
This product includes software developed by the NagiosQL team - www.nagiosql.org.
4. Neither the name of the NagiosQL team - www.nagiosql.org nor the
names of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE NAGIOSQL TEAM AND THE COPYRIGHT HOLDER ''AS IS'' AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE NAGIOSQL TEAM AND THE COPYRIGHT HOLDER BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Additional conditions for NagiosQL
a) Using NagiosQL bundled with commercial products is only allowed with
explicit approval of the copyright holder.
b) Using the code of NagiosQL to build a "fork" is only allowed with
explicit approval of the copyright holder.

38
doc/LIZENZ Normal file
View File

@@ -0,0 +1,38 @@
Freie Übersetzung der BSD basierenden NagiosQL Lizenz - es gilt die englische Originalversion!
Copyright (c) 2005-2012, Martin Willisegger
Alle Rechte vorbehalten.
Weiterverbreitung und Verwendung in nichtkompilierter oder kompilierter Form, mit oder ohne
Veränderung, sind unter den folgenden Bedingungen zulässig:
1. Weiterverbreitete nichtkompilierte Exemplare müssen das obige Copyright,
diese Liste der Bedingungen und den folgenden Haftungsausschluss im Quelltext enthalten.
2. Weiterverbreitete kompilierte Exemplare müssen das obige Copyright, diese Liste der
Bedingungen und den folgenden Haftungsausschluss in der Dokumentation und/oder anderen
Materialien, die mit dem Exemplar verbreitet werden, enthalten.
3. Alle Werbematerialien, die Eigenschaften oder die Benutzung erwähnen, müssen die folgende
Bemerkung enthalten: „Dieses Produkt enthält Software, die vom NagiosQL Team - www.nagiosql.org
entwickelt wurde.“
4. Weder der Name des vom NagiosQL Team - www.nagiosql.org noch die Namen der Beitragsleistenden
dürfen zum Kennzeichnen oder Bewerben von Produkten, die von dieser Software abgeleitet wurden,
ohne spezielle vorherige schriftliche Genehmigung verwendet werden.
DIESE SOFTWARE WIRD VOM NAGIOSQL TEAM UND DEM RECHTEINHABER SOWIE DEN BEITRAGSLEISTENDEN OHNE
JEGLICHE SPEZIELLE ODER IMPLIZIERTE GARANTIEN ZUR VERFÜGUNG GESTELLT, DIE UNTER ANDEREM EINSCHLIESSEN:
DIE IMPLIZIERTE GARANTIE DER VERWENDBARKEIT DER SOFTWARE FÜR EINEN BESTIMMTEN ZWECK. AUF KEINEN FALL
IST DAS NAGIOSQL TEAM, DER RECHTEINHABER SOWIE DIE BEITRAGSLEISTENDEN FÜR IRGENDWELCHE DIREKTEN,
INDIREKTEN, ZUFÄLLIGEN, SPEZIELLEN, BEISPIELHAFTEN ODER FOLGESCHÄDEN (UNTER ANDEREM VERSCHAFFEN
VON ERSATZGÜTERN ODER -DIENSTLEISTUNGEN; EINSCHRÄNKUNG DER NUTZUNGSFÄHIGKEIT; VERLUST VON NUTZUNGSFÄHIGKEIT;
DATEN; PROFIT ODER GESCHÄFTSUNTERBRECHUNG), WIE AUCH IMMER VERURSACHT UND UNTER WELCHER VERPFLICHTUNG AUCH
IMMER, OB IN VERTRAG, STRIKTER VERPFLICHTUNG ODER UNERLAUBTER HANDLUNG (INKLUSIVE FAHRLÄSSIGKEIT)
VERANTWORTLICH, AUF WELCHEM WEG SIE AUCH IMMER DURCH DIE BENUTZUNG DIESER SOFTWARE ENTSTANDEN SIND,
SOGAR, WENN SIE AUF DIE MÖGLICHKEIT EINES SOLCHEN SCHADENS HINGEWIESEN WORDEN SIND.
Zusätzliche Bedingungen zu NagiosQL
a) Das bündeln von NagiosQL zusammen mit einem kommerziellen Produkt ist nur zulässig
mit ausdrücklicher Genehmigung des Copyright Inhabers.
b) Das Benutzen von Code von NagiosQL mit dem Zweck einen "Fork" zu erstellen ist nur
zulässig mit ausdrücklicher Genehmigung des Copyright Inhabers.

52
doc/README_SSH_KEY Normal file
View File

@@ -0,0 +1,52 @@
To create an ssh key pair for NagiosQL:
=======================================
Remote system:
1. Create an user (like nagiosql_usr)
Local system
2. Create a path for the ssh keys
# mkdir /etc/nagiosql/ssh
2. Create a key pair (only rsa is supported!)
# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa): /etc/nagiosql/ssh/id_rsa
-> empty passphrase!
3. Copy the key on the remote system
# ssh-copy-id -i /etc/nagiosql/ssh/id_rsa/id_rsa.pub nagiosql_usr@remote-system
4. Check the permissions (read access for apache user)
# chown wwwrun /etc/nagiosql/ssh/id_rsa
5. Check the login on the remote system:
# ssh -i /etc/nagiosql/ssh/id_rsa nagiosql_usr@remote-system
-> Login without a password should be possible!
6. In NagiosQL GUI - go to Administration -> Domain and edit the domain data of your remote system:
6.1. Select SSH/SFTP as Method
6.2. Fill in nagiosql_usr as User
6.3. Fill in /etc/nagiosql/ssh/ as Directory of the key pair (without id_rsa)!
Using passwort authentication (not recommended)
===============================================
If you are using ssh2 with user/password - you have to enable PasswordAuthentication in your sshd_config:
PasswordAuthentication yes
Installing SSH2 Module for PHP
==============================
1. Install pecl extension from distribution (probably part of php5-devel)
2. Install libssh2 devel from distribution
3. # pecl install ssh2
or
# pecl install ssh2-beta
(Use predefined values -> return)
4. Add ssh2.so to your php.ini:
extension=ssh2.so