Release Notes

Standard Agent for Windows 23.06.1

  • The PCoIP Standard 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 23.06 of the Standard Agent for Windows includes:

Collaboration Manager Opens from In-Session Menu

The Collaboration Manager can now be launched from a new Collaboration menu option in the Standard Agent for Windows's menu, in addition to launching from the system menu bar. For more information, see Sharing Your Session With Collaborators.

Agent Updates No Longer Available From PCoIP Control Panel

Standard Agent for Windows updates must be done by downloading a new installer and running it in place. Previously, the agent software could be also be updated via the PCoIP Control Panel; this functionality has been removed in this release. For more information, see Updating the Standard Agent for Windows.

Resolved Issues

None.

Known Issues

Hot Plugging Wacom Tablet on Zero Client Connected to Windows Agent

New
187599

Following initial connection using a Zero Client to connect to an Anyware Windows Agent, disconnect/reconnect of the Wacom Tablet device may result in the device not appearing in the USB menu. 

Repeated USB hot-plugging of a Wacom tablet while in a PCoIP may also cause the session to hang.

Workaround:

Restart the PCoIP Session if unable to re-connect the Wacom Tablet after disconnecting.

Reboot the host if session freezes after repeated hot-plug attempts.

Bloomberg keyboard 5 firmware upgrade does not work over PCoIP session

New
182517

When the Bloomberg Keyboard firmware upgrade process starts, the upgrade will become unresponsive and will never complete. Bloomberg Biometric module gets disconnected from PCoIP session.

Workaround:

Do not run Bloomberg Keyboard firmware upgrade inside a PCoIP session.

Upgrade Bloomberg Keyboard firmware from local machine instead. If Bloomberg Biometric module gets disconnected, re-connect the Biometric module to the remote host.

Multiple collaboration manager UI icons shown in the system tray on Windows

 
172888

When connecting/disconnecting repeatedly without logging out of the session, multiple instances of the collaboration manager icon may appear in the system tray.

Workaround:

Hovering the mouse over the collaboration manager UI icons will make the duplicates disappear. The corresponding icon for the active collaboration manager UI will remain.

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.

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.

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.

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.

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.

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.

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.

Duplicate mode in Windows is not supported with PCoIP Agent

 
90789

Using "Duplicate displays" mode is not supported, and will result in unexpected behavior.

Workaround:

Connect to your virtual machine via RDP and change the Display settings to "Extend these displays".

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.

Users are unable to connect if they do not have "Allow log on locally" permission

 
88728

PCoIP connections are made to the console, and appear as local logons to the server. For this reason, remote users must have local logon permission ("Allow log on locally") in the system's Windows configuration.

For example, if only administrators are allowed to log on locally, then only administrators could connect via PCoIP; anyone outside the administrators group could not connect.

Workaround:

Adjust the value for "Allow log on locally" to include the groups that include the users who need to access this machine.

PCoIP connection may appear unresponsive during Windows update

 
88310

A Windows update that has become unresponsive can show a busy cursor in the PCoIP session and prevent the user from interacting with the desktop.

Workaround:

In some cases, users may be able to resize the window in order to gain access to the Windows task bar, and select "Update and Restart" to complete the process. If the user is unable to access the task bar, contact a system administrator to restart the machine.

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.

Cannot unlock session if Leostream credential provider installed

 
84919

If the Leostream credential provider is installed, it can interfere with unlocking the desktop. The result is a lock screen with no controls to unlock the user.

Workaround:

Uninstall the Leostream credential provider.

Performance monitor errors

 
81269

Errors may occur when opening performance monitor and adding performance counters.

Workaround:

Use the following Windows command to correct issues with the performance monitor:

 lodctr.exe / R

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.

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.

First connection fails to connect after Windows update

 
72116

After initiating certain Windows Updates, the update process may not complete until a user attempts to logon.  In these situations the PCoIP session will fail to establish while the Windows Updates completes and the WDDM driver is re-configured.

 

Subsequent connection attempts after the Windows Updates completes are successful.

Workaround:

Attempt to login via PCoIP after a Windows 10 update. If the connection fails, then wait a few minutes for Windows Update to complete and for the PCoIP agent to restore its compoents and then re-connect.

Windows privacy settings can block microphone access

 
72039

Starting with Windows 10 1803, modern applications that attempt to access the microphone can be prevented from doing so.

Workaround:

Through Windows Microphone privacy settings you may need to enable access to the microphone and allow the desired application to access it.

PCoIP Agent upgrade fails due to failure to uninstall the display driver

 
71940

A failure to upgrade the PCoIP Agent software includes the following error message in the logs:

ERROR:  An error occurred while uninstalling driver package 'C:\Program Files (x86)\Teradici\PCoIP Agent\drivers\Display\x64\tera_kmdod.inf' (Error code 0x57: The parameter is incorrect.)
Workaround:
  1. Issue the following command:
c:\Program Files (x86)\Teradici\PCoIP Agent\drivers\Display\x64> pnputil.exe -i -a tera_kmdod.inf 
  1. From the windows device manager, uninstall the Teradici PCoIP WDDM driver.

  2. Reboot the VM.

  3. Run the PCoIP Agent installer

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.

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.

PCoIP connection may be blocked by existing RDP sessions

 
63331

When using Windows Server without the RDS role installed, Windows will only support two concurrent user connections at most. If a third user attempts to initiate a PCoIP session, that login will be blocked, requiring the user to disconnect one of the other two sessions. This disconnect requires the user to have administrative rights on the machine.

Workaround:

Do not attempt to connect more than two users to a Windows Server system that does not have the RDS role installed.

Invalid resolution when hotplugging monitors

 
59421

If two different monitors are used and one or more displays is removed or added during a PCoIP session, there is a chance that one of the displays may get an incorrect resolution.

Workaround:

Disconnect your PCoIP session and reconnect.

Windows Filter Keys are not supported for Windows 10 and Server 2016

 
55978

Enabling Windows Filter Keys will render user unable to unlock desktop.

Workaround:

Disable Windows Filter Keys.

Operating system re-installation requires re-installation of PCoIP Standard Agent

 
54456

Upgrading from Windows 10 to Windows 10 Anniversary Update (1607) performs an operating system re-install. After re-installing Microsoft Windows, only some device drivers are migrated to the new operating system. Since not all of the PCoIP Standard Agent software is migrated, it will need to be re-installed.

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.

Relative mouse is not supported by PCoIP agent

 
44176

Relative mouse is not supported by PCoIP Standard Agent, Graphics Agent, or Multi-Session Agent. The 'Relative mouse enabled' message does not display in client logs.

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.

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.