The T-Plan License Server runs on the .NETCore internal web server, Kestrel. Therefore, in addition it requires a reverse proxy server (e.g. NGINX, Apache) in order to safely serve the application to the internet.
The instructions below detail how to setup and use the T-Plan License Server on NGINX, using yum, however others are supported.
If you want to install the License Server on Windows, please see find the installation details here.
MySQL Compatibility Update
If you are using MySQL version 8.0.29 or later please ensure you are running the latest version of the T-Plan License Server (v3.0.4 onwards).
MySQL applied key updates in this release which were not backwards compatible with the .NET libraries used by the License Server prior to v3.0.4.
Anyone looking to upgrade their MySQL instance should therefore upgrade to the latest License Server also.
- yum for Linux
- Reverse proxy server (NGINX installation instructions below)
- MySQL (installation instructions below)
Setup and Configuration
Install third party components
Log in to Linux OS and install NGINX if not already available:
Install MySQL 8 if not already installed:
Set MySQL root password. This will ask for the current password – installation will have set a temporary password that can be read from the MySQL log file:
Make note of the temporary password now shown on the screen for when the following asks for it:
Now log into MySQL as root and set up the blank DB and user:
As an alternative to the above, if installed you can create the database and user through MySQL Workbench.
Install T-Plan License Server
Login to Linux OS, and download the required build of License Server:
Unpack the file:
This will create a local folder “tplanls”. CD into this folder and run the installer:
Follow the prompts as directed. This will install the application, set it up as a service and start the service. Verify the service is running:
Check the logs if there are errors reported.
At this point, if everything went to plan, you’ll now have a License Server running on http://localhost:5000 and you’ll be able to connect to it locally through your browser. When you first connect it’ll go through the Initialise phase and then the Server License setup phase.
Following initialisation select “Request Server License” and send the displayed code to T-Plan. They will return an activated license for you to apply.
To make this server available to the network, you now need to add a reverse proxy. The steps to do this vary depending on server being used, but most of our testing has been performed using NGINX.
You’re all done – you should have a License Server up and running. Congratulations!
The MySQL password is in plain text in the service file. This MUST be secured, and the best way of doing this is to restrict access to the tplanls.service file to root only. Do that with this command:
Now only 'root' can view this file.