Trace: » 1. Plugin installation Procedure in GLPI

1. Plugin installation Procedure in GLPI

a) New installation

  • Back up the GLPI database.
  • Download the plugin from the GLPI plugins.
  • Uncompress the file using “tar -xzvf <pluginfile.tar.gz>”. The plugin contents will be uncompressed in a subdirectory <pluginname>.
  • Copy or move the uncompressed directory in the “plugins” directory of your GLPI root (e.g. /var/www/glpi/plugins).
    • If you move the directory, remember that you probably will have to take care of the permissions using chmod - your Apache user will need at least to be able to “read” and “execute” the directory and its contents. Plugin functionality and “uninstall” routines might require write access to the directory.
    • Important: Do not change the original name of the directory, otherwise, you may break plugin functionality.
    • If you want to change the display name of the plugin, you might modify the corresponding entry in the language locale file contained within the plugin directory.
  • Log off from GLPI and log in again.
  • Select Setup and Plugins.
  • You will see a option “Select a plugin to configure”, below it you should see the plugin you just installed. Click on the name of the plugin to start it.
    • If the plugin needs to modify the GLPI database, some preliminary installation will be initiated once you start it the first time. Once this one done, you will be redirected towards the configuration of the plugin.
  • Some plugins do have configuration options which may need to be set to fit your environment. Use the Plugin Configuration Page (“Administration” - “Setup” - “Plugins” - <Plugin Name>) to change these options.
  • Your plugin is ready for use.

Enjoy ^_^

b) Update of an existing plugin

The update procedure is basically the same as the initial installation, but you should take some additional precautions so you can revert to the old version in case of a setup failure:

  • Back up the GLPI database or at least the database tables which are created by the plugin. Typically, the tables affected are listed in the file readme.txt that comes with each plugin and can be found in the plugin directory (e.g. /var/www/glpi/plugins/<pluginName>)
  • Move the old plugin directory outside the plugin directory (e.g. using “mv /var/www/glpi/plugins/<pluginName> /var/www/glpi/plugins_old/<pluginName>”)

After that, you can proceed with the installation instructions given in Section a)

c) Removal

  • Back up the GLPI database.
  • Go on the setup of the plugin (Administration - Setup - Plugins - “Name of the plugin”).
  • Click on Uninstallation of the plugin.
    • Warning : all the data related to the plugin will be removed.

2. List of stable plugins

They can be downloaded here: Plugins GLPI Website.