INtime SDK Help
License Manager (licman.exe / licman.rta DRTOS)
INtime SDK v7 > INtime Utilities > License Manager (licman.exe / licman.rta DRTOS)

The License Manager utility provides the ability to view and add INtime licenses. This command can be used in a srcript.
This command is also available in INtime Distributed RTOS. Use the INtime License Manager from the INtime Configuration Panel on INtime for Windows for the equivalent capabilities in an interactive applet.

Licenses are installed in the %/INTIMECFG%lservrc file for INtime for Windows and in the /config/lservrc file for INtime Distributed RTOS.

The lservrc file can contain multiple licenses, one per line. Comments are preceded with the "#" character.

Starting in INtime 7, "unified" licenses for USB/CID licenses are supported by simply installing multiple licenses.

Command line

licman -a:[entitlement/SUAC] [-m:"[Activation Comment]"] [-q]
licman -c
licman -d*
licman -f:[output fingerprint file]
licman -i:[license file] [-q]
licman -ii:[license file] [-q]*
licman -l:[output license file]
licman -u:[username] -p:[password] [-m:"[Activation Comment]"] [-t:[licensetype(s|m|e)]] [-q]
licman -purge*
licman -serial*
licman -v
licman -w [-d]*

* Not available on INtime Distributed RTOS

License Activation Options

Activate new license using entitlement or SUAC:
-a:[entitlement/SUAC]
Takes a string argument as the Entitlement Code or SUAC (Single Use Activation Code).
The Entitlment specifies a specific license including the license type.
-m:"[Activation Comment]"
Takes a string argument as a user defined comment. This comment is retained in the license data base on the INtime license portal. Use this option with either the -a option or the -u & -p options. This comment can be used as a reference for the Customer Operations Manager to keep track of used Entitlments.
Activcate new license using username:
-u:[username]
Takes a string argument as the username. This option must be used with the -p option.
-p:[password]
Takes a string argument as the password. This option must be used with the -u option.
-t:[licensetype(s|m|e)]
Specify (s)tandard RT, (m)ultiple MCRT, or (e)VM license. This is only used with the -u & -p options. (The Entitlement includes the license type, so -t is not used with the -a option.) The default is (s), if multiple license types are available on the account.
-m:"[Activation Comment]"
Takes a string argument as a user defined comment. This comment is retained in the license data base on the INtime license portal. Use this option with either the -a option or the -u & -p options. This comment can be used as a reference for the Customer Operations Manager to keep track of used Entitlments.
Install valid license for USB/CID key from the Internet:
-c
Install the license onto the host (adds the license to the lservrc file). Only adds the USB/CID license associated with the USB/CID key present on the host. Requires an Internet connection.
Install valid licenses from file:
-i:[license file]
Install the named license file onto the host (adds the license to the lservrc file). Only adds licenses that are valid on the host.
Install all licenses from file:
-ii:[license file]*
Install the named license file onto the host (adds the license to the lservrc file). Adds all licenses, including licenses that do not currently match the host.

Other Options

-f:[output fingerprint file]
Create a fingerprint file including details of the host. If a USB/CID key is present, the key information is included.
-l:[output license file]
Save the current license file.
-purge*
This will remove all existing INtime licenses on the host after saving a copy.
-serial*
Print USB/CID serial number
-q
Restart the INtime Kernel Manager Service ofter acquiring a license without user action.
-v
Print licman version.
-d*
Print detailed information for each line of the lservrc file. (INtime for Windows: output is in the INtime License Manager.)
-w [-d]*
Print license information (same as License Manager applet).
With the -d option, print detailed information for each line of the lservrc file.

* Not available on INtime Distributed RTOS

Examples

licman -a:15592695-27c2-4529-95e4-2dceec04fb16 -m:"Activation for machine A" -q
Acquire a license using an Entitlement (or SUAC) with an Activation Comment.
licman -u:tenasysco -p:apassword -m:"Activation for machine A" -t:s -q
Acquire a license using an account with an Activation Comment and specifying a license Type.
licman -i:\license.txt -q
Install valid licenses from a license file.
licman -ii:\license.txt -q
Install all licenses from a license file.
licman -f:\fingerprint.txt
Save the Fingerprint to a File.
licman -l:license.txt
Save the License File.
licman -w
Output text listing all valid licenses by product.
licman -w -d
Output text listing the status all licenses in the lservrc file.

Error codes

// non-specific errors
INVALID_REQUEST = 1, // non-specific bad request - no other suitable error
NOT_INTERNAL = 2, // requires IP to be added to our whitelist for some internal actions
UNDER_MAINTENANCE = 3, // maintenance_mode

// license errors
FINGERPRINT_PARSE_ERROR = 100,
USB_NOT_FOUND = 101, // a /getcidlicense call was made but no matching license found for either serial or computer id
INCORRECT_CREDENTIALS = 102,
MULTIPLE_USB_FOUND = 103, // the unauthenticated /getcidlicense endpoint can only return a single license
ENTITLEMENT_EMBARGO = 104, // an attempt was made to activate an entitlement set to embargo
ENTITLEMENT_UNAVAILABLE = 105, // an attempt was made to activate an entitlement set to unavailable
ENTITLEMENT_ACCOUNT_MISMATCH = 106 // an entitlement was attempted to be reset for a different account
ENTITLEMENT_ALREADY_ACTIVATED = 107

Operation

See the license guides available on the TenAsys website policies page

Also the Customer Operations Manager Guide

See Also