Windows full Client

Prev Next

The Windows full Client is designed for use on a normal user's device, however it requires administrator rights to install.

The full Client supports auto-update (which can be disabled) - when the user allows, the update it will be applied.

It includes (optional) auto-start and remember-me functionality so can automagically connect the user at boot time without any user interaction required.

The Windows full Client uses standard executables.

Installation and uninstallation

How to install

When the installer .exe is run normally (when a user clicks it), then the full Client will be installed. The auto-start option will be enabled for the current user. Use command line installation to disable this option.

If you try to install the full Client on top of the lite Client then lite will be uninstalled and full installed, The settings for lite will be discarded.

There are sometimes issues installing the TUN driver when certain other drivers or particular security softwares are installed. Correct installation can be checked using the command:

driverquery /v | findstr wintun

How to uninstall

To uninstall theWindows full Client simply simply right click on Appgate SDP in the start menu and click uninstall or run installer from command line using the /z option or use Windows Add or Remove Programs.

Using the command line to start the Client

Once installed, when Appgate SDP.exe is run normally (when a user clicks it), then the full Client launches.

It is also possible to pre-install the profile link at this time and remove all subsequent user interactions required. By example; to pre-install a Client profile (so the users will be at the sign-in form) run:

"appgate sdp.exe" --url="appgate://Controller.myco.com/profilename..." --novalidate

When the .exe is run from the command line then the following options switches may be added (precede each with a space):

--help

show help

--url="appgate://controller.myco.com/profilename..."

adds the new profile profile name

--novalidate

Used with --url; this option adds the new profile and skips the profile acceptance steps and goes straight to the user sign-in form.

--loglevel level

levels are: Error, Warn, Info, Debug [default is: Info]

--version

Logs

Installer/Updater logs

The Client installer logs are in %PROGRAMDATA%\appgate\installer.log

The Client uninstaller logs are in %PROGRAMDATA%\appgate\uninstaller.log

The Client updater logs are in %PROGRAMDATA%\appgate\updater.log

Driver logs

There is a separate driver which is the Appgate SDP driver. Its logs are in: %programdata%\appgate\driver.log

Client logs

The Client logs are in %APPDATA%\appgate\logs.  For example:  c:\users\sally\appdata\roaming\appgate\logs\log.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.

List of log files with details like date modified, size, and type.

Log Level

There are two ways to increase the log level in the Client:

  • Quit the Client and from %programfiles%\appgate sdp\ui\ run: & ".\appgate sdp.exe" --loglevel <value>

  • In the registry (regedit.exe ), add a string <value> called LogLevel to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Appgate.

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.