Skip to content

Commit

Permalink
Add more details on update process (#67)
Browse files Browse the repository at this point in the history
* Add more details on update process

* Update update.rst
  • Loading branch information
cedric-anne committed Feb 8, 2022
1 parent c924a05 commit 022fe5a
Showing 1 changed file with 15 additions and 5 deletions.
20 changes: 15 additions & 5 deletions source/update.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,27 @@ Update
As for every update process, you have to backup some data before processing any upgrade:

* **backup your database**;
* backup your files directory;
* backup your configuration (especially your GLPI key file `config/glpi.key` or `config/glpicrypt.key` if present).
* backup your `config` directory, especially for your GLPI key file (`config/glpi.key` or `config/glpicrypt.key`) which is randomly generated;
* backup your `files` directory, it contains users and plugins generated files, like uploaded documents;
* backup your `marketplace` and `plugins` directory.

First, download latest GLPI version and extract files. GLPI update process is then automated. To start it, just go to your GLPI instance URI, or (recommended) use the :doc:`command line tools <command-line>`.
Here are the steps to update GLPI:

Once a new version will be installed; you will not be able to use the application until a migration has been done.
* Download latest GLPI version.
* Ensure the target directory is empty and extract files there.
* Restore the previously backed up `config`, `files`, `marketplace` and `plugins` directory.
* Then open the GLPI instance URI in your browser, or (recommended) use the `php bin/console db:update` :doc:`command line tools <command-line>`.

Please also note the update process will automatically disable your plugins.
.. warning::

As soon as a new version of GLPI files is detected, you will not be able to use the application until the update process has been done.

.. warning::

You should not try to restore a database backup on a non empty database (say, a database that has been partially migrated for any reason).

Make sure your database is empty before restoring your backup and try to update, and repeat on fail.

.. note::

Update process will automatically disable your plugins.

0 comments on commit 022fe5a

Please sign in to comment.