---
sourceDocument: Australia IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/it-operations-management

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Upgrade the ACC manually on a Linux system

# Upgrade the Agent Client Collector manually on a Linux system {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Perform a manual upgrade of your existing Agent Client Collector version on a system running a Linux OS if the single-line command script is not connected to the instance or you want to use enhanced customization options.

## Vorbereitungen

* Ensure that you have configured the Agent Client Collector web server. For more information, see [Configure the websocket server on the MID Server](https://servicenow-prod.fluidtopics.net/3KP7uq2XogzEllYciXgFVQ "Configure the websocket server on MID Servers to enable connections from agents to the MID Server. You can configure only one websocket server per MID Server.").
* Restart the MID Web Server.
* Collect host data, to ensure that all files are up to date. For details, see [Collect data from your system devices](https://servicenow-prod.fluidtopics.net/SOuh35eDfs4y0nr6PK0IlQ "Run a check command on your server or database to gather data from those devices. Depending on the check that is invoked, collected data may be monitoring data, visibility data, log data, or user metrics.").
* Ensure that you have installed a Linux version of the Agent Client Collector. For more information, see [Agent Client Collector installation on a Linux OS system](https://servicenow-prod.fluidtopics.net/b0f4XepBZFv3m0fxPcNgUA "Install Agent Client Collector on a system that uses a Linux OS, either using a single-line command script, or following the installation procedure to embed in your own package distribution mechanism. The installation procedure provides consistency when using package distribution solutions.").
* The upgrade procedure is the same for both MID Server and MID-less deployments.
* Role required: agent_client_collector_admin
{#acc-install-upgrade-linux__ul_wng_zjb_spb}

## Prozedur

1. Back up the agent-id and configuration files.  

       mkdir -p /tmp/acc-upgrade-backup
       sudo cp -rp /etc/servicenow/agent-client-collector/acc.yml /tmp/acc-upgrade-backup
       sudo cp -rp /etc/servicenow/agent-client-collector/check-allow-list.json /tmp/acc-upgrade-backup
       sudo cp -rp /var/cache/servicenow/agent-client-collector/agent_now_id /tmp/acc-upgrade-backup
       sudo cp -rp /var/cache/servicenow/agent-client-collector/agent_now_keystore /tmp/acc-upgrade-backup

       mkdir -p /tmp/acc-upgrade-backup
       sudo cp -rp /etc/servicenow/agent-client-collector/acc.yml /tmp/acc-upgrade-backup
       sudo cp -rp /etc/servicenow/agent-client-collector/check-allow-list.json /tmp/acc-upgrade-backup
       sudo cp -rp /var/cache/servicenow/agent-client-collector/agent_now_id /tmp/acc-upgrade-backup

2. Uninstall the package.
   1. Stop the service.  
      `sudo systemctl stop acc`
   2. Disable the service.  
      `sudo systemctl disable acc`
   3. Uninstall the package:  
      * For RHEL/CentOS/SUSE: `sudo rpm -e agent-client-collector`
      * For Ubuntu/Debian: `sudo dpkg -r agent-client-collector`
      {#acc-install-upgrade-linux__ul_csf_hqn_ypb}
   {#acc-install-upgrade-linux__substeps_t3n_4kb_spb}
3. Download the installation file.  
   For example, when working with an Ubuntu/Debian OS, use both of the following:

   `curl -L -O
   https://<MID-WEBSERVER-URI:PORT>/static/acc_installers/agent-client-collector/glide/distribution/builds/package/app-signed/agent-client-collector-<version number>-<Ubuntu/Debian version>_amd64-deb-deb.zip
   -O`

   `https://<MID-WEBSERVER-URI:PORT>/static/acc_installers/agent-client-collector/glide/distribution/builds/package/app-signed/agent-client-collector/agent-client-collector-<version number>-<Ubuntu/Debian
   version>_amd64.deb`
4. Verify and install the package.  
   1. Unzip the compressed file. `unzip agent-client-collector-2.3.0-debian-9_amd64-deb-deb.zip`

   2. Validate the installer file signature.
      * RHEL/Centos/SUSE OS:`openssl dgst -sha256 -verify {<ServiceNow DGST pem key>} -signature {<signature file>} agent-client-collector-<version number>-x86_64.rpm`

      * Ubuntu/Debian OS:  

            gpg --import ServiceNow_Digicert_Public.gpg
            dpkg-sig --verify agent-client_collector-<version number>-<Ubuntu/Debian version>_amd64.deb

      {#acc-install-upgrade-linux__ul_v33_43c_4pb}
   3. Install the package.
      * RHEL/CentOS/SUSE: `sudo rpm -vi --force agent-client-collector-<version number>-el7-x86_64.rpm`
      * Ubuntu/Debian: `sudo dpkg -1 agent-client-collector-<version number>-<Ubuntu/Debian version>_amd64.deb`

      {#acc-install-upgrade-linux__ul_owz_czv_spb}
      <!-- -->

      * RHEL/CentOS/SUSE: `sudo rpm -vi --force agent-client-collector-<version number>-x86_64.rpm`
      * Ubuntu/Debian: `sudo dpkg -1 agent-client-collector-<version number>-<Ubuntu/Debian version>_amd64.deb`
      {#acc-install-upgrade-linux__ul_rhd_jxm_4zb}
   {#acc-install-upgrade-linux__ol_drc_n3c_4pb}
5. Restore the agent-id and configuration files.  

       sudo -u servicenow cp -rp /tmp/acc-upgrade-backup/acc.yml /etc/servicenow/agent-client-collector/acc.yml
       sudo -u servicenow cp -rp /tmp/acc-upgrade-backup/check-allow-list.json /etc/servicenow/agent-client-collector/check-allow-list.json
       sudo -u servicenow cp -rp /tmp/acc-upgrade-backup/agent_now_id /var/cache/servicenow/agent-client-collector/agent_now_id
       sudo -u servicenow cp -rp /tmp/acc-upgrade-backup/agent_now_keystore /var/cache/servicenow/agent-client-collector/agent_now_keystore

       sudo -u servicenow cp -rp /tmp/acc-upgrade-backup/acc.yml /etc/servicenow/agent-client-collector/acc.yml
       sudo -u servicenow cp -rp /tmp/acc-upgrade-backup/check-allow-list.json /etc/servicenow/agent-client-collector/check-allow-list.json
       sudo -u servicenow cp -rp /tmp/acc-upgrade-backup/agent_now_id /var/cache/servicenow/agent-client-collector/agent_now_id

6. Configure the agent to run as a service.  
   `sudo systemctl enable acc`
7. Start the service.  
   `sudo systemctl start acc`
8. View the logs to verify that the startup was successful.  
   `sudo tail -f /var/log/servicenow/agent-client-collector/acc.log`