Install Agent Client Collector for DEX - Mac using one-line installer

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 1 minute to read

    • 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

    Ensure you have setup the ACC registration key.

    Role required: agent_client_collector_admin

    Procedure

    1. Navigate to Self-Service > Agent Client Collector > Deployment > Agent Client Downloads.
    2. Copy the command or script to execute by selecting the command icon (The command or installer icon to copy the command.) under Single-line Installer Commands > Commands without MID > Linux/macOS.
      Page from where you can download Agent Client Collector.

      For information on the command and the parameter values, see Perform a single-line Agent Client Collector installation on macOS by using ITOM Cloud Services.

    3. In your system, open Terminal.app.
    4. Paste the command and press Enter.
    5. Stop ACC by executing sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist.
    6. Navigate to /Library/Application\ Support/servicenow/agent-client-collector and edit the acc.yml file.
    7. Restart ACC by executing sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist.
      The ACC connects to your ServiceNow instance.
      Tip:
      To deploy ACC in Mac using the Terminal window:
      1. Install the following:
        1. cd /tmp;
        2. sudo curl -L -O -k https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.1.0-macos_x64.pkg
sudo installer -pkg agent-client-collector-3.1.0-macos_x64.pkg -target /;
sudo cp -p "/Library/Application Support/servicenow/agent-client-collector/acc.yml.example" "/Library/Application Support/servicenow/agent-client-collector/acc.yml";
      2. Launch and run the following:
        sudo launchctl load /Library/LaunchDaemons/com.sn.acc.plist; 
sudo launchctl load /Library/LaunchDaemons/com.sn.acc.plist  
sudo launchctl unload /Library/LaunchDaemons/com.sn.acc.plist 
sudo tail -f /var/log/servicenow/agent-client-collector/acc.log (only for version 3.4.0)
sudo tail -f /Library/Application\ Support/servicenow/agent-client-collector/log/acc.log (for version 3.4.1 or later)
cd "/Library/Application Support/servicenow/agent-client-collector"
      3. Stop ACC service and remove ACC:
        sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist; 
sudo rm /Library/LaunchDaemons/com.sn.acc.plist; 
sudo rm -rf /opt/servicenow/agent-client-collector; 
sudo rm -rf /Library/Caches/servicenow/agent-client-collector; (only for version 3.4.0)
sudo rm -rf /var/run/servicenow/agent-client-collector; 
sudo rm -rf /var/log/servicenow/agent-client-collector; (only for version 3.4.0)
sudo rm -rf "/Library/Application Support/servicenow/agent-client-collector";

    What to do next

    Enable DEX browser extension for monitoring web/SaaS applications.