Mac Agents

The macOS agent installer supports a broad range of macOS versions. In addition to performance and process metrics, CommandCTRL now collects network widgets and Wi-Fi statistics for Mac endpoints and displays them on the machine dashboard.

Installing the Agent

This is for installing the agent on a single or multiple Mac machines.

  1. Download the most recent mac agent .DMG file from the CommandCTRL console.

    The CommandCTRL.pkg appears on the desktop.

  2. Launch the CommandCTRL.pkg.

    The CommandCTRL installer Introduction dialog box appears.

  3. Click Continue.

    The CommandCTRL installer License agreement dialog box appears.

  4. Click Continue.

    The CommandCTRL installer Installation Type dialog box appears.

  5. Click Install.

  6. Enter the password you use to log into that machine.

    The CommandCTRL installer Summary dialog box appears.

  7. Click Close.

  8. Open a terminal window.

  9. Change the CommandCTRL install path as shown in the first command line of the previous screen to where CommandCTRL resides in your environment.

  10. Press the Enter key.

  11. The second command line in the previous screen displays <your tenantID> and <your apiKey>. Install the CommandCTRL service as Root and replace <your tenantID> (e.g., 6274957583) and <your apiKey> (e.g., AWBCT2CUSR79AB7N8L9J) with your tenant ID and api key.

  12. Press the Enter key.

    The command is executed and the following screen shows the agent was successfully installed.

Agent Updates

To enable or disable automatic updates, complete the following steps:

  1. In the side navigation panel, go to Settings > Site.

  2. In the Agent Settings section, the enable/disable switch located to the far right. The default is set to enable . It is recommended to accept automatic updates; however, this switch allows users the ability to control when the agent is updated.

  3. Either leave the switch enabled or slide the switch to the left to disable the agent from automatically updating.

Updating the Agent

This is for updating the agent on a single or multiple Mac machines.

Agent Updates

To enable or disable automatic updates, complete the following steps:

  1. In the side navigation panel, go to Settings > Site.

  2. In the Agent Settings section, the enable/disable switch located to the far right. The default is set to enable . It is recommended to accept automatic updates; however, this switch allows users the ability to control when the agent is updated.

  3. Either leave the switch enabled or slide the switch to the left to disable the agent from automatically updating.

Uninstalling the Agent

CommandCTRL collects historical metrics for each machine. After the CommandCTRL Agent has been uninstalled from a machine, no additional metrics will be collected.

Uninstall Using the Command Line Method

This is for uninstalling the agent on a single or multiple Mac machines using a command line method.

  1. Open a terminal window.

  2. Navigate to the path where CommandCTRL is currently installed in your environment, as shown in the first command line of the following screen.

  3. Press the Enter key.

  4. Type the uninstall command as Root, as shown in the second command line of the following screen.

  5. Press the Enter key.

  6. Type Y (yes) to accept continuing to remove the agent.

    The command is executed and the following screen shows the agent was successfully uninstalled.

Uninstall Using the CommandCTRL Method

To use CommandCTRL to remove an agent from a single machine, follow the same procedure in Uninstall the CommandCTRL Agent on Multiple Machines.