Support and Troubleshooting

If you encounter a problem installing or using the Software Client for Linux, there are a number of troubleshooting and support resources you can access.

Anyware Client Logging

The Software Client for Linux writes log files that document its processes and interactions with other services such as brokers and agents. These files are invaluable in diagnosing problems. This page describes how logs are handled and where they can be found.

System Libraries

The following system libraries are used by the Software Client for Linux:

Anyware Software Client Security Modes

The Anyware Software Client uses certificates to verify the identity of the host to which it connects. The security mode is configured by the security_mode setting in the Anyware Client configuration file or by setting its value in the pre-session user interface.

Three security mode options are available:

Installing the Internal Root CA Certificate on an Anyware Client for Linux

Your root CA certificate must be installed in any Anyware client that will be used to connect to the Anyware Agent.

System Requirements

The following table outlines the system requirements for the Anyware Software Client for Linux:

There a number of system level keyboard shortcuts on Ubuntu 18.04 that can affect your remote desktop experience. If you are using some of these keys then it is recommended that you re-map or disable them.

There are separate keyboard shortcuts if you are connecting to a Azure Virtual Desktop (AVD) using RDP, as outlined below.

The following keyboard shortcuts apply when using the Software Client for Linux for Linux to access a Azure Virtual Desktop (AVD) using RDP:

• CTRL+ALT+END = CTRL+ALT+DEL (inside the remote desktop)
• ALT+Pg-Up = ALT+TAB (task switcher inside the remote desktop)
• ALT+Home = Windows button (inside the remote desktop)
• SHIFT+ALT+Enter = Toggle full-screen mode on/off

On the Anyware Software Client for Linux using either Ctrl+Alt+SHIFT+F12 or Ctrl+Alt+F12 will switch to virtual terminal 12, which typically does not exist. This can result in a blank screen. To avoid this you can disable virtual terminal functionality by creating a file /usr/share/X11/xorg.conf.d/60-pcoip.conf with the following contents:

On Linux Clients that connect to Windows agents, sometimes, hotkeys do not work as expected. Specifically, the clients inconsistently receive Super key press events if the Super key is mapped to the local system. This issue can be resolved by disabling the Super key on the client machine.

To do this, run the following command:

sudo apt-get install gnome-tweaks
gsettings set org.gnome.mutter overlay-key ''