The macOS Agent Settings page lets you configure various options that affect the macOS Agent application. Use these settings to determine how often to collect data from devices, to allow passcode enforcement through Agent message prompts, to allow AirWatch Cloud Messaging so that devices receive push notifications and information about updates when available, and to choose how and when to allow updates.

  • Current Setting – Select whether to Inherit or Override the displayed settings. Inherit means use the settings of the current organization group's parent OG, while Override enables the settings for editing so you can modify the current OG's settings directly.
Setting Description
General
Check-in Interval Enter the time interval for device check-in.
Data Sample Interval Enter the time interval for sample data to be collected prior to transmission.
Data Transmit Interval Enter the time interval for the device to automatically transmit data to AirWatch.
Administrative Passcode Enter a passcode to be applied to the app that the end user must enter to access Agent settings.
Enable Agent Uninstall Select this check box to allow un-installation from the AirWatch Agent's main menu.
Location
Collect Location Data

Select this check box to enable AirWatch to collect GPS information from the device when available.

If Collect Location Data is enabled, the end user receives a prompt to enable location services for airwatchd. The alert persists until the user enables location services.

Password Enforcement
Enforce Passcode Select this check box to enforce passcode policy adherence on the device.
AirWatch Cloud Messaging
Use AWCM Select this check box to enable AWCM communication to the AirWatch Agent and device.
Agent Updates
Enable Automatic Updates

Select this check box to enable automatic updates to the AirWatch Agent when a new version is available.

  • Upgrade Silently – Select this check box to run silent updates without interruption. If this check box is not selected, users will receive a prompt to begin the upgrade process.
Remote Management
Mode

Select the Mode to define how the remote management applet and the device communicate over the network:

  • Off – Communication happens directly between the applet and the device. This mode is used when the computer that has the applet and the device you want to remotely manage are on the same network or virtual network.

  • WebSocket – Communication flows from the device to the applet. There is no direct connection available between the applet and the device. The applet and the device both proactively establish connections with the tunnel server. Use this when the device and the tunnel server are on different networks and the device can connect to the tunnel server on a public IP. An example of WebSocket connection would be a device out in the field and the applet and tunnel are located in a central location.

Enable Encryption Encrypt the data using AES 128 bit encryption.
Passphrase Enter a passphrase for the encryption.
Seek Permission

Enable Seek Permission if you want to prompt the end user to accept/decline the remote management request from the admin.

  • Enter a Seek Permission Message that the end user will see when a remote request is sent.
  • Enter the Yes Caption message for the accept button the end user will see on the Seek Permission request.
  • Enter the No Caption message for the decline button the end user will see on the Seek Permission request.
Advanced Open this menu to choose additional configuration options.
Remote Management Port

Enter the Remote Management Port used to communicate between the applet and the device.

Max Sessions Enter the Max Sessions allowed through Remote Management.
Number of Retries The number of retries allowed before communication attempts stop. This setting is available when WebSocket is selected as the Mode.
Retry Frequency (Seconds) The amount of time between attempts to communicate. This setting is available when WebSocket is selected as the Mode.
Heart Beat Interval (Seconds) The amount of time (in seconds) that passes between status updates are sent from the device. This setting is available when WebSocket is selected as the Mode.
Connection Loss Retry Frequency (Seconds) The amount of time (in seconds) that passes between attempts to reestablish connection. This setting is available when WebSocket is selected as the Mode.
  • Child Permission – Select the available behavior of child organization groups that exist below the currently selected organization group. Inherit only means child OGs are only allowed to inherit these settings. Override only means they override the settings, and Inherit or Override means you can choose to inherit or override settings in child OGs that exist below the currently selected OG.