Management Console 2.2.0 Release Notes

Release Status: General Availability (GA)

Release Overview:

PCoIP Management Console 2.2 introduces new features, enhancements, and updates to the PCoIP Management Console. It is compatible with Tera2 Zero Clients on Firmware 5.0 or higher. This article provides a summary of compatibility notes, key feature additions, resolved issues, and known issues for this release.

To evaluate Enterprise Edition features, request a 60-day Enterprise trial license.

Note: After the 60-day trial expires, return the license and the Enterprise version will revert to Standard Edition where only Standard Edition features will be available.

Important Notes and Requirements:

  • PCoIP Management Console 2.2 is only intended for use in managing PCoIP Tera2 Zero Clients from within a secured corporate network.
  • PCoIP Management Console 2.2 must not be accessible from unsecured networks, such as the open Internet. Making PCoIP Management Console 2.2 accessible from the open Internet is an unsupported use of the product and will void any warranty.
  • This release of PCoIP Management Console requires an accessible Internet connection for licenses to be activated.
  • PCoIP Management Console 2.2 cannot import databases from versions of PCoIP Management Console before 2.0. However, migration instructions are available through the user guide for moving your deployment from earlier versions of PCoIP Management Console to PCoIP Management Console 2.2, and for importing profiles from earlier versions to version 2.2.
    PCoIP Management Console 2.2 is not based on PCoIP Management Console 1.x. As a result, some features of PCoIP Management Console 1.x have not yet been implemented in this release. These features include:
    • Management of Workstation Access Cards
    • Auto Config rules using DHCP options
    • SCEP provisioning
    • Persistent Auto Config (replaced in 2.0 with recurring schedules)
    • Export of profiles

Compatibility NotesProductsEndpoint
Enterprise EditionStandard EditionTera2 Zero Clients

Deployments using the PCoIP Management Console to manage Tera2 Zero Clients on Zero Client Firmware 5.0 or higher must use PCoIP Management Console release 2.0 or higher.
Tera1 devices and Remote Workstation Cards are not compatible with this release of PCoIP Management Console.
Teradici recommends using the latest release of the PCoIP Management Console.

This release of the PCoIP Management Console has been tested with Zero Client Firmware release 5.2.0.
The OVA package for this release of PCoIP Management Console has been qualified against VMware ESXi versions 5.1, 5.5 and 6.0.
Teradici is currently working on providing the official Amazon Machine Image (AMI) for use with Amazon Web Services. However, users are able evaluate Amazon EC2 installation by creating their own AMI through the use of AWS provided conversion tools or by other means. Teradici does not provide technical support for the PCoIP Management Console AMI produced through conversion tools, or on the conversion tools themselves.
  • Firefox 45+
  • Internet Explorer 11+
  • Chrome 50+
  • Edge 25+

What's New in This ReleaseProductsEndpoint
Zero Clients

Inventory Report

A comma-delimited file can be generated from the endpoints table to provide a listing of all devices visible in the endpoints table, or a listing of all devices and columns visible in the endpoints table. This file can be used by users of the Management Console to import inventory information on their deployment into third-party inventory management systems.

Device Delete 

Endpoints can be deleted from the Management Console. Endpoints that have been deleted will need their management state manually cleared through their AWI or through a factory reset. If auto discovery is used (DHCP option or DNS SRV records) and the endpoints remain online, then they may rejoin the Management Console shortly after deletion.

Endpoint Device Count Indicator 

The endpoint view tabs for grouped and ungrouped devices provides a count of all devices in that state. This provides administrators to know if new devices have appeared in the system with a quick glance if they are in the endpoints page.

Microsoft Edge 

Support has been added to the Management Console for the Microsoft Edge web browser.

External links 

Any links in the Management Console to systems that are external to the Management Console will now open in a new browser window so as to not take the user away from their administration tool. 

Security Enhancements 

Security has been enhanced by requiring the OS admin user to enter their password when performing actions that require elevated privilege through the sudo command and enforcing new password complexity rules when changing passwords by all non-root user accounts. 

Updated appliance requirements

Default disk space requirement is now 62GB (45.6GB for system, 15.9GB for swap, 0.5GB for boot).

Partition allocations moved to make increases of the data partition easier using Linux tools.

Resolved IssuesProductsEndpoint
Enterprise EditionStandard EditionTera2 Zero Clients


PCoIP Management Console would not discover zero client if full IP range (1-255) is specified. When manually discovering endpoints, the PCoIP Management Console may not find any devices within an IP range if there is no device at the first IP address. This issue is now fixed.


'Apply Profile' from search selection is now working when more than one endpoint are selected. Previously, 'Apply Profile' from search selection would not work if more than one endpoint was selected.
43032 Pool Name to Select Property is no longer missing from the View Connection Server and Auto-Logon session type.


Daemon was unable to open connection to the console after uploading new certs with SHA256-ECDSA Signature. This issue is now fixed.


Advanced features now available when editing Profile. There were times when the radio button for Advanced profile settings were unavailable. Workaround: Modify one of the settings below the Basic/Advanced radio buttons to re-enable the Advanced radio button.


Migration Script failed to migrate port 1 and port 2 rotation values. The Quad Display Topology Port 1 Rotation and Port 2 Rotation values were not migrated when a PCoIP Management Console 1.x profile containing these values was migrated to version 2. This issue has been fixed.


PCoIP Management Console was unable to enable or disable zero client password protection. Zero client profile settings relationship between Enable Password and Force Password Change was unclear. This issue has now been fixed, and settings relationship is described next:

Enable Password ProtectionForce Password Change on Next LoginBehavior
Enabled Enabled User forced to change password
Enabled Disabled User forced to change password
Disabled Enabled User is not forced to change password
Disabled Disabled User is not forced to change password
Not set Enabled Behavior depends on default zero client value for Enable Password Protection
Not set Disabled Behavior depends on default zero client value for Enable Password Protection


Known Issues and WorkaroundsProductsEndpoint
Enterprise EditionStandard EditionTera2 Zero Clients


Database backups and restores fail. The database can grow too large due to the nature of action and property information being stored. This can result in the backup of the database being corrupt without warning, or the restore taking too long and ultimately failing. Workaround: See KB 3243 for instructions on cleaning the database prior to backup. Ultimately consider upgrading to the latest release of PCoIP Management Console.


Database imports may fail on new installations, or where network settings have been changed. Database imports may fail on a newly installed PCoIP Management Console, or where network settings have been changed on the PCoIP Management Console.


Successfully completed schedules cannot be deleted from PCoIP Management Console. Successfully completed schedules cannot be deleted from PCoIP Management Console. Only those schedules which are yet to run can be deleted.


Profile mismatch on Software Version field in the Endpoints page. If the endpoint is on a different firmware version that what is set in the profile, it may not get highlighted as a profile mismatch in the Endpoint page for that device.


Dashboard and Endpoint screens not being updated. The dashboard and endpoint screens may occasionally not update information. Workaround: Restart the PCoIP Management Console daemon.


Auto-Configuration rules are deleted silently when deleting a group. When a group is deleted, all auto-configuration rules assigned to that group will also be removed without any notification.


Enhanced Logging Mode cannot be disabled in PCoIP Management Console 2It is not possible to disable Enhanced logging mode on a zero client using a PCoIP Management Console profile. Workaround: Consider setting the Enhanced mode to one that is not applicable to your environment. For example, ONESIGN or UNIFIED COMMUNICATIONS.


Certificate Store shows mismatch when not set in the profile. When a profile without a configured Certificate Store is applied to a zero client, then the Management Console will always show that the zero client does not match the profile. The Endpoints page shows a profile mismatch and the Endpoint Details page shows the Certificate Store does not match. Workaround: Configure a Certificate Store in the profile.


Endpoint naming using Group Naming does not work with auto configuration. For zero clients grouped using Auto Configuration to be given names that use the Primary Group Name and/or Deepest Sub-group Name options configured in Settings > Naming, the moved between grouped and ungrouped rule for Rename Endpoints when must be selected instead of first discovered for the name to be applied.


Mismatch between timeout ranges in profile and zero client AWI. The Display Suspend Timeout and OSD Screensaver timeout profile properties range does not match that of the zero client. In the PCoIP Management Console, the Display Suspend Timeout property can be configured with a value between 60 to 28800 seconds. The PCoIP Zero Client AWI allows a range of 10 to 14400 seconds. Similarly, the PCoIP Management Console Profile editor allows the OSD Screensaver Timeout property to be configured with a value between 10 to 9999 seconds. The PCoIP Zero Client AWI allows a range of 10 to 65535 seconds.


PCoIP Management Console does not support the zero client's Clear Trusted View Connection Servers cache feature.


PCoIP Management Console does not check values of device bandwidth setting. The PCoIP Management Console Profile editor does not enforce the requirement that Bandwidth Floor ≤ Bandwidth Target ≤ Bandwidth Limit. Profile content that does not meet this requirement will fail to apply to a zero client. Workaround: Ensure that the profile content meets the requirements. Consider setting all three values in the profile to ensure this.


Schedule Start Date incorrect. In the Change Profile dialog accessed from the Endpoints page, the Schedule Start Date value appears as "NaN-NaN-NaN 12: AM".


Zero clients with underscore characters not displaying properly. Zero clients that have the underscore character '_' at the start and/or end of the label are not properly displayed in the PCoIP Management Console. Blank fields are shown instead of endpoint data. Workaround: Avoid underscores at the start and end of zero client labels.


Profile Mismatch column does not display status. The Profile Mismatch column on the Endpoints page may be blank. Workaround: Refer to the Endpoint Details for profile mismatch information.


Cannot manage zero client Management Security Level feature. Workaround: Use the Zero Client Administrative Web Interface to configure this setting.


Cannot manage zero client Management Discovery Mode feature. Workaround: Use the Zero Client Administrative Web Interface to configure this setting.


Cannot configure zero client View Connection Server and Imprivata OneSign Restrict Proximity Cards feature. The Restrict Proximity Cards feature was introduced in firmware 4.8.0.


Cannot configure zero client PCoIP Connection Manager Organization ID feature.


Cannot manage RDS Application Access. RDS Application Access cannot be set by PCoIP Management Console from the zero client profile settings.


Cannot manage IPv6 Address Resolution. IPv6 Address Resolution cannot be set by PCoIP Management Console from the zero client profile settings.


Cannot manage Low Bandwidth Text Code. Low Bandwidth Text Code is missing from the list of Profile settings.


Cannot manage zero client Unified Communications feature. The Unified Communications feature was introduced in firmware 4.8.0. Workaround: Use the PCoIP Zero Client Administrative Web Interface to configure this setting.


Cannot manage zero client OSD Region Tab Lockout feature. Workaround: Use the Zero Client Administrative Web Interface to configure this setting.


Endpoint Log takes 8 seconds to load. The Endpoint Log dialog accessed from the Endpoint Details page takes up to 10 seconds to be populated with event log messages retrieved from the zero client. 


Missing settings in OneSign advanced configuration. The following profile configuration settings for Imprivata OneSign are not yet available for configuration:
  • Direct to View Address
  • Invert Wiegand Data
  • Restrict Proximity Cards
  • Use OSD Logo for login banner


End Time not working accurately. Daily recurring schedules may occur one additional time after the End Date and Time set in the schedule.


USB Local Audio dependency should be set in profile editor. PCoIP Management Console profiles that set Local USB Audio Driver to Enable must also set HD Audio to Enable. Otherwise, the profile will fail to apply to zero clients that have HD Audio disabled.


Remote Host Power Control in zero client profile has Soft Power-Off optionThe Soft Power-off only and Soft and Hard Power-Off options under the Remote Host Power Control profile should not be visible as they are not applicable to zero clients. Only the options Hard Power-Off only and Power-off not permitted apply to zero clients.


Delete Profile applied to a group message. Profiles attached to a group cannot be deleted, even though a dialog will prompt for the user to Delete or Cancel the delete action. Workaround: Ensure the profile is not attached to any group prior to attempting to delete it. Groups using the profile can be viewed from the profile page using the widget on the right-hand side of the screen.


The above known issues are under investigation. Please subscribe to this knowledge base item to receive updates.