Echelon i.LON SmartServer 2.0 - Manual (Page 160)

146 Creating FPM Application Licenses
Licensing Overview
You can create FPM application licenses and let customers order and implement your FPMs on their
SmartServers. To create an FPM application license and make your FPM application available for
order, you do the following:
1. Create an FPM licensing tool.
2. Enable license validation in your FPM application.
3. Build the release version of your licensed FPM application.
4. Create FPM application licenses.
5. Supply your customers the FPM licenses, FPM applications, your FPM library, and your resource
files.
Creating an FPM Licensing Tool
The i.LON SmartServer 2.0 Programming Tools includes an i.LON License Generator program that
you can use to construct your own FPM licensing tool. The i.LON License Generator is located in the
LonWorks\iLON\Development\Licensing\iLONLicenseGen folder, and it includes the following three
components:
• The main executable (iLONLicenseGen.exe) that provides a user interface for entering the values
used to generate an FPM license.
• A sample license generator configuration file (an XML file named
iLONLicenseGenValuesSample.xml) that demonstrates the structure of the i.LON License
Generator user interface and provides sample pre-defined values.
• A sample security DLL file (LicenseSecurityHMACMD5.dll) that takes the values entered in the
i.LON License Generator user interface and creates an FPM license.
To construct your FPM licensing tool, you create a license values file that defines the default values for
the user interface of the i.LON License Generator, and you create a security DLL file named
LicenseSecurity.dll that takes the values entered in the i.LON License Generator user interface and
creates an FPM license. If you do not have the resources to build the security DLL file, you can re-
name the sample DLL file to LicenseSecurity.dll. This file provides a standard HMAC-MD5 digest
security algorithm.
Once you create the license manager file (iLONLicenseGenValues.xml) and the security DLL file
(LicenseSecurity.dll), and you have built a release version of your licensed FPM application, you can
open the i.LON License Generator and begin using it to create FPM licenses.
Creating a License Generator Configuration File
The i.LON License Generator requires an XML configuration file named
iLONLicenseGenValues.xml that defines the default values for the properties in the user interface. A
sample configuration file named “iLONLicenseGenValuesSample.xml” is provided in the
LonWorks\iLON\Development\Licensing\iLONLicenseGen folder. The sample file displays the XML
structure of that the i.LON License Generator requires. In addition, the sample configuration file
provides an example of the default values that you can define for your FPMs.
You can create your own default values using the sample configuration file as a guide, or you can copy
and rename the sample file to iLONLicenseGenValues.xml and modify the values to fit your
company and your FPMs.
The configuration file includes a element in which you define a
element. Within the element, you define (1) your company’s properties such as name,
and LonMark ID, and (2) one or more features, the properties for each feature such as name, algorithm,
and secret key, and the pre-defined values for the properties. The following table lists the company
and feature properties you define within the element. An example that