Pour installer un nouvel agent Outpost, on génère d'abord un token d'enrôlement dans Portail ZAPP, puis on lance sur la machine la commande d'installation proposée. L'agent se présente avec ce token, qui ne sert qu'une fois. Les packages d'installation déposés dans Portail ZAPP servent à la fois à l'installation et aux mises à jour.
Les écrans sont réservés au groupe Administrateurs. On y accède par le menu Outpost (entrées Outposts, Packages et Tokens d'enrôlement).
Générer un token d'enrôlement
Sur la page Outposts, cliquez sur Générer un token d'enrôlement et renseignez :
- Hostname (optionnel) : si renseigné, seul un agent s'annonçant exactement sous ce nom pourra utiliser le token (lettres, chiffres, points, tirets et soulignés). Sous Linux, la commande générée impose ce nom à l'agent. Sous Windows, ce doit être le nom de l'ordinateur (
%COMPUTERNAME%), ce que la page rappelle ; - Machine ID (optionnel) : même principe, avec l'identifiant matériel de la machine ;
- Durée de validité (minutes) : entre 1 et 1 440 minutes (24 h), 60 par défaut ;
- Paramètres d'installation (optionnel) : réglages du journal de l'agent, mémorisés pour toute l'instance et repris dans les commandes générées à l'étape suivante. Laissés sur Défaut de l'agent, ils ne figurent pas dans les commandes :
| Paramètre | Valeurs | Défaut de l'agent |
|---|---|---|
| LogSinks | file : fichiers de journal dans le dossier des journaux ; native : Journal d'événements Windows, ou journal système (journald) sous Linux ; both : les deux | both |
| LogLevel | Trace, Debug, Information, Warning, Error, Critical, du plus détaillé au plus restreint | Information |
| Dossier des journaux (Windows) | chemin absolu (lettre de lecteur, ou partage réseau \\serveur\partage\…) où le compte du service peut écrire, sans guillemet, accent grave ni signe dollar ; utile seulement avec file ou both |
sous-dossier logs du dossier de l'agent dans %ProgramData% |
| Dossier des journaux (Linux) | chemin absolu commençant par / où le compte du service peut écrire, sans antislash, guillemet, apostrophe, accent grave ni signe dollar ; utile seulement avec file ou both |
/var/log/webbase-outpost |
Un niveau changé ensuite depuis la fiche de l'agent l'emporte sur LogLevel, y compris après un redémarrage. Le dossier Windows ne sert qu'à la commande Windows, le dossier Linux qu'au fichier de configuration Linux. Une valeur refusée est signalée champ par champ et aucun token n'est généré. Si l'adresse publique de l'instance n'est pas configurée, les commandes portent https://<App:BaseUrl> : remplacez-la par l'adresse du serveur.
Cliquez sur Générer. La page Token d'enrôlement généré affiche le token et sa date d'expiration : « Copiez ce token maintenant. » Il ne sera plus jamais affiché après avoir quitté cette page, car il n'est jamais stocké en clair. Le bouton Copier le place dans le presse-papiers.
La section Commande d'installation donne, prêtes à copier :
- Windows (MSI) : le téléchargement du package depuis votre instance, puis l'installation silencieuse, à lancer dans un PowerShell administrateur (le token est passé par un fichier temporaire, supprimé après lecture) ;
- Linux (.deb) : le téléchargement du paquet (la commande échoue si aucun package n'est disponible), les commandes qui créent le fichier de configuration
/etc/webbase-outpost/outpost.env, lisible par root seul, puis l'installation.
Si l'agent est refusé à l'enrôlement, la réponse du serveur en donne le motif : token expiré, déjà utilisé, révoqué, ou nom de machine différent de celui lié au token. Dans ce dernier cas, le journal de l'application indique le nom annoncé par l'agent.
Le téléchargement utilise le token lui-même : il ne fonctionne que tant que le token est valide, et seulement si un package courant existe pour la plateforme. Cliquez enfin sur J'ai copié le token. Une fois installé, l'agent apparaît dans la liste des Outposts.
Les tokens d'enrôlement
La page Tokens d'enrôlement (bouton du même nom sur la liste des Outposts) liste les tokens générés : statut, machine à laquelle il est Lié à (ou Non lié), dates de création, d'expiration et d'utilisation, auteur. Un token est Valide, Consommé (déjà utilisé par un agent), Expiré ou Révoqué. Révoquer (pour un token valide) empêche qu'il soit encore utilisé.
Les packages d'installation
La page Packages d'installation Outpost liste les packages déposés : plateforme, version, fichier, taille, date et statut : Courante (la version distribuée), Disponible (jamais activée : elle attend que vous l'activiez) ou Archivée (elle a été la version courante et ne l'est plus). Les plus récents viennent en premier ; la liste se trie, se filtre et se pagine.
- Uploader un package : choisissez le Fichier, indiquez sa Version et un Motif de plateforme (par exemple « Debian GNU/Linux 13 »). Ce texte est comparé, sans tenir compte des majuscules, au système d'exploitation remonté par l'inventaire de chaque agent pour choisir le bon package ;
- Activer fait d'un package la version courante pour son motif de plateforme : la version courante précédente passe en Archivée. Désactiver (sur la version courante) retire ce statut sans en activer une autre : plus rien n'est distribué pour cette plateforme (mise à jour automatique, mise à jour manuelle, commandes d'installation) jusqu'à la prochaine activation. Supprimer retire un package, après confirmation.
Site public des versions : quand l'adresse du site est renseignée dans la configuration (Outpost:Packages:FeedUrl), Portail ZAPP vérifie toutes les heures la dernière version publiée de l'agent et l'ajoute aux packages, avec l'origine Site public. La signature de la publication, la taille et l'empreinte de chaque fichier sont vérifiées : un fichier non conforme n'est jamais ajouté. Par défaut, la nouvelle version est ajoutée sans être activée, avec le statut Disponible : cliquez sur Activer pour la distribuer (ou réglez Outpost:Packages:FeedAutoActivate à true). Une version supprimée n'est jamais réimportée, et une version plus ancienne que la version courante est ignorée. Le cadre Site public des versions affiche la dernière vérification et son résultat ; Vérifier maintenant la relance. Après plusieurs échecs d'affilée, une alerte apparaît dans la gestion des événements.
Auto-update automatique : quand il est Activé, Portail ZAPP envoie la version courante à chaque agent actif qui se connecte avec une autre version. Un contrôle périodique (par défaut toutes les 5 minutes) rattrape aussi les agents restés connectés. Quand il est Désactivé, un agent ne se met à jour que si vous cliquez sur Forcer l'envoi de la version courante dans sa fiche.