---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Upgrade the Agent Client Collector manually on a Linux system

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

* Release version: Yokohama
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

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.

## Before you begin

* 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/Nhz4taSWhPBGMQb4g~EIQg "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 [Run host data collection for an agent](https://servicenow-prod.fluidtopics.net/4wMNLhjx3vpRiWyovgew4g "Collect data on the host being monitored by an agent. Manually collecting host data ensures that the host's files are up to date.").
* 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/xYsJMqPsY2XjwJqpMJot9Q "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.").
* Role required: agent_client_collector_admin
{#acc-install-upgrade-linux__ul_wng_zjb_spb}

## About this task

The upgrade procedure is the same for both MID Server and MID-less deployments.

## Procedure

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

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>-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

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`