ACC installation on a Linux OS system › ACC deployment - servers › Configuring Agent Client Collector › Agent Client Collector › IT Operations Management

Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Upgrade the Agent Client Collector manually on a Linux system

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.
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.
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.
The upgrade procedure is the same for both MID Server and MID-less deployments.
Role required: agent_client_collector_admin

Procedure

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

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
  - 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
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
```
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
4. 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
```
Configure the agent to run as a service.

sudo systemctl enable acc
Start the service.

sudo systemctl start acc
View the logs to verify that the startup was successful.

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

Parent Topic:Agent Client Collector installation on a Linux OS system