The Archires Plugin

This plugin enables you to automatically generate a chart of your network architecture.

Installation

Windows

- Graphviz install on your server (http://www.graphviz.org/)

CAUTION: 8-) It seems that the latest version of Graphviz (2.12 to date) is not very well supported by the plugin (images degraded and NB). The 2.8 is functional, it is available in the archives of Graphviz here: http://www.graphviz.org/pub/graphviz/ARCHIVE/ or here: http://www.thetsmr.fr/graphviz-2.8.exe

- Restart the machine hosting physically GLPI.

- Check that your php.ini safe_mode is OFF.

When trick and trick the test in the plugin does not work, it is possible that this is related to the Windows environment variable must be done:

- Right click on desktop / Properties / advanced / environment variable.

- Select and edit path.

- Add the path to the graphviz binary at the end of the line (eg: C: Program FilesGraphviz2.20bin)

- Reboot

Case: IIS

You have to give the user rights IIS IUSR anonymous .. on the C:Windowstemp and C:windowssystem32cmd.exe (reading and execution)

IMPORTANT: 8-) Graphviz works with PEAR module, if it is not installed graphviz not work at all.

Ubuntu 6.06

- With Synaptic, download graphviz 2.2.1-lubuntu2

Debian 3.1

- With apt, do an apt-get install graphviz

Centos 4.4

- The packages to install graphviz:

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

- The following packages will also work (but not the latest):

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

Centos 5.0

- The packages to install graphviz:

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

- If you do not display graphics test after installation, it is possible that the configuration file graphviz is not properly or not at all created. To create the root type in: c-dot

RedHat Enterprise Linux 4

- The packages to install graphviz:

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

RedHat Enterprise Linux 3

- The packages to install 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

- Use the command emerge-pv “= graphviz-2.8 *”

Mandriva 2007/2007.1/2008

- Login as root and use the command urpmi graphviz

FreeBSD

Graphviz works without any problem with version 2.20.2

- Install the port:

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

- Install PEAR if not installed:

 cd / usr / port / deval / pear /
 make install clean

Use

Assigning images

  • Move your images in the /pics folder.
  • Select an item type.
  • Choose an image.

Assigning colors

  • Select an interface type.
  • Choose a color : red, green, blue.

The complete list can be found here : http://www.graphviz.org/doc/info/colors.html

enjoy ^_^

Image Database

Those images have been created for a specific need. In the purpose of keeping it simple, if you wish to add images, please respect the images format…

Informations about images

  • Image size 48*48.
  • Format : png.
  • Transparent background.

Images for servers

: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
Generic Mail Database Files Citrix

Images for stations

empty empty empty empty
Tower Desktop Notebook PDA

Images for network devices

empty empty empty empty
Hub Switch Routeur Firewall

Archires Plugin FAQ

Tips

All the computers are graphed on a same line whether above or under the switch to which they are connected, how do I change that?

To be able to graph computers above and under the switch, connect half of the computers from the switch to the computers (they will appear under the switch) then connect the other half from the computer to the switch (they will appear above the switch).

How to add a type of item and its corresponding image?

In version 1.3, it has been automated.
In version 1.2, you have to:

First you have to know the type you want to add.

In glpi_type_computers, locate the ID to be added. For example (ID 3 = Rack).

Then add an entry in the glpi_plugin_archires_config table

Corresponding fields :

  • type glpi_plugin_archires_config = ID form the type of glpi_type_computers
  • device_type glpi_plugin_archires_config = ID correspond to the ID declared in config.php (Section ITEMS TYPE) *img = the name of your image (that you will have added before in the plugin pics folder) The image will be automatically added to the configuration of the plugin and visible on the graph. ===== Questions/Answers ===== === Q: In debug mode, I have lines of the following type PHP ERROR : Notice: Undefined index: 6 in plugin_archires.functions_display.php on line 419. In addition my image does not show up.=== > R : You may have a path problem that prohibits archires/inc/plugin_archires.functions_display.php to find the dot utility. You can define a hard link in this script (usr/local/bin/dot for example). You can detect if this is happening looking for “sh: dot: not found” in apache's log. (This problem is corrected in Version 1.3) === Q: My image contains weird sized items (the shape of a rhombus). === > R: The name or type of the concerned item cannot include any character other than basic ones ( none of those “&”, “/”, “'”, etc…)