Release Notes
Standard Agent for Linux 22.09
Release 22.09 of the Standard Agent for Linux includes:
-
Collaborator Input Control: This release introduces the ability for guest collaborators to share control of the host's desktop while in a collaboration session. For more information, see Collaborator Input Control.
-
Bug fixes and stability enhancements.
None.
Resizing collaboration session window causes crash
Re-sizing the PCoIP Client window while participating in a PCoIP Ultra Collaboration session may cause the PCoIP client to crash.
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.
Cursor artifacts may appear if collaborator client window is resized
When the collaborator client window is resized, cursor artifacts may be seen on the collaborator client momentarily.
Once the resizing settles, the artifacts will disappear.
Collaboration Manager UI Layout incorrect on CentOS 7 and RHEL 7
When running on CentOS/RHEL 7, the Collaboration Manager may have an incorrect layout. Collaboration features still function properly. This issue will be fixed in a future release.
Collaborator may not see the remote cursor when first connected
When a guest collaborator connects to the host's session, the host's cursor may not be visible to the guest until it moves.
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
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.
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
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.
Wait until the following day in the timezone of the license server.
pcoip.service is not enabled on systemd multi-user target
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.
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:
- reset the systemd default target with the following command:
systemctl set-default graphical
- reinstall PCoIP Agent: the package executes a post-installation script that resets the default target to graphical.
Timezone redirection may not work on RHEL/CentOS hosts with SELinux enabled
When SELinux is enabled on RHEL/CentOS hosts timezone redirection may not work due to the SELinux file label being incorrect on /etc/localtime.
Run restorecon /etc/localtime as root and attempt to start another session.
First PCoIP session fails to establish on RHEL/CentOS7 with SELinux enabled and nfs mounted home directories
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.
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
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.
It is advised not to install the PCoIP License Server and PCoIP Agent on the same machine
Session fails to start when using SSSD in Linux
When using SSSD for authentication in Linux starting a PCoIP session fails with the following message in the journal:
pcoip-desktop-child[<pid>]: pam_sss(pcoip-session:account): Access denied for user <user>@<domain>: 6 (Permission denied)
and the following in the SSSD domain logs:
[sssd[be[<domain>]]] [ad_gpo_access_send] (0x0400): service pcoip-session maps to Denied
[sssd[be[<domain>]]] [ad_gpo_access_done] (0x0040): GPO-based access control failed.
In /etc/sssd/sssd.conf, add the following line to the domain section:
ad_gpo_map_permit = +pcoip-session
Example:
[domain\mydomain.com]
ad_domain = mydomain.com
...
ad_gpo_map_permit = +pcoip-session
Cursor offset and wrapping while bridging Wacom pen displays
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.
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
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.
Do not use Wacom Display Settings touch key.
gnome-shell crashes repeatedly causing failure to start a session
When first attempting to start a PCoIP session using the GNOME desktop, the gnome-shell process can crash repeatedly, causing the desktop to exit and an error code to be returned to the PCoIP client.
If the backtrace is something like the following:
#0 0x00007f0bc8dba901 in __strlen_sse2_pminub () at ../sysdeps/x86_64/multiarch/strlen-sse2-pminub.S:38
#1 0x00007f0bcb35aec2 in do_lookup (path=path@entry=0x0, size=size@entry=0x7f0bafdcda98, flags=flags@entry=0x0, data=data@entry=0x0, data_size=data_size@entry=0x0, error=error@entry=0x7f0bafdcda40, lookup_flags=G_RESOURCE_LOOKUP_FLAGS_NONE, resource=<optimized out>) at gresource.c:609
#2 0x00007f0bcb35b4fd in g_resource_get_info (resource=<optimized out>, path=path@entry=0x0, lookup_flags=lookup_flags@entry=G_RESOURCE_LOOKUP_FLAGS_NONE, size=size@entry=0x7f0bafdcda98, flags=flags@entry=0x0, error=error@entry=0x7f0bafdcda40) at gresource.c:836
#3 0x00007f0bcb35bb4d in g_resources_get_info (path=path@entry=0x0, lookup_flags=lookup_flags@entry=G_RESOURCE_LOOKUP_FLAGS_NONE, size=size@entry=0x7f0bafdcda98, flags=flags@entry=0x0, error=error@entry=0x0) at gresource.c:1241
#4 0x00007f0bc82ea8da in _gdk_pixbuf_new_from_resource_try_pixdata (resource_path=resource_path@entry=0x0) at gdk-pixbuf-io.c:1700
#5 0x00007f0bc82ea9cf in gdk_pixbuf_new_from_resource (resource_path=0x0, error=error@entry=0x40ab180) at gdk-pixbuf-io.c:1751
#6 0x00007f0bca6662eb in icon_info_ensure_scale_and_pixbuf (icon_info=0x40ab0f0 [GtkIconInfo]) at gtkicontheme.c:3912
#7 0x00007f0bca66658c in load_icon_thread (task=0x7f0ba801b410 [GTask], source_object=<optimized out>, task_data=<optimized out>, cancellable=<optimized out>) at gtkicontheme.c:4164
#8 0x00007f0bcb370cbd in g_task_thread_pool_thread (thread_data=0x7f0ba801b410, pool_data=<optimized out>) at gtask.c:1331
#9 0x00007f0bcadf0e8c in g_thread_pool_thread_proxy (data=<optimized out>) at gthreadpool.c:307
#10 0x00007f0bcadf04f0 in g_thread_proxy (data=0x232ca30) at gthread.c:784
#11 0x00007f0bc9020dd5 in start_thread (arg=0x7f0bafdce700) at pthread_create.c:307
#12 0x00007f0bc8d49ead in clone () at ../sysdeps/unix/sysv/linux/x86_64/clone.S:111
it may be due to an issue with the icon cache. Running the following commands will regenerate the icon and pixbuf loader cache, resolving the issue:
# gtk-update-icon-cache /usr/share/icons/gnome
# gdk-pixbuf-query-loaders-64 --update-cache
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 is unreliable in KVM environments
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
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.
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.
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.
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.
Changing display configuration during an active PCoIP session not supported
Changing display resolution within the VM during a PCoIP session is not supported and may cause display issues.
Set preferred display resolution at the client device.
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.
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.