lscgen - Global Defaults File
Licenses may often require common information, such as feature names, license lifetimes, and sharing criteria. The license generator (lscgen) first looks for the option specified in the command line. If that is not found, it looks for a file specified by the environment variable, CODEOPTS. Set the variable to a file name:
SET CODEOPTS = filename
If this environment variable is not set, lscgen searches for a file named codeopts in its directory. Two sample files to use with the CODEOPTS environment variable are included in the \Tools directory for generating licenses:cgentmpl.stafile is for standalone licenses and cgentmpl.netis for network licenses. Here are the points to be noted for creating a global defaults file:
>A defaults file should contain one entry per line, each entry corresponding to an interactive input.
>For those inputs not defined in the defaults file, an exclamation point (!) should be used. For such fields, lscgen will prompt for inputs. For example, below in Example 1, lscgen will prompt to input the license expiration year, month, and date. Specifying an option on the command-line overwrites settings in the defaults file.
>Comments can be entered with the pound sign (#) in the first position.
>White space is ignored.
>Blank lines will be interpreted as new line inputs. Every line is significant.
The sequence of inputs specified in the global defaults file (cgentmpl.sta) for standalone license (version 20) is listed below.
1. Code generator version
2. license model (long or short-numeric)
3. Feature name
4. Feature version
5. Capacity or non - capacity (Pooled or non-pooled capacity)
6. Trial or non - trial license (normal license)
7. Standalone license
8. License combination property (additive or aggregate or exclusive license)
9. Private vendor information
10. Public vendor information
11. License vendor information
12. Token lifetime units
13. Token lifetime (in minutes)
14. Number of challenges-responses
15. License start year
16. License start month
17. License start day
18. License start hour in UTC
19. License expiration year
20. License expiration month
21. License expiration date
22. Expiration hour in UTC
23. Hard limit
24. Soft limit
25. Locking mode
26. Number of subnets
27. Time tamper check allowed or not.
28. Virtual machine detection flag
29. Do you want to generate license.
30. Type of license code (encrypted, concise or expanded readable)
31. Generate more licenses.
The sequence of inputs specified in the global defaults file (cgentmpl.net) for network license (version 20) is listed below.
1. Code generator version
2. license model (long or short-numeric)
3. Feature name
4. Feature version
5. Capacity or non-capacity (Pooled or non-pooled capacity)
6. Trial or non-trial license (normal license)
7. Network license
8. Log file encryption level
9. License combination property (additive or aggregate or exclusive license)
10. Private vendor information
11. Public vendor information
12. License vendor information
13. Type of shared license
14. Token lifetime units
15. Token lifetime (in minutes)
16. Type of held license
17. Number of challenges-responses
18. License start year
19. License start month
20. License start day
21. License start hour in UTC
22. License expiration year
23. License expiration month
24. License expiration date
25. Expiration hour in UTC
26. Commuter license
27. Grace period
28. Hard limit
29. Soft limit
30. Locking mode
31. Lock to multiple redundant License Managers
32. Number of subnets
33. Time tamper check allowed or not.
34. Virtual machine detection flag
35. Do you want to generate license.
36. Type of license code (encrypted, concise or expanded readable)
37. Generate more licenses.
NOTE The following examples are relevant for generating version 20 licenses. You can use the same approach for generating licenses for higher versions.
Example 1: A sample global defaults file for a standalone license (version 20).
20 # Code generator version
1 # License model: long code
LSWDEMO # Feature name
1 # Feature version
0 # Non-capacity
N # Non-trial license (normal license)
1 # Standalone license
2 # Aggregate license
PrivateInfo # Private vendor information
PublicInfo # Public vendor information
LicenseInfo # License vendor information
0 # Token lifetime units
2 # Token lifetime (in minutes)
# Number of challenges-responses
2018 # License start year
1 # License start month
1 # License start day
# License start hour in UTC
2019 # License expiration year
12 # License expiration month
31 # License expiration date
# Expiration hour in UTC
2 # Hard limit
2 # Soft limit
2 # Locking mode - Any Host Type
# Number of subnets
N # Time tamper check allowed or not?
Y # Virtual machine detection flag
Y # Do you want to generate license?
0 # Type of license code - Encrypted license code
N # Generate more licenses?
Example 2: A sample global defaults file for a network license (version 20).
20 # Code generator version 1 # License model: long code LSWDEMO # Feature name 1 # Feature version 0 # Non-capacity N # Non-trial license (normal license) 0 # Network license 0 # Log file encryption level 2 # Aggregate license PrivateInfo # Private vendor information PublicInfo # Public vendor information LicenseInfo # License vendor information 0 # No sharing of licenses 0 # Token lifetime units 2 # Token lifetime (in minutes) 0 # Type of held license - Not allowed # Number of challenges-responses 2018 # License start year 1 # License start month 1 # License start day # License start hour in UTC 2019 # License expiration year 12 # License expiration month 31 # License expiration date # Expiration hour in UTC N # Commuter license 0 # Grace period 1 # Hard limit 1 # Soft limit 2 # Locking mode - Any Host Type N # Lock to multiple redundant License Managers # Number of subnets N # Time tamper check allowed or not? Y # Virtual machine detection flag Y # Do you want to generate license? 0 # Type of license code - Encrypted license code N # Generate more licenses?
NOTE For bulk license generation, these methods can be used together. For example, common information can be stored in a defaults file and referenced by lscgen during license code generation.