Windows lite client

Prev Next

You can use the Windows lite client on any user device, and you can install it without administrator rights. It suits users such as third parties who may not be able to install the full client, or users of web apps that a web proxy can handle.


Installing the Windows lite client

When a user runs the installer (including from the command line), the lite client installs, upgrades, or launches as needed. Auto-start is always enabled.

NOTE

If you try to install the lite client on top of the full client, the installation does not proceed, and the installer prompts the user to start the full client instead.


Uninstalling the Windows lite client

You can uninstall the Windows lite client in the following ways:

  • Right-click on AppGate ZTNA Lite in the Start menu and select Uninstall.

  • Use Add or Remove Programs in Windows.


Logs

Client logs are in %APPDATA%\AppGate\Logs (for example, c:\users\sally\AppData\AppGate\Logs.)

  • lite.log includes logs from the main service.

  • ui-<date>.log includes logs from the UI process.

Logs are archived daily for 30 days.

List of log files with details including date modified and file size.

To increase the log level, quit the client and run:

& ".\appgate sdp.exe" --loglevel <value>

The <value> options are:

  • Dump

  • Trace

  • Debug

  • Info

  • Warn

  • Error

  • Fatal

Info is the normal setting. Values to the right reduce the number of log records saved. Values to the left are not recommended unless AppGate support instructs you to use them. To return to normal, quit the client and restart.


Configuration settings

The following table lists common configuration tasks for the lite client:

Task

Details

View client settings

The user.config file is in: %appdata%\AppGate\AppGate_SDP_Service_Url_<text>\<version>\

Clean all client settings

Delete the user.config file.

Download the PAC file

To download the current PAC script generated by the lite client for troubleshooting:

  1. Open the following link in a browser: http://localhost:3198/sdp_proxy_pac_<random_number>.pac

  2. Replace <random_number> in the URL before opening the link—for example: http://localhost:3198/sdp_proxy_pac_1234567890.pac

Remove all stored passwords, cookies, and certificates

  1. With administrator rights, run certmgr.msc.

  2. Select and delete certificates under ”AppGate” in the right-hand pane:

Certificate management interface displaying AppGate certificates and their details.

In Credential Manager, confirm you are using the correct user account to see the correct generic credentials.