My Issues

Fledermaus

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:

  1. Recently upgraded or changed your license and have received a new license file from QPS with a different activation code.
  2. 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:

Upgrade (change) License with new activation code

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

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:

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


For example, here we cd into the Fledermaus folder. 

cd Fledermaus

Uninstall and Deactivate Old License

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

qps-license-server.exe -u

Then this command to deactivate (Online Activation):

Online Activation
qps-license-server.exe -deact

Or, for an Offline Activation:

Offline Activation
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.

Reactivate and Install

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

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

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

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

And install (start) the license service:

qps-license-server.exe -i

Refresh Existing License (same activation code)

To refresh an existing license, follow these steps:

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:

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


For example, here we cd into the Fledermaus folder. 

cd Fledermaus


Uninstall Server

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

qps-license-server.exe -u

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

Offline Activation only
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.


Reactivate License

For an Online Activation:

Online Activation
qps-license-server.exe -a

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

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

Install (start) the server license service

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

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.):

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


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

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


For example, here we cd into the Fledermaus folder. 

cd Fledermaus


Update and Restart Server

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

For an Online Activation:

Online Activation
qps-license-server.exe -a

Or, for and Offline Activation:

Offline Activation only
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:

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:

Stop Server

Stop the old instance of the Server.

./qps-license-server -u

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

Online Activation
./qps-license-server -deact

Or, for an offline activation:

Offline Activation
./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.

Update and Restart Server

Activate the new license (online activation):

Online Activation
./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
./qps-license-server -a -aresp="/Location/To/Load/QPS-Application-ActivationResponse.xml"

Start the server instance:

./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:

Stop Server

Stop the old instance of the Server.

./qps-license-server -u

Update and Restart Server

Activate changes to existing license:

Online Activation
./qps-license-server.exe -a
Offline Activation
./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"

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

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:

killall qps-license-server

Now, deactivate the license:

Online Activation
qps-license-server -deact

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

Offline Activation
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.

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
qps-license-server -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YYZZ"

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

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

And then:

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.

Stop Server

killall qps-license-server

Update License Information

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

Online Activation
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
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"

Restart Server

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