Upgrade the Agent Client Collector manually on a Windows system

task australia Updated Mar 12, 2026 1 min read acc-install-upgrade-windows.md
Raw file servicenow.com

Perform a manual upgrade of your existing Agent Client Collector version on a system running a Windows OS.

Before you begin

Backup the Agent Client Collector configuration files, such as acc.yml, check-allow-list.json and agent_now_id. The agent_now_id is located in the cache directory: C:\ProgramData\Servicenow\agent-client-collector\cache

Backing up configuration files is a safety precaution to safeguard the files during the upgrade. Configuration files need to be restored only if there are upgrade issues which require new installation.

(Optional): Enable golden image mode for cloning additional agents by setting the msi property GOLDEN_IMAGE=true.

Role required: agent_client_collector_admin

Procedure

  1. Upgrade to the new agent version, as described in Upgrade an agent in an instance.

    You can use either the manual or single-line procedure. When restoring backup files, the system replaces the configuration file values.

  2. After installation is complete, you can delete the backup files.

Parent Topic:Install the Agent Client Collector on a Windows machine manually

Search documentation
Search document titles and file paths on the australia branch