License Management Support
Table of Contents
License management installation for Wind River has been automated using the Internet.
For the majority of users with Internet access, license management installation
for system administrators and end-users can be completed as part of the installation
process while running the SETUP program.
To reload an existing license for an existing host or to reconfigure license
management go to &InstallPath&SETUP and run SETUP /L. Look for buttons
that indicate &Check this box to reload your existing license file.&
And check it before proceeding.
It is recommended that the license file you receive from Wind River be named
WRSLicense.lic and that it be placed at the default path &InstallPath&/license.
Note that for the remainder of the document, the location of the license file
can be in a default path (sometimes referreed to as $WIND_BASE/.wind/license,
or $WIND_BASE/license) or a user designated path. For more instructions concerning
manually installing floating and nodelocked licenses please read the section
entitled &Manual License Management Instructions& at the end of this
document. If you wish to combine license files from other vendors, please read
Chapter 3 &Multiple License Files& in the End Users Manual available
from Globetrotter at .
A web-based version of automated license retrieval is available at /ali.
[For Tornado 2.2, go to /corporate/support/alm] Please
be prepared to type in your installation key and/or your Wind River license
number (that comes in your sales agreement form). Once you get your license,
follow the instructions in the section entitled &Manual License Management
Instructions& below.
To contact Wind River License Administrators please use the following regional
phone numbers and email addresses
North America, Japan, Asia Pacific
phone: 510-749-2333
fax: 510-749-2823.
phone: +44
email: license-
This table below lists the FLEXlm error codes that may be returned with a description
of what the error means and instructions to respond to the errors.
Flexlm Error Code
-1 LM_NOCONFFILE
&cannot find license file&
The license file cannot be opened. FLEXlm will attempt to open the standard
&InstallPath&/*.lic,
or the file specified by the user in LM_LICENSE_FILE.
If the file cannot be found in the
default directories, run the
seup program to install the license file.
-2 LM_BADFILE
&invalid license file syntax&
A feature name is &
MAX_FEATURE_LEN,
A daemon name is &
MAX_DAEMON_LEN.
A server name is &
MAX_SERVER_NAME.
A feature specifies no hostid and
the # of licenses is &= 0.
Request a valid license file from
or re-install the
license file using the Setup Program.
Run &InstallPath&/SETUP/SETUP &L
-3 LM_NOSERVER
&cannot connect to a license server&
The daemon name specified in the license file FEATURE line does not match the
vendor daemon name.
Request a valid license file from
or re-install the
license file using the Setup Program.
-4 LM_MAXUSERS &licensed number of users already reached&
The licenses number of users has been reached.
Order more licenses from
Wind River Systems for the feature.
-5 LM_NOFEATURE &no such feature exists&
The feature could not be found in
the license file.
Request a valid license file from
or re-install the
license file using the Setup program.
-6 LM_NOSERVICE &no TCP &license& service exists&
This happens if a SERVER line does not specify a TCP port number, and the TCP
license service does not exist in
/etc/services.
Modify the license file to add a
Port address and to add a TCP
License service in /etc/services
(Unix only).
-7 LM_NOSOCKET
-8 LM_BADCODE
Internal Error, no user remedial
action possible. Call Wind River Technical
Support for help.
-9 LM_NOTTHISHOST &invalid host&
The hostid specified in the license file does not match the node on which the
software is running.
Ask the system administrator to run
the Setup program to get and install
a valid license file for the server.
-10 LM_LONGGONE &feature has expired&
The feature has expired, i.e.,
today's date is after the expiration
date in the license file
Contact Wind River Sales to purchase
additional seats of the product.
-11 LM_BADDATE &invalid date format in license file&
The start or expiration date in the license file is invalid.
Ask the system administrator to run
the Setup program to get and install
a valid license file.
-12 LM_BADCOMM &invalid returned data from license server&
An attempted connection to vendor daemon did not result in a correct acknowledgment
from the daemon.
The port number returned from
Lmgrd is invalid.
Ask the system administrator to kill
the license server and restart it. Then
try running the application again.
-13 LM_NO_SERVER_
&no SERVER lines in license file&
There is no SERVER line in the
license file. All non-zero license
count features need at least one
SERVER line.
Request a valid license file from
or re-install the
license file using the Setup Program .
-14 LM_BADHOST &cannot find SERVER hostname in network database&
The gethostbyname() system call failed for the SERVER nodename in the license
Make certain that the SERVER
nodename in the license file matches
that on which the license daemon is installed.
-15 LM_CANTCONNECT &cannot connect to license server&
The connect() system call failed, while attempting to connect to the daemon.
The attempt to connect to the vendor daemon on all SERVER nodes was unsuccessful.
Try running the application again.
If the same error message
recurs, ask the system administrator
to check that the server is running.
-16 to -17
Errors that are not user
serviceable.
Contact Wind River technical Support for
-18 LM_NOTSUPPORTED
License server does not support this feature
The license server does not have a
license file that supports this feature.
Errors that are not user
serviceable.
Contact Wind River technical Support for
-20 LM_SERVBUSY &license server busy (no majority)&,
The license server is busy establishing a quorum of server nodes so that licensing
can start.
This error is very rare, and checkout
should be retried if this occurs.
-21 LM_OLDVER &license file does not
support this version&
The version requested is greater
than the highest version supported
in the license file FEATURE line.
Contact Wind River Sales to purchase a
new version of the application.
-22 LM_CHECKINBAD &feature checkin failure detected at license server&
The checkin request did not
receive a good reply from the
vendor daemon (the license might
still be considered in use).
Kill the application and it will be
Reclaimed by the license daemon at
a later time.
-23 LM_BUSYNEWSERV &license server temporarily
busy (new server connecting)&
The vendor daemon is in the
process of establishing a quorum condition. New requests from
clients are deferred during this
The user should retry the application.
-24 LM_USERSQUEUED &users are queued for this feature&
Errors that are not user
serviceable.
Contact Wind River technical Support for
-25 LM_SERVLONGGONE &license server does not support this version of this
The version specified in the
checkout request is greater than
the highest version number the
daemon supports.
Contact Wind River Sales to purchase a
new version of the application.
-26 LM_TOOMANY &request for more licenses than this feature supports&
A checkout request was made for
more licenses than are available.
This request will never succeed.
Contact Wind River Sales to purchase
additional licenses.
-29 LM_CANTFINDETHER &cannot find ethernet device&
The ethernet device could not be located on this system.
Check your hardware for installation of
the correct ethernet device.
-30 LM_NOREADLIC &cannot read license file&
The license file cannot be read (errno = EPERM or EACCES).
Change the permission of the license
file to be readable in your context.
-31 LM_TOOEARLY &feature not yet available&
The feature is not enabled yet
(current date is before the feature
start date).
Wait until the start date arrives or
contact Wind River for a new license file
-32 to -37
Internal errors that are not user
serviceable
Contact Wind River technical Support for
-38 LM_FEATEXCLUDE -39 LM_FEATNOTINCLUDE &User/host on exclude list or
not included for feature&
The user/host/display has been excluded from this feature by an
end-user's daemon option file.
The license administrator at you site
will have to modify the option file to
allow the excluded users to run.
-40 LM_CANTMALLOC &Cannot allocate dynamic memory&
The malloc() call failed to return sufficient memory.
User needs to free memory on the
-41 to -47
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-48 LM_BADPLATFORM &FLEXlm platform not enabled&
The software is running on a
platform which is not supported
by the vendor keys you have purchased.
Contact Wind River Sales to purchase
additional licenses for the platform
-49 LM_DATE_TOOBIG &Date too late for binary
The start date format in FLEXlm licenses are good until the year
This is probably a bad date. Request a
valid license file from .
or re-install the license file using the
Setup Program.
-50 to -51
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-52 LM_NOSERVRESP &Server did not respond to message&
UDP communications failure. UDP communications are not guaranteed. FLEXlm makes
a best effort to recover from lost
and garbled messages, but this indicates a failure.
Retry the application so that it can
attempt to retrieve a license from the
License daemon.
-53 to -58
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-59 LM_BADCHECKSUM &message checksum failure&
Communications error - messages between client and server are
encrypted and checksummed for security and integrity.
The checksum will usually fail because of poor networking communications.
Please check your network or network
connection for faults.
-61 LM_SERVNOREADLIC &Cannot read license file
from server&
This occurs when the license file, via LM_LICENSE_FILE, is
incorrectly defined. This only
occurs in lmutil when LM_LICENSE_FILE is set to port@host or @host.
Check the value your environment
Variable LM_LICENSE_FILE is set to.
Make sure it conforms to specifications
as defined in the user&AEs guide.
-62 to -66
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-71 LM_BAD_TZ &Invalid TZ environment
On some operating systems, the
end-user can significantly change
the date using the TZ environment variable. This error detects this
type of theft.
Self-explanatory.
-72 to -77
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-78 LM_NOADMINAPI &FLEXadmin API functions
not available&
An attempt to get information from another company's vendor daemon was made
via lc_get_attr(LM_A_VD_*, ...).
This function call is only allowed
for the ISV's own vendor daemon.
Self-explanatory.
-82 LM_BADPKG &Invalid PACKAGE line in
license file&
PACKAGE missing or invalid COMPONENTS.
A COMPONENT has number of licenses set, with OPTIONS = SUITE.
A COMPONENT has number of licenses==0
Request a valid license file from , or re-install the
license file using the Setup Program.
-83 LM_SERVOLDVER `Server FLEXlm version older than client's'
Vendor daemon FLEXlm version is older than the client's FLEXlm
version. This is only supported
with a v5.0+ client.
This error should not be possible.
Contact Wind River technical Support for
help if it does.
-84 LM_USER_BASED `Incorrect number of USERS/HOSTS included in options file
When a feature has the
USER_BASED attribute, this
error occurs when there is no
INCLUDE line in the end-user
options file for this feature, or the number of users included exceeds
the number authorized
Modify your option file accordingly.
Please read the End Users Manual
available from Globetrotter at .
-85 to -86
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-87 LM_MAXLIMIT `Checkout exceeds MAX
specified in options file'
End-user option MAX has been specified for this feature.
Modify your option file accordingly.
Please read the End Users Manual
available from Globetrotter at .
-88 LM_BADSYSDATE `System clock has been set back'
The license server has detected
that the system clock on your
host has been set back.
This can be interpreted as a sign of
attempted theft.
-89 LM_PLATNOTLIC `This platform not authorized by license'
Returned from checkout call
where FEATURE line specifies PLATFORMS='...'
Installation has occurred on the wrong
platform. Uninstall and install on a
valid host.
-90 to -91
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-92 LM_SERVER_REMOVED Feature removed during lmreread,or wrong SERVER line hostid
Checkout failure due to 2 possible causes.
the feature is removed during lmreread, but the client is reading an old copy
of the license file which still has removed feature.
The hostid on the SERVER line is for a different host, so all features in this
license file were removed.
Re-install the license file, it may
have been corrupted. Run
&InstallPath&/SETUP/SETUP -L
-93 to &94
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-95 LM_NOT_THIS_HOST `Network connect to
THIS_HOST failed'
Returned by checkout. When `this_host' is used as a hostname.
Replace this_host with a real hostname to resolve this error.
-96 LM_HOSTDOWN `Server node is down or not responding'
R indicates
the whole license-server system
is not up, not just the lmgrd
Check to ensure that the license daemon and the vendor daemon is up and running
on the server host.
-97 LM_VENDOR_DOWN `The desired vendor daemon is down'
R indicates
lmgrd is running, but not the
vendor daemon.
Check to see that the vendor daemon,
wrsd (or wrsd.exe) is installed in
&Inst/host.&HOST_TYPE&/
bin. If not, re-install the license utilities using the Setup program. You can
type SETUP /F or -F as a short cut.
-98 to -99
Internal errors that are not user
Serviceable.
Contact Wind River technical Support for
-100 LM_REMOVE_LINGER `Cannot remove a lingering
Returned to lmremove command.
User has already exited, but
license is lingering. lmremove
doesn't remove the linger time.
The license daemon should reclaim
this license after the default time-out
value has elasped.
-101 LM_RESVFOROTHERS `All licenses are reserved for
Checkout return value when a checkout will never succeed, since the end-user
options file has all licenses reserved for others.
Modify your option file accordingly.
Please read the End Users Manual
available from Globetrotter at .
In the course of running the Automated License Installation (ALI) the database
application may output error codes in dialog boxes that pop up. These error
codes are explained below.
Error Message Display
The error message appears in a text format followed the error code.
Sample Error code: -
The first 4 digits are for use by IT for technical support. The last 4 digits
are for use by Key Administration for trouble shooting.
The first digit of the first 4 digits indicates the following error category:
10xx - ALI utility
11xx - ALI message
12xx - ALI tests
13xx - ALI sync
2nxx - Database/application
The other numbers (nn) indicate the software procedure and what paragraph generated
the error code.
Position A indicates the category that the error falls into:
00 - default error category
10 - system category
20 - connection category
30 - license header category
40 - hostId category
50 - feature record category
60 - license product category
70 - retry category
71 - sync category
72 - hot sync category
80 - message parameter category
81 - data return category
Position B indicates the specific type of error for a transaction category:
01 - default license error
02 - default failed return
10 - Oracle exception
11 - default nonqualify
16 - missing dates
17 - out of date range
20 - default invalid data, or a customer license is a Tools category with OS
products as well.
21 - null data found in field
22 - invalid license type, only development, eval, subscription, WindLink partner
types qualifies for ALI
23 - invalid feature version
25 - data out of sync
30 - default inactive license
31 - license has inactive status
40 - default duplicate error
41 - mulitiple rows found identical
45 - host mismatch name
47 - host mismatch name hostId
48 - host port has changed
50 - negative seats added
51 - nodelocked license already taken by this host
52 - number of floating seats requested exceeds allocation
53 - number of nodelocked seats exceeded
For users behind a firewall without access to the internet, manual instructions
for license management installation follows:
1. System administrators
The following is for system administrators or personnel who are setting up
to run floating license management or node-locked license management.
Insert the product CD into your machine's CD ROM drive.
Run the Setup program at the root of the CD image.
Please step through the Setup program, until you reach the &Installation
page. Please select of the &Floating License Server Installation&
option and click
In the &License Management Utilities Installation& page, type or
select the directory
path where you want the license daemon and other utilites to be installed. Click
&Next.& This will install all the license daemons and license management
utilites for
The &License Management Installation Options& page allows you to
choose the
method by which to contact Wind River to configure and get a license file for
your server. Since you are behind a firewall, the only options available to
&email& or &&phone or fax.& Please select one or the
Next you'll see a &Configuration& page that allows you to enter the
number of licenses
you want this server host to control and dispense. Please enter the number of
that you desire for each product, and click next.
The next page summarizes the information that will be sent or must be told
to our license administrators. If you are using email, and have connection to
the outside, just click &Next.&
If you are using a telephone of a fax machine, cut and paste the information
it to a file for your own record. Then call or fax the information to our license
administrators.
You'll need to call our license administrators at (510) 749-2333,
or send email to , or send a fax to
(510) 749-2823.
In summary, the information you'll need to supply is:
a) hostID of the machine to be the license server
b) hostName - the name of the license server host
c) your Customer License number that is on your sales receipt
or if you don't have that, supply the installation key for the CD
d) number of licenses to be served for each licensed Wind River product
E.g. We want 3 licenses for tornado, 3 for Windview.
e) Your contact information (name, address, phone, email).
Our license administrators will then validate your request, and supply you
with a license file that you must install on your server. We recommend that
the license file be installed in the default directory. For some products that
default path is &InstallationPath&/.wind/license, and for others
it is &InstallationPath&/license please read your installation guide.
directory path doesn't exists, please create it and install the file as WRSLicense.lic.
For Floating license management:
Next you'll need to run the license daemon:
On Unix: in the &InstallPath&/host/sun4-solaris2/bin directory, execute
lmgrd daemon
% lmgrd -c &InstallPath&/WRSLicense.lic -x lmdown -l &PathToLogFile&
Note: check the path where your WRSLicense.lic license file is located and
substitute it in
place of &InstallPath&
On Windows: (You may need to reboot to see the flexlm control) In the control
double click &Flexlm license manager& icon to start it. Then click
on the &Setup& tab.
There you'll be able to enter the path to the license file which typically would
&&InstallPath&\WRSLicense.lic.&
Click on the &Control& tab and start the LIcense Server daemon.
For node-locked license management:
There is no need to start a license server daemon. Set the environment variable
LM_LICENSE_FILE to point to the path of the license file (please replace with
the location
of your license file):
setenv LM_LICENSE_FILE &InstallPath&/WRSLicense.lic
LM_LICENSE_FILE=&InstallPath&/WRSLicense.lic
export LM_LICENSE_FILE
Please substitute the path to your license file for &InstallPath&
On Windows:
Bring up the control panel. Then click on the &system& icon.
Next click on the &Environment& tab.
Under &System Variables& define a new variable LM_LICENSE_FILE with
the value &InstallPath&/WRSLicense.lic.
2. End users
These instructions are for end users who have already installed the products
tools from the installation media and need to configure their environment for
license management manually.
If you desire to configure license manually, an environment
variable LM_LICENSE_FILE needs to be set to the name of the
license server host. Please ask your system administrator for the server
name and set the environment variable to it. The format of
LM_LICENSE_FILE value is:
port@server
where &port& is the port which is set by your system administrator.
Port number can be left blank if using the default port (which is 27000).
&server& is the name of the license server host.
If you are installing a Tornado product on a laptop with multiple NIC cards,
and if you are installing a node-locked license, (the most common case), you
should use the disk serial number rather than a MAC address (the default) as
your host ID.
Each NIC card has its own MAC address, and if you register your installation
with one of them (let's say the docking station), you will not be able to run
licensed Tornado products when the laptop is used stand-alone. The docking station's
NIC card is the master when the laptop is docked, and the laptop's NIC card
is the master when it is used stand-alone. The license management software can
only use one or the other as host ID, not both.
Tornado 2.2
To use your disk serial number as the host ID, check the box in the Database
Query Permission dialog box during your Tornado installation. This option is
only offered for node-locked license installation. It is not an issue for floating
license installation or for license server installation.
Tornado 3.x
Contact Wind River License Administration to have your node-locked license
reset, using the disk serial number as the host ID.
To obtain the disk serial number:
Open a command prompt window and type &dir c:\& at the prompt.
On the 2nd line of the response you'll see a line similar to:
Volume in drive C is WINNT Serial number is 1130:16DD
Your host ID is the serial number with the &:& or &-& removed
and prepended with &DISK_SERIAL_NUMBER=&. , e.g. DISK_SERIAL_NUMBER=113016DD}