Installer GLPI Agent, le successeur de FusionInventory

Depuis GLPI 10, l'inventaire est intégré au cœur de GLPI et c'est GLPI Agent qui remonte les postes. Voici comment l'activer côté serveur, déployer l'agent sur Windows et Linux, et vérifier le premier inventaire.

Schéma : pc-win01 (Windows 11) et srv-deb01 (Debian 13) envoient leur inventaire GLPI Agent en HTTPS à srv-glpi01 ; GLPI joint l'agent Linux sur le port 62354
Illustration schématique — ne reproduit aucune interface réelle.

L'ancienne version de cette page décrivait le plugin FusionInventory 9.3 pour GLPI 9.3.3. Ce couple n'a plus d'avenir : la branche 9.x de GLPI n'est plus maintenue, et le site de FusionInventory marque son plugin pour GLPI 10.0.6 comme abandonné (discontinued). La documentation de l'agent est claire sur la suite : GLPI Agent est le successeur de FusionInventory Agent, construit sur le même code, et il peut le remplacer partout.

La différence de fond est côté serveur. Depuis GLPI 10, l'inventaire est natif : plus besoin de plugin pour recevoir l'inventaire des ordinateurs. Le plugin GLPI Inventory, disponible dans le marketplace, ne sert qu'aux tâches avancées comme la découverte réseau, l'inventaire SNMP, l'inventaire des hôtes VMware, la collecte ou le déploiement de paquets. Cette page vise GLPI 11 et la version courante de l'agent, publiée sur la page des releases GitHub du projet.

Testez le déploiement sur quelques postes de lab avant de le pousser par stratégie de groupe, et sauvegardez la base GLPI avant d'activer l'inventaire sur une instance en production.

FusionInventory ou GLPI Agent : ce qui change

PointFusionInventory (GLPI 9.x)GLPI Agent (GLPI 10 et 11)
Côté serveurplugin FusionInventory obligatoireinventaire natif, plugin GLPI Inventory pour les tâches avancées
URL du serveur/plugins/fusioninventory/racine de GLPI, sauf si le plugin GLPI Inventory est installé
Configuration Windowsclé de registre FusionInventoryHKEY_LOCAL_MACHINE\SOFTWARE\GLPI-Agent
Configuration Linuxfichier de l'agent FusionInventory/etc/glpi-agent/agent.cfg et conf.d/

Topologie du lab

HôteRôleInterfaceAdresse
srv-glpi01GLPI 11, https://glpi.lab.local/ens18192.168.10.20/24
pc-win01poste Windows 11 à inventorierEthernet192.168.10.101/24
srv-deb01serveur Debian 13 à inventorierens18192.168.10.30/24

Prérequis

Étape 1 : activer l'inventaire dans GLPI

C'est l'étape qu'oublient presque tous les tutoriels. Dans le code de GLPI 11, l'option d'inventaire est désactivée par défaut : sans elle, l'agent contacte le serveur et rien n'arrive dans le parc.

Allez dans Administration > Inventaire, cochez Activer l'inventaire et enregistrez. Les autres options de cet écran règlent ce qui est importé (logiciels, volumes, etc.) ; laissez-les par défaut pour un premier test.

Étape 2 : installer l'agent sous Windows

L'installeur MSI pour Windows 64 bits est publié sur la page des releases GitHub. Depuis la version 1.8, il n'existe plus d'installeur 32 bits. Lancé sans option, il ouvre une interface graphique ; en ligne de commande, /quiet le rend silencieux.

Utilisez cmd.exe en administrateur : la documentation déconseille PowerShell, qui modifie un contexte que l'installeur gère mal.

msiexec /i GLPI-Agent-<version>-x64.msi /quiet SERVER=https://glpi.lab.local/ RUNNOW=1

SERVER désigne le serveur qui reçoit les résultats, et RUNNOW=1 lance un inventaire juste après l'installation. Attention à la syntaxe : pas d'espace autour du signe égal, et les noms d'options sont sensibles à la casse.

Les paramètres MSI utiles

L'installeur accepte de nombreux paramètres. Ceux-ci couvrent la plupart des déploiements :

Avec winget

Sur Windows 10 et 11, l'agent s'installe aussi avec winget, en passant les mêmes paramètres par --custom :

winget install glpi-agent --custom="SERVER='https://glpi.lab.local/' RUNNOW=1"

Le fonctionnement de winget lui-même est détaillé sur la page consacrée au gestionnaire de paquets winget. Pour un parc entier, la documentation de l'agent fournit aussi un script VBScript de déploiement à lancer par GPO au démarrage des ordinateurs.

Étape 3 : installer l'agent sous Linux

Pour Debian et les distributions RPM, la documentation recommande l'installeur Perl glpi-agent-<version>-linux-installer.pl, qui choisit le bon paquet. Par défaut, il configure l'agent en service, ne lance que les tâches d'inventaire et n'accepte les requêtes HTTP sur le port 62354 que depuis le serveur GLPI. Consultez ses options avant de l'exécuter :

perl glpi-agent-<version>-linux-installer.pl --help

Plutôt que de modifier agent.cfg, que les mises à jour peuvent écraser, placez votre configuration dans un fichier du dossier conf.d, par exemple /etc/glpi-agent/conf.d/server.cfg :

server = https://glpi.lab.local/
tag = lab

Redémarrez ensuite le service et forcez un premier envoi :

systemctl restart glpi-agent
glpi-agent --force

L'option --force envoie un inventaire même si le serveur ne l'a pas demandé.

Étape 4 : vérifier le premier inventaire

Si l'inventaire a été demandé à l'installation, le poste apparaît dans Parc > Ordinateurs quelques minutes plus tard. Sinon, vérifiez dans l'ordre :

  1. L'inventaire est-il activé dans Administration > Inventaire ?
  2. L'URL est-elle la bonne ? Sans plugin, c'est la racine de GLPI. Avec le plugin GLPI Inventory sous GLPI 11, la documentation donne https://<serveur>/plugins/glpiinventory/.
  3. Le certificat est-il reconnu ? Un certificat d'autorité interne doit être fourni à l'agent (CA_CERT_FILE sous Windows).
  4. L'agent tourne-t-il ? En service, son interface web répond sur http://<poste>:62354 ; depuis une adresse de confiance, elle propose de forcer une exécution.

Une fois l'inventaire en place, rattachez les ordinateurs à leurs utilisateurs en important ceux-ci depuis l'annuaire, comme expliqué dans la configuration LDAP de GLPI. Les autres tutoriels sont dans la rubrique GLPI.

Questions fréquentes

GLPI Agent remplace-t-il FusionInventory ?

Oui. Sa documentation le présente comme le successeur de FusionInventory Agent, basé sur le même code. Désinstallez l'ancien agent avant d'installer le nouveau ; une configuration placée dans conf.d peut être conservée.

Faut-il encore un plugin dans GLPI pour l'inventaire ?

Non pour l'inventaire des ordinateurs, natif depuis GLPI 10. Le plugin GLPI Inventory reste nécessaire pour la découverte et l'inventaire réseau, l'inventaire VMware, la collecte et le déploiement de paquets.

Quelle URL donner à l'agent ?

La racine de GLPI, comme https://glpi.lab.local/, si vous n'utilisez pas le plugin GLPI Inventory. Avec ce plugin, l'URL change selon la version de GLPI ; la page de configuration de l'agent donne les deux formes.

Où se trouve la configuration de l'agent sous Windows ?

Dans la clé de registre HKEY_LOCAL_MACHINE\SOFTWARE\GLPI-Agent. Après une modification, redémarrez le service de l'agent, installé en service par défaut.

Peut-on installer GLPI Agent sur un Windows 32 bits ?

Plus avec les versions récentes. La documentation indique que la dernière version disponible pour les systèmes 32 bits est la 1.7.3 ; depuis la 1.8, seul l'installeur 64 bits est fourni.