Upgrade Agent Client Collector on a Linux system

  • Release version: Australia
  • Updated March 12, 2026
  • 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

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

    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