Getting Started with Quick License Manager Professional
QLM Professional is composed of 2 components:
(a) a License Server that provides a service for issuing and managing license keys
(b) a client application (QLM Management Console) that communicates with the License Server and acts as a user interface to the License Server.
Adding licensing support to your application is a 3 step process.
QLM Professional allows you to implement online software activation. Software activation is the process of generating a computer bound license key over the internet. In order to implement software activation, you work with 2 types of license keys. The first key is called “Activation Key”. This is the key that you send to your customer when they purchase your software. The activation key can be sent to your customer directly from your eCommerce provider (see other section on how to integrate QLM with your eCommerce provider) or manually. This key does not enable your software. It simply allows the user to activate his license. If a user purchases several copies of your software, you can send them one activation key for all purchased licenses or one activation key per purchased copy.
From your application, the user enters the activation key. Using the QLM API, your application invokes the QLM License Server with the activation key and a unique computer identifier. The QLM License Server then generates the second type of license key called “Computer Bound Key” and sends this key back to your application. The computer bound key enables your application.
Read about the differences between QLM Professional and QLM Enterprise.
The first step in creating license keys for your products is to define each product. Click on the Define Products tab and then click on New.
Enter the Product Name, the Major and Minor version of the product. The Product ID and the GUID fields are automatically generated. You will need these values when you use the API to validate license keys. You may also associate up to 32 features with each of your products.
If you are evaluating QLM, we recommend that you use the Demo 1.0 product during the trial period.
Modify your application to validate a license key
The simplest way to integrate QLM to your application, is to use the QLM License Wizard standalone application.
The QLM .NET Control provides a ready-to-go license activation form. If your application is developed in .NET, check out this tutorial for a step by step instruction on how to integrate using the QLM .NET Control.
If your application is not a .NET application, you can use the QLM License Wizard standalone appication to manage the license activation process. For a tutorial on how to use the QLM License Wizard, click here .
Of course, you can always create your own license registration form and use our extensive API to manage license validation and activation.
Below are step by step instructions to integrate QLM Pro in your application:
1. From the Protect your application tab, follow the instructions in the wizard. QLM will generate the code that you need to add to your application.
2. For .NET applications:
a) add to your application a reference to: QlmLicenseLib.dll
a) add to your application a reference to: QlmControls.dll
3. In your application, as soon as your application is started, call the ValidateLicenseAtStartup function (found in the generated code above).
4. If the ValidateLicenseAtStartup function returns false, it means there is no valid license and you must prompt the user for a license.
5. If you are using the QLM .NET Control, display a form containing the QLM .NET Control to allow the user to register his license.
6. If you are not using the QLM .NET Control, launch the QLM License Wizard application (with the proper command line arguments).
7. Upon successful activation of the license, close the license form and display your application.
For more details about specific APIs, refer to the API reference found in the online help.
Several sample applications are included in the Samples folder developed in VB6, VC6, VB.NET, C#, VC7, and Excel.
Generate license keys
Once you have defined your products, you can generate license keys for each product. There are 2 types of license keys: permanent, and evaluation keys. Evaluation keys can specify the duration of the evaluation, an expiry date or both.
Prior to creating license keys with QLM Professional, you need to setup the QLM License Server and a database that will host the license keys. For instructions on installing the QLM License Server and the database, refer to the help. For evaluation purposes, Soraco provides a demo License Server and a database. The only restriction of our demo web service is that you cannot publish your products to the License Server; you can only work with the default product Demo. Additionally, note that the database content on the demo License Server is regularly reset.
To generate license keys with QLM Professional, click on the Manage Keys tab, then click on the Create button.
Select a Product, the number of keys to generate, the type of keys to generate and then click on the OK button. QLM stores the generated keys in a database.
All QLM Pro samples are located in the folder:
C:\Users\Public\Documents\Quick License Manager\Samples\qlmpro
Samples are grouped by programming language.
Windows\DotNet\C#\QlmProSample – This sample shows how to add online activation to your C# Windows Forms application by using the QLM API.
Windows\DotNet\C#\AspDotNetSample – This sample shows how to add online activation to your C# ASP.NET application by using the QLM API.
Windows\DotNet\C#\QlmApiSample – This sample shows how to implement online activation using plain http requests in your C# application.
Windows\DotNet\VB.NET\QlmApiSample – This sample shows how to implement online activation using plain http requests in your VB.NET application.
Windows\C++\QlmLicenseWizard: Visual Studios 2005 sample shows how to add online activation to your C++ application.
MS Access Sample:
Windows\MSAccess2003: MS Access sample shows how to add online activation to your MS Access 2003 application.
Windows\Excel: Excel sample shows how to add online activation to your Excel application.
Windows\VB6: VB6 sample shows how to add online activation to your VB6 application.
Windows\Delphi: Delphi sample shows how to add online activation to your Delphi application.
Windows\OutlookAddIn: Outlook sample shows how to add online activation to your Outlook add-in.
Windows Phone (7):
Windows\WindowsPhone: Windows Phone sample shows how to add online activation to your Windows Phone application.
Windows 8 Store:
Windows\Win8Store: Windows 8 Store sample shows how to add online activation to your Windows 8 application.