Windows full client

Prev Next

You can use the Windows full client on any user device, but installation requires administrator rights. The client supports auto-update, auto-start, and remember-me functionality, so it can connect the user automatically at boot time without user interaction. It uses the standard Windows client executables. See Windows clients.

The full client supports auto-update. When the user allows the update, the client applies it. To disable the auto-update feature, see Installing and updating clients.


Installing the Windows full client

Before installing, review the general Installing and running the client information on the Windows clients page.

When a user opens the installer, it installs the full client with auto-start enabled for the current user. To disable auto-start, use the /SKIPAUTOSTART command you pre-install the client.

Downloading the installer from the command line

Run CMD or PowerShell as an administrator. To download the installer, run the following and replace x.y.z in the filename and x.y in the filepath with the correct version numbers:

CMD

curl -L -o "%TEMP%\AppGate-SDP-client.exe" "https://bin.appgate-sdp.com/x.y/client/Appgate-SDP-x.y.z-Installer.exe"

PowerShell

Invoke-WebRequest -Uri "https://bin.appgate-sdp.com/x.y/client/Appgate-SDP-x.y.z-Installer.exe" -OutFile "$env:TEMP\AppGate-SDP-client.exe"

Installing from the command line

To install from the command line, run CMD or PowerShell as an administrator. Ensure the file is in your temporary folder. Run one of the following commands to install and replace x.y.z with the correct version number and <full profile URL> with the profile link:

CMD

start "" /WAIT "%TEMP%\Appgate-SDP-x.y.z-Installer.exe" /S /P="<full profile URL>"

PowerShell

Start-Process "$env:TEMP\AppGate-SDP-x.y.z-Installer.exe" -ArgumentList ' /S /P="<full profile URL>"' -Wait

NOTE

If you install the full client on top of the lite client, the installer uninstalls the lite client first and discards its settings.

NOTE

If you experience issues installing the TUN driver when other drivers or certain security software are installed, check your installation with: driverquery /v | findstr wintun

The client launches after installation. Sign in when prompted.


Uninstalling the Windows full client

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

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

  • Use Add or Remove Programs in Windows.

  • Run the installer from the command line using the /Z option.

To uninstall from the command line, ensure the install file is in your temporary folder and run one of the following commands as an administrator and replace x.y.z with the correct version number:

CMD

start "" /WAIT "%TEMP%\AppGate-SDP-x.y.z-Installer.exe" /S /Z

PowerShell

Start-Process "$env:TEMP\AppGate-SDP-x.y.z-Installer.exe" -ArgumentList ' /S /Z' -Wait

To run the uninstaller to remove the client but keep your configuration settings, run the command with the /K or /KEEPSETTINGS switch.


Starting the client with the command line

When a user runs Appgate SDP.exe by clicking it, the full client launches. You can also pre-install the profile link at launch time to remove subsequent user interactions. To pre-install a client profile so users reach the sign-in form, run:

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

You can add the following switches when you run the executable from the command line. Precede each switch with a space:

Switch

Description

--help

Shows help.

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

Adds the new profilename profile.

--novalidate

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

--loglevel level

Sets the log level. Options are: Error, Warn, Info, Debug (default: Info).

--version

Lists version information.


Logs

The following table lists the Windows full client log files:

Log type

Location

Client installer logs

%PROGRAMDATA%\appgate\installer.log

Client uninstaller logs

%PROGRAMDATA%\appgate\uninstaller.log

Client updater logs

%PROGRAMDATA%\appgate\updater.log

Driver logs

In the separate AppGate ZTNA driver:

%programdata%\appgate\driver.log

Client logs

%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 every day, the client archives a log-date and ui-date record for 30 days.

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

There are two ways to increase the log level and capture more detailed logs:

Quit the client, and from %programfiles%\appgate sdp\ui\ run:

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

Or, in the registry (regedit.exe), add a string <value> named LogLevel to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Appgate, and set it to one of the <value> options.

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.