Table of Contents:
How to Start
- Launch the standalone license-manager.exe located in C:\Program Files\Common Files\QPS\License-Manager OR
- Launch the License Manager from each QPS Application
- Window/Linux - View License Status... under Help Menu in the Menu Bar
- macOS - View License Status... under the Application Name in the Menu Bar
What it Does
This dialog manages QPS product licenses across its entire software suite.
In order to run any software in the QPS Suite, a valid license must be available for the software application.
QPS applications currently support Softlock and HASP Dongle licenses that are fully integrated into the License Status Dialog.
When you purchase a QPS software application you will be provided with licenses of your choosing.
The License Information group contains information for the currently selected license in License ID combo box.
Selecting a License in in the License ID combo box will filter the Product table to only contain that license.
The Product table contains information for all HASP and Softlock product licenses attached to the device.
If a Softlock license is no longer needed on the device it can be deactivated using the Deactivate combo box cell and selecting online or offline deactivation.
The Add-Ons table displays any additional functionality your License may offer for a particular product line.
Selecting a License in the Product table will filter the Add-Ons for the selected License.
Copy License ID or Tag ID
In the case that a license ID needs to be conveniently copied from the License Manager, simply right click (click with the right mouse button) on the product for which the license ID is to be copied, then select one of Copy License ID or Copy Tag ID. The option to select depends on what is to be copied. The Tag ID is one of the following: for dongles, it is the number that appears on the printed tag attached to the physical dongle, for softlocks, it is the 7 digit number like a virtual tag ID starting with the digits 520, for servers, this is the same as the license ID. The license ID is one of the following: for dongles, it is the number electronically associated with a dongle, shown in tandem with the tag ID in the display separated by a slash; for softlocks, it is the 28 character activation code separated with dashes, not including the product number or name' for server licenses, this is the location of the server for that product.
Shortcut keys are available. It is sufficient to click on the product row, then press the control, shift and C keys together (Ctrl+Shift+C) to copy the tag ID. The license ID may be copied as before in v1.2 by pressing Ctrl+C.
See an example of the right click menu in the following:
Selecting a HASP dongle from the License ID combo box will enable the button to Upgrade Dongle.
QPS will provide a HASP Upgrade code that will have to be entered or loaded into the Upgrade Code Dialog Window.
Press Load XML File to browse for the file. When you open it, the code will automatically be loaded into this window.
After pressing OK the dongle will be upgraded and will be ready for use.
Add Activation Code
Selecting the Add Activation Code... button launches a new dialog to add a new Softlock License obtained through QPS.
The Softlock license key can be entered manually, pasted into the first text field, or loaded with an appropriate XML file using the Load XML File button.
Clicking OK will apply the new Softlock License for use.
Note: An active Internet connection is required for the activation to complete. Alternatively, an offline activation may be used. The file created during offline activation must then be sent by Internet to QPS. The file can be sent from another computer or network.
If changes have been made to a Softlock License, for example new Add-Ons requested, the local Softlock License will have to be updated.
This can be done manually using the Update Softlocks... button.
Softlocks are automatically updated whenever a licensed application is started and when the License Manager is opened, if the computer with the application is connected to the Internet. So, in general it should not be necessary to use the Update Softlocks... button. However, if the need arises, the status of the licenses may be easily updated by clicking Update Softlocks....
In the event of limited internet connectivity Offline Activation can be performed by clicking the Offline Activation button.
After selecting Generate Request... you will be required to enter your QPS supplied Softlock Product Key which will generate an XML formatted machine fingerprint that must be provided to QPS.
QPS will then provide an XML formatted activation string that can be applied using the Apply Response... option of the Offline Activation button.
Connect to Server
If a license server has been configured it can be used to distribute licenses over a network.
Enter the IP address of the license server and select the appropriate user option and select OK.
Disconnect from server
If a license server has been connected to in the past this option will become available even if the server is offline.
Disconnecting from a server will prompt the user to confirm the requested disconnect. It should be noted that the licenses will remain active until the application is closed.
Set CUSTOM PORTS
It is possible to set the ports used to connect to the server on a case-by-case basis. The default ports used range from 24000 to 24023 at this time, though only ports 24014 to 24019 may actually be used. In future, lower port numbers (down to 24000) may be used.
The port used by any product may be changed by selecting the Set Custom Ports menu item from the Connect to Server button menu. Select the product and desired port number, then click Set Port for product. The port used for licensing for that product (and any other chosen products) will be changed. The default port number for a selected product can be easily restored by clicking on the Reset Default Port button. Any products that are currently running must be restarted for the changes to take effect.
A list of ports used by each product can be retrieved by clicking the List Ports button. The port used by each product will be listed next to the applicable product. Custom ports will be highlighted with a star ``*'' next to any product that has a custom port. In the example attached, note that Fledermaus was assigned port 2222 and a star appears next to the port number.
Care should be taken that no two products use the same port. The port number for the product must match the port number set in the matching configuration file for the product, TurboFloatServer-config.xml. The configuration for the Fledermaus server would in this case be configured as seen here (where the configuration boxed in green). Note that the port used for both the client and the server are the same.
SET CUSTOM Proxy
By default, License Manager uses whatever proxies your users have set for their system. Where License Manager reads these proxy settings from differs between operating systems:
Windows: The proxy settings are read from Internet Explorer.
Mac OS X: The proxy settings are read from the system internet settings.
Linux: The proxy settings are read from the environment variables
You can overwrite the default system proxy settings by specifying a proxy server address. When using custom proxies they must be in the form Proxy in the form:
Example 1 (just a host):
Example 2 (host and port):
Example 3 (all 3):
Note: If the port is not specified, License Manager will default to using port 1080 for proxies.
- To set a custom proxy simply check 'Use Proxy Server' and specify a proxy server address and press OK.
- To clear a previously set custom proxy simply uncheck 'Use Proxy Server' and press OK.
License Manager also support NTLM proxies on Windows. To use NTLM proxies you must also specify the domain. For example:
The commandline can be used to activate a softlock license in an automated manner. The -silent option in conjunction with the -activate option can be used to activate a single activation code. It is an error to specify either of these options without the other.
Usage is: license-manager
[ -silent ]
[ -activate <activation-code> ]
- "-silent" tells the LicenseManager not to show the GUI.
- "-activate <activation-code>" tells the LicenseManager to activate the specified code.
- "-h" displays the usage information.
- "-ver" displays the version information.
- The exit code indicates if the activation was successful or not.
Clicking the Help menu item will give you online and offline options for viewing 'How-to' manuals for the License Manager and HASP Dongles.
1) Modern Windows operating systems can have something called Hyper-V (or Hyper Visor) turned on. Having this active causes some processes to be run in a virtual machine (VM). By default, QPS softlocks are restricted and won't work on an OS that is running within a VM or one that has Hyper-V enabled. If you are unable to use the licensing due to this restriction, QPS may be able change the configuration of your license to enable use on a VM / Hyper Visor based machine.
2) If your license is not activating successfully, ensure that you can view wyday.com in a web browser. If you cannot see this page (this is the same address that the license software uses to authenticate), it may be necessary to whitelist wyday.com, or perhaps use a proxy if your organization has one in place.