Release Notes

Graphics Agent for Windows 22.09.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 22.09.2 of the Graphics Agent for Windows is a maintenance release which replaces and deprecates 22.09.0. There was no public release of 22.09.1.

It includes the following:

  • Bug fixes.

Previous release information:

22.09.0:

  • 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.

  • Introduces support for Microsoft Azure NCasT4_v3-Series instances.

  • Bug fixes and stability enhancements.

Resolved Issues

PCoIP firewall rules are now automatically created on non-English Windows systems

22.09.0
165945

PCoIP firewall rules are now automatically created on non-English Windows systems. Previously, firewall rules had to be manually created on non-English systems.

Graphics Agent for Windows image corruption fixed

22.09.0, 23.01.0
165315

Graphics Agent for Windows 22.07.2 introduces a fix to correct image corruption.

Graphics Agent for Windows issues with rotated displays when connected from zero client resolved

22.09.0, 23.01.0
164474

An issue with PCoIP Agent 22.07 that resulted in problems when connecting from a zero client with a rotated display has been resolved with PCoIP Agent 22.07.2

User Principal Name (UPN) is now supported in PCoIP Agent for Windows

22.09.1
161332

Support for UPN is added to PCoIP Agents for Windows. Users can now authenticate, use single sign on, and start a PCoIP session on Windows using their UPN.

Known Issues

On PCoIP Graphics Agent for Windows using PCoIP Ultra GPU offload has reduced framerate

 
169164

On 22.07.2  PCoIP Ultra GPU offload PCoIP sessions may experience lower FPS than previous builds. This symptom is more commonly seen on systems with resolution higher than 1920x1080.

Workaround:

Possible workarounds include using PCoIP Ultra CPU offload, using lower resolution monitors, or downgrading to Graphics Agent for Windows 22.04

PCoIP Graphics Agent for Windows GPU Offload has reduced image quality

 
165968

22.07.0 Graphics Agent with GPU offload might experience following performance issues: 

  • image pixelation due to image quality dropping to very low
  • Bandwidth use dropping to very low results in low session FPS
Workaround:

Adjusting PCoIP session bandwidth floor settings should help reduce pixelation and increase session FPS.

Resizing collaboration session window causes crash

 
165911

Re-sizing the PCoIP Client window while participating in a PCoIP Ultra Collaboration session may cause the PCoIP client to crash.

Workaround:

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

 
165332

When the collaborator client window is resized, cursor artifacts may be seen on the collaborator client momentarily.

Workaround:

Once the resizing settles, the artifacts will disappear.

Collaborator may not see the remote cursor when first connected

 
154011

When a guest collaborator connects to the host's session, the host's cursor may not be visible to the guest until it moves.

Workaround:

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

Connecting a USB Webcam may cause browser to quit

 
151469

When a webcam is connected to a remote desktop, the browser on the remote desktop may terminate.

Workaround:

Disable webUSB in chrome:

chrome://flags/#enable-webusb-device-detection

Multi-channel audio deteriorates after switching from wired to wireless network

 
145191

When a session started with a wired connection is switched to a wireless network, the multi-channel audio quality deteriorates. The audio quality does not improve after switching back from the wireless network to a wired connection.

Workaround:

Disconnect the session and reconnect after switching to a wireless network.

Power save not supported

 
125759

Power save is an operating system feature where the screen goes black after some time to save power. This event will cause the PCoIP Graphics Agent to crash.

Workaround:

Power save mode must be disabled on the host computer. 

To clarify, lock screen mode, where it prompts the user to login when left idle, is supported.  Power save option, where the screen goes black after some time to save power, is not supported and must be disabled.

Long connection time results in failed PCoIP connection

 
121954

Fixes an issue where PCoIP connection would fail due to long connection time. Affected versions are:

  • PCoIP Agent for Windows 21.01.0
  • PCoIP Agent for Windows 21.01.1
  • PCoIP Agent for Windows 21.01.2
Workaround:

No known workaround.

Soon to expire licenses can cause licensing failure for new host

 
117440

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.

Workaround:

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

Session fails to start with PCoIP Ultra GPU or Auto Offload enabled

 
112285

If you are unable to start a session with PCoIP Ultra GPU Offload or Auto Offload enabled it may be due to a lack of GPU memory. This can be verified by looking for "out of memory" in the PCoIP server log.

Workaround:

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.

PCoIP single sign on will fail if a popup is shown on the secure desktop (Ctrl+Alt+Del screen)

 
107689

When a popup is shown on the secure desktop, for example "Incorrect password or username" or "Smartcard subsystem failure", PCoIP SSO cannot be started.

Workaround:

The user will still get a PCoIP session when SSO fails; from that session, dismiss the popup and finish the logon manually. After completing this procedure, future SSO connections should work as expected.

NVIDIA control panel still contains Teradici information after PCoIP Graphics Agent uninstall

 
102069

During normal operation the PCoIP Graphics Agent for Windows will populate information about remoted displays into the NVIDIA graphics stack. This information is provided by PCoIP clients either for the real displays they have attached or a virtual display when the client is run windowed.

This information is left populated in the NVIDIA driver between PCoIP sessions to improve re-connection times. It is also left populated if the Agent software is uninstalled.

Workaround:

Left over client display information can be manually removed from the NVIDIA control panel using the following steps. # Open the NVIDIA control panel # Navigate to the "View System Topology" view (this is typically nested under "Workstation" settings) # Look under each graphics card for displays that appear to have an EDID loaded from file # Click the +EDID+ link to bring up the EDID management dialog # Navigate to the "Unload" tab in this dialog and check the box next to each EDID where the status is listed as "File" # Click the "Unload EDID" button to purge this information from the graphics driver

PowerShell scripts cannot be executed by PCoIP Agent Installer

 
101924

Folder where the PowerShell.exe binary is located is not present in the Windows system environment variable PATH.

Workaround:

Ensure that folders "%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\" and "%SYSTEMROOT%\System32" are present in the System variable PATH.

ZoomText is not supported on Windows Graphics Agent

 
100893

ZoomText cursor and magnification features get internally disabled when launched with Windows Graphics Agent versions post 20.01.

PCoIP Agent and PCoIP License Server commands have the same name

 
99245

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.

Workaround:

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

Wacom tablet bridging: Cursor issue with Windows Ink setting enabled

 
97596

When a Wacom tablet is running in bridged mode in a PCoIP session, the cursor may not be shown correctly with Windows Ink setting enabled in the Wacom Desktop Center.

Workaround:

Disable Windows Ink in Wacom Desktop Center. Applications which rely on Windows Ink feature may not work after turning off that setting.

Wacom display toggle does not work in local termination mode

 
97543

After connecting Wacom tablet in local termination mode, display toggle is not supported in the PCoIP session.

Workaround:

Connect Wacom tablet in USB bridging mode.

Custom resolutions may not work for NVIDIA in a multi display scenario

 
96847

It has been observed that in a a dual display scenario, with one display rotated the NVIDIA driver version 44166 (branch 441_58) does not apply custom resolution to the right display. As a result, the rotated display comes up as black.

Workaround:

This issue may not occur, if the custom resolution already exists in the list of resolutions for the display.

As a workaround, downgrade the NVIDIA Grid driver to 43179 (branch r430_00) to avoid this issue.

Sharp edges introduced in curves when using Wacom tablets

 
93214

Drawing with a Wacom tablet can introduce sharp edges when quickly drawing curves. This is more likely to happen under any of the following conditions:

  • Network latency greater than 25ms
  • Using large tablets such as Intuous Pro (L) or Cintiq 24 pro or larger
  • Drawing quickly
Workaround:

To reduce the likelihood of sharp edges, draw more slowly, establish a lower latency network connection, or use a smaller tablet.

Using Windows-p to adjust monitor behavior not supported

 
93160

Using the Windows-P key combination to adjust projector display types is not supported. Using this key combination and selecting "duplicate" may cause secondary displays to turn black.

Workaround:

Adjust your monitor configuration at the client, before the PCoIP session begins.

Wacom tablet force proportions setting causes cursor offset

 
93086

Enabling the Wacom tablet's force proportions setting will limit the tablet area to match the aspect ratio of the display, but the PCoIP Client misinterprets the cursor location and displays the cursor in the wrong place.

Workaround:

Map the Wacom tablet either to the entire desktop, or to one of the displays.

Using resolutions unsupported by the AMD GPU profile can cause display problems

 
91960

Using a display topology outside of the what the AMD GPU instance supports, display problems can occur. These issues include:

  • Non functional displays
  • Imaging artifacts
  • Loss of accelerated capture support
Workaround:

Generally, reducing the display topology to be within the Microsoft Azure instance type's support limitations and reconnecting will solve the problem. In severe cases, a full graphics driver reinstall or re-provisioning of the instance may be required.

High resolution portrait displays do not work with AMD GPU

 
91834

Portrait-oriented displays with a vertical resolution greater than 2160px are not currently supported by Cloud Access Software on AMD GPUs.

Workaround:

Reducing the resolution of the portrait oriented display to a value less than 2160 pixels may allow it to work,

Display resolution problems when using Windows Server 2019 and NVIDIA GRID 9.1 driver

 
91811

Display resolution may not work correctly on Windows Server 2019 instances when using the GRID 9.1 driver.

Workaround:

Upgrade to NVIDIA Grid 10.0 driver.

Disabling Windows SSO disables vchan plugins

 
91615

Vchan plugins are launched when the PCoIP session begins. If the system has single sign on disabled, then the PCoIP session cannot login the user desktop and the vchan plugins cannot start properly. This causes multiple issues including loss of clipboard synchronization and lack of printing support.

Workaround:

Re-enable single sign on to ensure that vchan plugins start properly and both clipboard and printer plugins are available. 

If enabling single sign on is not an option, connect, login, disconnect (if not disconnected automatically) and re-connect to ensure vchan plugins are running in the reconnected session.

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

 
91222

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.

Workaround:

Do not use Wacom Display Settings touch key.

Wacom drawing issues on Windows Server 2019

 
90094

While using a Wacom tablet in a PCoIP session on Windows Server 2019, pen pressure is detected but drawing with the Wacom stylus does not work.

Workaround:
  1. Start Wacom Tablet Properties app, switch to Mapping tab, and uncheck "Use windows ink" option.

  2. For Photoshop users:  Create a file “PSUserConfig.txt” with the following content. Place the file in "C:\Users*[User Name]*\AppData\Roaming\Adobe\\ Settings\"

*# Use WinTab*
*UseSystemStylus 0***

Uninstall failure: unable to delete TeraCleanupLogs schedule task

 
89323

Sometimes, PCoIP agent uninstall failed because it could not delete TeraCleanupLogs schedule task.

Workaround:

According to [https://superuser.com/questions/1475639/how-to-fix-broken-permissions-for-windows-scheduled-task], this is caused by security patch from Microsoft. 

Go to C:\Windows\System_32\Tasks\

  • Run the following command to find the hardlink to TeraCleanupLogs task.
fsutil hardlink list TeraCleanupLogs
  • Delete the hardlink to the TeraCleanupLogs task.

AMD displays not all present at first connect

 
86615

In some cases, the graphics driver may not be ready when the initial PCoIP connection is established on an AMD GPU Microsoft Azure instance. When this occurs, not all expected displays will be available.

Workaround:

Disconnect the PCoIP session and reconnect.

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 is unreliable in KVM environments

 
80201

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 issues warning in device manager and is not functioning

 
79051

Wacom functions like clicking with the pen, side-buttons on tablet, and pen pressure sensitivity, do not work.

Workaround:

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

 
72726

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

Workaround:

Reboot the machine.

PCoIP Agent refuses connection with licensing error

 
72286

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.
Workaround:

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.

Windows resolution change options are disabled after uninstalling PCoIP agent

 
71751

Windows display settings to change resolution are grayed out after uninstalling the PCoIP agent.

Workaround:

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

 
71425

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

 
70173

When USB bridging a Wacom tablet to a Windows agent the cursor position is not updated while working in Windows INK.

Workaround:

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

 
69794

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.

Workaround:

You can either disable interactive logon text or you can disable the PCoIP SSO.

Wacom tablet cursor fails to highlight some UI elements

 
68947

When moving the Wacom pen across the desktop some program controls do not highlight properly.

Workaround:

Remove long right mouse click from the pen settings in Windows.

Cloud Access Software indicates no license

 
66566

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.

Workaround:

Rebooting the VM can restore proper licensing functionality.

Licensing can fail if Windows WMI infrastructure is impaired

 
65660

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.

Workaround:

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

 
63089

Some applications may not be able to handle resolution change when they are running in full-screen mode.

Workaround:

Exit affected applications before changing desktop resolution.

User may be required to log on twice

 
61632

Rarely, a user may be presented with the lock screen when connecting via PCoIP.

Workaround:

Authenticate a second time to gain access to the desktop.

NVIDIA GRID licensing not enabled on Azure VM

 
61088

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.

Workaround:

Restart Windows.

Cursor size larger than 64x64 pixels does not display correctly

 
57721

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

 
55408

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.

Workaround:

Copy the installer to a local drive first.

Multiple display issue occurs when NVIDIA GRID is not properly licensed

 
52157

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.

Workaround:

Ensure NVIDIA GRID GPU is properly licensed.

Duplicated screens in-session

 
51912

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.

Workaround:

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)

 
51788

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.

Workaround:

Avoid sleeping and hibernating PCoIP Graphics Agent that is configured to utilize NVIDIA GPUs.

Cursor pointer shadow is not supported with Windows 10

 
45095

'Enable pointer shadow' is not supported in a PCoIP session to Windows 10 PCoIP Graphics Agent.

Performance counters do not appear to collect data

 
45092

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.

Workaround:

To solve the issue:

  1. Click Start, click Run, type cmd, and then click OK.
  2. Type the following command, and then press Enter: mmc.exe /32 perfmon.msc. This command runs System Monitor in 32-bit emulation mode.
  3. Use System Monitor to determine whether the performance counter object is available.

System volume set to maximum after agent upgrade

 
42226

When upgrading to the latest PCoIP agent, audio volume is automatically set to maximum.

Workaround:

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

 
42099

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.

Workaround:

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

 
40825

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.

Workaround:

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

 
22702

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

 
1870

The mouse pointer shadow, which gives the mouse pointer a 3D appearance, is not available during PCoIP sessions.