Barcode Xpress for Node.js v13.3 - Updated
How To Register an Automatically Reported Runtime License (Node-Locked)
User Guide > Licensing > Runtime Licensing > How To Register an Automatically Reported Runtime License (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 Server Licensing Utility (SLU) is a stand-alone application that integrates the Licensing Development Kit (LDK) to perform the registration.

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 Barcode Xpress, one using Barcode Xpress for Node.js and the other using Barcode Xpress for .NET, they would purchase two pools of Runtime licenses, one for the Node.js 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 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 to activate licenses when the customer’s application is installed on their users' systems.

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 function. For example:

JavaScript
Copy Code
bx.setSolutionName("ACMEImaging");

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 function. For example:

JavaScript
Copy Code
bx.setSolutionName("ACMEImaging");
bx.setSolutionKey(0x1C3A023Q, 0xA018F266, 0x37AF0E55, 0x557F2388);

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