Installer un agent
Créez un agent depuis le web et exécutez sur le serveur la commande que vous fournit l'écran, sous Linux ou sous Windows.
Sur cette page
Créez l'agent dans ARGUNIS, puis installez-le sur le serveur avec la commande et la clé affichées à l'écran.
Avant de commencer
Il vous faut le rôle administrateur.
Votre forfait doit disposer d'un quota d'agents.
Accès au serveur :
Linux : en tant que root. Pour l'installation avec systemd, le serveur a besoin de Node.js 22 ou supérieur ; vous pouvez aussi l'installer avec Docker.
Windows : PowerShell en tant qu'Administrateur, sous Windows Server 2016 ou ultérieur, ou Windows 10/11.
Étape 1 : créer l'agent
Allez dans Paramètres → Supervision → Agents.
Appuyez sur Nouvel agent.
Dans Serveur où vous l'installerez, choisissez le serveur si vous le supervisez déjà, ou Autre serveur (pas encore supervisé). L'agent est placé dans le même groupe de l'inventaire et la même catégorie que le serveur choisi.
Si vous réinstallez l'agent sur un serveur qui en a déjà eu un, la liste affiche aussi ses serveurs inactifs avec « Inactif : reprendre ce serveur ». Choisissez celui-ci : le nouvel agent poursuit l'historique de ce serveur au lieu d'en créer un nouveau.
Facultatif : saisissez le Nom de l'agent. Si vous le laissez vide, il prend le nom du serveur suivi de
-agent. Il accepte de 2 à 40 lettres, chiffres, espaces, points, tirets et tirets bas.Appuyez sur Créer l'agent.
Une fenêtre s'ouvre avec le nom de l'agent et les instructions d'installation.
Copiez la commande et la clé à ce moment-là : la clé ne s'affiche qu'une seule fois, ne sert que pour un seul hôte et expire à la date indiquée dans la fenêtre. Si vous la perdez, générez-en une autre avec Nouvelle clé.
Étape 2 : installer sous Linux
Dans la fenêtre, choisissez l'onglet Linux.
Dans Étape 1 · installez, copiez avec Copier la commande correspondant à votre type d'installation. S'il y a plusieurs serveurs ARGUNIS auxquels se connecter, vous verrez une paire de commandes pour chacun :
systemd (Node.js 22+), pour un serveur Linux classique.
Docker, si vous préférez l'exécuter comme conteneur.
Collez la commande sur le serveur et exécutez-la en tant que root.
Dans Étape 2 · collez la clé quand l'installateur la demande, copiez la Clé d'installation (usage unique) et collez-la quand l'installateur la demande. Rien ne s'affiche à l'écran quand vous la collez : c'est normal. Appuyez sur Entrée.
Dans certains cas, la fenêtre affiche un autre ordre : d'abord Étape 1 · enregistrez la clé, avec une commande pour l'enregistrer dans un fichier protégé (vous exécutez la commande, collez la clé, appuyez sur Entrée puis sur Ctrl+D), et ensuite Étape 2 · installez. Suivez les étapes telles qu'elles apparaissent.
Étape 2 : installer sous Windows
Dans la fenêtre, choisissez l'onglet Windows.
Ouvrez PowerShell en tant qu'Administrateur sur le serveur.
Copiez la commande de Windows (PowerShell) et collez-la. Elle tient sur une seule ligne.
Quand l'installateur la demande, collez la Clé d'installation (usage unique). Elle ne s'affiche pas quand vous la collez. Appuyez sur Entrée.
Si l'onglet Windows indique que l'installateur Windows n'est pas encore publié, demandez de l'aide à Argunis avant d'installer.
Vérifier l'installateur
Avant d'exécuter, vous pouvez vérifier que l'installateur est bien l'original. La section Vérification affiche l'URL de l'installateur et son empreinte SHA-256 (sous Windows, celle de l'installateur Windows). À la fin se trouve la Clé publique du serveur. Avec Tout copier, vous copiez toutes les instructions en une fois.
Ce qui se passe ensuite
Quand l'agent se connecte, la liste des Agents affiche son état, sa version, son type d'installation et son dernier rapport.
Le serveur apparaît dans Infrastructure → Serveurs avec ses métriques. Voir Données fournies par l'agent.