Perform a single-line Agent Client Collector installation on macOS by using ITOM Cloud Services

  • Release version: Xanadu
  • Updated August 1, 2024
  • 1 minute to read

    • Install Agent Client Collector on a macOS machine without a MID Server by using the ITOM Cloud Services application. When you send information through the cloud, you enable the MID Server to be used for more persistent resources.

    Before you begin

    Install the ITOM Cloud Services plugin.

    Create an agent registration key, as described in Configure an agent registration key.

    Role required: agent_client_collector_admin

    About this task

    For details on working with Cloud Services, see DEX Architecture.

    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 shows the parameter values in the command.

      Table 1. Command-line parameter values
      Parameter Value
      CONNECT_WITHOUT_MID Specify true to enable ITOM Cloud Services. If you don't specify a value, the regular MID Server websocket installation is invoked.

      For details on configuring a websocket on the MID Server, see Configure the websocket server on the MID Server.
      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.