FormSuite v6.0 - Updated
How to Register an Automatically Reported Runtime (Node-Locked)
Developer Guide > Licensing and Distributing > Runtime Licensing > How to Register an Automatically Reported Runtime (Node-Locked)

Automatically Reported Runtime licenses use a mechanism similar to Toolkit licensing to activate a license for a particular system. In this case, each installation has a unique license that is pulled from the pool of licenses purchased by the customer. When the license key is generated, it contains hardware information that identifies the system on which the license is to be installed. 

The Licensing Development Kit component, which interacts with the licensing web service and installs the newly generated license key, may be used directly by the application or it may be used through a simple tool known as the Server Licensing Utility. 

 

This section provides information about the following:

License Pools

When Automatically Reported Runtime licenses are purchased, they are organized into pools of a specific version and platform for a particular toolkit.  For example, if a customer developed two applications using ImagXpress, one using 32-bit ActiveX and the other using .NET, they would purchase two pools of Runtime licenses, one for the ActiveX platform and one for the .NET platform.

At installation, a new license would be pulled from the appropriate pool, depending upon which platform the application is using.

License Configuration Files

When an Automatically Reported Runtime license is purchased, a License Configuration file is created and distributed to the customer via the Accusoft Customer Portal along with their assigned Solution Name and Solution Key. 

The License Configuration file contains information about the Runtime licenses for a particular platform and version of a toolkit. It is used by the Server Licensing Utility or License Development Kit to activate licenses when the customer’s application is installed on their users' systems.

License Access Key Files

When an Annualized Automatically Reported Runtime license is purchased, an Access Key file must be retrieved from the Accusoft Customer Portal alongside the License Configuration File.

The Access Key file is a csv formatted text file containing all access keys that are associated with the license purchase. Each access key can be registered on one machine by using the SLU or the LDK. Once an access key has been used, the registration date and expiration date will be applied and reflected when retrieving the Access Key file again.

Licensing API

The Licensing API is used in the developer’s code to specify Runtime Licensing deployment information. This is used to unlock the Accusoft products and enable all licensed features at runtime. Both the "Solution Name" and "Solution Key" values used in the API described below are provided by Accusoft, along with the License Configuration file, at the time of purchase of a Runtime License.

Solution Name

The solution name is the name assigned by Accusoft to the licenses purchased for runtime deployment. It is a character string that is set for a component prior to use in a deployment environment and is typically the name of the organization that purchased the Runtime licenses. It is set via the SetSolutionName method of the component’s Licensing class or by using a Forms API Processor object along with a LicenseKeychain object.

The Solution Name must be set in order to use runtime licensing.

Solution Key

The Solution Key is a set of four numbers assigned when the licenses are purchased for runtime deployment; the Solution Key also identifies the organization that purchased the Runtime licenses. The Solution Key is set via the SetSolutionKey method of the component’s Licensing class or by using a Forms API Processor object along with a LicenseKeychain object. 

LicenseKeychain licenseKeychain = new LicenseKeychain();
licenseKeychain.FormFix.SetSolutionName("ACMEImaging");
licenseKeychain.FormFix.SetSolutionKey(0x1C3A023F, 0xA018F260, 0x37AF0E51, 0x557F2389);
Processor processor = new Processor(formset, licenseKeychain);

The Solution Key must be set in order to use runtime licensing.

SLU vs. LDK

Both the SLU and the LDK perform the same function of registering the Runtime license for the system on which it will be run. The SLU is a user interface for the LDK. Both are provided in order to give you some options.

When installing the license, the user you are running as must have Administrator access so that the Registry can be accessed and the license can be added to the system.

  

Is this page helpful?
Yes No
Thanks for your feedback.