Troubleshooting and FAQs
Question: What is the maximum size of a typical license code?
Version 13 licenses (introduced in Sentinel RMS v8.4.0 release) can contain up to 5200 bytes. However, for license version 19 and above, the maximum license size can be up to 6400 bytes.
NOTE To know the latest maximum license size supported, always verify with the VLS_MAX_LICENSE_SIZE macro in lserv.h.
Question: I am unable to obtain public vendor information for a version 13 license. What might be wrong?
This is possible under the following scenario:
>Licensing library version between 8.1.x to 8.3.x.
>License version 13 (or higher) with vendor information longer than 395 characters.
In such a scenario, the query API (feature and license information) will not return public vendor information.
Question: What are the interfaces and compilers provided for the license generation?
Sentinel RMS provides a license generation interface which is based on the C programming language. From RMS v8.6.0, the license generation libraries are not available in the Sentinel RMS SDK ISO. These are distributed separately through the ordering process in the form of electronic delivery. You can contact Technical Support for more details. For information related to libraries, and compilers, refer to Appendix B.
Question: Where are the generated license codes stored?
By default, WlscGen and lscgen generate licenses at: <user home directory>\Application Data\Thales\Sentinel RMS Development Kit\tools.
By default, WlscGen and lscgen append new license codes to the file newcodes in the local directory. If the output file does not exist, it will be created.
Also, you can use the NEWCODES environment variable to define the name of the license code generator output file. The format is: SET NEWCODES = filename. If this environment variable is not set, the license code generator creates a file named newcodes in its own directory.
Question: Can all the license properties be included in a license code?
You can choose the properties a license can have, however, a few of them are mutually exclusive. For example, a trial licenses cannot be not be defined as commuter, redundant, shared, grace, capacity, or repository. Also, with short-numeric licenses not all licensing options can be used.
Question: Are there any reserved characters and strings that need to be avoided while generating license codes?
For guidelines regarding reserved characters and strings, refer to License Generation API Reference Guide.
Question: Does Sentinel RMS have a mapping of license versions with the corresponding library/SDK version?
The following table shows the mapping of Sentinel RMS license versions with their corresponding library/SDK version.
| Sentinel RMS SDK Version | Major Functionality Introduced | License Version |
|---|---|---|
| 10.2 | Named user licensing added in Connected (Cloud LM) deployment mode | 23 |
| 10.0 | Connected (Cloud LM) deployment mode added | 22 |
| 9.7.0 | Offline usage | 21 |
| 9.5.0 | Support higher value of hard limit and soft limit up to 4,294,967,294. | 20 |
| 9.4.1 | Aggregation in Lease mode | 19 |
| 9.2.x | Enhanced license security | 18 |
| 9.1.x | Updates in the license structure | 17 |
| 9.0.x |
Changes in the License Generation module: >Added new members in the license structure to support SCL - Add on for Sentinel RMS >Support for License Start Time and End Time |
16 |
| 8.6.x | Deprecate PIII Processor ID locking attribute | 15 |
| 8.5.x | Aggregate Licenses | 14 |
| 8.4.x | Increased size of private vendor information, VM detection, and VM specific locking criteria | 13 |
| 8.2.3 | Support for real hard disk serial number-based locking | 12 |
| 8.1.x, 8.2.0, 8.2.1, 8.2.2 | Miscellaneous features including volume transaction licenses | 11 |
| 8.0.x | Grace licenses, repository licenses (earlier named as perpetual licenses), and license revocation | 10 |
| 7.3.0.1 | The maximum number of features allowed in multi-feature licenses was increased to 63 from 11 | 9 |
| 7.3.0 | Capacity licenses | 8 |
| 7.0.0 | Introduction of multi-feature licenses, redundant License Managers, commuter licensing, and usage log encryption levels, The maximum number of License Managers increased from 8 to 11. Also, in this release the Elan licenses were converted to Sentinel LM licenses | 7 |
| Sentinel RMS License Versions Corresponding to Library/SDK Version | |
|---|---|
| License Version | Library/SDK Version |
| 21 | RMS 9.7.0 |
| 20 | RMS 9.5.0, 9.6.0 |
| 19 | RMS 9.4.1 |
| 18 | RMS 9.2.0, 9.2.1, 9.3.0, and 9.4.0 |
| 17 | RMS 9.1.0 |
| 16 | RMS 9.0.0 |
| 15 | RMS 8.6.0, 8.6.1, 8.6.2 |
| 14 | RMS 8.5.0, 8.5.1 |
| 13 | RMS 8.4.0, 8.4.1 |
| 12 | RMS 8.2.3, 8.3.0 |
| 11 | RMS 8.1.x, 8.2.0, 8.2.1, and 8.2.2 |
| 10 | RMS 8.0.0 |
| 9 | RMS 7.3.0.x |
| 8 | RMS 7.3.0 |
| 7 | RMS 7.0, 7.1, and 7.2 |