macOS full Client

Prev Next

The macOS full Client is designed for use on a normal user's device, however it requires administrator rights to install. When a user clicks the .dmg file the full Client will then be installed with the auto-start option enabled.

The full Client supports auto-update and when the user initiates the update it will be updated.

NOTE

To use the macOS client, you must turn off Limit IP address tracking on your device. If this is not disabled, DNS settings will be ignored. You can disable the setting manually or through an Apple MDM profile. To manually disable this setting:

  1. On your macOS device, navigate to Settings > Network.

  2. Select your ethernet connection or Wi-Fi.

  3. Select the Details… button.

  4. Disable Limit IP address tracking and select OK.

Using the command line to start the Client

Once installed, when AppGate ZTNA is run normally (when a user clicks it), then the Client launches.

It is also possible to pre-install the profile link at run time and avoid any subsequent user interactions required. By example; to pre-install a Client profile (so the users will go straight to the sign-in form) run:
/Applications/Appgate\ SDP.app/Contents/MacOS/Appgate\ SDP --url appgate://controller.myco..com/profilename... --novalidate

Logs

Client logs

Under 'FILES' they are at ~/.appgatesdp/log

  • log- includes the logs from the main service

  • ui- includes logs from the UI process

At the end of everyday a log-date and a ui-date record is archived for 30 days.

Driver logs

Use the macOS utility 'Console' to view client logs under var/log appgate>driver.log

Under 'FILES' they are at /var/log/appgate/driver.log

From 'terminal' you can also enter: sudo cat /var/log/appgate/driver.log

Log Level

To change the log level just start the Client from the command line:

/Applications/AppGate\ SDP.app/Contents/MacOS/Appgate\ SDP --loglevel <value>

The <value> options are: Dump, Trace, Debug, Info, Warn, Error, Fatal

Info is the normal setting – moving to the right will reduce the amount of log records saved - moving to the left is not recommended unless instructed to do so by AppGate support.

To return to normal - quit the Client and then restart normally.