Install MID-less Agent Client Collector using a single-line command in a Windows environment

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read

    • Install MID-less Agent Client Collector on a Windows machine to enable sending data from the agent to the instance through the cloud. Sending information through the cloud allows the MID Server to be used for more persistent resources.

    Before you begin

    • Install the ITOM Cloud Services Core (sn_itom_cloud_svc) plugin.
    • Onboard your instance to use ITOM Cloud Services. For details, contact Customer Support.
    • Configure an agent registration key. For details, see Configure an agent registration key.
    • Role required: agent_client_collector_admin

    About this task

    For details on sending data through the cloud in a MID-less deployment, see DEX Architecture.

    Procedure

    1. Retrieve the publicly accessible gateway URL, based on your location.
      • AMER (Americas): itomcnc-prod-gateway-amer.sncapps.service-now.com:443
      • EMEA (Europe): itomcnc-prod-gateway-emea.sncapps.service-now.com:443
      • APAC (Asia Pacific): itomcnc-prod-gateway-apac.sncapps.service-now.com:443
    2. On the Windows server where the agent is installed, enter the following command: 
      msiexec /i <msi_file_path> /quiet /qn /norestart CONNECT_WITHOUT_MID="true" ACC_CNC="<gateway_endpoint>" REGISTRATION_KEY="<registration_key>" INSTANCE_URL="https://<instance_url>"

      The following table shows the parameter values in the command.

      Table 1. Installation command-line parameters
      Parameter Description
      CONNECT_WITHOUT_MID Specify true to enable MID-less Agent Client Collector installation. If you don't specify a value, the regular MID Server websocket installation is invoked.
      ACC_CNC Specify a public gateway endpoint for Agent Client Collector.
      REGISTRATION_KEY Active and valid registration key for the agent to communicate with.
      INSTANCE_URL ServiceNow instance that the agent is registered with.
      ACC_ALLOW_LIST Optional string. To disable the allow list, set ACC_ALLOW_LIST=0. By default, the allow list is enabled.
      Note:
      Disabling the allow list compromises your system's security and is intended as a temporary measure while you’re updating the allow list. After completing the update, enable the allow list by setting ACC_ALLOW_LIST=1.
      ACC_VALIDATE_SIG Optional string. To disable verification of the installer certification validation, set ACC_VALIDATE_SIG=0 that you can add to disable the verification of the installer certification validation. By default, validation is enabled.
      Note:
      Disable the certification validation only when using non-standard signature validation tools.