Installation / Mise à jour

Faites une sauvegarde

Avant toute manipulation sur votre base de données ou sur votre instance GLPI, nous vous conseillons fortement de faire une sauvegarde de votre base de données ainsi que du dossier GLPI.

---

Qu'est-ce que GLPI ?

GLPI est un outil ITSM open source qui peut être utilisé dans divers systèmes opérationnels, puisqu'il s'agit d'une application web fonctionnant sur un serveur web avec un compilateur PHP et une base de données MySQL. GLPI s'exécute dans une architecture à trois niveaux qui consiste en un niveau de présentation, un niveau d'application et un niveau de données.

1. Niveau de présentation

C'est la couche qui est chargée d'afficher les informations à l'utilisateur et d'interagir avec lui. L'application GLPI génère des codes HTML, donc pour que ces codes aient un sens pour l'utilisateur, nous avons besoin d'un serveur web pour les "traduire". Parmi les serveurs web les plus connus figurent Apache et NGINX, par exemple.

2. Niveau d'application

C'est la couche métier de l'application. Elle est responsable du traitement des opérations que GLPI effectue sur les données selon les demandes de l'utilisateur. Pour GLPI, cette logique est codée en PHP

3. Niveau de données

Le niveau de données est celui qui s'occupe de l'accès et du stockage des données. Sur GLPI, ce niveau est géré par un Système de Gestion de Base de Données basé sur MySQL ou son fork MariaDB. Vous trouverez la liste complète des prérequis pour installer et utiliser GLPI ici

---

Puis-je installer le frontend GLPI sur un serveur et la base de données sur un autre ?

Oui, vous pouvez. Et vous devriez dans le cas d'environnements complexes et plus importants. Dans cet article de blog, nous travaillons avec une architecture simple. Mais vous pouvez créer des scénarios qui s'adaptent aux plus grandes entreprises avec ou sans microservices, bases de données séparées, bases de données maître et esclave, partage NFS pour les fichiers. Les possibilités sont énormes, et nous pourrions en discuter dans de futurs articles.

---

J'ai des problèmes d'accès à GLPI après une mise à jour, comment puis-je les corriger ?

Après une mise à jour, les données en cache tentent d'être utilisées mais sont obsolètes. La méthode recommandée pour remédier au problème est de vider le contenu du cache dans le dossier fichiers rm -rf ../files/_cache/*.

Attention "Ce dossier peut être dans un emplacement différent selon votre configuration. Vous pouvez consulter le fichier ../inc/downstream.php pour connaître le chemin exact si votre installation a été personnalisée.

---

Pourquoi reçois-je un message sur ma page d'accueil m'informant que La configuration du dossier racine du serveur web n'est pas sécurisée car elle permet l'accès aux fichiers non publics. Veuillez consulter la documentation d'installation pour plus de détails ?

Afin de sécuriser votre instance et empêcher l'exposition de fichiers non publics, votre vhost doit être modifié (cela s'applique particulièrement aux instances qui sont exposées sur Internet). Vous pouvez suivre la documentation officielle pour configurer cette configuration disponible ici

---

Puis-je installer GLPI 10 avec PHP 7.4 ?

PHP 7.4 n'est actuellement plus supporté. Vous pouvez vérifier le support PHP via ce lien

---

Comment savoir si ma version GLPI est à jour ?

Dans les options utilisateur, (en haut à droite), un champ à propos est disponible. Si vous cliquez sur ce champ, un message vous alertera si vous avez des mises à jour en retard

Alt text

Vous pouvez aussi aller dans Configuration > Générale > Système. cliquez sur Vérifier si une nouvelle version est disponible. Un message en bas à droite vous dira si une nouvelle version est disponible

Alt text

---

Comment corriger les erreurs lors de la mise à jour de GLPI ?

Si vous rencontrez des erreurs lors du processus de mise à jour, plusieurs commandes sont possibles afin de vous guider. Ces commandes doivent être entrées dans le dossier GLPI :

• php bin/console database:check_schema_integrity : affiche les incohérences trouvées dans la base de données

• php bin/console database:check_schema_integrity -p formcreator : affiche les incohérences dans la base de données liées à Formcreator

• php bin/console system:check_requirements : vérifie les prérequis système demandés par GLPI.

• php bin/console migration:migrate_all : utile pour migrer de 9.5 vers 10. Permet de migrer (convertir les champs "datetime" en "timestamp" pour utilisation dans les fuseaux horaires, migrer les clés principales/étrangères vers des entiers non signés, convertir le jeu de caractères de la base de données de "utf8" vers "utf8mb4").

• php bin/console system:list_services : liste les services système

• php bin/console system:status : liste le statut système Si vous avez besoin de plus d'informations, veuillez consulter la documentation officielle

---

Quels serveurs Web sont compatibles ?

Pour installer GLPI, nous recommandons d'utiliser :

• Apache

• Nginx

• Lighttpd

• IIS

---

Où puis-je télécharger la dernière version de GLPI ?

Pour vous assurer d'avoir la bonne version de GLPI, vous pouvez la télécharger depuis Github

---

Comment déplacer le dossier fichiers du dossier GLPI ?

Vous devez créer un fichier downstream.php dans le dossier inc. Selon la configuration souhaitée, vous pouvez relocaliser plusieurs dossiers GLPI. Dans cet exemple, le dossier configuration sera situé dans /var/www/glpi_config et le dossier files dans /var/www/glpi_files.

define('GLPI_CONFIG_DIR', '/var/www/glpi_config');
define('GLPI_VAR_DIR', '/var/www/glpi_files');

Cela vous permet de segmenter chaque dossier dans le dossier fichiers (_log, _pictures, _lock, etc.). Portez une attention particulière aux permissions de ces dossiers, qui doivent être accessibles en lecture/écriture par l'utilisateur du service web. Plus d'informations ici

---

Comment obtenir la liste des commandes disponibles en CLI ?

Depuis la racine du dossier GLPI, entrez php bin/console, cette commande affichera toutes les commandes disponibles en CLI.

---

Pourquoi certaines informations sont-elles chiffrées après une migration de serveur ?

GLPI inclut un système de chiffrement via la glpicrypt.key. Si cette clé n'est pas migrée avec le reste des données, certaines de vos données peuvent ne plus être lisibles. Il suffit de migrer la glpicrypt.key vers le dossier config pour retrouver un usage normal de votre GLPI.

---

Pourquoi les données de certains plugins ne sont-elles plus présentes après une migration de serveur ?

Lorsque vous migrez une instance GLPI d'un serveur vers un autre, vous devez également migrer le dossier plugin et/ou marketplace afin que toutes les données des plugins soient également transférées.

---

Pourquoi reçois-je un message indiquant que la directive PHP session.cookie_httponly devrait être définie sur on pour empêcher l'accès aux cookies depuis les scripts côté client ?

Cette directive refuse l'accès au cookie de session depuis JavaScript et empêche les cookies récupérés par une injection JavaScript. Elle peut être définie dans /etc/php/8.X/apache/php.ini

---

Pourquoi ne puis-je pas accéder à GLPI après avoir activé la directive PHP session.cookie_secure ?

Cette directive autorise l'accès au cookie uniquement lorsque le protocole HTTPS est activé. Si vous utilisez HTTP, nous vous recommandons de désactiver cette option ou de passer votre instance en HTTPS afin de retrouver l'accès à votre instance.

---

Quel est le but du dossier _tmp ?

Le dossier _tmp dans GLPI est un espace de stockage temporaire utilisé pour diverses opérations. En particulier, il est utilisé comme lieu de transit pour les fichiers avant leur destination finale, comme lors de l'importation ou du téléchargement de fichiers, ainsi que pour des opérations ponctuelles comme les mises à jour ou la génération de rapports.

Par exemple, le plugin DataInjection crée des fichiers temporaires dans ce dossier pour stocker les résultats d'import ou les erreurs rencontrées. Bien que certains fichiers soient automatiquement supprimés à la fin des opérations, ce n'est pas toujours le cas.

Ce dossier peut être vidé manuellement si nécessaire.

---

Puis-je passer directement de la version 9.5.x ou 10.0.x à la dernière version 11 de GLPI ?

Oui c'est possible. Le processus de mise à jour se chargera de mettre à jour votre version de GLPI de la version 9.5.X ou 10.0.X vers la 11 sans que vous n'ayez besoin de faire chaque mise à jour de version majeure manuellement.

Attention si vous utilisez des plugins comme Formcreator ou Generic Objects. Ces plugins ayant été intégré dans le coeur de GLPI, une procédure particulière est disponible afin de vous accompagner dans la mise à jour de ces plugins

Mettre à jour les plugins

---

Puis-je installer GLPI 11 sur un autre serveur et importer la base de données depuis une version précédente 10.0.X ?

Oui c'est tout à fait possible et même recommandé pour effectuer la mise à jour sur un serveur de préproduction.

Lors du transfert de base données, pensez également à copier votre glpicrypt.key dans votre dossier de configuration.

Une fois votre base de données importée, lancez la commande sudo -u www-data php bin/console database:update. GLPI se chargera de mettre à jour votre base de données vers la version de GLPI installée.

Attention si vous utilisez des plugins comme Formcreator ou Generic Objects. Ces plugins ayant été intégré dans le coeur de GLPI, une procédure particulière est disponible afin de vous accompagner dans la mise à jour de ces plugins

Mettre à jour les plugins

---