PCoIP Management Console 3.0.0 Release Notes (15134-3219)
Important: If you are unable to access the sign-in link or if the page navigation seems broken, force refresh your browser's cache. From Windows and Linux browsers, use Ctrl+F5. From Mac browsers, use +Shift+R.

PCoIP Management Console 3.0.0 Release Notes (15134-3219)

Release Overview

PCoIP Management Console version 3.0 introduces support for remote device management on Tera2 Zero Clients, and other features and improvements.

This version introduces features over PCoIP Management Console 2.5.1. These release notes provide a summary of key feature additions, compatibility notes, resolved issues, and known issues for this release.

This version also retires the Standard Edition of Management Console, replacing it with PCoIP Management Console - FREE.

Please be aware that this version also contains important security updates and fixes. All earlier versions should be upgraded to this version or higher.

To evaluate PCoIP Management Console - ENTERPRISE features, request a 60-day enterprise trial license.

Note: After the 60-day trial expires, any installed licenses must be removed in order to run PCoIP Management Console - FREE.

What's New in This Release

Introducing Management Console Free

PCoIP Management Console Free is now available.

Management Console Free supports up to 100 endpoints and basic configuration of those devices. Advanced features are now exclusive to PCoIP Management Console Enterprise.

Amazon WorkSpaces Session Type

For Tera2 Zero Clients on firmware version 6.0, PCoIP Management Console can now configure the Amazon WorkSpaces session type from within the profile settings. This session types enables Tera2 Zero Clients to connect directly to Amazon WorkSpaces without the use of the PCoIP Connection Manager for Amazon WorkSpaces. Amazon Web Services will instruct the zero client to present which authentication fields are required to log into Amazon WorkSpaces.

Remote Endpoint Management (Enterprise only)

Administrators can control and manage PCoIP Zero Clients for at-home workers in the same way they do for those in the office, without the expense of a VPN. Zero clients can be remotely placed and will receive profile updates and firmware updates provided the latency to the zero client is within 100ms. Information on deploying this configuration is available in the administrators' guide.

Offline License Activation (Enterprise only)

Enabling licenses for Enterprise capabilities can now be done in highly secured environments that do not permit access to the Internet. In order to do so, Offline activation license SKUs must be purchased instead of the standard Desktop Access SKUs. Activation occurs in the command line of the operating system. See the administrators' guide for additional details.

Unified Communications Options Removed

As of firmware 6.0, CounterPath's Unified Communication (UC) is no longer available in zero client firmware. As such, the ability to configure UC or enhanced logging for UC has been removed from the Management Console.

System Network Configuration tool has been replaced with NetworkManager TUI

As of CentOS 7, the System Network Configuration tool has been replaced with NetworkManager textual user interface (nmtui). NetworkManager TUI is now the default tool for configuring IPv4 static addresses and hostnames.

Added endpoint serial number to the Endpoint page

The serial number of the endpoint is now a property in the endpoints table. It can also be exported into the Inventory Report, enabling administrators to better track their endpoint inventory

Updated Profile assignment in the endpoints table

Profile assignments are now listed same row in the endpoint‘s row in the endpoint table. Previously profile assignments were only listed when the group’s row. This facilitates a quicker identification of the profile associated with an endpoint.

Session Timeout setting (Enterprise)

The session time out is now configurable from a tab in the security settings page for PCoIP Management Console Enterprise. This enables administrators to configure how long a user’s session in the PCoIP Management Console can be idle for before it logs the user out.

Sudo console commands require password

To improve the security of the virtual appliance, the Linux console admin account password is now required when enacting any elevated privilege commands using sudo.

Manual request Get All Settings for arbitrary sets of Endpoints

The Endpoint page's ENDPOINTS -> GET ALL SETTINGS menu option now supports arbitrary sets of devices.

Improved IP Address sorting

Columns in tables that contain IP Addresses are now sorted based on the numerical value of each octet of the IP address as opposed to being sorted as if they were a string. Now would be considered greater than Previously it was the reverse.

Zero Client session status information updated dynamically on session state change

The PCoIP Management Console now updates the zero client's PCoIP session status when it changes, based on an alert sent by the endpoint every time its session has been changed. This will permit the session status to be updated on a more frequent basis in the PCoIP Management Console interface.

Upgraded to CentOS 7.0

Upgraded installation OS to CentOS 7.3 - 64 bit.

Improved search now supports sub groups

When moving groups, the search field will now use the entered text to search within group names of any group in the hierarchy. This enables search based on the name of a parent or intermediary group in order to find the desired child group.

Hide Sub Group can be checked if only the group that matches the search text is desired.

Important Notes and Requirements

  • This release of PCoIP Management Console is only intended to be deployed in a secured environment. Any management exposure to unsecured endpoints should be performed through a reverse proxy.
  • This release of PCoIP Management Console must not be accessible from unsecured networks, such as the open Internet. Making this release of PCoIP Management Console accessible from the open Internet is an unsupported use of the product and will void any warranty.
  • PCoIP Management Console version 3.0 cannot import databases from versions of PCoIP Management Console before version 2.0. However, migration instructions are available through the administrators' guide for moving your deployment from earlier versions of PCoIP Management Console to PCoIP Management Console version 3.0, and for importing profiles from earlier versions to version 3.0.

Release Downloads

Related Documents and Software

  • Teradici PCoIP® Management Console 3.0 Administrators' Guide
  • Tera2 PCoIP® Zero Client Firmware Administrators' Guide
  • Tera2 Zero Client Firmware 6.0.0 Release Notes

Release History

3.0.0 October 2017 Release with new features and improvements


Compatibility NotesProducts
 Enterprise EditionFree Edition
This version of the PCoIP Management Console has been tested with Tera2 PCoIP Zero Client Firmware release 6.0. X X
The OVA package for this version of PCoIP Management Console has been qualified against VMware ESXi versions 5.5 and 6.0. X

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. Please note, you may need to enable SSH in order to access the appliance for configuration. This can be done prior to conversion or after. For information on configuring the console after conversion please review instructions from AWS: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html

 X X

Compatible browsers:

  • Firefox
  • Chrome
  • Edge

PCoIP Management Console is tested against the browser version available prior to release.


Known Issues

Migrations from releases prior to 2.5 may fail

Migrating PCoIP Management Console deployments to PCoIP Management Console 2.5.1 or 3.0.0 may fail with a corrupted database due to the database restore taking too long. This issue stems from a known issue (68605) in older releases (2.4 and earlier), which results in excessively large or corrupted database backups. (68452)

Workaround: See KB 3243 for instructions on cleaning the database prior to backup.

Some predefined filters not showing results

The predefined filters Endpoint Updates Pending, and Endpoints Waiting on Restart do not consistently display endpoints matching those states. (66993)

APPLY profile active when it should be disabled

The APPLY menu item under the PROFILE menu in the ENDPOINTS page is displayed as being active even when there is no profile associated with the selected group or endpoints. (66972)

Mouse hover is not revealing all active filters

If more than two filters are active on the ENDPOINTS page, then hovering over the filter list will not reveal all of the active filters. (66971)

Some Group List buttons are not working with Internet Explorer

When using Internet Explorer 11, buttons that involve lists of groups do not always work. The impacted buttons are: Schedule > New Schedule > Groups Add button Auto Configuration > New Rule > Group Endpoints > Structure > Grouped > New Group (66762)

Workaround: Use Firefox, Chrome, or Edge.

Endpoint settings temporarily removed from database during upgrade from Management Console 2.x to 3.0

When migrating from Management Console 2.x to 3.0, if there are profiles that contain zero client firmware 6.0.0, then the settings data of the endpoint will be dropped from the Management Console. The information will repopulate the next time the endpoint reports its current settings back to the Management Console. (66374)

Workaround: Remove firmware 6.0.0 from profiles prior to upgrading or wait for endpoints to report all their settings back in.

Unable to move a large number of endpoints

It is not possible to select thousands of rows of endpoints for the purpose of moving. (66369)

Workaround: When endpoints are grouped, move them based on the group to minimize the number of selected rows. If the endpoints are ungrouped, they will have to be moved in smaller chunks.

Incorrect Profile USB VID and PID reported in Endpoint Details

The Endpoint Details page may incorrectly report USB Product and Vendor IDs in the Preferred USB Device settings for the Profile Settings. (66181)

Profile application fails when "Server URI" and "DNS Name or IP Address" are too long

Profile settings permit values that are too long for the "Server URI" and "DNS Name or IP Address" settings result in failed profile applications. (66162)

Workaround: Ensure values for "Server URI" and "DNS Name or IP Address" are no more than 67 characters long.

Incorrect empty value for "Pool Name to Select" is shown

Blank values for the profile setting "Pool Name to Select" are incorrectly shown as "Not Set" on the Endpoint Details page. (66161)

Session -> Server URI setting not always being set on endpoint

The Server URI setting for the View Connection Server session type is not always applied to the endpoint. (66133)

A new session type may not get applied to an endpoint if the profile setting is missing the server URL.

A new session type may not get applied to an endpoint if the profile setting is missing the server URL. (66127)

Blank values are not accepted for View Connection Server advanced "Custom Session SNI" setting

Blank values are not accepted for View Connection Server setting Custom Session SNI found in the advanced section. (66078)

Some comparisons for IP Address and MAC Address filters do not work correctly

The comparison values of "is greater than" and "is not" are not producing results for the IP Address and MAC Address filters and may result in a "ValidationException" entry in the console log file. (65917)

View Connection Server + Imprivata OneSign connection type does not get set the first time

The View Connection Server + Imprivata OneSign connection session type does not set when the profile is applied. (64076)

Workaround: Apply the same profile twice to set the View Connection Server + Imprivata OneSign connection type.

ENDPOINT -> DETAILS active when it should be disabled

When selecting a group in the ENDPOINTS table, the ENDPOINTS -> DETAILS menu item is shown as active when it should be disabled. (64042)

Exporting the results of a search will show empty values in the Profile column.

Exporting the results of a search will show empty values in the Profile column. (63913)

Web interface may fail to load when accessed by the FQDN

The Management Console's web interface may fail to load with a JavaScript error when the address used is a FQDN containing the word "console", such as console.company.local. (61464)

Workaround: Use the IP address or rename the MC VA so that the FQDN does not contain the word 'console'.

Profile Mismatch column on the Endpoint's page incorrectly shows True

The Endpoints page table incorrectly shows Profile Mismatch is True for some zero clients even though the Endpoint Details page does not show any mismatches. (61140)

Web interface unavailable for a Management Console with DHCP assigned host name.

Users are not able to log into the Management Console web interface when the DHCP server assigns a host name to the Management Console Virtual Appliance. The error shown on the login page is "Waiting for the server to start." (59280)

Workaround: Follow the steps described in knowledge base article 15134-2760

Disabling individual schedule does not work if the user selects only the date without a start time

If the start date is set for a schedule, but the start time is not set, then a change to the 'Enable' function in the schedule edit or creation page may not be saved. (55912)

Workaround: Ensure your schedule has a start time in addition to a start date.

Incorrect count for additional schedules on dashboard

The 'more schedules' text in the Dashboard section for Upcoming Schedules always states '(1) more schedules' regardless of how many schedules are upcoming but do not fit in the view. (55636)

Profile mismatch reported when Authorized Devices is set to 'Any'

The endpoint details page will report a device as having a profile mismatch if the profile settings for the profile applied to the device has Peripherals > Authorized Devices set to Any Device Class, Any Sub Class, or Any Protocol. (54060)

New features from latest PCoIP Management Console disappear when using FQDN instead of IP address

Some web browsers consider previous releases of PCoIP Management Console cache content as valid. Hence, features from the new version of PCoIP Management Console disappears when using FQDN instead of IP address. (51732)

Workaround: Clear the web browser's cache.

'Ungrouped' tabs display offline and out of session device statuses as blank

Devices that are displayed in the Ungrouped endpoints table will have their online or session status column data listed as blank if the device is offline and/or out of session. Both of these values should be displayed as false in those cases. (48320)

Profile applications applied from the Endpoints page is not recorded in the Schedule > History page

When applying a profile to a group from the Endpoints page, the application is not recorded in the Schedule > History page and the power reset assignment for the profile is in the 'Failed' state when it should be skipped. (48169)

Unable to delete endpoints when using a filter

The delete function does not work when a filter is applied to the endpoints table. (44508)

Workaround: Remove the filter, then find the device(s) to delete.

Exporting endpoints on Firefox downloads a file with unexpected filename and without '.csv' file extension

Exporting the endpoints on Firefox downloads a file with an unexpected filename and without '.csv' file extension. Following this, the 'Endpoints' page briefly displays a 'Server not responding' message and jumps to the dashboard. (43864)

Workaround: At the time of saving, rename the file.

Session filters return no results

Applying filters for Session Status 'In Session' or 'Out of Session' does not display devices in the endpoints table. (39456)

Deleting a group will silently delete auto-configuration rules

When a group is deleted, all auto-configuration rules assigned to that group will also be removed without any notification. (38229)

Endpoint naming using Group Naming does not work with auto configuration

To give zero clients with auto configuration a Primary Group Name and/or Deepest Sub-group Name, go to Settings > Naming and select moved between grouped and ungrouped rule in the Rename Endpoints when tab. (34756)

PCoIP Management Console does not check the value 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. (32527)

Workaround: Ensure that the profile content meets the requirements. Consider setting all three values in the profile to ensure this.

Schedule Start Date on Change Profile Confirmation dialog shows NaN-NaN-NaN 12: AM

Schedule Start Date on Change Profile Confirmation dialog shows NaN-NaN-NaN 12: AM (32524)

Endpoint labels with underscore characters at the start or end are not displayed properly

Endpoints 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. (32398)

Workaround: Avoid underscores at the start and end of endpoint labels.

View endpoint log takes some time to load

The Endpoint Log dialog accessed from the Endpoint Details page takes up to ten seconds to be populated with event log messages retrieved from the zero client. (29846)

Daily schedules may occur one additional time

Daily recurring schedules may occur one additional time after the End Date and Time set in the schedule. (27959)

Profile's HD Audio setting may fail if set differently to Local USB Audio Driver

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. (27823)

Resolved Issues

Request Certificate menu item now displays the UPGRADE icon

When operating PCoIP Management Console FREE, the REQUEST CERTIFICATE menu item from the ENDPOINTS menu on the ENDPOINTS page now displays the UPGRADE icon to indicate that it is a feature only available in the PCoIP Management Console Enterprise. (64150)

Table columns sortable after search

If a search is run from the Endpoint page, then the columns will now be sortable. (63580)

Exported Endpoint data no longer unnecessarily includes Certificate columns

Endpoint data exported from the Endpoints page now only includes the "Certificate Rule", "Certificate Name", "Certificate Status" , "Certificate Start Date" and "Certificate Expiry Date" columns when these columns are shown on the Endpoints page. (62474)

Endpoint page Last Polled column is now sortable

The Last Polled column on the Endpoints can now be sorted. (62163)

Actions to a group now apply to endpoints in sub-groups

Actions from the Endpoint page, such as Apply profile, applied to a group are now also applied to any endpoints in the sub-groups. (61743)

Profile can now be saved if Broker Address Cache has a port

Profiles can now be saved if the Broker Address Cache under Session Connect Type has a port number in the URL. (59455)

Endpoint searching no longer impacts the availability of the refresh button

The refresh button is no longer disabled after one usage when a search has been applied to the Endpoint page. (56086)

Profile can now be saved if broker address is a FQDN has a port

A broker address that has been entered as an FQDN can now also include an explicit port number, such as https://broker.domain.com:4430. (54569)

Scheduled actions adjust to daylight savings

When daylight savings changes occur, scheduled actions will now occur at the scheduled time, and not at an incorrect hour. (43174)

Disable option for Enhanced Logging profile property

A 'Disable' option in the Enhanced Logging profile property has been added. This option will remove all enhanced logging settings from endpoints that have the profile applied to them. (37600)

Was this answer helpful?YesNo

Knowledge Base

Topic Information
  • Topic #: 15134-3219
  • Date Created: 10/10/2017
  • Last Modified Since: 01/12/2018
  • Viewed: 2612