---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Perform a single-line Agent Client Collector installation on macOS

# Perform a single-line Agent Client Collector installation on macOS {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Use an efficient single-line command script to install Agent Client Collector on a machine that uses macOS operating system. Use the manual installation procedure if the agent is not connected to the instance or you want enhanced customization options.

## Before you begin

* Ensure that you have configured the Agent Client Collector web server.
* Verify that your server's OS and version matches the list of supported OS versions as described in [Agent Client Collector installation](https://www.servicenow.com/docs/T4OsCkn5IdRfJKG9Vg3T5A "You can install the Agent Client Collector on any supported host machine. The Agent Client Collector connects to a MID Server using the HTTP/S protocol, and the connection remains active after being established. One MID Server may handle several agents simultaneously, while a single agent works with one MID Server at a time and switches to a different MID Server when necessary to provide failover protection.").
* Ensure that you have the pkgutil packages available, to be used by the install script.
* Ensure that the target agents have connectivity to the following:
  * ServiceNow install server \[install.service-now.com\]
  * ServiceNow instance
  * The MID Server to which the agent will connect
  {#acc-install-macOS-single-line__ul_wy4_h2q_nqb}

{#acc-install-macOS-single-line__ul_prj_f2q_nqb}

Role required: agent_client_collector_admin

## Procedure

1. Retrieve the MID Server websocket URL parameters.
   1. Navigate to Agent Client CollectorWebsocket Endpoint.
   2. Select the relevant websocket endpoint.
   3. Copy the Endpoint URL field value to be used in the installation command.
   {#acc-install-macOS-single-line__substeps_izh_n2q_nqb}
2. Retrieve the API Key.
   1. Navigate to Agent Client CollectorDeploymentMID Web Server API Key.
   2. Copy the API Key value, to be used in the installation command.
   {#acc-install-macOS-single-line__substeps_m2w_p2q_nqb}
3. Run the following command on the server where the Agent Client Collector is being installed.  

       ACC_API_KEY=<api_key> ACC_MID=wss://<mid_ip>:<websocket_port>/ws/events bash -c "$(curl -L https://<instance URL>/api/sn_agent/agents/install_agent)"

   Enter the following values in the command line:
   {#acc-install-macOS-single-line__table_wff_w2q_nqb__entry__2}

   | Parameter | Value |
   |-|-|
   | ACC_API_KEY | Replace the \<api_key\> string with the API key used to access the MID Server websocket. If no value is specified, you will be prompted to enter the API key value during the script's execution. |
   | ACC_MID | Replace the \<mid_ip\> string with the URL of the MID Server websocket. When specifying multiple MID Servers, enter a string separated by commas for each MID Server. |
   | ACC_ALLOW_LIST | (Optional) Add the string ACC_ALLOW_LIST=0 to disable the allow list. By default, the allow list is enabled. Note: Disabling the allow list compromises your system's security and is recommended only as a temporary measure until you finish updating the allow list. After completing the update, re-activate the allow list by removing ACC_ALLOW_LIST=0 from the single-line command string. |
   | ACC_VALIDATE_SIG | (Optional) Add the string ACC_VALIDATE_SIG=0 to disable verifying the installer certificate validation. By default, validation is enabled. Default: Validation is enabled. Note: Disable certification validation only when using non-standard signature validation tools. |
   [Table 1. Command line parameters]

   {#acc-install-macOS-single-line__table_wff_w2q_nqb}

*[\>]: and then