====== NagiosQL  ======

Tutoriel rédigé pour une version de Debien Squeeze (Debian 6).

Dans ce tutoriel, nous aborderons l'installation de NagiosQL depuis les sources, elle recommande une certaine maîtrise de l'utilisation du système Debian.
<note warning>
**ATTENTION :** Nous partons du principe que vous avez une installation de Nagios fonctionnelle.
</note>


Ce tutoriel a été réalisé par :

^ **Rôle**                          ^ **Nom**          ^
| **Rédacteur**                    |    Charles JUDITH    |


==== Pré-requis ====

<code>
$ sudo apt-get install apache2 php5 mysql-server
$ sudo pear install HTML_Template_IT
</code>





Téléchargement de la dernière version de NagiosQL:
<code>
$ sudo wget http://sourceforge.net/projects/nagiosql/files/nagiosql/NagiosQL%203.1.1/nagiosql_311.tar.gz
</code>

Décompression de l'archive:
<code>
$ tar xvf nagiosql_311.tar.gz
</code>

==== Installation de NagiosQL: ====
<code>
$ cp -r nagiosql/ /var/www/
$ chown -R www-data:www-data /var/www/nagiosql
</code>

Création de la base de données:
<code>
$ mysql -u root -p
$ mysql> CREATE DATABASE nagiosql;
$ mysql> quit
</code>

Importation du schéma de la base de données:
<code>
$ mysql -u root -p nagiosql < /var/www/nagiosql/install/sql/nagiosQL_v31_db_mysql.sql
</code>

Dans votre navigateur, entrez l'adresse suivante: 

http://adresse_ip_de_votre_serveur/nagiosql

Vous arriverez sur l'interface d'installation de nagiosQL. Vous pouvez choisir la langue de votre choix en haut à droite, pour passer à l'installation cliquez sur "STAR INSTALLATION".

Vous arriverez sur une deuxième page qui effectue des tests sur les paquets pré-requis à l'installation de nagiosQL.

Si vous avez installé les paquets au début de ce tutoriel, vous n'aurez qu'une seule erreure, la suivante:

suhosin.session.encrypt: 1 (should be 0) 

Pour y remédier, il vous suffit d'éditer votre fichier php.ini et d'y insérer la ligne suivante:
suhosin.session.encrypt=Off

Redémarrez Apache pour que la modification soit pris en compte:
<code>
$ sudo /etc/init.d/apache2 restart
</code>

Rafraichissez votre page web et cliquez sur "Next" ou "Suivant" (cela dépend du langage sélectionné).

Sur la page suivante, vous devrez saisir les informations concernant votre base de données:
<code>
Database Configuration

    MySQL Server ==> IP de votre serveur MySQL
    MySQL Server Port ==> 3306 (par défaut pour MySQL)
    Database name ==> nom de votre base de données, ici nous avons choisis nagiosql
    Administrative MySQL User ==> utilisateur de la BDD
    Administrative MySQL Password ==> mot de passe de l'utilisateur de la BDD
</code>

<note important>Si vous voulez donner les droits à un utilisateurs sur une base de données, voici un exemple:
mysql -u root -p
Entrez le mot de passe root de votre mysql
mysql>GRANT ALL on nagiosql.* TO 'monitor'@'localhost' IDENTIFIED BY 'sonmotdepasse';
mysql>FLUSH PRIVILEGES;
</note>

L'étape suivante vous demandera de supprimer le répertoire d'installation /var/www/nagiosql/install, vous le supprimerez:
<code>
$ sudo rm -rf /var/www/nagiosql/install
</code>

Après vous allez vous rendre sur l'URL http://adresse_ip_de_votre_serveur/nagiosql et vous rencontrerez une erreur 404 (page inexistante).

Vous allez recopier le répertoir d'installation que vous avez copié dans /var/www/nagiosql/install:
<code>
$ sudo cp -r /home/charles/downloads/nagiosql/install /var/www/nagiosql/
<code>

Essayez de vous connecter à nouveau sur l'URL suivante http://adresse_ip_de_votre_serveur/nagiosql puis vous referez les étapes d'installation "Démarrer l'installation" puis "Suivant" puis "Paramètre de la base de données et juste en dessous paramètre de connexion à linterface de NagiosQL". 

Vous validez la fin de l'installation puis vous pouvez dès à présent vous connecter sur votre interface de NagiosQL à l'adresse suivante:

http://adresse_ip_de_votre_serveur/nagiosql