Trace: » Présentation du plugin archires

Présentation du plugin archires

Ce plugin vous permet de générer automatiquement une représentation graphique de l'architecture réseau.

Installation

Windows

- Installez Graphviz sur votre serveur (http://www.graphviz.org/)

ATTENTION : 8-) Il semble que la dernière version de Graphviz (2.12 à ce jour) ne soit pas tres bien supportée par le plugin (images dégradées et en NB). La 2.8 est fonctionnelle, elle est telechargeable dans les archives de Graphviz ici : http://www.graphviz.org/pub/graphviz/ARCHIVE/ ou ici : http://www.thetsmr.fr/graphviz-2.8.exe

- Redémarrez physiquement la machine hébergeant GLPI.

- Vérifiez dans votre php.ini que le safe_mode est bien sur OFF.

Truc et astuce Lorsque le test dans le plugin ne fonctionne pas, il est possible que ce soit lié aux variables d'environnement windows Il faut donc faire :

- clic droit sur le poste de travail / propriété / avancé / variable d'environnement.

- Sélectionner path et modifier.

- Ajouter le chemin vers les binaire de graphviz à la fin de la ligne (par ex : C:Program FilesGraphviz2.20bin)

- redémarrer la machine

Cas particulier : Serveur WEB IIS

Il faut donner les droits au user anonyme IIS IUSR.. sur le répertoire C:Windowstemp et sur C:windowssystem32cmd.exe (lecture et execution)

IMPORTANT : 8-) Graphviz fonctionne avec le module PEAR, si celui-ci n'est pas installé, graphviz ne fonctionnera pas du tout.

Ubuntu 6.06

- Avec Synaptic, chargez graphviz 2.2.1-lubuntu2

Debian 3.1

- Avec apt, faire un apt-get install graphviz

Centos 4.4

- Les paquetages à installer pour graphviz :

  • graphviz-2.2-1.2.el4.rf.i386.rpm
  • graphviz-graphs-2.2-1.2.el4.rf.i386.rpm

- Les paquetages suivants fonctionnent aussi (mais pas les plus récents):

  • graphviz-2.8-1.el3.i386.rpm
  • graphviz-graphs-2.8-1.el3.i386.rpm

Centos 5.0

- Les paquetages à installer pour graphviz :

  • graphviz-2.8-1.el5.rf.i386.rpm
  • graphviz-graphs-2.8-1.el5.rf.i386.rpm

- Si vous n'avez pas d'affichage du graphique de test après l'installation, il se peut que le fichier de config de graphviz ne soit pas correctement ou pas du tout crée. Pour le créer taper en root : dot -c

RedHat Enterprise Linux 4

- Les paquetages à installer pour graphviz :

  • graphviz-2.8-1.el3.x86_64.rpm
  • graphviz-graphs-2.8-1.el3.x86_64.rpm

RedHat Enterprise Linux 3

- Les paquetages à installer pour graphviz :

  • graphviz-2.13.20061211.0540-1.el3.i386.rpm
  • graphviz-graphs-2.13.20061211.0540-1.el3.i386.rpm
  • graphviz-gd-2.13.20061211.0540-1.el3.i386.rpm

Gentoo

- Utiliser la commande emerge -pv ”=graphviz-2.8*”

Mandriva 2007/2007.1/2008

- Se connecter sous root et utiliser la commande urpmi graphviz

FreeBSD

Graphviz fonctionne sans aucun soucis avec la version 2.20.2

- Installer par le portage :

  cd /usr/ports/graphics/graphviz/
  make install clean

- Installer PEAR s'il n'est pas installé :

  cd /usr/ports/devel/pear/
  make install clean

Utilisation

Association d' images

  • Placez vos images dans le répertoires /pics
  • Associez vos types de matériels aux images

Association de couleurs

  • Sélectionnez un type d'interface
  • Choisissez une couleur type : red, green, blue

liste complète ici : http://www.graphviz.org/doc/info/colors.html

Création d'une vue

  • Cliquez sur le ”+” à fond rouge
  • Configurez les options d'affichage de cette vue

Création d'une architecture

  • Cliquez sur le ”+” jaune
  • Choisissez architecture par lieu ou matériel réseau
  • Configurez les paramètres de cette architecture
  • Sélectionnez une des vues déjà créées
  • Pour vérifier, cliquez sur l'onglet “Tester”

Visualiser votre graphique

  • Choisissez architecture par lieu ou matériel réseau
  • Si la colonne “afficher” n'apparaît pas, ajoutez là
  • Cliquez sur “génération” dans la colonne “afficher” de la vue souhaitée

enjoy ^_^

Banque d'images

Ces images ont été réalisées pour un besoin spécifique. Dans un soucis de simplicité, si vous etes amené a ajouter des images, merci de respecter le format des images…

Informations sur les images

  • Images de taille 48*48.
  • Format : png.
  • Fond transparent.

Images pour les serveurs

:fr:plugins:server_base.png :fr:plugins:server_mail.png :fr:plugins:server_db.png :fr:plugins:server_file2.png :fr:plugins:server_citrix.png
Générique Mail Base de données Fichiers Citrix

Images pour les postes

vide :fr:plugins:pc.png :fr:plugins:laptop.png :fr:plugins:pda.png
Tour Desktop Portable PDA

Images pour le matériel réseau

:fr:plugins:hub.png :fr:plugins:switch.png :fr:plugins:switch2.png :fr:plugins:wifi.png vide
Hub Switch Switch 2 Wifi Firewall

Images pour le matériel d'impression

:fr:plugins:encre_n.png :fr:plugins:encre_c.png :fr:plugins:laser_n.png :fr:plugins:laser_c.png :fr:plugins:photocopieur.png
Jet d'encre N/B Jet d'encre Couleur Laser N/B Laser Couleur Photocopieur

Télécharger le pack complet en une seule fois

Images libres de droit (à vérifier sur le site)

Particularités

Ce plugin peut être utilisé conjointement avec le plugin applicatifs.

FAQ Plugin Archires

Astuces

Pour les parcs contenant beaucoup d'ordinateurs ces derniers se mettent sur une seule ligne soit en dessous soit au dessus d'un switch ce qui surcharge le graphique.

Pour remedier à cela il faut connecter la moitié des ordinateurs depuis le switch vers les ordinateurs (ces derniers seront mis en dessous du switch) puis connecter l'autre moitié des pc au switch (les ordinateurs seront alors placés au dessus).

Comment ajouter un type de matériel et l'image correspondante

A partir de la version 1.3, cela a été automatisé.
Avec la version 1.2, il faut :

a) Connaitre le type à ajouter.

Dans glpi_type_computers, repérer l'ID à ajouter. Par exemple (ID 3 = Rack).

b) Ajouter une entrée dans la table glpi_plugin_archires_config

Champs correspondants :

  • type glpi_plugin_archires_config = ID du type de glpi_type_computers
  • device_type glpi_plugin_archires_config = ID correspondant à l'ID déclaré dans config.php (Section // ITEMS TYPE)
  • img = le nom de votre image (que vous avez préalablement ajouté au répertoire pics du plugin)

Et de là elle sera automatiquement ajoutée dans la configuration du plugin et visible sur l'image.

Questions/Réponses

Q: En mode debug, j'ai des lignes type ''PHP ERROR : Notice: Undefined index: 6 in plugin_archires.functions_display.php on line 419''. De plus mon image ne s'affiche pas.

R : il peut y avoir un problème de path qui fait que l'utilitaire dot n'est pas trouvé dans archires/inc/plugin_archires.functions_display.php. On peut rajouter le chemin en dur (usr/local/bin/dot par exemple) dans ce script. ça se manifeste par un “sh: dot: not found” dans le log d'erreur d'apache. (La version 1.3 corrige ce problème)

Q: Mon image contient des matériels bizarrement reconnus (sous forme de losange).

R: Le nom du matériel ou le nom du type du matériel concerné par ce problème ne doit comporter que des caractères de base ( pas de ”&”, ”/”, ”'”, etc…)

Q: Mon image ne s'affiche pas dans GLPI mais le SVG est correctement généré .

R: Le lieu des matériels ne doit comporter que des caractères de base ( pas de ”&”, ”/”, ”'”, etc…)

Q: Mes images sont dégradées et/ou en Noir et Blanc

R: l semble que la dernière version de Graphviz (2.12 à ce jour) ne soit pas tres bien supportée par le plugin (images dégradées et en NB). La 2.8 est fonctionnelle, elle est telechargeable dans les archives de Graphviz ici : http://www.graphviz.org/pub/graphviz/ARCHIVE/