Release Notes
Graphics Agent for Windows 19.11.2
-
The PCoIP Graphics Agent for Windows 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 registratration code for a full evaluation.
-
When reporting issues to Teradici, run the SupportBundler.exe application and include the output it generates.
Release 19.11.2 of the Graphics Agent for Windows replaces and deprecates release 19.11.0. It includes the following enhancements:
-
Security fixes
It also includes the following changes from 19.11.0:
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
-
Added support for AWS EC2 G4 instances. G4 instances must have NVIDIA GRID Quadro Virtual Data Center Workstation licenses.
-
You can now disable the locally-rendered cursor. This prevents double cursors in applications that render their own cursor.
-
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.
-
This release removes support for Windows 7 and Windows Server 2008R2.
-
Bug fixes and security enhancements.
Wacom tablet sharp lines when used in higher latency networks
Drawing with a Wacom tablet can introduce sharp edges when quickly drawing curves. Testing shows that any of the following can increase the likelihood of sharp edges: latency > 25 ms, using a large tablet such as an Intuos Pro (L) or Cintiq 24 Pro or larger, drawing quickly.
To reduce the likelihood of sharp edges you can do one or more of the following: draw slower, establish a lower latency network connection, use a smaller tablet.
Using Windows-p to adjust monitor behaviour not supported with PCoIP Agent
Using the Windows-P to adjust projector display types is not supported. Selecting duplicate may result in secondary displays turning black.
Only adjust monitor configuration on the client side before the PCoIP session begins.
Wacom tablet force proportions setting causes cursor offset
Enabling Wacom tablet force proportions setting will limit the tablet area to match the aspect ratio of the display but will cause an error in the PCoIP Client interpretation of the cursor location resulting in incorrect cursor position on the screen.
Map the Wacom tablet either to the entire desktop or to one of the displays.
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.
Updating Windows 10 to 1903 requires specific installation sequence
If uninstalling PCoIP agent in preparation for installing a newer version you must reboot before starting the new install.
Uninstall the PCoIP Agent that does not yet support the new Windows 10 version. Reboot the machine. Install the new PCoIP Agent version that supports the new Windows version. Update Windows to the new version ensuring that a reboot is completing after the Windows upgrade is fully complete.
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.
After Windows 10 upgrade, GPU acceleration stops working
The PCoIP Graphics Agent loses its NVIDIA GRID connection with the GPU when Windows 10 is upgraded. When this happens, graphics performance is degraded and a yellow warning indicator appears in the top right corner of the display.
Open a command line prompt as an administrator, and execute the following command: c:\Program Files\Teradici\PCoIP Agent\GRID\reset_grid.bat
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.
Wacom tablet cannot be mapped to non-primary display on Windows 7 and Server 2008
This issue only affects Windows 7 and Windows Server 2008 SA.
After setting the Zero Client's tablet OSD setting to map to the non-primary display, pressing the Display Toggle function button on the tablet within PCoIP session does not map the Wacom tablet correctly to the monitors.
The issue can be seen in both local termination and bridged modes.
If monitor mapping is required for the Wacom tablet, only map the tablet to the primary display in the Zero Client's tablet OSD and in the Wacom properties.
Wacom tablet issues warning in device manager and is not functioning
Wacom functions like clicking with the pen, side-buttons on tablet, and pen pressure sensitivity, do not work.
If Wacom drivers are already installed but the device is not working correctly then this could be because the drivers were installed with the Wacom tablet connected. In this case the recovery is to unplug the Wacom tablet, uninstall the Wacom drivers and reboot the VM. Once the system comes back up, install the Wacom drivers completely before connecting the Wacom device. You can find the Wacom drivers here.
If the Wacom tablet still is non-functional on the host machine then this could be due to the Wacom tablet not running the latest firmware. The best way to do this is to connect the tablet to a physical machine that also has the Wacom drivers installed. Under the Wacom Desktop Center, go to the "Update" tab to update the firmware of the tablet itself.
PCoIP Agent fails to start
The PCoIP Agent requires port 60443 for proper operation. Unavailability of this port prevents the agent from starting.
The following PCoIP Agent log message can appear: AGENT :0894 Failed to bind required address ssl://127.0.0.1:60443: Cannot bind to port
Reboot the machine.
PCoIP Agent refuses connection with licensing error
The Windows Management Instrumentation service can run into a bad state, which prevents PCoIP Agent from checking out a valid license. When this problem occurs, user will see the "no license" error on the client and should see the following error message in the PCoIP agent log:
Exception caught ( Error processing FNE capability response: [1,7E2,5,0[7000001B,0,C03F9]] Response does not match system hostid. ) while sending a request for license renewal.
This problem was caused by WMI's inability to get host UUID. When running
wmic csproduct get UUID
Node - TERVDIW10DEV22
ERROR:
Description = The paging file is too small for this operation to complete.
The workaround is to restart Windows Management Instrumentation and PCoIP Agent for Windows service in sequence in Control Panel -> Administrative Tools -> Services. If the services won't restart then restarting Windows will resolve the issue.
Wacom Cintiq 22HD does not work with Cloud Access Software
Wacom Cintiq 22HD does not work with Cloud Access Software PCoIP Agent for Windows with the latest Wacom Windows driver.
Downgrade the Wacom Windows driver to version 6.3.32-4.
Windows resolution change options are disabled after uninstalling PCoIP agent
Windows display settings to change resolution are grayed out after uninstalling the PCoIP agent.
open regedit.exe , navigate to HKEYLOCALMACHINE\Software\Microsoft\Windows\CurrentVersion\Policies\System and set the value NoDispCpl to 0.
Wacom tablet PTH-451 not detected
Wacom tablet PTH-451 may not be detected correctly when USB bridged to Cloud Access Software Agent for Windows with PCoIP software client for Windows. Software client for macOS and PCoIP Zero Clients work as expected.
Windows INK cursor location not updated
When USB bridging a Wacom tablet to a Windows agent the cursor position is not updated while working in Windows INK.
Starting with PCoIP Agent 2.15 and when using Zero clients with a minimum firmware of 6.2.0.a2, Teradici recommends using local termination for the Wacom tablet. This allows the cursor to be properly displayed in Windows INK.
Windows Interactive logon text interferes with PCoIP session connection
Configuring Windows logon text will cause a PCoIP user to be unable to connect using the PCoIP client. This is because the Single Sign-On implementation within PCoIP needs to be able to authenticate directly to the user desktop.
You can either disable interactive logon text or you can disable the PCoIP SSO.
Wacom tablet cursor fails to highlight some UI elements
When moving the Wacom pen across the desktop some program controls do not highlight properly.
Remove long right mouse click from the pen settings in Windows.
Installation timeout in Windows 7 when system restore is enabled
If system restore is enabled, PCoIP agent installation on windows 7 platform might fail due to time out.
Disable system restore
Cloud Access Software indicates no license
Connection via PCoIP can fail stating a lack of license even though the system is properly licensed. Additionally, issuing the pcoip-validate-license.ps1 command can fail resulting in a crash dump.
Rebooting the VM can restore proper licensing functionality.
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.
Licensing can fail if Windows WMI infrastructure is impaired
Windows infrastructure failures can prevent PCoIP agent licensing to be acquired. If the PCoIP agent is not licensed, the user will not be able to connect to the remote machine.
Rebooting the machine may resolve the WMI impairment, enabling PCoIP licensing to be successfully acquired.
Changing window resolution while running a full-screen application may cause issues
Some applications may not be able to handle resolution change when they are running in full-screen mode.
Exit affected applications before changing desktop resolution.
User may be required to log on twice
Rarely, a user may be presented with the lock screen when connecting via PCoIP.
Authenticate a second time to gain access to the desktop.
GRID licensing fails after disabling then enabling GRID capture.
GRID licensing fails after disabling NVFBEnable -disable
then enabling NVFBEnable -enabling
GRID capture, resulting in limitations in the number of monitors and resolutions available.
Teradici has included, as part of the PCoIP Graphics Agent install, a reset script to reset the graphics driver to a good state:
C:\Program Files (x86)\Teradici\PCoIP Agent\GRID\reset_grid.bat
You'll need administrator permissions to run the script. Before running the script, close all other applications, especially those that utilize the GPU. Teradici also recommends you disconnect and reconnect once the script has completed.
NVIDIA GRID licensing not enabled on Azure VM
After starting (re-allocating) a previously stopped (de-allocated) VM in Azure, NVIDIA GRID licensing is not always enabled following VM boot up. This results in PCoIP sessions being limited to a single display with a maximum resolution of 2560x1600 pixels. Contact Microsoft Azure for help.
Restart Windows.
Cursor size larger than 64x64 pixels does not display correctly
Display of cursors larger than 64x64 pixels can become truncated and can terminate the PCoIP session.
PCoIP Graphics Agent upgrade after disconnecting may not work on mapped drives
If you manually download a new version of the PCoIP Graphics Agent and run it from a mapped drive from within a PCoIP session, the update will show an error and plan to continue the update offline while the user is disconnected. If the software installer is located on a mapped drive that the local system account does not have access to, the update will fail.
Copy the installer to a local drive first.
Multiple display issue occurs when NVIDIA GRID is not properly licensed
If NVIDIA GRID is not properly licensed, connecting with multiple displays to a remote machine running PCoIP Graphics Agent may result in only one display being optimized with GRID performance. The other displays will work but will not be optimized with GRID, resulting in lower frames per second.
Ensure NVIDIA GRID GPU is properly licensed.
Duplicated screens in-session
If an application sets the displays to 'duplicate', the user will be unable to restore the configuration to extend across multiple displays due to the controls being disabled.
Open the Projector Menu by pressing Windows key + P, then select Extend.
NVIDIA GPUs do not support Windows Sleep and Hibernate system power states (S3/S4 respectively)
A small number of occurrences have been reported where Windows will crash (resulting in BSOD) when resuming from Windows Hibernate, when installed on a virtual machine equipped with NVIDIA GPUs. For details on sleep and hibernate behaviors supported by NVIDIA, contact and visit http://www.nvidia.com/object/support.html.
Avoid sleeping and hibernating PCoIP Graphics Agent that is configured to utilize NVIDIA GPUs.
Cursor pointer shadow is not supported with Windows 10
'Enable pointer shadow' is not supported in a PCoIP session to Windows 10 PCoIP Graphics Agent.
Performance counters do not appear to collect data
In some cases, even though the performance counters have been installed correctly, it may appear as if they are not collecting data. This occurs due to the fact that the user may have opened the 64-bit version of the performance monitor, while Teradici's performance counters are 32-bit only. As the counters cannot be loaded into the 64-bit version, Windows will disable data collection. A corresponding message in the Windows Event Log should indicate this as well.
To solve the issue:
- Click Start, click Run, type cmd, and then click OK.
- Type the following command, and then press Enter:
mmc.exe /32 perfmon.msc
. This command runs System Monitor in 32-bit emulation mode. - Use System Monitor to determine whether the performance counter object is available.
System volume set to maximum after agent upgrade
When upgrading to the latest PCoIP agent, audio volume is automatically set to maximum.
Manually set the audio to the desired volume after upgrading. Once set manually, the audio volume is maintained. The change in audio volume only happens at upgrade.
GRID capture fails with K520 card using VBIOS 80.04.ED.00.07
NVIDIA K520 cards with Video BIOS (VBIOS) 80.04.ED.00.07 are known to cause a GRID capture failure resulting in the PCoIP Graphics Agent falling back to BitBLT capture. The VBIOS version currently installed on the NVIDIA card can be found via the NVIDIA Control Panel under System Information.
Update the VBIOS on the K520 card to the latest version. VBIOS 80.04.D4.00.03 is known to work.
PCoIP agent fails to connect when host has multiple NICs
When a host computer has more than one network adapter, the system must be configured to inform which adapter to use for inbound PCoIP connections. You can do so by populating the PCoIPConnectionAddress registry value with your desired network interface.
Some software applications such as Npcap can create a virtual network adapter that will present additional Ethernet adapters. These configurations also require populating the PCoIPConnectionAddress registry value with your desired network interface.
In HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Teradici\PCoIPAgent
, set the PCoIPConnectionAddress
registry value:
"PCoIPConnectionAddress"="a.b.c.d"
Where a.b.c.d is your desired network interface). The type of the reg key is a string value: REG_SZ.
Agent installation may take a long time
Teradici installs Microsoft Visual Studio 2013 C/C++ runtimes as part of the agent installation. Runtime installers create a system restore point which, on systems such as Windows 8, can take over 15 minutes. If the installer appears to be stalled when installing the C/C++ runtimes, it may simply be the runtime installers creating a system restore point.
Mouse pointer shadow is missing
The mouse pointer shadow, which gives the mouse pointer a 3D appearance, is not available during PCoIP sessions.