Release Notes

Do one of the following to resolve this issue:

• Disable "Build to Lossless" to reduce CPU load when connecting with a Tera2 Zero Client.
• If "Build to Lossless" is enabled, use a desktop software client to access RHEL 9 or Rocky Linux 9 agent machines.
• Roll back the agent operating system to RHEL 8 or Rocky Linux 8.

Ensure that the{*}* specific driver for that smartcard reader is installed.

This solution has been verified with the SCR3310 smart card reader by installing the SCR3310 smart card reader driver. 

To successfully install the SCR3310 smart card reader on RHEL 8 and RHEL 9, copy the scmccid.bundle folder to the /usr/lib64/pcsc/drivers folder by running the following command:

cp proprietary/scmccid.bundle/   /usr/lib64/pcsc/drivers -r 

{}Note{}: Other brands and models of smartcard readers and drivers have not been verified and may not function as expected over USB Bridging.

There is no workaround for this issue.

When relative mouse is enabled, use another supported browser if distinguishing between mouse clicks and pen inputs is necessary.

Use a FQDN that can be accessible by both the internal and external users. The FQDN can map to an internal address for internal users, and external address for external users.

No known workaround.

After a short delay, the keyboard and mouse inputs will become responsive again. Once activity resumes, the user will be able to unlock with the password.

There are 2 workarounds available right now: # Manually switch to the desired input language every time a system reboot is performed. # Delete other language inputs as secondary input options and keep only one language input in the system setting.

Avoid re-sizing client window size while participating in a PCoIP Ultra Collaboration session.

If this occurs, re-start the collaboration session by sending a new invitation to the Guest Collaborator.

Once the resizing settles, the artifacts will disappear.

Re-establish the PCoIP session or use use RHEL/CentOS 7 or RHEL 8 if possible.

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

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.

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

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.

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

2. reinstall PCoIP Agent: the package executes a post-installation script that resets the default target to graphical.

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.

• If the NVIDIA GRID driver is not yet installed, install the libglvnd-opengl package first to allow the machine to get the correct glapiCurrent symbol. Once this is done, proceed with the installation of the NVDIA GRID driver. Run the following command to install the libglvnd-opengl package:

sudo yum install libglvnd-opengl

• If this error is encountered after installing the NVIDIA GRID driver, uninstall the driver, and install it again.

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

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

Configure a NVIDIA GPU license that supports the number and resolution of displays that you require.

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

Do not use Wacom Display Settings touch key.

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

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

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

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

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

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

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.

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. 

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

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.

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

Manually set timezone on the host Virtual Machine.

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

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

Manually delete the undesired taskbars.