Release Notes

Graphics Agent for Linux 19.11

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

PCoIP Ultra Updates
  • PCoIP Ultra with GPU acceleration enabled shows improved performance on lossy networks.

  • PCoIP Ultra with GPU acceleration enabled now supports 4:2:0 chroma subsampling color mode, decreasing bandwidth consumption.

  • PCoIP Ultra with GPU acceleration enabled can now be used from PCoIP Software Clients for macOS (version 19.11).

  • PCoIP Ultra with CPU acceleration enabled shows increased video playback quality.

Other Improvements
  • You can now use the Graphics Agent for Linux with bare-metal physical PCs, when equipped with a supported GPU.

  • Added support for AWS EC2 G4 instances. G4 instances must have NVIDIA GRID Quadro Virtual Data Center Workstation licenses to enable more than one display.

  • Added support for local termination of additional Wacom tablets:

    • Wacom Cintiq 22HD
    • Wacom Cintiq 22HDT
    • Wacom Cintiq 24 Pro P
    • Wacom Cintiq 24 Pro PT

    Local termination with these tablets also requires PCoIP Tera2 Zero Client Firmware 6.5.0 or higher.

  • You can now disable the locally-rendered cursor. This prevents double cursors in applications that render their own cursor.

  • The cursor now hides as expected during video playback.

  • Bug fixes and security enhancements.

Resolved Issues

NVENC now works in Linux Graphics Agent when SELinux is enabled

87199

This is now fixed.

Known Issues

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

91222

For Wacom Pen Displays, touch key for Display Settings does not work in PCoIP session. If user taps Wacom Display Settings touch key at the top right corner of the display, "Compatible display device not found" message would appear in Windows host and no response in Linux host.

Workaround:

Do not use Wacom Display Settings touch key.

Wacom Cintiq 24 Pro P cursor flashing when used with local termination

91038

The cursor mapping for the Wacom Cintiq 24 Pro P is incorrect and results in a cursor update flashing between the correct cursor position and the origin.

Workaround:

None.

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.

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.

PCoIP validate license reports unsupported version of Trusted Storage

66075

When executing pcoip-validate-license on either Windows or Linux an error is reported stating that 

This version of trusted storage is not supported.
Workaround:
  1. Delete the contents of C:\ProgramData\Teradici\PCoIPAgent\licensing\5 in Windows, or /var/lib/pcoip-agent/licensing/5 (requires root permissions) in Linux

  2. Restart the appropriate agent service (PCoIP Graphics Agent or PCoIP Standard Agent on Windows, or pcoip-agent on Linux)

  3. If using Teradici Cloud Licensing (not using a local license server), re-register the host.

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.