Release Notes

Standard Agent for Windows 19.11.2

  • 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 19.11.2 of the Standard 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 with CPU acceleration enabled shows increased video playback quality.

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

  • You can now disable the locally-rendered cursor. This prevents double cursors in applications that render their own cursor.

  • This release removes support for Windows 7 and Windows Server 2008R2.

  • Bug fixes and security enhancements.

Known Issues

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

91222

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.

Workaround:

Do not use Wacom Display Settings touch key.

Wacom Cintiq 24 Pro P cursor flashing when used with local termination

91038

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.

Workaround:

None.

Duplicate mode in Windows is not supported with PCoIP Agent

90789

Using "Duplicate" mode will result in unexpected behavior around displaying your Windows desktop with the PCoIP Agent.

Workaround:

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

Updating Windows 10 to 1903 requires specific installation sequence

90155

If uninstalling PCoIP agent in preparation for installing a newer version you must reboot before starting the new install.

Workaround:

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.

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.

Wacom tablet cannot be mapped to non-primary display on Windows 7 and Server 2008

79144

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.

Workaround:

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.

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 Cintiq 22HD does not work with Cloud Access Software

71924

Wacom Cintiq 22HD does not work with Cloud Access Software PCoIP Agent for Windows with the latest Wacom Windows driver.

Workaround:

Downgrade the Wacom Windows driver to version 6.3.32-4.

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.

Installation timeout in Windows 7 when system restore is enabled

67818

If system restore is enabled, PCoIP agent installation on windows 7 platform might fail due to time out.

Workaround:

Disable system restore

Windows CardSpace interferes with PCoIP

66833

On Windows 7 and Windows Server 2008R2 there is a Microsoft feature to support digital identification called Windows Cardspace. Use of this feature will freeze your PCoIP session and prevent future connections.

Workaround:

If you are unable to connect to your PCoIP session due to launching Windows Cardspace then you can connect to your virtual machine using RDP and close Windows Cardspace to re-enable PCoIP connectivity.

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.

PCoIP validate license reports unsupported version of Trusted Storage

66075

When executing pcoip-validate-license on either Windows or Linux an error is reported stating that 

This version of trusted storage is not supported.
Workaround:
  1. Delete the contents of C:\ProgramData\Teradici\PCoIPAgent\licensing\5 in Windows, or /var/lib/pcoip-agent/licensing/5 (requires root permissions) in Linux

  2. Restart the appropriate agent service (PCoIP Graphics Agent or PCoIP Standard Agent on Windows, or pcoip-agent on Linux)

  3. If using Teradici Cloud Licensing (not using a local license server), re-register the host.

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.