Licence Protector 5

Navigation: Part II - Enhanced Features > Concurrent User - how it works

Floating license over the Web

For single user applications, Licence Protector 5 offers an option to use an application on multiple PC's but only on one PC at a time. It is similar to a floating license in a network but uses the Activation Server 6 to check, which PC has started the application.

During each program start, the PC has to register the application online and at the end of the application, the application has to unregister online.

As a basic integration use the EasyGo workflow including the license transfer option.

License File

The license file is either on the local computer or on the network. The module type must be a Yes/No module so that the users are not counted within the license file. The module count is done through the Activation Server 6.

At the start of the application

The command PrepareAndCheck will do all necessary steps. There is nothing special to consider.

If you want to start the application without displaying any screens, use the following code sequence

•Open the license file with Prepare. If return code is not 0 use PrepareAndCheck to display the error

•Find out if the product is activated (GetWebActivation = 2). If the product is not activated (e.g. trial mode) use PrepareAndCheck

•Retrieve main module ID with MainModuleID

•Retrieve Serial Number / ID with GetSerial. If the Serial Number / ID is empty then the product is not activated yet and can only be used on this PC. Do not continue with the online check

•Activate the license transfer option using SetRegisterLicTransfer. Set option TransferLicence to true, to transfer the complete file. This command must be used before WebRegisterExt.

•Register the license online using WebRegisterExt and the main module ID and Serial Number as parameters

Error handling

•Check the error code after PrepareAndCheck or WebRegisterExt

•If the error is 3001 then no Internet / Server connection is available. You could allow a program start although the license count is wrong. Otherwise the user will not be able to use the program in case of an Internet / Server problem

•For all other errors terminate the application

At the end of the application

When the application terminates, the license has to be unregistered online. The local license is then locked.

•Retrieve main module ID with MainModuleID

•Retrieve Serial Number / ID with GetSerial

•Lock the local license using DeactivateModule. Use the main module ID and your Serial Number / ID as parameter.

You can disable the progress screens using ShowWAStartPage, ShowWAProgressPage and ShowWAResultPage.

Activation Server

•Change how often the Serial Number can be used to the maximum concurrent user license usage

•The field: Effective Key / ID usage is the real time status of the number of users who are working right now with the application

Special Considerations

This workflow will result in a heavy server load of the Activation Server 6, depending how many products you have delivered and how often a user does start the application. If you are using the hosting service ensure that you have the right hosting package to cover the requests.