Release Notes

Graphics Agent for Linux 22.07

  • 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 22.07 of the Graphics Agent for Linux includes:

  • With this release, Teradici CAS is now HP Anyware. HP Anyware brings Teradici CAS and ZCentral Remote Boost together into a single solution, starting with enhancements for the collaboration feature.

  • Collaboration Enhancements: There are three major improvements to collaboration in this release:

    • Collaboration is now a supported feature. Previously, collaboration on the Graphics Agent for Linux was a technology preview offering.

    • The Graphics Agent for Linux now includes a Collaboration Management Console application, which launches Collaboration and generates invitations. Previously, a browser-based method was used to do this. For instructions, see Hosting a Collaboration Session.

    • Mouse visibility has also been added in this release; Guest collaborators can now see the host's cursor movements during a collaboration session.

    See Collaboration for more information on these enhancements.

  • Bug fixes and stability enhancements.

Resolved Issues

Agents now allow clients to reconnect even after long network outages

20.10.1, 22.01.1, 22.04.0, 22.07.0
141968

Previously, if a network outage lasted longer than 60 seconds, the PCoIP agent could reject PCoIP client requests to reestablish the session. This has been fixed.

Known Issues

Collaborator may not see the remote cursor when first connected

New
154011

When a guest collaborator connects to the host's session, the host's cursor may not be visible to the guest until it moves.

Workaround:

The host collaborator should move their cursor. This will update its position and cause the cursor to appear in the guest collaborator's client.

MATE desktop background has non-responsive regions

 
130406

After resizing the PCoIP client window some regions of the MATE desktop may be non-interactive (i.e. the right click context menu will not show up, and icons cannot be placed in these regions). This is an issue with a MATE desktop component where resize events are missed.

Workaround:

Restart the affected MATE desktop component by running the following command in a terminal window:

killall caja

The component will automatically restart, restoring full desktop interactivity.

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

First PCoIP session fails to establish on RHEL/CentOS7 with SELinux enabled and nfs mounted home directories

 
100037

When initiating a PCoIP connection to a RHEL/CentOS host, with SELinux enabled and nfs mounted home directories, the first connection attempt may fail if an nfs version prior to 4.2 is being used. This is due to the pcoip-server process not having permission to read files labelled nfs_t.

Workaround:

In versions 20.04 and above:

Install the pcoip-server-nfs SELinux package as follows:

# semodule -i /usr/share/pcoip-agent/selinux/pcoip-server-nfs.pp

In versions prior to 20.04:

Create a file named pcoip-server-nfs.te with the following content:

module pcoip-server-nfs 1.0;

require {
    type pcoip_server_t;
    type nfs_t;
    class dir search;
    class file { getattr open read };
}

allow pcoip_server_t nfs_t:dir search;
allow pcoip_server_t nfs_t:file { open getattr read };

and run the following commands to build and install it:

$ checkmodule -m -o pcoip-server-nfs.mod pcoip-server-nfs.te
$ semodule_package -m pcoip-server-nfs.mod -o pcoip-server-nfs.pp
$ sudo semodule -i pcoip-server-nfs.pp

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.