Release Notes

License Server for Linux 24.07

Version 24.07 introduces the following new features and capabilities:

Support for Designating IP Addresses

In version 24.07, full support for designating IP addresses has been added. IP addresses for the license server can be specified in the localconfiguration.yaml file. This capability is useful in scenarios where customers have multiple network interfaces, and they want to reserve specific IP addresses for license server communication. 

Note: In the previous releases, the license server would not start after IP address assignment. This issue has now been fixed, and the license server starts as expected.

For more information, see Assigning IP Addresses for License Server Communication.

Resolved Issues

The Linux Local License Server did not restart after configuring the IP and port

 
213349

The Linux License Server could not start after configuring the the network interface IP along with the port number in the localconfiguration.yaml file.

This issue has now been fixed.
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 Local License Server Administrator's Guide (Troubleshooting --> Troubleshooting General Issues --> 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.