Skip to content
ACC installation › ACC deployment - servers › Configuring Agent Client Collector › Agent Client Collector › IT Operations Management
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Deploy the Agent Client Collector using a custom base image

Deploy the Agent Client Collector on a virtual machine during mass deployment using the machine's base image. Mass deployment uses silent installation, which hides installation status.

Before you begin

Use Microsoft SCCM to manage the deployment and security of your devices, as described in the Create a Windows service account with Log on as a Service KB article.

Role required: agent_client_collector_admin

Procedure

  1. Navigate to All > Agent Client Collector > Agent Downloads.

  2. Download the installation file of the relevant OS.

  3. Install the agent according to the relevant OS instructions.

  4. Run the following command to stop the agent service:

    • In a Windows environment: Run the command sc stop AgentClientCollector
    • In a Linux environment: Run the command sudo systemctl stop acc
    • Ensure that the acc.yml file doesn’t include an encrypted API key.

    For example: api-key: "<insert plain text API key here>"

  5. Delete the contents of the agent's cache directory, keeping the directory structure intact:

    • In a Windows environment: C:\ProgramData\ServiceNow\agent-client-collector\cache
    • In a Linux environment: /var/cache/servicenow/agent-client-collector

    • When installing on a Windows machine, ensure that the installation was successful by doing one of the following:

    • Enable logging in silent installation and verify that the log file ends with the string, Windows Installer installed the product.

    • Ensure that the AgentClientCollector service has the status Running.

    • When installing on a Linux machine, access the machine where the agent is installed and modify the /usr/share/servicenow/agent-client-collector/serial_number.txt file in one of the following ways:

    • Change its content with the host's serial number, by running the following command: sudo -n dmidecode -s system-serial-number

    • Assign sudo permissions to the ServiceNow user to enable running the following osqueryi command: sudo -E env "PATH=$PATH" osqueryi --logger_min_status=3 --line "select hardware_serial from system_info" Note: You must change the virtual machine's host name after deployment to a unique value, to avoid damaging the host's CI.

  6. As a post-deployment step, restart the agent service.

    • In a Windows environment: Run the command sc start AgentClientCollector
    • In a Linux environment: Run the command sudo systemctl start acc