--- sourceDocument: Gestion des opérations IT Australie sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/it-operations-management Release : - australia ft:locale : - fr-FR ft:publication_title : - Gestion des opérations IT Australie ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Installer ACC sur un système Linux # Installer Agent Client Collector sur un Linux système {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/SyrZVAMWaDXOt~WIrPLHDw "Vous pouvez installer le sur n’importe Agent Client Collector quel ordinateur hôte pris en charge. Le se Agent Client Collector connecte à Serveur MID l’aide du protocole HTTP/S et la connexion reste active après avoir été établie. L’un d’eux Serveur MID peut gérer plusieurs agents simultanément, tandis qu’un seul agent travaille avec un Serveur MID par un et passe à un autre Serveur MID si nécessaire pour assurer la protection contre le basculement."). * 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\].](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=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 TousAgent Client CollectorDéploiementServeurs 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 . {#install-acc-linux__ol_wpd_4bj_pvb} * Récupérez la Serveur MID clé API spécifiée dans le paramètre de l'agent api-key . 1. Accédez à la TousAgent Client CollectorDéploiementClé 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. {#install-acc-linux__ol_i4d_4dj_pvb} {#install-acc-linux__ul_cvh_2z3_pvb} 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 : {#install-acc-linux__table_zgx_pfw_vcc__entry__2} | Système d'exploitation/d'emballage | Commandes | |-|-| | RPM | `ACC_SKIP_CAPS=vrai yum / dnf localinstall` `ACC_SKIP_CAPS=true rpm -vi agent-client-collector--x86_64.rpm` | | Debian | `ACC_SKIP_CAPS=true apt-get install` `ACC_SKIP_CAPS=true dpkg -i agent-client-collector--_amd64.deb` | | SLES | `ACC_SKIP_CAPS= vrai Installation de Zypper` | [Tableau 1. Commandes de désactivation de l'aptitude améliorée de Linux] {#install-acc-linux__table_zgx_pfw_vcc} ## Procédure 1. Téléchargez les packages d'installation correspondants. * Pour une installation manuelle : 1. Accédez à la Agent Client CollectorDéploiementTé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. {#install-acc-linux__ol_adz_cfj_pvb} * 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--x86_64.rpm curl -LO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector--x86_64-rpm-rpm.zip Remarque : Chaque commande curl doit apparaître sur une seule ligne. {#install-acc-linux__choices_t4l_52j_pvb} 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--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 {} -signature {} agent-client-collector--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--_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) " 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. {#install-acc-linux__ul_jpv_tw4_pvb} {#install-acc-linux__substeps_pmf_l54_pvb} 3. Installez le Agent Client Collector package à l'aide du gestionnaire de packages associé à Linux la distribution. {#install-acc-linux__table_oqf_1bp_pvb__entry__2} | Systèmes d'exploitation | Commande | |-|-| | Basé sur RHEL | `Installation locale Yum / DNF` | | SLES | `Installation de Zypper` | | Basé sur Debian | `installation apt-get` | [ ] {#install-acc-linux__table_oqf_1bp_pvb} 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--x86_64.rpm` * Système basé sur `Debian : # dpkg -i agent-client-collector--_amd64.deb` {#install-acc-linux__ul_zcn_2dp_pvb} 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--x86_64.rpm` Les chemins d'accès suivants peuvent être déplacés :{#install-acc-linux__table_mjp_j2p_pvb__entry__2} | 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 | La mise à jour du répertoire /var conserve tous les sous-référentiels /var , imbriqués dans le nouveau répertoire. | | /var/exécuter | La mise à jour du répertoire /var conserve tous les sous-référentiels /var , imbriqués dans le nouveau répertoire. | | /var | La mise à jour du répertoire /var conserve tous les sous-référentiels /var , imbriqués dans le nouveau répertoire. | [ ] {#install-acc-linux__table_mjp_j2p_pvb}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` {#install-acc-linux__substeps_ehc_nfp_pvb} 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 {#install-acc-linux__ul_vvt_kxm_p3c} 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 {#install-acc-linux__ul_eyh_msp_pvb} 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` {#install-acc-linux__substeps_v55_ry1_rvb} {#install-acc-linux__steps_kgm_ck4_fwb}