License Server Upgrade Guide
This page details steps required to upgrade your License Server from a previous version to the latest.
Given that the License Server is a .Net Core application, it is self-contained within the application files. Therefore, when it comes to upgrading your License Server you essentially just need to replace your current application file set with the new file set. How this is achieved differs depending on the distribution platform you are using with each being explained below.
Before preceding with an upgrade, please ensure that you are aware of the prerequisites for the intended version.
When completing the upgrade from an earlier release, upon first logon you will be prompted to migrate your database.
BACKUP
NOTE: This operation is irreversible! Please ensure that you have taken a backup of your MySQL License Server database.
Upgrading your License Server on Docker
Docker is arguably the simplest deployment method and makes the task of upgrading very straight forward.
Backups
Prior to running any upgrades it is always recommended to take a backup of your database
First, stop the licserver container:
docker stop [containerId or name]
Then remove the container:
docker rm [containerId or name]
Then run up the effectively new container with the new tplan/licserver:[version]:
docker run -d -p 5200:5200 -e ASPNETCORE_ENVIRONMENT='Development' -e "ASPNETCORE_URLS=http://*:5200" -e "MYSQLCONNSTR_LicenseServerDB=server=[MySQLServerAddress];user id=[MySQLUser];password=[MySQLPassword];database=[MySQLDB]" tplan/licserver:latest
Now launch the License Server in your browser. If prompted, select the "Upgrade" button to allow the UI to upgrade your database.
This completes your upgrade.
Upgrading your License Server on Linux
Backups
Prior to running any upgrades it is always recommended to take a backup of your database
If remaining on Linux, you need to first stop the tplanls service:
[me@centos ~]$ sudo systemclt stop tplanls
Then you can download and extract the latest License Server application files to overwrite your existing file set:
[me@centos ~]$ wget https://downloads.t-plan.com/releases/ls/LicenseServer_Linux.tar.gz [me@centos ~]$ tar -xzf LicenseServer_Linux.tar.gz
Then simply restart the tplanls service:
[me@centos ~]$ sudo systemclt start tplanls
Now launch the License Server in your browser. If prompted, select the "Upgrade" button to allow the UI to upgrade your database.
This completes your upgrade.
Upgrading your License Server on Windows
Backups
Prior to running any upgrades it is always recommended to take a backup of your database
If currently running a License Server within IIS on Windows, it is recommended to first stop IIS. This will then allow you to simply download the new application file set and extract the zip contents to overwrite your existing application files.
Download the latest application files from here.
Having done this, you may need to verify the file permissions are correct (e.g. IIS_IUSR etc) depending on your setup.
Once the new files are in place, restart IIS before launching the License Server in your browser.
If prompted, select to Update your database to the latest version.
This completes the upgrade.
Switching from one platform to another
Converting from one environment to another is really a case of running a new installation and pointing it to your existing database.
In order to make the switch you will need to ensure that your MySQL is accessible to your new setup. Alternatively, you may wish to also take this opportunity to move to a new database server and therefor will need to export your database from one MySQL instance to another, as discussed here (external link).
If exporting to a new MySQL instance, you will require a new License Server license. Please contact T-Plan Support.
With the database considerations in hand, you can then proceed to setup your new License Server instance by following the installation steps outline here:
If switching environments you will need to ensure that your new instance is accessible, as required (internally, externally) through your DNS settings. If this involves a new domain/URL then you will also need to update your Robot/RAP installations with the new license URL - which can be obtained from within the License Server.
<<Windows Installation Linux Installation >>