Installer manuellement sans MID Agent Client Collector dans un Linux environnement

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • Installez manuellement MID-less Agent Client Collector sur un Linux ordinateur pour permettre l’envoi de données de l’agent à l’instance via le cloud. L’envoi d’informations via le cloud permet Serveur MID de les utiliser pour des ressources plus persistantes.

    Avant de commencer

    • Installez le module d’extension ITOM Cloud Services Core (sn_itom_cloud_svc).
    • Intégrez votre instance pour utiliser les ITOM services dans le cloud. Pour en savoir plus, contactez le service clientèle.
    • Configurez une clé d’inscription d’agent. Pour plus de détails, voir Configurer une clé d’inscription d’agent.
    • Rôle requis : agent_client_collector_admin

    Pourquoi et quand exécuter cette tâche

    Pour plus d’informations sur l’envoi de données via le cloud dans un déploiement sans MID, reportez-vous à la section DEX Architecture.

    Procédure

    1. Téléchargez le package d’installation correspondant.
      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.
    2. Facultatif : Vérifiez la signature du package.
      1. Extrayez le fichier d’installation (s’il est compressé) en exécutant la commande suivante :
        unzip agent_client-collector-<numéro_version>-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é PEM DGST ServiceNow > est le fichier .pem extrait du fichier .zip et < fichier de signature > correspond au 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 yum / dnf localinstall
      SLES Installation de Zypper
      Basé sur Debian apt-get install

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

      • Système basé sur 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 les modules d’extension 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 comme paramètre .rpm .

      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/share N/A
      /var/cache La mise à jour du répertoire /var conserve tous les sous-répertoires /var , imbriqués dans le nouveau répertoire.
      /var/log
      /var/run
      /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. Exécutez la commande de mise à niveau de package appropriée, en fonction du processeur avec lequel votre ordinateur s’exécute :
      • Processeur Intel : 
        sudo installer -pkg agent-client-collector-<version number>-macos_x64.pkg -target /
      • Apple Processeur en silicium :
        sudo installer -pkg agent-client-collector-<version number>-macos_arm64.pkg -target /

      Cette commande sauvegarde et restaure également l’ID de l’agent et les fichiers de configuration avant la mise à niveau.

    5. Dans le fichier de configuration acc.yml :
      1. Définissez les paramètres suivants :
        Paramètre Valeur
        URL back-end « <URL de la passerelle> »
        connecter sans MID vrai
        URL d’instance « <URL d’instance> »
        clé_inscription « <clé-régulation> »
        non sécurisé-ignorer-tls-vérifier Faux
      2. Commentez le api-key paramètre.
    6. Enregistrez le fichier de configuration.
    7. Configurez l'agent pour qu'il s'exécute en tant que service.
      1. Protégez la consommation de ressources en ajoutant les valeurs indiquées au fichier /usr/lib/systemd/system/acc.service .
        • CPUShares = 128
        • CPUQuota=10 %
        • MemoryLimit=192M
        • BlockIOWeight=10
        • LimitNICE=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écuter la commande recharger le démon Si vous avez modifié le fichier de service après avoir activé le service ACC.

        # rechargement démon systemctl

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

        # systemctl activer ACC

        # systemctl démarrer ACC