Linux full client

Prev Next

The Linux full client is designed for use on a normal users device, however it requires administrator rights to install. It includes (optional) auto-start and remember-me functionality so it will automagically connect the user at boot time without any interaction required.

The Linux client has partial support for auto-update.

Installation and uninstallation

How to Install

Ubuntu

sudo apt install ./appgate-sdp_x.y.z_amd64.deb

Fedora

sudo dnf install ./appgate-sdp-x.y.z-fc38.x86_64.rpm

RHEL9

sudo dnf install epel-release
sudo dnf install ./appgate-sdp-x.y.z-el8.x86_64.rpm

How To un-install

Ubuntu

sudo apt remove appgate

Fedora

sudo dnf remove appgate

RHEL9

sudo dnf remove appgate

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 possible to pre-install the profile link at this time and remove all subsequent user interactions required. For example; to pre-install a client profile (so the users will be at the sign-in form) run:
appgate --url appgate://controller.myco..com/profilename... --novalidate

The Linux full client consists of two components

  • AppGate Service - The main client executable that will run in the background and handle all connections.

  • AppGate Driver - The virtual network adapter.

Logs

Driver logs

The daemon logs can be viewed using journalctl -u appgatedriver.service

or view tun-service logs in /var/log/appgate/driver.log

Client logs

The regular client logs are in ~/.appgate/log/ or using journalctl -t appgate-sdp

  • 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.

LogLevel

To increase the log level in the client, quit the client and then run: appgate --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.