Release Notes

License Server for Linux 20.10

Release 20.10 for the PCoIP License Server introduces the following:

  • Introduces support for RHEL 8 and CentOS 8.
  • Bug fixes and security enhancements.
Known Issues

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

Sudden shutdown of the PCoIP License Server can cause database corruption

79544

If the license server is shut down suddenly and cannot be shut down cleanly, the trusted storage database may become corrupted. A corrupted database will prevent the flexnetls-TERADICI service from starting.

When the flexnetls-TERADICI service cannot start due to a corrupted database, you will see various error messages in the log file at /var/log/flexnetls-TERADICI/pcoip-license-server.log.  Example messages: "FATAL Encryption error in file null", or "ERROR flexnetls_licenses:database flush".

Workaround:

Delete the trusted storage, and re-start the flexnetls-TERADICI service. Instructions can be found in the Teradici License Server Administrator's Guide (Troubleshooting --> General Issues --> To rebuild the trusted storage database).

License Server may fail to upgrade

72671

License Server fails to upgrade if

  • You initially deployed License Server 2.0 prior to February 2018 (version 2.0.0.376 Beta)
  • AND you upgraded once to either version 2.0.0.384 (stable) or 2.0.1.389 (stable)

If this applies to you, follow the workaround steps below prior to upgrading the License Server.

Workaround:

Online License Server workaround: 

  1. Stop license Server
sudo systemctl stop flexnetls-TERADICI
  1. remove trusted storage
sudo rm -rf /var/opt/flexnetls/ 
  1. Upgrade license server
sudo yum upgrade pcoip-license-server
  1. Once the new license server is installed and started, change the default password  and check the licenses. It should have the same licenses as before
sudo pcoip-set-password -p 1P@ssw0rd!
pcoip-view-license

Verify license is available.

 

Offline License Server workaround: 

  1. Return the license first
pcoip-activate-offline-license -g -a KEY -c 0

Copy the binary file to internet access machine and upload the binary file to https://teradici.flexnetoperations.com Copy the response file to the license server

pcoip-activate-offline-license -r FILE

Verify license is returned by running pcoip-view-license

  1. Stop license Server
sudo systemctl stop flexnetls-TERADICI
  1. remove trusted storage
sudo rm -rf /var/opt/flexnetls/ 
  1. Upgrade license server. Please review Offline license server administrator guide for installation instructions 

  2. Activate the license again.