Installer Agent Client Collector sur un Linux système

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 7 minutes de lecture

    • Installez Agent Client Collector à l’aide d’un outil de distribution de packages. Avant l’installation, vous pouvez installer manuellement sur Agent Client Collector quelques ordinateurs pour vous assurer que vos agents contiennent les politiques et les vérifications correctes avant d’installer un grand nombre d’agents.

    Avant de commencer

    • Assurez-vous que l’écouteur Agent Client Collector est configuré sur votre Serveurs MID et que le service est disponible à partir de vos hôtes cibles.
    • Vérifiez que le système d’exploitation et la version de votre serveur sont pris en charge. Pour obtenir la liste des systèmes d’exploitation et des versions pris en charge, reportez-vous à la section Agent Client Collector L’installation.
    • Vérifiez s’il existe des restrictions ou des exigences à prendre en compte pendant le déploiement, comme la spécification d’un compte autre que le compte ServiceNow par défaut. Pour en savoir plus sur l’intégration de l’agent dans votre propre système automatisé, consultez la documentation ITOM Agent Client Collector [KB1122613].
    • Assurez-vous que les Serveur MID extensions et son Serveur Web MID et ACC Websocket Endpoint sont opérationnels.
    • Activez le mode d’image de référence pour cloner des agents supplémentaires en définissant le marqueur d’image de référence situé dans /tmp/acc-goldenimage. Le marqueur d’image dorée n’intervient pas lors des nouvelles Linux installations, car il n’y a rien qui nécessite un nettoyage.
    • Récupérez les informations de l’écouteur Serveur MID ACC à spécifier dans le paramètre de l’agent backend-url .
      1. Accédez à la Tous > Agent Client Collector > Déploiement > Serveurs MID.
      2. Sélectionnez un Serveur MID.
      3. Sélectionnez l’onglet Points de terminaison Websocket ACC .
      4. Sélectionnez un point de terminaison websocket.
      5. Copiez la valeur dans le champ URL du point de terminaison .
    • Récupérez la Serveur MID clé API spécifiée dans le paramètre de l’agent api-key .
      1. Accédez à la Tous > Agent Client Collector > Déploiement > Clé API du serveur Web MID.
      2. Sélectionnez la clé API que vous souhaitez utiliser.
      3. Dans la section Liens connexes , sélectionnez Afficher la clé API.
      4. Copiez la valeur de la clé API et fermez la fenêtre contextuelle.

    Rôle requis : agent_client_collector_admin

    Pourquoi et quand exécuter cette tâche

    Lors Linux de l’installation (et de la mise à niveau), le fichier exécutable de l’agent est activé avec Linux des options (CAP_SETFCAP, CAP_SETPCAP) par défaut. Les applications de stockage telles que Analyse des journaux d'Agent Client Collector (ACC-L) peuvent l’utiliser pour accorder des capacités de lecture de l’intégralité du système de fichiers (CAP_DAC_READ_SEARCH). Le système est soumis à diverses mesures de sécurité, telles que la double vérification de l’origine du contenu, l’exploitation du processus de vérification du module d’extension, etc., afin de s’assurer que l’octroi d’options ne pose pas de risque de sécurité. Cette procédure suppose que vous connaissez bien les commandes pour Linux les options.

    Pour désactiver ces fonctionnalités améliorées, exécutez les commandes suivantes, en fonction de votre Linux système d’exploitation/d’emballage :

    Tableau 1. Commandes de désactivation de l’aptitude améliorée de Linux
    Système d’exploitation/d’emballage Commandes
    RPM

    ACC_SKIP_CAPS=vrai yum / dnf localinstall

    ACC_SKIP_CAPS=true rpm -vi agent-client-collector-<numéro de version>-x86_64.rpm
    Debian

    ACC_SKIP_CAPS=true apt-get install

    ACC_SKIP_CAPS=true dpkg -i agent-client-collector-<numéro de version>-<distro>_amd64.deb
    SLES

    ACC_SKIP_CAPS= vrai Installation de Zypper

    Procédure

    1. Téléchargez les packages d’installation correspondants.
      • Pour une installation manuelle :
        1. Accédez à la > Agent Client Collector > Déploiement > Téléchargements de l'agent.
        2. Téléchargez le fichier d’installation .rpm ou .deb pertinent.
        3. Téléchargez les fichiers de signature pertinents pour valider les fichiers d’installation.
      • Pour une installation sur ligne de commande, exécutez les commandes suivantes pour télécharger les fichiers de signature et d’installation sur votre ordinateur local :
        curl -LO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-<version_number>-x86_64.rpm
curl -LO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-<version_number>-x86_64-rpm-rpm.zip
        Remarque :
        Chaque commande curl doit apparaître sur une seule ligne.
    2. Facultatif : Vérifiez la signature du package.
      1. Extrayez le fichier d’installation (s’il est compressé) en exécutant la commande suivante :
        Décompresser agent_client-collector-<version_number>-x86_64-rpm-rpm.zip
      2. Validez la signature du fichier d’installation en exécutant les commandes indiquées.
        • Sur un système RPM :
          openssl dgst -sha256 -verify {<ServiceNow DGST pem key>} -signature {<signature file>} agent-client-collector-<version number>-x86_64.rpm

          Où < clé ServiceNow DGST pem > est le fichier .pem extrait du fichier .zip et < fichier de signature > est le fichier .bin extrait du fichier .zip .

          Par exemple : 
          $ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-x86_64.rpm
$ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-x86_64-rpm-rpm.zip
$ unzip agent-client-collector-3.0.0-x86_64-rpm-rpm.zip
Archive: agent-client-collector-3.0.0-x86_64-rpm-rpm.zip
inflating: ServiceNow_Digicert_DGST.pem
extracting: agent-client-collector-3.0.0-x86_64.bin
$ openssl dgst -sha256 -verify ServiceNow_Digicert_DGST.pem -signature agent-client-collector-3.0.0-x86_64.bin agent-client-collector-3.0.0-x86_64.rpm
Verified OK
          Remarque :
          Chaque commande doit apparaître sur une seule ligne.
        • Sur un système basé sur Debian :

          gpg --import ServiceNow_Digicert_Public.gpg

          sudo gpg --verify agent-client-collector-<numéro de version>-<distro>_amd64.deb

          Par exemple :
          $ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-debian-9_amd64.deb
$ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-debian-9_amd64-deb-deb.zip
$ unzip agent-client-collector-3.0.0-debian-9_amd64-deb-deb.zip
Archive: agent-client-collector-3.0.0-debian-9_amd64-deb-deb.zip
extracting: ServiceNow_Digicert_Public.gpg
$ gpg --import ServiceNow_Digicert_Public.gpg
gpg: /home/admin/.gnupg/trustdb.gpg: trustdb created
gpg: key 985DD52C6A0ABB45: public key "ServiceNow, Inc. (Signing) <seceng@servicenow.com>"
imported
gpg: Total number processed: 1
gpg: imported: 1
$ dpkg-sig --verify agent-client-collector-3.0.0-debian-9_amd64.deb
Processing agent-client-collector-3.0.0-debian-9_amd64.deb...
GOODSIG _gpgbuilder 9B928FB49771DF6C047430DD985DD52C6A0ABB45 1665054068
          Remarque :
          Chaque commande doit apparaître sur une seule ligne.
    3. Installez le Agent Client Collector package à l’aide du gestionnaire de packages associé à Linux la distribution.
      Systèmes d'exploitation Commande
      Basé sur RHEL Installation locale Yum / DNF
      SLES Installation de Zypper
      Basé sur Debian installation apt-get

      Si ces commandes ne sont pas configurées correctement, vous pouvez également utiliser les commandes de base configurées pour s’exécuter avec les commandes du gestionnaire de packages.

      • Système RPM : # rpm -vi agent-client-collector-<numéro de version>-x86_64.rpm
      • Système basé sur Debian : # dpkg -i agent-client-collector-<numéro de version>-<distro>_amd64.deb

      Vérifiez que les commandes du package sont correctement configurées avec votre administrateur système.

      Remarque :
      Certains systèmes de fichiers peuvent avoir des restrictions activées ; Par exemple, /var/ peut être monté avec un noexec drapeau. Étant donné que l’agent doit exécuter Agent Client Collector des modules d’extension qui sont normalement stockés dans le répertoire /var/cache , vous devez déployer l’application dans des dossiers spécifiques en personnalisant les chemins d’installation à l’aide de l’option --relocate.rpm paramètre.

      Par exemple : rpm -i --relocate /var/cache=/opt/cache agent-client-collector-<version_number>-x86_64.rpm

      Les chemins d’accès suivants peuvent être déplacés :
      Chemin d'accès Notes
      /etc Lors de la mise à jour, vous devez également mettre à jour le allow-list paramètre du fichier acc.yml avec le nouveau chemin.
      /usr/partager N/A
      /var/cache La mise à jour du répertoire /var conserve tous les sous-référentiels /var , imbriqués dans le nouveau répertoire.
      /var/journal
      /var/exécuter
      /var
      Examinez les chemins d’accès dans /usr/lib/systemd/system/acc.service pour vous assurer qu’ils s’affichent comme prévu.
    4. Lors de l’installation d’un package .deb, configurez le fichier de configuration acc.yml de l’agent.
      1. Copiez l’exemple de fichier de configuration en exécutant la commande suivante.

        # cp -p /etc/servicenow/agent-client-collector/acc.yml.example /etc/servicenow/agent-client-collector/acc.yml

      2. Renommez le fichier de liste d’autorisation.

        # cp -p /etc/servicenow/agent-client-collector/check-allow-list.json.default /etc/servicenow/agent-client-collector/check-allow-list.json

      Remarque :
      Cette étape n’est pas pertinente pour les packages .rpm, qui sont fournis avec des fichiers acc.yml et check-allow-list.json inclus dans le système de base.
    5. Mettez à jour le fichier de configuration, en ajoutant check-allow-list.json à /etc/servicenow/agent-client-collector et en copiant l’URL back-end et la clé API à partir de l’instance.
      Par exemple :
      ---
# Agent Client Collector configuration
backend-url:
 - "wss://YOUR_MID_ENDPOINT_HERE:YOUR_MID_PORT_HERE/ws/events"
api-key: "YOUR_API_KEY_HERE"
log-level: "info"
insecure-skip-tls-verify: false
allow-list: /etc/servicenow/agent-client-collector/check-allow-list.json
verify-plugin-signature: true
max-running-checks: 10
disable-sockets: true
disable-api: true
statsd-disable: true
enable-auto-mid-selection: false
agent_cpu_threshold:
 cpu_percentage_limit: 25
 repeated_high_cpu_num: 3 
 monitor_interval_sec: 60
 agent_cpu_threshold_disabled: false

      La allow-list fonctionnalité, qui indique les commandes autorisées à être exécutées par l’agent, est activée.

    6. Configurez sudoers.

      La configuration est généralement automatisée par votre Linux administrateur système. Pour effectuer une configuration manuelle en veillant à l’exactitude avant la configuration complète, exécutez les opérations suivantes pour créer un nouveau fichier sudoers pour l’utilisateur du service d’agent :

      visudo -f /etc/sudoers.d/01_servicenow

    7. Ajoutez la configuration sudoers en fonction de votre Linux distribution.

      • Lors de l’installation d’agents sur un système deb/ubuntu, exécutez les éléments suivants :

        User_Alias ACC_USERS = servicenow
Cmnd_Alias ACC_CMD = /usr/sbin/dmidecode -s baseboard-serial-number,/usr/sbin/dmidecode -s chassis-serial-number,/usr/sbin/dmidecode -s system-serial-number,/usr/sbin/dmidecode -s system-uuid,/usr/sbin/ss -tanp,/usr/bin/systemctl start 
acc,/usr/bin/systemctl stop acc,/usr/bin/dpkg --install --refuse-downgrade --skip-same-version /var/cache/servicenow/agent-client-collector/upgrade/agent-client-collector-upgrade*
Cmnd_Alias ACC_CMD_SETENV = /usr/bin/netstat -ltnup,/usr/bin/ls -l /proc/*,/usr/bin/cat /proc/*
ACC_USERS ALL = (root) NOPASSWD:ACC_CMD
ACC_USERS ALL = (root) NOPASSWD:SETENV:ACC_CMD_SETENV
Defaults:ACC_USERS !requiretty

      • Lors de l’installation d’agents sur un système RPM, exécutez les éléments suivants :

        User_Alias ACC_USERS = servicenow
Cmnd_Alias ACC_CMD = /usr/sbin/dmidecode -s baseboard-serial-number,/usr/sbin/dmidecode -s chassis-serial-number,/usr/sbin/dmidecode -s system-serial-number,/usr/sbin/dmidecode -s system-uuid,/usr/sbin/ss -tanp,/usr/bin/systemctl start 
acc,/usr/bin/systemctl stop acc,/usr/bin/rpm -Uv /var/cache/servicenow/agent-client-collector/upgrade/agent-client-collector-upgrade.rpm
Cmnd_Alias ACC_CMD_SETENV = /usr/bin/netstat -ltnup,/usr/bin/ls -l /proc/*,/usr/bin/cat /proc/*
ACC_USERS ALL = (root) NOPASSWD:ACC_CMD
ACC_USERS ALL = (root) NOPASSWD:SETENV:ACC_CMD_SETENV
Defaults:ACC_USERS !requiretty
    8. Configurez l’agent à exécuter en tant que service.
      1. Sauvegardez la consommation de ressources en ajoutant les valeurs indiquées au fichier /usr/lib/systemd/system/acc.service .
        • CPUShares = 128
        • CPUQuota=10 %
        • Limite de mémoire = 192 Mo
        • BlocIOWhuit=10
        • LimiteNICE=15

        Par exemple :

        # vi /usr/lib/systemd/system/acc.service
[Unit]
Description=Agent-Now acc
After=network-online.target
[Service]
Environment=AGENT_ROOT=/usr/share
Environment=AGENT_CACHE_ROOT=/var/cache
Environment=AGENT_CONFIG_ROOT=/etc
Environment=AGENT_LOG_ROOT=/var/log
Environment=AGENT_RUN_ROOT=/var/run
Environment=RUBYOPT=-Eutf-8
User=servicenow
Group=servicenow
ExecStart=/usr/share/servicenow/agent-client-collector/bin/acc-service start acc
KillMode=process
Restart=on-failure
RestartSec=1min
CPUShares=128
CPUQuota=10%
MemoryLimit=192M
BlockIOWeight=10
LimitNICE=+15
[Install]
WantedBy=network-online.target
      2. Exécutez la commande reload daemon Si vous avez modifié le fichier de service après avoir activé le service acc.

        # systemctl daemon-reload

      3. Activez et démarrez le service en exécutant les commandes suivantes.

        # systemctl activer ACC

        # Systemctl Démarrer ACC