Install ACC for DEX on macOS
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
Procedure
Retrieve the agent registration key:
Navigate to All > Agent Client Collector > Deployment > Agent Registration Key.
Select the relevant agent registration key.
Copy the registration key value and store it in a place where you can easily retrieve it when needed.
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 - 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.
- AMER (Americas):
| 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. |
Configure the ServiceNow sudoers file.
For details on the procedure, see Configure ServiceNow sudoers file.
Parent Topic:Installing DEX on your local machine
Related topics