Documentation et architecture du logiciel

INTERFACE GRAPHIQUE

1.INSTALLATION:
Actuellement, l’installation de l’interface graphique ne peut être réalisée qu’à partir des packages dédiés à certaines distributions Linux car je n’ai pas eu le temps de finir le script qui permettrait d’installer l’interface graphique à partir des sources du logiciels.
De plus, l’installation ne pourra être réalisée qu’après avoir satisfait les pré-requis suivants:
-IDE Langage Gambas v1.0.x (tous les packages sont nécessaires)
-RRDtool v1.x
-SNMP commandes
-SSHPASS
Rappel des commandes d’installation:
Package RPM
rpm -ivh <nom du fichier .rpm>
Package Debian
dpkg -i <nom du fichier package>

Répertoire d’installation:

Par défaut, l’interface graphique gbRRDGraphix s’installe dans le répertoire:

/opt/Monitoring/gbRRDGraphix

Fichier de configuration: /opt/Monitoring/gbRRDGraphix/gbrrdgraphix.ini

2.CONFIGURATION:

Il n’est pas nécessaire de modifier le fichier de configuration manuellement au premier lancement de l’interface. Si au démarrage de l’application, une commande nécessaire est manquante, une fenêtre s’affichera pour vous en informer. Une fois l’application démarrée, il est recommandé de vérifier dans le Panneau des Préférences, accessible par le menu, si l’interface est bien configurée.
Par contre, si vous avez installé certains des composants requis, ailleurs que dans les répertoires habituels vous serez peut être obliger de le modifier à la main. Dans ce cas, respecter bien la syntaxe de ce fichier.

3.UTILISATION:

ORDONNANCEUR (Updated):

4.INSTALLATION:
A ce jour, comme pour l’installation de l’interface graphique, seuls les packages dédiés à certaines distributions Linux sont disponible pour pouvoir installer l’Ordonnanceur car je n’ai pas eu le temps de finir le script qui permettrait d’installer celui-ci à partir des sources du logiciels.
L’installation ne pourra être réalisée qu’après avoir satisfait les pré-requis suivants:
-RRDtool v1.x (commande ‘rrdtool update’)
-SNMP commandes (commande ‘snmpget’)
Rappel des commandes d’installation:

Cf Installation Interface Graphique

Répertoire d’installation:

Par défaut, l’Ordonnanceur ‘Updated’ s’installe dans le répertoire:

/opt/Monitoring/Updated

Fichier de configuration: /opt/Monitoring/Updated/Updated.conf

Démarrage du service: /etc/init.d/UpdatedScheduler start

Arrêt du service: /etc/init.d/UpdatedScheduler stop

5.CONFIGURATION:

Le fichier de configuration contient la liste de toutes les requêtes à traiter par l’Ordonnanceur.
Vous pouvez le configurer soit manuellement en respectant bien la syntaxe décrite en entête du fichier, soit par l’interface graphique, dans la partie réservée à cela (Cf Onglet Gestion de l’Ordonnanceur).

Pour l’instant, seules les requêtes SNMP sont autorisée au travers de l’Ordonnanceur, mais plus tard il sera possible de mettre a jour les base de données ‘rrdtool’ par des scripts Unix ou par connexion sur des machines distantes par protocole SSH.

6.UTILISATION:

SITE WEB:

7.INSTALLATION:
L’installation du l’interface Web est relativement facile et se résume à déposer un répertoire contenant l’ensemble des fichiers du site Web.
Le site Web est développé principalement pour fonctionner avec Apache HTTP Server mais a priori vous pouvez utiliser d’autres serveurs Web (gérant les CGI scripts).
Si vous rencontrez des difficultées lors de l’utilisation de l’Interface Web avec un serveur Web particulier, n’hésitez pas à m’en informer afin que je puisse vous aidez.
Il est possible d’installer plusieurs sites Web sur la même machine, simplememt par copie du répertoire d’origine vers un autre répertoire de votre choix.
Le nombre de Site Web n’est pas limité. Par contre le répertoire contenant les scripts CGI est commun à tous les Sites Web et n’est donc pas besoin d’être dupliqué a chaque fois.
Donc, voici les pré-requis nécessaires:
-Apache HTTP Serveur ou Serveur Web (+ CGI scripts)

Répertoire d’installation:

Par défaut, l’Interface Web s’installe dans le répertoire:

/opt/Monitoring/www

Fichier de configuration: /opt/Monitoring/www/configuration_web

Scripts CGI: /opt/Monitoring/cgi-bin/

Fichiers Site Web: /opt/Monitoring/html/Web/ (Répertoire à copier pour avoir plusieurs

Site Web)

Fichier Login/Password pour Site Web: /opt/Monitoring/html/Web/config/.passwdaccess

Par défaut:

Password: admin

Fichier pour générer des password:

/opt/Monitoring/html/Web/config/passwordgenerate.pl

8.CONFIGURATION:

Le fichier de configuration ‘configuration_web.conf’ doit être placé dans le répertoire du serveur HTTP Apache (ou autres serveur HTTP).
La configuration des fichiers du Site Web se réalise grâce à l’Interface Graphique gbRRDGraphix (Onglets ‘Gestion Site Web’).
Fichiers impactés:

/opt/Monitoring/www/Web/config/cgi.conf

/opt/Monitoring/www/Web/config/equipement_details.conf

/opt/Monitoring/www/Web/js/Arbre.js

/opt/Monitoring/www/Web/index.html

Configuration des droits des fichiers du Site Web:

A) L’ensemble du Site Web doivent appartenir à l’utilisateur associé au serveur HTTP Apache pour respecter les sécurités.

Exemple:

User Group Other

apache apache

RWX RWX -- -- --

B)Afin que l’Interface Graphique gbRRDGraphix puisse mettre à jour certains fichiers du Site Web, il est obligatoire de faire appartenir l’utilisateur Unix ayant lancer l’interface Graphique, au groupe Unix du l’Utilisateur Apache.