Mettre à niveau un agent dans une instance

Rversion finale: Australia

Mis à jour 12 mars 2026

3 minutes de lecture

Effectuez une auto-mise à niveau sélective au lieu d’une mise à niveau en bloc pour une efficacité accrue lorsque vous travaillez avec des agents difficiles d’accès, tels que des agents déployés dans le cloud. Vous pouvez effectuer une mise à niveau sélective sur un maximum de 20 agents à la fois.

Avant de commencer

Remarque :

La mise à niveau sélective est disponible pour les agents de la version 2.7.0 et des versions ultérieures.

Systèmes d’exploitation pris en charge : Windows et Linux.

Assurez-vous que les fichiers de données sont à jour en redémarrant et en collectant les données de l’hôte Serveur MID . Pour plus d’informations sur la collecte des données hôte, reportez-vous à la section Exécuter la collecte de données de l’hôte sur demande.

Remarque :

Lorsque vous travaillez dans un Linux environnement, assurez-vous que vous disposez des autorisations sudo et que les configurations suivantes sont définies :

Tableau 1. Systèmes d’exploitation Linux
Systèmes d'exploitation	Version de SE	Commandes	Version de l'agent
CentOS,Red Hat	7, 8	`/usr/bin/systemctl démarrer ACC` `/usr/bin/systemctl Arrêter ACC` `<emplacement systemctl> daemon-reload` (l’emplacement par défaut est `/usr/bin`) `/usr/bin/rpm -UV <emplacement du répertoire cache>/upgrade/agent-client-collector-upgrade.rpm` Emplacement du répertoire de cache par défaut : `/var/cache/servicenow/agent-client-collector` `unzip -o` : décompresse le fichier de signature pour valider l’installation. `OpenSSL dgst -SHA256 -Verify` : vérifie l’utilisation d’une signature à partir d’un fichier d’installation ServiceNow. Remarque : Si vous avez installé l’agent à l’aide de l’indicateur Linux`--relocate` (par exemple, `rpm -i --relocate /var/cache=/opt/cache agent-client-collector-<version_number>-x86_64.rpm` ), vous devez être autorisé à exécuter les commandes suivantes : `sudo /usr/bin/rpm -q --queryformat '[ %{PREFIXES}\\n]' agent-client-collector` `sudo /usr/bin/rpm -q --queryformat '[ %{INSTPREFIXES}\\n]' agent-client-collector` Ces commandes sont utilisées par le script de mise à niveau pour détecter les déplacements d’origine et générer la commande de mise à niveau appropriée. Une mise à niveau sans les commandes de déplacement peut entraîner l’échec de l’installation.	2.7
Debian, Ubuntu		`/usr/bin/systemctl démarrer ACC` `/usr/bin/systemctl Arrêter ACC` `<emplacement systemctl> daemon-reload` (l’emplacement par défaut est `/usr/bin`) `/usr/bin/dpkg --install --refuse-downgrade --skip-same-version <emplacement du répertoire de cache>/upgrade/agent-client-collector-upgrade.deb` Emplacement du répertoire de cache par défaut : `/var/cache/servicenow/agent-client-collector` `unzip -o : décompresse le fichier de signature pour valider l’installation` `gpg -import & gpg --verify : vérifie l’utilisation d’une signature provenant d’un fichier d’installation ServiceNow.`	2.7

Lors de la connexion via un Serveur MID, les installations ACC doivent accéder à l’une des URL suivantes :

https://<URI-MID-WEBSERVER :PORT>/statique/acc_installers/agent-client-collector
https://install.service-now.com/

Lors de la mise à niveau des agents sans MID, la mise à niveau est effectuée à l’URL définie dans la agent-upgrade-url-path propriété du fichier acc.yml. Si aucune URL n’est définie au niveau de cette propriété, la mise à niveau est effectuée en téléchargeant le script du programme d’installation à partir de l’URL du réseau de diffusion de contenu (CDN) suivante : https://cdn-install.sncapps.service-now.com/glide/distribution/builds/package

Remarque :

Lorsque vous utilisez un CDN, envoyez votre demande de téléchargement via un serveur proxy, pour plus de sécurité. Pour plus de détails, voir Configurer les proxys lors de l’exécution d’une mise à niveau sans MID à l’aide d’un réseau de diffusion de contenu (CDN).

Sélectionnez la version vers laquelle vous souhaitez mettre à niveau votre agent.

Accédez à la Tous > Propriétés système > Toutes les propriétés.
Sélectionnez Nouveau.
Affectez les valeurs suivantes :
- Nom = sn_agent.agent_upgrade_version
- Type = chaîne
- Valeur = numéro de version à mettre à niveau, au format <major_version.minor_version.patch_version>. Par exemple : 4.3.2
Sélectionnez Envoyer.

Si vous ne sélectionnez pas une version, l’agent effectue automatiquement une mise à niveau vers la version actuelle Cadre de travail d'Agent Client Collector de l’application incluse dans le périmètre.

Rôle requis :

Windows: compte SYSTEM local (Agent Client Collector service s’exécutant en tant que Local System)
Linux: sudo rpm/dpkg
MacOS: paquet sudo

Pourquoi et quand exécuter cette tâche

Agent Client Collector prend en charge l’auto-mise à niveau sélective dans les systèmes d’exploitation suivants :

Windows: en raison de restrictions UAC, l’agent Windows doit s’exécuter en tant que compte SYSTEM local pour effectuer la mise à niveau via msiexec.
Linux: RPM et DEB

Procédure

Accédez à la Tous > Agent Client Collector > Agents.
Sélectionnez l’agent que vous souhaitez mettre à niveau.
Dans la section Liens connexes , sélectionnez Mettre à niveau l’agent.
Dans la boîte de dialogue de confirmation, sélectionnez Mettre à niveau.
La page Historiques de mise à niveau de l’agent s’affiche, dans laquelle vous pouvez surveiller la progression de la mise à niveau dans la colonne État , qui affiche soit Réussite , soit Échec.
Affichez le journal de mise à niveau de l’agent dans la colonne Message .
En cas d’échec de mise à niveau sur une Linux machine, accédez au fichier <emplacement du répertoire cache>/upgrade/agent-client-collector-upgrade.rpm et assurez-vous que les configurations sont définies pour le système d’exploitation concerné, conformément à la Linux table Operating Systems ci-dessus.
En cas d’échec de mise à niveau sur un Windows ordinateur, vérifiez le fichier journal correspondant, situé dans le <dossier utilisateur>\AppData\Local\Temp\ACC_Logs :
- Journaux ACC : ACC_Upgrade.log
- Journaux MSI : MSI_ACC_Upgrade.log