3.3 Migrate your GLPI

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 n°1 : The update process needs more resources as usual. Please increase your memory_limit and timeout in your php.ini configuration.

Warning n°2 : 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.