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.
NVENC now works in Linux Graphics Agent when SELinux is enabled
This is now fixed.
Wacom touch key for Display Settings does not work in a PCoIP session
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.
Do not use Wacom Display Settings touch key.
Wacom Cintiq 24 Pro P cursor flashing when used with local termination
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.
None.
PCoIP session ends when using very large application window
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.
Do not stretch a window more than 4096 pixels, horizontally or vertically.
License registration fails when proxy server name resolution takes too long
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.
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
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.
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
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.
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
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.
Configure the Wacom tablet to be USB bridged on the zero client.
Wacom Cintiq display cursor offset
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.
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
Wacom local termination does not work with Wacom tablet PTH-451
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
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.
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
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.
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
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.
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
Timezone redirection from client to host may not reflect in the user session on RHEL.
Manually set timezone on the host Virtual Machine.
PCoIP validate license reports unsupported version of Trusted Storage
When executing pcoip-validate-license on either Windows or Linux an error is reported stating that
This version of trusted storage is not supported.
-
Delete the contents of C:\ProgramData\Teradici\PCoIPAgent\licensing\5 in Windows, or /var/lib/pcoip-agent/licensing/5 (requires root permissions) in Linux
-
Restart the appropriate agent service (PCoIP Graphics Agent or PCoIP Standard Agent on Windows, or pcoip-agent on Linux)
-
If using Teradici Cloud Licensing (not using a local license server), re-register the host.
Video playback performance problems on Ubuntu
Video playback on Ubuntu Linux systems using Unity can result in poor video playback.
Unity is not supported with the PCoIP Linux Agent. Instead, use kubuntu-desktop.
Session establishment may fail when more than one monitor is present
Session establishment may fail with vGPU profiles utilizing 512 Mbytes of frame buffer when more than one monitor is present.
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
There is no audio output when pulseaudio is run as a system daemon.
Switch the daemon to run in per-user mode, which is the default.
Too many taskbars created on first login to KDE
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.
Manually delete the undesired taskbars.