THE PROCEDURE IS AS FOLLOWS

1. Get the tarball of GLPI on Glpi-project.org. Unpack it on your computer. You obtain a directory called glpi
containing the whole files of GLPI.

2. Copy this directory onto your server.

3. Using your browser, get the root of GLPI. You can now configure GLPI using an graphic interface. After this step,
you can use GLPI and begin to work.

DETAILLED PROCEDURE
Requirements

You should have a space on a web server with :

an access to the web server in order to install the files (FTP, SSH, etc) ;
PHP5.4 or later with the support of the sessions ;
an access to a MySQL (>4.1.2) database.

Before the installation, you must have a MySQL database available. If you are not the administrator of the server,
it is necessary to ask for the activation of a MySQL base to the administrator.

You must know the data of your MySQL connection (provided by the administrator):
the host address of the MySQL server ;
your MySQL login ;
your MySQL password ;
the name of the database

Getting GLPI

GLPI is available in the website :

http://glpi-project.org in the "download" section.

Choose the version you want to install. Unpack the tarball in your personnal computer. Upload the obtained
directory into your web server.

If your are the administrator of the server unpack the tarball in the root apache directory (/var/www or
/var/www/html).

Install the files

Install the whole files of GLPI in your web space, where you want that GLPI is accessible to the public.

Now, it is necessary to modify permissions to some directories in order that PHP can write in:

/files
/config

Begin of the installation

From now, all is held online. To begin the installation you must to use your browser to get the root of GLPI:
default is http://yourserver/glpi/

During the first connection, a step by step installation starts. The interface is user friendly, you must just enter
the required informations.

Preliminary steps

A- Choose your favorite language.

Just choose your favorite langage and click to OK

B- Install or Update.

You want to do a fresh install, so click on Install .

C- Compatibility checks to use GLPI

This step verifies that all requirements are ojk for the installtion of GLPI. If something is wrong, you cannot
continur the installtion. An error message will appear that explain you what to do to correct the problem.

If all is ok, you can click on continue .

Installation steps

Step 1 : Configuration of the access to the database server.

You must enter in a form all the informations needed to connect to MySQL.

Mysql server is the hostname where is your database server. For example: localhost or mysql.domain.tld

Mysql user is the username you use to connect to the server.

Mysql pass is the password of the username This field can be empty if your user have no password (No comment
will be done here on the security of such a user).

Then, you must to click on continue .

Two cases now:

Your parameters are rights. So, you access to the next step.
Your parameters are wrongs. So, an error message is displayed, you must to click on back to modify your
parameters and retry.

Step 2 : Choose or create the database.

The access to the database is ok. You mustr to create or choose the database that GLPI will use.

Two possibilities:

You want to use an existing database to store the GLPI tables:

Select this database and click on continue to initialize this database.

You want to create a new database to store the GLPI tables:

For this case, you must to have the rights to create a new database on the server.

Select create a new database . Enter the name of the database that you want to create in the text field. Click
on continue in order to initialize the database.

Step 3 : Temporary step and explanations :

This stage informs you that the database is initialized with the default values. Some informations are given to you
on these values. Read this information attentively and click on continue .

Step 4 : This stage indicates that the installation of GLPI is now finished, a summary is displayed. Read these
informations attentively and click on "use GLPI" to perform your first connection with the application.

End of the installation

In case of error (of the kind: you forgot your own access to GLPI...), to start again this procedure of installation, it
is necessary to use your software ftp (for example) and to erase the following file:
config/config_db.php

For security reasons you must to set the read right to config/config_db.php only to the web service user.
Example : chmod 400 config/config_db.php

Use your browser to get the root of GLPI: http://yourserver/glpi/ (by default) to start again the procedure of
configuration then (actually, it is the absence of file "config_db.php" which causes the launching of this
procedure).

Important : Following directories must not be accessible through web access (you may allow .htaccess files to do
such a thing)
/files
/config

UPDATE GLPI PROCEDURE

This article described you the process to update your version of GLPI in case you are already using it but with a
previous version.
Warning n1 : The update process needs more resources as usual. Please increase your memory_limit and timeout
in your php.ini configuration.

Warning n2 : You need to desactivate all plugins before update GLPI. You also must be sure that all your plugins
are compatible.

I) Backup of your old configuration

First of all, please perform the following operations :

Backup your database through the use of backup interface.

Backup the full directory where GLPI is installed (including the SQL database backup and your documents.

From now, if a problem occurs during update or if you do not like the new version, it would be very easy for you to
go back to previous version.

However, if you encouter any problem, please warn us on our forum, bugtrack list or mailing list with the used
process and the error message you got.

II) Retrieve and install files

Download lastest version tarball available from download section on the website (http://glpi-project)

a) If you update from a GLPI version <0.68 to a GLPI version >=0.68 :

Unpack the new archive and replace the old version by the new one

!- Somes folders have changed since 0.68. If your version is older than 0.68, you must copy their content -!

old_installation_GLPI/backup/dump -> new_installation_GLPI/files/dumps

old_installation_GLPI/docs/ -> new_installation_GLPI/files

Verify or change rights on following folders :

[your_http_root/]/glpi/files
[your_http_root/]/glpi/config/

in order that PHP has write rights.

b) If you update from a GLPI version >=0.68 to higher (0.70 for example).

Unpack the new archive and overwrite all files of the old version.

III) Update process start

1) Launch your web browser on this address http://yourserver/your_glpi_path/

2) Select the language into which you want to perform the update process and click on OK .

3) Click on Update.

4) Verify the environment tests succeeded or follow the displayed instructions and try again.

If everything worked fine, click on next .

5) Configure MySQL server access while using the config.php file, previously backuped. Fill out : Mysql server :
hostname of MySQL server Mysql user : mysql username Mysql pass : password of mysql user
 Once this is done, simply click on next

6) Select the database you want to update. Then, click on next

7) You are asked to confirm you really want to update. Click on next if you want to do so.

8) Update begins. It can take a while, depending on the size of your database.

9) Depends on the GLPI version you upgrade, some questions would be asked to you.

10) Process ask you about update the old contents of your database.

After you click on "continue", a progress bar appears. The process can take a long time, depending on the size of
your database and can stay for very long time at 0%.

If you upgrade from 0.4, please read this note [1]

11) Click on "use GLPI" to perform your connection with the application.
[1] IMPORTANT : Update from version earlier than 0.4 does not allow you to automatically preserve your detailled configurations
(general configuration, external sources, etc) which where stored into config.php file.
You nedd to use the forms from configuration menu after the install process.
Those menus are accessible only to a new type of user : super-admin .
Update automaticcaly converts admin users to super-admin users or ask you about creation of a super-admin user.
From now, different cases are possible, depending from which version you are updating.
CASE 1 : You add admin users or at least one of these users do not use external source to connect.
All your users with admin rights and empty password are given super-admin rights (youll see a notice informing you about
this)
Your database is up to date, you now can configure GLPI while clicking on use GLPI and using an old admin account.
CASE 2 : You do not have admin user or all of them have an empty password (all use external source to connect).
Process asks you to create a new user (name and password) with super-admin rights. Do not use an existing account !
Next step
If this process succeeded, your database is now up to date. Click on use GLPI to configure it ! (use the new user you just
created)
Once the configuration is completed, you can suppress this user. Be careful that you always have at least one super-admin
user that can connect to the application from MySQL database, because of eventual external source connection problems.

Plugins
GLPI provides facilities to develop plugins, and there are many plugins that have
been already published.

Note

Plugins are designed to add features to GLPI core.

This is a sub-directory in the plugins of GLPI; that would contains all related files.
Generally speaking, there is really a few things you have to do in order to get a
plugin working; many considerations are up to you. Anyways, this guide will provide
you some guidelines to get a plugins repository as consistent as possible :)

If you want to see more advanced examples of what it is possible to do with

plugins, you can take a look at the example plugin source code.
 Guidelines

Directories structure

Versionning

ChangeLog

Third party libraries

o Requirements

setup.php

hook.php

Coding standards

o Database

Creating and updating tables

Deleting tables

o Adding and managing objects

Define an object

Add a front for my object (CRUD)

o Hooks

Standards Hooks

Functions hooks

Automatic hooks

o Automatic actions
 Goals

Implement an automatic action

Register an automatic action

Unregister a task

o Massive Actions

o Tips & tricks

Add a tab on a core object

Add a tab on one of my plugin objects

Add several tabs

Add an object in dropdowns