Upgrade Agent Client Collector on a Linux system

  • Release version: Xanadu
  • Updated August 1, 2024
  • 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

    Role required: agent_client_collector_admin

    Procedure

    1. Optional: Back up sensitive files by running the following command. 
      tar -cvzf /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 / -xvzf /root/acc_backup.tar.gz usr/lib/systemd/system/acc.service \
/usr/lib/systemd/system/acc.servicesystemctl daemon-reload
    5. Change the owner:group setting to the correct one by running the following command. 
      chown -R sn_acc:sn_acc /{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
grep -i successfully /var/log/servicenow/agent-client-collector/acc.log
2022-11-17T19:32:24.25 [INFO] [agent] successfully connected to the url: wss://YOUR_BACKEND_FQDN:YOUR_BACKEND_PORT/ws/events