Release Notes

Graphics Agent for Linux 21.03.3

  • When installed on RHEL, the PCoIP Graphics Agent requires access to the  rhel-7-desktop-optional-rpms.  This can be enabled by issue the following yum command:

    • sudo yum-config-manager --enable rhel-7-desktop-optional-rpms
  • PCoIP Graphics Agent for Linux requires a license registration code (for Teradici Cloud Licensing), or a license activation code (for Local License Servers). If you are a new user, request a registration code for a full evaluation.

  • When reporting issues to Teradici, be sure to run pcoip-support-bundler and include the output it generates.

Release 21.03.3 of the Graphics Agent for Linux is a maintenance release which replaces and deprecates 21.03.2. It includes the following:

  • There are no changes in this release. Version 21.03.3 was released to maintain version parity with other instances of the Graphics Agent.
Resolved Issues

None.

Known Issues

Soon to expire licenses can cause licensing failure for new host

117440

If a license server is operating in a different timezone than the PCoIP Agent and a license is still valid in the timezone of the PCoIP license server but considered expired in the timezone of the PCoIP Agent, then a PCoIP session can be denied with a licensing error.

This issue only affects hosts that do NOT have a valid license granted previously.

Workaround:

Wait until the following day in the timezone of the license server.

Session fails to start after configuring clipboard plugin settings

114825

If when configuring clipboard plugin settings quotes are included around the values, e.g.

/etc/pcoip-agent/pcoip-agent.conf

pcoip.server_clipboard_state = "1"

the PCoIP session will fail to start.

Workaround:

Remove the quotes from the configuration value, e.g.

/etc/pcoip-agent/pcoip-agent.conf

pcoip.server_clipboard_state = 1

and it should again be possible to start a PCoIP session.

Session fails to start with PCoIP Ultra GPU or Auto Offload enabled

112285

If you are unable to start a session with PCoIP Ultra GPU Offload or Auto Offload enabled it may be due to a lack of GPU memory. This can be verified by looking for "out of memory" in the PCoIP server log.

Workaround:

Potential workarounds are:

  • disable PCoIP Ultra GPU Offload or Auto Offload
  • reduce the number of displays connected to the client.
  • reduce the resolutions of the displays connected to the client until a session can successfully be started.

pcoip.service is not enabled on systemd multi-user target

110926

During installation, the PCoIP Agent service is set as the default display manager of the system. As a result, systemd only activates pcoip.service when the default target is set to graphical. Setting the default target to multi-user is not supported by the PCoIP Agent.

Workaround:

If the default target is changed to multi-user after installation of PCoIP Agent, it is possible to recover with one of the following steps:

  1. reset the systemd default target with the following command:
systemctl set-default graphical
  1. reinstall PCoIP Agent: the package executes a post-installation script that resets the default target to graphical.

Bridging Cintiq 22HDT (DTH-2200) with Linux RHEL/CentOS host may not work.

110117

After launching a PCoIP session RHEL/CentOS host with Cintiq 22HDT bridged, the session may get disconnected and the system becomes unresponsive.

Workaround:

Do not bridge Cintiq 22HDT (DTH-2200 - Pen and Touch) with RHEL/CentOS host. Cintiq 22HD (DTK-2200 - Pen Only) may be locally terminated or bridged.

PCoIP Agent and PCoIP License Server commands have the same name

99245

When both the PCoIP Agent and PCoIP License Server are installed on the same machine, they will both try and create the command pcoip-list-licenses and pcoip-support-bundle, which causes one to overwrite the other's command. Whichever is installed or updated last will be the one that the command will map to.

Workaround:

It is advised not to install the PCoIP License Server and PCoIP Agent on the same machine

Cursor offset and wrapping while bridging Wacom pen displays

92111

When using Wacom pen displays like the Cintiq Pro 24 in bridged mode, the cursor will appear to be offset when using a stylus. When the stylus is close to the bottom of the display, the cursor wraps to the top of the display. 

This only affects Linux hosts.

Workaround:

Do not bridge Wacom pen display. Use Wacom pen display in local termination mode.

Wacom touch key for Display Settings does not work in a PCoIP session

91222

The "Display Settings" touch key for Wacom Pen Displays does not work in a PCoIP session. Windows hosts display a "Compatible display device not found" message when the user taps the touch key. Linux hosts do not display a message.

Workaround:

Do not use Wacom Display Settings touch key.

PCoIP session ends when using very large application window

86099

PCoIP supports a maximum application window width of 4096 pixels.  If an application window is stretched across multiple displays with a total width or height greater than 4096, the PCoIP session will end.

Workaround:

Do not stretch a window more than 4096 pixels, horizontally or vertically.

Xorg crashes on session start after upgrading to NVIDIA GRID

82080

After upgrading to an NVIDIA GRID driver, incompatible Xorg extensions (like libglx.so) from previous drivers can remain on the machine. These incompatible extensions can cause Xorg to crash, which prevents the PCoIP session from starting.

Workaround:

Reinstall the Xorg package so the correct glx Xorg extension is installed.

In RHEL/CentOS:

sudo yum reinstall xorg-x11-server-Xorg

In Ubuntu 16.04/18.04:

sudo apt install --reinstall xserver-xorg-core

License registration is unreliable in KVM environments

80201

Retrieval of the VM_UUID can be unreliable when running under KVM. This can cause licensing failures when attempting to validate a license or start a session.

License registration fails when proxy server name resolution takes too long

78337

The pcoip-register-host command can fail when using a proxy server if resolving the name of the proxy server takes more than 5 seconds.

Workaround:

Run pcoip-register-host again, or run pcoip-register-host using the IP address of the proxy server instead of the name.

NVIDIA driver may not load after update

76941

After updating the NVIDIA Grid driver on a Linux agent system the contents of initramfs may still contain the older NVIDIA Grid driver kernel modules.  On reboot the new NVIDIA driver will not load resulting in an inability to connect via PCoIP.

Workaround:

When the system is rebooted, the older kernel modules from the initramfs are loaded again, which means the userspace libraries can't talk to the new driver.

To resolve the issue:

To resolve the issue after the driver is installed but before rebooting:

sudo dracut -fv

 To resolve the issue after the driver is installed and after rebooting:

sudo modprobe -r nvidia_drm nvidia_modeset nvidia sudo dracut -fv sudo reboot

Wacom LT may take up to ~25 seconds to register in RHEL/CentOS 7.x

74752

Due to limitations in the operating system kernel, the tablet may take up to ~25 seconds to show up in RHEL/CentOS 7.x. This is not related to the PCoIP subsystem.

Workaround:

If possible, upgrade to a newer operating system that comes with a newer kernel.

Wacom tablet in mouse mode does not map cursor position correctly with Cloud Access Software

72799

When using Cloud Access Software with Zero Client firmware 6.0 or lower the Wacom tablet cannot be locally terminated with full functionality.  The tablet will operate in mouse mode, with cursor mapping that is difficult to control and a lack of pressure sensitivity.

Workaround:

Configure the Wacom tablet to be USB bridged on the zero client.

Wacom Cintiq display cursor offset

72044

Using the Wacom Cintiq display with the tablet mapped to the entire desktop when used with more than one monitor results in an offset cursor.

Workaround:

On multi-monitor workstations the tablet is mapped to the entire desktop by default. If a tablet is mapped to a single display on a multi-monitor workstation, configure both the zero client tablet mapping setting and the host tablet mapping setting. Use the Zero client OSD User Setting > Tablet Mapping screen to map the tablet to a single display. Change the host tablet mapping setting by configuring the xsetwacom MapToOutput setting. The local and remote cursors will not be in sync if the zero client and host settings are not configured properly.

Wacom local termination does not work with Wacom tablet PTH-451

72025

Wacom local termination does not work with Wacom tablet PTH-451

Workaround:

Enable the USB permissions on the Zero Client to bridge the Wacom device. More information can be found in the Zero Client firmware Administrators' Guide. 

New RHEL version on Azure not yet supported for Graphics Agent

71346

On Azure the NVIDIA driver only works if Linux Integration Services (LIS) is installed. When a new kernel comes out, it takes several days for Microsoft to release an LIS update to support the new kernel version. There is also delayed support for new RHEL minor releases (e.g. RHEL 7.5 is not yet supported). In order for the PCoIP Graphics Agent to work in Azure on RHEL or CentOS, the kernel must be locked down to a version which is known to be supported by both the NVIDIA driver and LIS.

Workaround:

Below is a script that will install a known working kernel version, ensure it is the default booted kernel and that updates will not change the default kernel or remove the working version. It should be run as root.

#!/bin/sh

KERNEL_VERSION=3.10.0-693.21.1.el7

# ensure the default is set to the saved entry
sed -i 's/GRUB_DEFAULT=.*/GRUB_DEFAULT=saved/' /etc/default/grub

# make sure installing a new kernel package does not change the saved entry
sed -i 's/UPDATEDEFAULT=.*/UPDATEDEFAULT=no/' /etc/sysconfig/kernel

# install kernel/kernel-devel for the latest known working kernel version
yum install -y kernel-${KERNEL_VERSION} kernel-devel-${KERNEL_VERSION}

# set the installonly attribute to keep so that installing new kernels does not remove our known working kernel
yumdb set installonly keep kernel-${KERNEL_VERSION}

# find the name of the kernel we just installed in the grub config
GRUB_KERNEL_NAME="$(awk -F\' /^menuentry/{print\$2} /etc/grub2.cfg | grep ${KERNEL_VERSION} | grep -vi rescue)"

# set the grub default
eval grub2-set-default \"${GRUB_KERNEL_NAME}\"

# regenerate the grub config
grub2-mkconfig -o /boot/grub2/grub.cfg

Double cursors shown when MapToOutput is used to map a Wacom tablet

71125

When using MapToOutput to map the Wacom tablet to something other than all displays, a duplicate and offset-ed cursor is shown, making stylus input very difficult to use.

Workaround:

In order to use MapToOutput to map the Wacom tablet to a particular display, one must set the tablet mapping in the Zero Client OSD. From User Settings -> Tablet, use the stylus to select the corresponding display. Click OK to save the setting.

Session start fails when using Host-Based Access Control if there is no rule for the pcoip-session PAM service

68189

When authenticating against a RHEL IdM server where HBAC is in use and the allow_all rule is disabled, PCoIP sessions will fail to launch with "Error: 6405" due to users not being permitted to access the pcoip-session PAM service.

If this issue is being encountered, a log similar to this

[sssd[be[<domain>]]] [ipa_pam_access_handler_done] (0x0020): No HBAC rules find, denying access

can be seen in /var/log/sssd/sssd_<domain>.log when the SSSD debug level is set to 10 for the domain.

Workaround:

Add a HBAC service for the pcoip-session PAM service and any necessary HBAC rules to allow users to connect via PCoIP.

Further information on HBAC: https://access.redhat.com/documentation/en-us/redhatenterpriselinux/7/html/linuxdomainidentityauthenticationandpolicy_guide/configuring-host-access

Timezone redirection may not work on RHEL

67723

Timezone redirection from client to host may not reflect in the user session on RHEL.

Workaround:

Manually set timezone on the host Virtual Machine.

Video playback performance problems on Ubuntu

64876

Video playback on Ubuntu Linux systems using Unity can result in poor video playback.

Workaround:

Unity is not supported with the PCoIP Linux Agent. Instead, use kubuntu-desktop.

Session establishment may fail when more than one monitor is present

57936

Session establishment may fail with vGPU profiles utilizing 512 Mbytes of frame buffer when more than one monitor is present.

Workaround:

Reduce the number of monitors, or change the vGPU profile to increase the frame buffer memory.

No audio with Linux agent when pulseaudio is run as a system daemon

50710

There is no audio output when pulseaudio is run as a system daemon.

Workaround:

Switch the daemon to run in per-user mode, which is the default.

Too many taskbars created on first login to KDE

22062

On the very first login (when the .kde directory gets populated), four taskbars are created. With a single monitor, all four will collapse on top of each other on the one display.

Workaround:

Manually delete the undesired taskbars.