This guide covers how to activate and install the server using command line.
QPS-License-Server is the application that distributes floating license "leases" for QPS applications. The server runs on your local network.
Activating the Server
Before you can use Server it must be activated.
1) Download the Server Package QPS-License-Server-X.X.X-win64.zip
2) Unzip Server Package
3) Open command prompt as administrator
4) cd into where you unzipped the package
5) cd into the folder for the product you want to activate.
6) For offline activation of this step, refer to the Offline Activation steps below. Otherwise, follow this step if access to the Internet is possible. If at all possible, use this method to activate the server. To activate the QPS License Server online simply pass the product key like this:
7) Repeat step 5) and 6) for every product you want to activate.
Installing the Server
1) You can use a simple commandline switch "-i" to setup your Server.
This does two things:
- It installs the QPS License Server instance as a Windows Service set to start with the computer and run silently in the background.
- It starts the QPS License Server immediately.
2) Repeat for every product you want to install.
Offline Activation (Optional)
The offline activation can be used when a machine has no access to the Internet. A file must be retrieved from the machine and sent to QPS to initialize the license, and a response file from QPS must be loaded by the server. Transferring the file can be done by internal network to another machine or by USB key or the like. Activation is otherwise similar to online activation. At step 6, perform the following two steps to do an offline activation: When access to the Internet is available, these steps are not required and step 6 above should be followed.
a) Activate and create the offline request file. It is suggested to use the name of the product in the filename, particularly if one is activating more than one product server. For example, to activate Fledermaus:
.QPS-License-Server.exe -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="C:\Location\To\Save\Fledermaus-ActivationRequest.xml"
At this point, the file Fledermaus-ActivationRequest.xml or equivalent must be sent to QPS. Once the contact at QPS has sent back a response file, e.g. Fledermaus-ActivationResponse.xml, the activation may be completed by applying the response file.
b) Apply the response file from QPS as follows:
QPS-License-Server.exe -a -aresp="C:\Location\To\Load\Fledermaus-ActivationResponse.xml"
The activation should now be completed, and the remaining steps followed as usual.
Companion files "TurboActivate.dat" or "TurboFloatServer-config.xml"
When the Server is activating it needs to load both the "TurboActivate.dat" and "TurboFloatServer-config.xml" files. By default, the server package for each product will contain these files.
If you've already activated and you want to re-activate, then you don't need to pass a new product key. You can just call the Server with the "-a" commandline argument:
Deactivating the Server
If you want to move the Server from one computer to another computer you have to deactivate from the first computer before you can activate on the second computer. To deactivate the Server instance you must use the "-deact" commandline switch:
If the server does not have access to the Internet, offline deactivation steps must be followed as outlined below. Note that the file generated must be sent to QPS at your point of contact. Once QPS receives and processes the file, it will then be possible to activate the server on another machine, using either online or offline activation at your choice. Until the deactivation file is processed, it will not be possible to activate another license server.
If you have any firewall software running then you'll have to set it to allow incoming connections to the Server instance. If you installed the service using the -i option, and are using the Windows Firewall, it will be automatically configured for the license server. However, in circumstances when the Firewall needs to be configured manually, please follow the guide below:
1) Open Windows Firewall with advanced security
2) Add Inbound Rule
3) Choose Program
4) Click Next
5) Select the program path
6) Click Next
7) Click Next
8) Click Next
9) Enter Name
10) Click Finish
The end result should be a set of TCP and UDP Inbound rules, for each of the products, similar to the screenshots below:
If you are using a different Firewall program, the steps should be similar. If you wish to specify a port range, the server instance will connect using ports 24000-24020.
If you want to install the Server, but don't want it to start immediately, then use the "-delaystart" commandline switch:
QPS-License-Server.exe -i -delaystart
This installs the Server instance but it doesn't start the service. The service will be started on the next restart of the computer.
Uninstalling the Server
To uninstall the Server simply use the "-u" commandline switch:
This does two things:
- It stops the Server immediately.
- It removes the Server instance from the Windows Services.
Running Server from commandline
If you would rather just run the Server from the commandline, rather than installing it, you can do that using the "-x" command switch:
In that example the Server instance will run from the commandline.
Upgrading the Server instance
Upgrading the Server instance is simple:
To start / stop the Server Windows Service instance you must use the "service name" of "TurboFloatServer-[VERSIONID]".
The "[VERSIONID]" value is the id of the version where the product key is from. You can get the version ID by examining the URL in your browser. For instance, from the URL
https://wyday.com/limelm/version/100/ you can see the version ID is 100. (Note: The Version ID is not the Version GUID).
So if your version id is "100" then the service name for your Server instance is "TurboFloatServer-100" on Windows.
- Stop the running old instance of the Server.
sc stop TurboFloatServer-100
- Replace the old QPS-License-Server.exe (or whatever you've renamed it as) with the new version.
- Start the Server instance again.
sc start TurboFloatServer-100