Perform a single-line Agent Client Collector installation on macOS when using a MID Server

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.
• Ensure that you have the pkgutil packages available, to be used by the install script.
• Enable golden image mode for cloning additional agents by setting the golden image marker located at /Library/Preferences/acc.rc.plist.
• 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

Role required: agent_client_collector_admin

Procedure

1. Retrieve the MID Server websocket URL parameters.
   1. Navigate to Agent Client Collector > Websocket Endpoint.
   2. Select the relevant websocket endpoint.
   3. Copy the Endpoint URL field value to be used in the installation command.
2. Retrieve the API Key.
   1. Navigate to Agent Client Collector > Deployment > MID Web Server API Key.
   2. Copy the API Key value, to be used in the installation command.
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:

   Table 1. Command line parameters

   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.