Install ACC for DEX on macOS

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

    • Install Agent Client Collector (ACC) to monitor and collect data in a centralized and organized manner, provide insights into system performance, identify issues, and enable proactive maintenance.

    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.
    • Role required: root

    About this task

    Procedure

    1. Retrieve the agent registration key:
      1. Navigate to All > Agent Client Collector > Deployment > Agent Registration Key.
      2. Select the relevant agent registration key.
      3. Copy the registration key value and store it in a place where you can easily retrieve it when needed.
    2. 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
    3. On the server where you’re installing the Agent Client Collector, enter the following command: 
      CONNECT_WITHOUT_MID="true" ACC_CNC="<gateway_endpoint>" REGISTRATION_KEY="<registration_key>" INSTANCE_URL="https://<instance_url>" bash -c "$(curl -L https://<instance_url>/api/sn_agent/agents/install_agent)"

      The following table describes the parameter values in the command.

      Table 1. Command-line parameter values
      Parameter Value
      CONNECT_WITHOUT_MID Specify true to enable MID-less installation. If you don't specify a value, the regular MID Server websocket installation is invoked.
      ACC_CNC Public gateway endpoint for Agent Client Collector that you can specify.
      REGISTRATION_KEY Active and valid agent registration key for the agent to communicate with.
      INSTANCE_URL ServiceNow instance that the agent is registering with.
      ACC_ALLOW_LIST Optional ACC_ALLOW_LIST=0 string that you can add to disable the allow list.

      Default: The allow list is enabled.

      Note:
      When you disable the allow list, you compromise your system's security. This action is intended as a temporary measure while you're updating the allow list. After you complete the update, remove ACC_ALLOW_LIST=0 from the command line.
      ACC_VALIDATE_SIG Optional ACC_VALIDATE_SIG=0 string that you can add to disable the verification of the installer certification validation.

      Default: Validation is enabled.

      Note:
      Disable the certification validation only when you're using non-standard signature validation tools.