How-to Softlock License Server - Upgrade or Refresh

This how-to outlines the steps to follow to either refresh an existing license server or to upgrade your current license server to a new license.

These steps only need to be followed if you have either:

Recently upgraded or changed your license and have received a new license file from QPS with a different activation code.
Your existing license was changed and needs to be refreshed (No new license file has been given. An example of this would be if the date of your license expiration or support and maintenance expiration has been updated. These steps will also enable changes like the addition or removal of a product add-on)

Online Activation: The server has access to the internet.

Offline Activation: The server does not have access to the internet and activation requests and activation responses are sent and received from QPS via email or support ticket system.

If you are experiencing difficulties after following the steps outlined here, please contact our support team via the Support Desk: QPS Support Desk

To download the license server package go to www.qps.nl and navigate to the download page for either Fledermaus or Qimera. Click on the 'Get Latest Version' option, and scroll down to the license server section of downloads.

You can find the product key in your license .xml file by opening it with a text editor or internet browser. From there, you can copy the <upgrade code> line up to the first period.

Example key: ABCD-EFGH-IJKL-MNOP-QRST-UVWX

For offline activations, the process of upgrading a license is more complicated. A deactivation request AND an activation request need to be created, sent to QPS, we will then send back an activation response. The details of the new license are contained in the activation response which is then used as outlined in the steps below.

Windows

For more information on setting up a QPS License Server on Windows, see the following page:

How-to Softlock License Server - Windows Setup

Upgrade (change) License with new activation code

To upgrade your license server with a new license file, follow these steps:

1) Navigate to Correct Folder

Start the command prompt as an administrator, and cd into the directory where your license server package is, and into the folder of the product you want to upgrade:

CODE

cd..\..\qps-license-server-windows

For example, here we cd into the Fledermaus folder.

CODE

cd Fledermaus

2) Uninstall and Deactivate Old License

Run this command to uninstall (stop) the license service:

CODE

qps-license-server.exe -u

Then this command to deactivate (Online Activation):

Online Activation

CODE

qps-license-server.exe -deact

Or, for an Offline Activation:

Offline Activation

CODE

QPS-License-Server.exe -deact="C:\Location\To\Fledermaus-deactivation.xml"
QPS-License-Server.exe -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="C:\Location\To\Save\Fledermaus-ActivationRequest.xml"

Send both of these created files to QPS and a new activation response will be sent back.
In the second step, use the NEW activation code.

3) Reactivate and Install

Next, the product needs to be reactivated with the NEW activation code:

Online Activation

CODE

qps-license-server.exe -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX"

or, for an offline activation, apply the NEW activation response:

Offline Activation

CODE

qps-license-server.exe -a -aresp="C:\Location\To\Load\QPS-Application-ActivationResponse.xml"

And install (start) the license service:

CODE

qps-license-server.exe -i

Refresh Existing License (same activation code)

To refresh an existing license, follow these steps:

1) Navigate to Correct Folder

Start the command prompt as an administrator, and cd into the directory where your license server package is, and into the folder of the product you want to upgrade:

CODE

cd ..\..\QPS-License-Server-Windows

For example, here we cd into the Fledermaus folder.

CODE

cd Fledermaus

2) Uninstall Server

Next you must uninstall the existing server, by running the following command line:

CODE

qps-license-server.exe -u

For an Offline Activation, you must also create a deactivation request and activation request:

Offline Activation only

CODE

QPS-License-Server.exe -deact="C:\Location\To\Fledermaus-deactivation.xml"
QPS-License-Server.exe -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="C:\Location\To\Save\Fledermaus-ActivationRequest.xml"

Send both of these created files to QPS and a new activation response will be sent back.
In the second step, use the NEW activation code.

3) Reactivate License

For an Online Activation:

Online Activation

CODE

qps-license-server.exe -a

Or, for an Offline Activation, using the NEW activation response:

Offline Activation

CODE

qps-license-server.exe -a -aresp="C:\Location\To\Load\QPS-Application-ActivationResponse.xml"

4) Install (start) the server license service

CODE

qps-license-server.exe -i

You should now be able to access the updated license server from client machines once you have completed step three.

Alternate License Refresh Procedure

1) Stop Windows Service

First you must stop/uninstall the existing server, by running the following command line (this command line is for Fledermaus. The four digits at the end of the line is the version ID.):

CODE

sc stop TurboFloatServer-4286

Version ID's:

Fledermaus = 4286
FMGeocoder = 4615
Midwater = 4616
QARTO = 4290
QASTOR Online = 3124
QASTOR Office = 3125
Qimera Clean = 4284
Qimera = 4283
Qimera PRO = 4285
Qlipper = 5724
Tile Server = 4287

2) Navigate to Correct Folder

Start the command prompt as an administrator, and cd into the directory where your license server package is, and into the folder of the product you want to upgrade

CODE

cd ..\..\QPS-License-Server-Windows

For example, here we cd into the Fledermaus folder.

CODE

cd Fledermaus

3) Update and Restart Server

Now the server must be updated with the following command line.

For an Online Activation:

Online Activation

CODE

qps-license-server.exe -a

Or, for and Offline Activation:

Offline Activation only

CODE

QPS-License-Server.exe -deact="C:\Location\To\Fledermaus-deactivation.xml"
QPS-License-Server.exe -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="C:\Location\To\Save\Fledermaus-ActivationRequest.xml"

Send both of these created files to QPS and a new activation response will be sent back.
In the second step, use the NEW activation code.

Once you have received a new activation response file from QPS, apply it:
qps-license-server.exe -a -aresp="C:\Location\To\Load\QPS-Application-ActivationResponse.xml"

And then the server must be started again:

CODE

sc start TurboFloatServer-4286

Mac

For additional information on setting up a QPS Server License on Mac OSX, please see this page:

How-to Softlock License Server - Mac OS X Setup

The following commands will be run from within the folder for each product that you are updating.

Example, updating a Qimera Clean server instance means you need to be in the "Qimera Clean" folder.

Upgrade (change) License with a new activation code

To upgrade the server instance to a new license follow the steps below:

1) Stop Server

Stop the old instance of the Server.

CODE

./qps-license-server -u

and then this command to deactivate (for an online activation):

Online Activation

CODE

./qps-license-server -deact

Or, for an offline activation:

Offline Activation

CODE

./qps-license-server -deact="/Location/To/Fledermaus-deactivation.xml"
./qps-license-server -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="/Location/To/Save/Fledermaus-ActivationRequest.xml"

Send both of these created files to QPS and a new activation response will be sent back.
In the second step, use the NEW activation code.

2) Update and Restart Server

Activate the new license (online activation):

Online Activation

CODE

./qps-license-server -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX"

Or, if you have an offline activation, use the -aresp option and point to your NEW activation response file:

Offline Activation

CODE

./qps-license-server -a -aresp="/Location/To/Load/QPS-Application-ActivationResponse.xml"

Start the server instance:

CODE

./qps-license-server -i

Refresh Existing License (same activation code)

If you've already activated and you want to reactivate, then you don't need to pass a new product key. You can just call the Server with the "-a" command line argument:

1) Stop Server

Stop the old instance of the Server.

CODE

./qps-license-server -u

2) Update and Restart Server

Activate changes to existing license:

Online Activation

CODE

./qps-license-server.exe -a

Offline Activation

CODE

./qps-license-server -deact="/Location/To/Fledermaus-deactivation.xml"
./qps-license-server -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="/Location/To/Save/Fledermaus-ActivationRequest.xml"

Send both of these created files to QPS and a new activation response will be sent back.
In the second step, use the NEW activation code.

Once you have received a new activation response file from QPS, apply it:
./qps-license-server -a -aresp="/Location/To/Load/QPS-Application-ActivationResponse.xml"

CODE

./qps-license-server -i

Linux

For additional information on setting up a QPS Server License on Mac OSX, please see this page:

How-to Softlock License Server - Linux Setup

The following commands will be run from within the folder for each product that you are updating.

Example, updating a Qimera Clean server instance means you need to be in the "Qimera Clean" folder.

Upgrade (change) License with a new activation code

1) Stop Server and Dectivate License

First you must stop the current server. In Linux this means stopping all active servers, with the following command line:

CODE

killall qps-license-server

Now, deactivate the license:

Online Activation

CODE

qps-license-server -deact

or, for an offline deactivation (this must then be sent to QPS along with an offline activation request).

Offline Activation

CODE

qps-license-server -deact="/Location/To/Save/QPS-Application-deactivation.xml"
qps-license-server -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="/Location/To/Save/Fledermaus-ActivationRequest.xml"

Send both of these created files to QPS and a new activation response will be sent back.
In the second step here, use the NEW activation code.

2) Reactivate and Install Server

Next you will reactivate all servers, with this command line for each server that you want to have active again.

Activate with the NEW activation code:

Online Activation

CODE

qps-license-server -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ"

or, for an offline activation, with the NEW activation response file:

Offline Activation

CODE

qps-license-server -a -aresp="/Location/To/Load/QPS-Application-ActivationResponse.xml"

And then:

CODE

qps-license-server -d -silent -pidfile=/var/run/<name>.pid

Refresh Existing License (same activation code)

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" command line argument.

1) Stop Server

CODE

killall qps-license-server

2) Update License Information

Reactivate (this will pull new information down from the license database)

Online Activation

CODE

qps-license-server -a

(this will stop all qps-license-server instances running on the PC)

Or, for an offline activation, there are several steps:

Offline Activation

CODE

qps-license-server -deact="/Location/To/Save/QPS-Application-deactivation.xml"
qps-license-server -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ" -areq="/Location/To/Save/Fledermaus-ActivationRequest.xml"

Send both of these created files to QPS and a new activation response will be sent back. In the second step, use the NEW activation code.
Once you have received the activation response, carry out the following step:

Once you have received a new activation response file from QPS, apply it:
qps-license-server -a -aresp="/Location/To/Load/QPS-Application-ActivationResponse.xml"

3) Restart Server

CODE

qps-license-server -d -silent -pidfile=/var/run/<name>.pid