GLPI : sauvegarde et maintenance via bin/console

La console bin/console exécute les opérations de maintenance GLPI en ligne de commande, dont la sauvegarde de base.

Prérequis

• Accès shell au serveur GLPI (utilisateur du serveur web).
• Répertoire d’installation, par exemple /var/www/glpi.
• mysqldump ou mariadb-dump installé.

1. Lister les commandes disponibles

cd /var/www/glpi
php bin/console list

2. Activer le mode maintenance

php bin/console glpi:maintenance:enable --message="Sauvegarde en cours"

3. Sauvegarder la base de données

Les paramètres se lisent dans config/config_db.php. Lancer le dump :

mysqldump --single-transaction \
  -h db.exemple.fr -u glpi -p \
  glpidb | gzip > /sauvegardes/glpi-$(date +%F).sql.gz

4. Sauvegarder les fichiers

Le répertoire files/ contient documents, plugins et marqueurs. L’archiver :

tar czf /sauvegardes/glpi-files-$(date +%F).tar.gz \
  /var/www/glpi/files /var/www/glpi/config

5. Désactiver le mode maintenance

php bin/console glpi:maintenance:disable

6. Tâches de maintenance complémentaires

php bin/console glpi:database:optimize   # optimise les tables
php bin/console glpi:crontask            # exécute les actions automatiques
php bin/console glpi:cache:clear         # vide le cache

Vérification

Contrôler l’intégrité du dump :

gzip -t /sauvegardes/glpi-2025-01-15.sql.gz && echo "archive valide"

Vérifier la cohérence de l’instance :

php bin/console glpi:system:check_requirements

Dépannage

• « Access denied » au dump : vérifier identifiants dans config/config_db.php.
• Console muette : lancer avec l’utilisateur du serveur web (sudo -u www-data php bin/console ...).
• « You are not in a GLPI instance » : exécuter depuis la racine d’installation.
• Sauvegarde incohérente : toujours utiliser --single-transaction sur InnoDB pour un dump atomique.