kb-glpi-inventaire-auto-agents - My Personal Knowledge Base

# Présentation Dans la procédure ci-dessous, nous allons activer le **système d'inventaire natif GLPI** et déployer les agents GLPI pour Linux et pour Windows afin de réaliser un inventaire automatique. Voici les points décrits dans cette procédure : - [[#Activer le système d'inventaire natif de GLPI]]. - [[#Déploiement de l'agent GLPI pour Windows]]. - [[#Déploiement de l'agent GLPI pour Linux]]. - [[#Résoudre les erreurs communes]]. L’agent GLPI est un fork de l’agent Perl FusionInventory, agrémenté de nouvelles fonctionnalités, notamment : une nouvelle interface (Toolbox), un mode proxy amélioré, le support d’inventaire distant agentless (sans agent), etc. > [!info] À savoir ! L’ancien plugin FusionInventory n’est plus compatible avec GLPI 10.0.7 et ultérieur. Il faut à présent utiliser le système d’inventaire natif de GLPI et ses agents. # Activer le système d'inventaire natif de GLPI Le système d'inventaire GLPI est inclus nativement dans la solution. Depuis la version 10, il n'est plus nécessaire d'installer de plugin additionnel. Toutefois, l'inventaire est désactivé par défaut, donc nous devons l'activer dans les paramètres de GLPI. Commencez par vous connecter à l'interface d'administration de GLPI, puis : - Cliquez sur "*Administrateur*" dans le menu latéral. - Cliquez sur "*Inventaire*". - Cochez l'option "*Activer l'inventaire*". - Enregistrez la modification en cliquant sur le bouton `[Sauvegarder]` en bas de page. ![[_img-kb-lnx-glpi-agent.png]] # Déploiement de l'agent GLPI pour Windows Dans cette procédure, nous allons installer GLPI Agent 64 bits sur une machine Windows 11 (10.0.2.100) connectée au même réseau que le serveur GLPI. L'URL de GLPI est http://10.0.2.254. > [!warning] Rappel ! Adaptez cette URL en fonction de votre configuration. > [!info] À savoir ! Pour les grands déploiements, l'éditeur fournit un fichier VBScript afin d'optimiser l'installation : [GLPI Agent - Large installations](https://glpi-agent.readthedocs.io/en/latest/installation/index.html#large-installations). Dans les étapes ci-dessous, nous allons déployer GLPI Agent manuellement en mode graphique. ## Installation de GLPI Agent pour Windows Téléchargez la dernière version "*GLPI-Agent-1.13-x64.msi*" pour Windows disponible sur le site [GLPI Project](https://github.com/glpi-project/glpi-agent/releases). Une fois le fichier téléchargé, exécutez le programme d'installation. Si l'application "*Microsoft Defender SmartScreen*" empêche le démarrage de l'installeur, un message s'affiche : ![[_img-kb-lnx-glpi-agent-1.png]] Pour reconnaître le programme et autoriser son installation : faites un clic droit sur le fichier "*GLPI-Agent-x.y.z.msi*", choisissez l'option propriétés. Dans l'onglet "*Général*", cochez la case "*Débloquer*", puis cliquez sur les boutons `[Appliquer]` et `[OK]`. ![[_img-kb-lnx-glpi-agent-2.png]] Relancez l’installation de GLPI Agent et suivez les étapes suivantes : ![[_img-kb-lnx-glpi-agent-3.png]] ![[_img-kb-lnx-glpi-agent-4.png]] ![[_img-kb-lnx-glpi-agent-5.png]] Une installation en mode "*Typical*" est généralement suffisante, mais vous pouvez choisir le mode "*Custom*" pour sélectionner les fonctionnalités à installer selon votre environnement : ![[_img-kb-lnx-glpi-agent-6.png]] ![[_img-kb-lnx-glpi-agent-7.png]] Au moment de sélectionner les cibles, renseignez l'URL du serveur distant GLPI. Dans notre cas, nous utiliserons l'URL : http://10.0.2.254 mais si le système DNS est correctement configuré vous pouvez utiliser le nom de domaine à la place. > [!warning] Rappel ! Adaptez cette URL en fonction de votre configuration personnelle. Il faut saisir l'URL utilisée pour vous authentifier sur GLPI. ![[_img-kb-lnx-glpi-agent-8.png]] Pour finir, cliquez sur le bouton `[Install]`, patientez jusqu'à la fin de l'installation et cliquez sur le bouton `[Finish]` : ![[_img-kb-lnx-glpi-agent-9.png]] ![[_img-kb-lnx-glpi-agent-10.png]] ## Optionnel : Installer Glpi-Agent Monitor L'outil **Glpi-Agent Monitor** fournit une icône dans la zone de notification pour surveiller l'état de l'agent et permettre d'exécuter certaines tâches (arrêter le service, forcer l’inventaire, ouvrir un ticket, etc.) : - Téléchargez l’outil depuis la page de version du projet [Glpi-Agent Monitor](https://github.com/glpi-project/glpi-agentmonitor/releases). - Au choix : - Exécutez l'outil "_GLPI-AgentMonitor-x64.exe_" de façon manuelle et ponctuelle. - Collez le fichier "_GLPI-AgentMonitor-x64.exe_" dans le dossier suivant afin qu’il soit lancé automatiquement à l’ouverture de session de tous les utilisateurs : "`C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup`" ![[_img-kb-lnx-glpi-agent-15.png]] ## Vérifier la bonne exécution du service GLPI Agent pour Windows ### Vérifier l'état du service glpi-agent sous Windows Ouvrez la console "*Services*" (**services.msc**) sous Windows et vérifiez le statut du service "*GLPI Agent*" : il doit être "*En cours d'exécution*" avec un type de démarrage "*Automatique*". ![[_img-kb-lnx-glpi-agent-14.png]] ### Accès HTTP Agent GLPI pour Windows Lorsqu'il est exécuté en tant que service, l'Agent GLPI est accessible sur une interface HTTP qui, par défaut, est accessible sur le port **TCP 62354**. Un administrateur peut accéder à cette interface depuis n’importe quel emplacement du réseau à partir d'une URL. Dans cette démonstration, nous nous connecterons directement depuis le poste client Windows à l'adresse de loopback : http://127.0.0.1:62354. ![[_img-kb-lnx-glpi-agent-13.png]] Cette interface fournit quelques fonctionnalités de base : version de l’agent, cibles GLPI, date de prochaine exécution, et possibilité de forcer l’inventaire d’un poste. > [!danger] Attention ! En environnement de production, des mesures de sécurisation devront être appliquées, telles que : l'activation de l'authentification, l’activation de SSL, ou la définition des IP d’administration de confiance, etc. > [!warning] Ressources : Pour limiter la surface d’attaque, vous pouvez consulter la documentation officielle sur le site : [Glpi Agent - Plugins Security](https://glpi-agent.readthedocs.io/en/latest/plugins/index.html#security). Dans le cadre de cette démonstration, nous n'apporterons pas d'autres modifications à la configuration de l'agent. ## Vérifier la remontée des informations dans l'inventaire Ouvrez GLPI et vérifiez que le PC est bien remonté dans l’inventaire en cliquant sur le menu "**_Parc_**", puis "**Ordinateur**". Vous constaterez que la machine est bien remontée dans l'inventaire et que la date de dernière modification correspond à l'heure d'installation de l'agent : ![[_img-kb-glpi-inventaire-auto-agents-2.png]] Félicitations ! Vous avez configuré l’agent GLPI pour Windows et remonté une VM dans votre inventaire de façon automatique. # Déploiement de l'agent GLPI pour Linux Plusieurs approches sont disponibles pour l’installation de l’agent GLPI pour Linux en fonction de la distribution utilisée. Dans cette démonstration, nous utiliserons la méthode recommandée pour Debian 12 via un script d'installation Perl. > [!warning] Ressources : Les différentes méthodes d'installation sous Linux sont décrites dans la documentation officielle : [GLPI Agent GNU-Linux](https://glpi-agent.readthedocs.io/en/latest/installation/index.html#gnu-linux). ## Installation de GLPI Agent pour Linux (sous Debian 12) Pour cette démonstration, nous utiliserons un client Linux de type Debian 12. La version actuelle de GLPI Agent pour Linux est 1.13. Connectez-vous sur le site https://github.com/glpi-project/glpi-agent/releases pour connaître la dernière version disponible et adapter les commandes ci-dessous. Ouvrez un shell avec un compte utilisateur autorisé et installez les prérequis de l'application GLPI Agent : ``` sudo apt update && sudo apt install perl wget -y ``` Téléchargez le script Perl depuis le dépôt GitHub : ``` wget https://github.com/glpi-project/glpi-agent/releases/download/1.13/glpi-agent-1.13-linux-installer.pl ``` Modifiez les permissions du fichier afin de rendre le script exécutable par l’utilisateur et le groupe propriétaire : ``` chmod ug+x glpi-agent-1.13-linux-installer.pl ``` Lancez l’installation du script Perl : ``` sudo perl glpi-agent-1.13-linux-installer.pl ``` Renseignez l’URL du serveur GLPI et laissez les autres options vides. Par exemple, sur ma machine de démonstration, cela donne la sortie suivante : ![[_img-kb-lnx-glpi-agent-16.png]] Supprimez le fichier d'installation : ``` sudo rm glpi-agent-1.13-linux-installer.pl ``` ## Vérifier la bonne exécution du service GLPI Agent pour Linux ### Vérifier l'état du service GLPI Agent sous Linux Vérifiez la version de l'agent : ``` glpi-agent --version ``` ![[_img-kb-lnx-glpi-agent-18.png]] Vérifiez l’état du service "*glpi-agent*" : ``` sudo service glpi-agent status ``` Le service doit être "*enabled*" et "*active (running)*" comme dans l'exemple ci-dessous : ![[_img-kb-lnx-glpi-agent-17.png]] ### Vérifier l'état du service GLPI Agent sous Linux via HTTP Vous pouvez vérifier l'état du service GLPI Agent à l'aide de l'interface HTTP sur le port **TCP 62354**. Dans l'exemple ci-dessous, le service est dans le statut "*Waiting*". Cela signifie que le service est démarré et qu'il remontera son inventaire lors de la prochaine exécution planifiée. Connectez-vous à l'aide d'un navigateur sur l'adresse IP du client Linux et le port TCP 62354 : ![[_img-kb-lnx-glpi-agent-19.png]] Cette interface fournit quelques fonctionnalités de base : version de l’agent, cibles GLPI, date de prochaine exécution et possibilité de forcer l’inventaire d’un poste. > [!danger] Attention ! En environnement de production, des mesures de sécurisation devront être appliquées, telles que l'activation de l'authentification, l’activation de SSL, ou la définition des IP d’administration de confiance, etc. > [!warning] Ressources : Pour limiter la surface d’attaque, vous pouvez consulter la documentation officielle sur le site : [GLPI Agent - Plugins Security](https://glpi-agent.readthedocs.io/en/latest/plugins/index.html#security). Dans le cadre de cette démonstration, nous n'apporterons pas d'autres modifications à la configuration de l'agent. ## Vérifier la remontée des informations dans l'inventaire Ouvrez GLPI et vérifiez que le PC est bien remonté dans l’inventaire en cliquant sur le menu "**_Parc_**" puis "**Ordinateur**". Vous constaterez que la machine est bien remontée dans l'inventaire et que la date de dernière modification correspond à l'heure d'installation de l'agent : ![[_img-kb-glpi-inventaire-auto-agents-3.png]] Félicitations ! Vous avez configuré l’agent GLPI pour Linux et remonté une VM dans votre inventaire de façon automatique. # Résoudre les erreurs communes Si vous rencontrez des difficultés pour remonter cette machine dans l'inventaire, commencez par vérifier la connectivité entre le client et le serveur. ## Débogage de GLPI Agent pour Windows Ouvrez la console "*Services*" (**services.msc**) sous Windows. Vérifiez la présence du service **glpi-agent**, faites un clic droit et sélectionnez **Redémarrer**. ![[_img-kb-lnx-glpi-agent-11.png]] Forcez l'inventaire : - Connectez-vous à l’interface HTTP de l’agent GLPI (cf. ci-dessous). - Cliquez sur "*Force an Inventory*" et patientez quelques minutes. ![[_img-kb-lnx-glpi-agent-12.png]] Si vous avez installé GLPI Agent Monitor, vous pouvez également faire un clic droit sur l'icône dans la zone de notification Windows (en bas à droite, près de l'horloge) et choisir l'option "*Forcer l'inventaire*" : ![[_img-kb-glpi-inventaire-auto-agents-1.png]] Si le problème persiste, consultez les logs de l'agent GLPI disponibles sous "*C:\Program Files\GLPI-Agent\logs\glpi-agent.log*" et vérifiez les valeurs configurées dans la clé de registre. > [!info] À savoir ! Les options configurées pendant l'installation sont disponibles dans le registre : `HKEY_LOCAL_MACHINE\SOFTWARE\GLPI-Agent`. Par exemple, la valeur `server` contient l'URL du serveur GLPI. ## Débogage de GLPI Agent pour Linux Redémarrez le service glpi-agent : ``` sudo service glpi-agent restart ``` Affichez les informations et la date du dernier inventaire : ``` sudo glpi-agent ``` Pour forcer l’inventaire, utilisez l'agent HTTP via http://ip-client-linux:62354 ou la commande suivante : ``` sudo glpi-agent --force ``` Si le problème persiste, vérifiez l'URL du serveur utilisé : ``` sudo cat /etc/glpi-agent/conf.d/00-install.cfg ``` Activez la journalisation de l'agent en éditant le fichier "*agent.cfg*" : ``` sudo nano /etc/glpi-agent/agent.cfg ``` Recherchez l'option "*logfile*" et supprimez le symbole "*#*" pour activer la journalisation : ![[_img-kb-glpi-inventaire-auto-agents-4.png]] Redémarrez le service "*glpi-agent*" afin que les modifications soient prises en compte : ``` sudo service glpi-agent restart ``` Forcez l'inventaire : ``` sudo glpi-agent --force ``` Enfin, consultez les logs de l'agent GLPI avec la commande : ``` less /var/log/glpi-agent.log ``` # Conclusion En suivant cette procédure, vous êtes en mesure d'activer la gestion d'inventaire automatique sous GLPI et de remonter automatiquement vos machines clientes Windows ou Linux via l'agent natif de GLPI. Vous êtes également capable de diagnostiquer les erreurs de configuration courantes. Pour aller plus loin et envisager un déploiement massif en environnement, vous pouvez consulter les articles : - [Installer GLPI Agent pour Windows en ligne de commande](https://glpi-agent.readthedocs.io/en/latest/installation/windows-command-line.html). - [VBScript pour les déploiements massifs](https://glpi-agent.readthedocs.io/en/latest/installation/index.html#large-installations). ## Références Sources GLPI : - [GLPI Inventaire natif](https://glpi-project.org/fr/glpi-inventaire-natif/) - [Installation GLPI Agent](https://glpi-agent.readthedocs.io/en/latest/installation/)