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

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

    • Install MID-less Agent Client Collector on a macOS 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.
    • 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.