---
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 ACC on a Linux system

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

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

Upgrade 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

* The upgrade procedure is the same for both MID Server and MID-less deployments.
* Enable golden image mode for cloning additional instances by setting the golden image marker located at /tmp/acc-goldenimage. The golden image marker is applied only during a Linux upgrade and not during new installations.
* Role required: agent_client_collector_admin
{#acc-linux-upgrade__ul_j1z_sw5_zfc}

## Procedure

1. **Optional:** Back up sensitive files by running the following command.  

       tar -Pcvzf /root/acc_backup.tar.gz /etc/servicenow/agent-client-collector \
       /var/cache/servicenow/agent-client-collector/agent_now_id \
       /usr/lib/systemd/system/acc.service

2. Download the .rpm/.deb agent package and signature files, as described in [Install Agent Client Collector on a Linux system](https://servicenow-prod.fluidtopics.net/gnStIIij9QHlEGg9eHnQWA "Install Agent Client Collector using a package distribution tool. Before that, you can manually install the Agent Client Collector on a few machines to verify that your agents contain the correct policies and checks.").
3. Upgrade the package.
   * In an RPM-based system:`rpm -Uv agent-client-collector-<version number>-x86_64.rpm`

   * In a DEB-based system:`dpkg -i agent-client-collector-<version number>-<distro>_amd64.deb`

   {#acc-linux-upgrade__choices_ghn_s5q_pvb}
4. Restore the systemd service file (if you customized the file), using either an automation tool or by reloading systemd configuration.  

       tar -C / -Pxvzf /root/acc_backup.tar.gz usr/lib/systemd/system/acc.service

       systemctl daemon-reload

5. Change the owner:group setting to the correct one by running the following command.  

       chown -R servicenow:servicenow /{etc,var/cache,var/log,usr/share}/servicenow/agent-client-collector

6. Restart the service and verify that it connects to its backend-url.  

       systemctl restart acc
       tail -f /var/log/servicenow/agent-client-collector/acc.log

{#acc-linux-upgrade__steps_im2_ln4_fwb}