LicenseManager(1M)LicenseManager(1M)NAMELicenseManager - view and manage FLEXlm and NetLS software licenses
SYNOPSIS
/usr/etc/LicenseManager [ -vendor { sgi | aw } ]
/usr/etc/LicenseManager [ -vendor { sgi | aw } ] names ...
/usr/etc/LicenseManager -install { flexlm_nodelock |
flexlm_floating |
flexlm_increment |
flexlm_nodelock_package |
flexlm_floating_package |
flexlm_increment_package |
netls }
/usr/etc/LicenseManager -V
DESCRIPTION
When executed without file arguments, License Manager displays the Main
Window, which provides a complete graphical interface for viewing,
installing, upgrading, and removing FLEXlm and NetLS software licenses.
The optional argument -vendor is used to specify the vendor mode, which
customizes the License Manager interface for a specific vendor. The
vendor mode determines the default values of license entry fields, the
location of the license files, and the location of licensing server
startup scripts. The values that can follow -vendor are sgi and aw. sgi
specifies the vendor mode for licenses from Silicon Graphics and from
other vendors. aw specifies the vendor mode for licenses from Alias |
Wavefront. The default value when vendor mode is not specified is sgi.
When License Manager is run with file arguments names ..., License
Manager runs in automatic license installation mode. Each name specified
in names ... is the pathname of a License Installation File. The format
of these files are documented below. When running in this mode, licenses
in these files are automatically installed on the system, and a popup
dialog displaying the installation status of all licenses in these files
are displayed. NOTE: This mode is used to support the automatic
installation of software licenses over the World Wide Web or via E-mail
attachment.
When License Manager is run with the -install argument, the License
Manager graphical interface is invoked with the license installation
dialog already displayed. The type of dialog displayed is determined by
the type of license being installed, which is specified by the second
argument: flexlm_nodelock, flexlm_floating, flexlm_increment,
flexlm_nodelock_package, flexlm_floating_package,
flexlm_increment_package, or netls. NOTE: This mode is used to support
the license installation tasks found in the System Manager and is not
intended to be used directly by the user.
Page 1
LicenseManager(1M)LicenseManager(1M)
When run with the -V option, License Manager just prints out its version
string.
LICENSE LIST
The License Manager Main Window displays a list of installed licenses.
FLEXlm licenses that are installed using this tool or manually entered
into a license file using a text editor are always displayed in this
list. NetLS licenses that are installed using this tool or manually
entered into a license file using a text editor in a format understood by
this tool will also be recognized and displayed in this list. Licenses
that are manually entered into a NetLS license file in a format not
understood by this tool are retained in the file, but cannot be viewed or
managed using License Manager.
LICENSE SERVER MANAGEMENT
When exiting License Manager, if any FLEXlm floating licenses were
installed during the session, License Manager will prompt the user to
determine if it should update the license server lmgrd(1) to use the new
licenses. If the user clicks OK, License Manager will start the
licensing server if it is not running, or ask the license server to
reread its license file using lmreread(1).
CHECKING LICENSE STATUS
This tool is able to decode licenses issued by Silicon Graphics to check
for entry errors, but it is not able to check licenses issued by other
vendors.
MAIN WINDOW
The Main Window displays the list of products and licenses installed in
the license files that are recognized by this tool. For each license,
the list displays the Product Name, Expiration Date, and License Type.
Operations:
Install...
Display the Install License Dialog Window, which is used to install
a license for a new product or a new version of a product.
Update...
Display the Update License Dialog Window, which is used to enter a
license password for a product that already appears in the Main
Window. The user can use this operation to convert a temporary
license into a permanent one.
Remove...
Remove the license selected in the Main Window.
Page 2
LicenseManager(1M)LicenseManager(1M)
Get Info...
Display the Get Info Dialog Window, which shows information about
the license selected in the Main Window.
Options ...
Displays the Options Dialog Window, which allows the user to switch
between the Silicon Graphics and Alias | Wavefront vendor mode.
Close
Close the Main Window and exit License Manager.
Help Display help information for License Manager.
UPDATE LICENSE DIALOG WINDOW
The Update License Dialog Window is used to enter a new license password
for a product that already appears in the Main Window. It can be used to
update a temporary license into a permanent license.
If a NetLS license is selected, this window displays the License Password
and Expiration Date fields.
If a FLEXlm license is selected, this window displays the the Password,
Miscellaneous, Expiration, and Host ID fields.
Operations:
Apply
Update the license with the new license password.
Cancel
Close the Update License Dialog Window.
GET INFO DIALOG WINDOW
The Get Info Dialog Window shows information about the selected license.
The fields displayed depend on the type of license that was selected in
the Main Window. The status of the license is always displayed at the
bottom.
Operations:
Close
Close the Get Info Dialog Window.
INSTALL LICENSE DIALOG WINDOW
The Install License Dialog Window is used to add a license for a new
product or version that does not already appear in the Main Window
license list.
Page 3
LicenseManager(1M)LicenseManager(1M)
The user chooses the type of license to install and clicks OK to display
the License Entry Dialog Window. Click Cancel to close the dialog
without installing a license.
LICENSE ENTRY DIALOG
The License Entry Dialog displays the license fields for the type of
license being installed. These fields are documented below. Enter the
appropriate license information and click OK to install the license.
At the bottom of the dialog, the default installation location for the
license is displayed.
Operations:
Browse ...
Displays a dialog used for overriding the default license
installation location
OK Install the license entered.
Cancel
Close the Install License Dialog Window.
Entry Fields:
The following entry fields will appear in some or all of the License
Entry Dialogs. See the FLEXlm End User Manual for more information about
FLEXlm fields.
Annotation
This is the optional annotation for a NetLS nodelock license.
Daemon
This is the name of the vendor daemon for a FLEXlm Floating license.
Daemon Path
This is the pathname of the vendor daemon for a FLEXlm Floating
license.
Expiration
The license expiration date.
Feature
The feature name for a FLEXlm license.
Increment
This is the feature name for an INCREMENT license.
Page 4
LicenseManager(1M)LicenseManager(1M)
License Version
The license version.
Miscellaneous
This field is used to enter other FLEXlm optional license arguments.
Values entered in this field will take the form attribute=value
separated by spaces. For example, dist_info=noreplace
user_info=demo.
Package Key
This is the Package license key, which enables a package specified
by Feature.
Package List
This is the list of products for the package specified by Feature.
Package Options
This specifies the options for the package specified by Feature.
Password
The license password.
Port Number
This is the port number used by lmgrd(1M). It is specified the
FLEXlm license SERVER line.
Product Name
The long product name for a license. For FLEXlm licenses, this value
is stored in the optional field vendor_info.
Server Host
The name of the license server host.
Server Host ID
The host ID for the license server host. For licenses from SGI and
other vendors, this value is generated by using the command sysinfo
-s. For licenses from Alias | Wavefront, this value is generated by
using the command lmhostid.
Vendor Name
The name of the license issuer.
Vendor ID
This is the Vendor ID for a NetLS nodelock license.
Vendor String
The vendor string for a FLEXlm license.
Page 5
LicenseManager(1M)LicenseManager(1M)FILES
/var/netls/nodelock
This file contains the NetLS nodelock licenses. Properly formatted
licenses in this file can be read in and displayed by License
Manager. Licenses installed using License Manager will always be
written to the file in this format. Licenses that are not formatted
for License Manager are retained in the file, but cannot be viewed
using this tool.
A properly formatted license will have the following form:
#:# "VendorName" "ProductName" "Version" "Expiration" [ProductID]
VendorID [ Password [ "Annotation" ]]
/etc/nodelock
This file also contains NetLS nodelock licenses and is the location
used by some NetLS licensed applications which must get their
licenses from the root partition.
/var/flexlm/license.dat
This file is the standard installation location for FLEXlm nodelock
licenses used by SGI applications. License Manager is able to read
in all FLEXlm licenses contained in this file.
/var/flexlm/aw.dat
This file is the standard installation location for FLEXlm nodelock
licenses used by Alias | Wavefront applications. Licenses are
installed in this file when the vendor mode is specified as aw.
/var/flexlm/license_HostName.dat
On the license server HostName, this file is the standard
installation location for FLEXlm floating licenses for that host.
Users on client systems who want to use licenses on this server
should copy this file to their systems using the same pathname if
they do not intend to use LM_LICENSE_FILE to specify the
port@hostname of the license server. See the FLEXlm End User Manual
for more information about using port@hostname.
/var/flexlm/aw_HostName.dat
On the license server HostName, this file is the standard
installation location for FLEXlm floating licenses for Alias |
Wavefront applications. Licenses are installed in this file when
Page 6
LicenseManager(1M)LicenseManager(1M)
the vendor mode is specified as aw. Users on client systems who
want to use licenses on this server should copy this file to their
systems using the same pathname if they do not intend to use
LM_LICENSE_FILE to specify the port@hostname of the license server.
/var/flexlm/licensefile.db
This file specifies the License File Database, which determines the
list of FLEXlm license files searched by a licensed Silicon Graphics
application. License Manager uses this database file to determine
the list of license files to read when displaying the installed
licenses.
The format of a license file database is one file or directory per
line. Comments are indicated by a pound sign '#' in the first
column of the line. Blank lines are ignored. Trailing and/or
leading whitespace is not allowed on a line.
Any directory listed in the file is searched for filenames matching
"*.dat". Any subdirectory is also searched (recursively).
License Manager also uses this file to determine which files can be
updated when installing a software license. If the installation
location is not specified in this file, the user is prompted, and
the license is installed only if the user decides to install it,
automatically updating this database file with the new license file
location.
/etc/config/lmgrd.options
This file specifies the options to use when /etc/init.d/FLEXlm is
used to start the FLEXlm License Daemon lmgrd(1). Normally, this
file is used to specify the location of the file which contains the
floating licenses for this license server.
If this file contains the default value -c /var/flexlm/license.dat,
License Manager will update this file to point to the correct
location whenever a floating license is installed.
License Installation Files
License Installation Files are used to support the installation of
software licenses using the World Wide Web or E-mail attachment.
When License Manager is run with one of these files as an argument,
the licenses contained in this file are installed into the
appropriate license files.
Each license installation file contains one or more license
installation blocks, and each block can install either NetLS or
Page 7
LicenseManager(1M)LicenseManager(1M)
FLEXlm licenses.
NetLS License Installation Block
A NetLS license installation block will consist of a header and one
or more NetLS licenses. Note that the location of each line in the
block determines the semantics of the data.
The header has the following format:
### NetLS Nodelocked License File NLSNLF 1.0
System_ID
Host_Name
If the license can be installed on any host, the System ID should be
0 and the Host_Name should be Any. These two fields are used by
License Manager to check if the license block should be installed on
a host. If not, the license block is written to a License Block
Save File located at /var/flexlm/save/license_install.Host_Name
where Host_Name is the name of the host to which this license block
should be installed.
Each license will consists of the following lines:
LICENSE
Vendor_Name
Vendor_Password
Vendor_ID
Product_Name
Product_ID
Product_Version
Product_Password
Annotation
If there is no license annotation, then a blank line should be used
as the annotation.
FLEXlm License Installation Block
A FLEXlm license installation block consist of a header and one or
more FLEXlm nodelock or floating licenses. The license lines in
this block have the same format as any FLEXlm license file.
The format of the block header file consists of the mandatory header
line and optional installation directive lines for specifying the
license installation location, the installation host, and the
installation control argument.
The Filename directive is used to specify the installation location
Page 8
LicenseManager(1M)LicenseManager(1M)
of licenses in the block. If this directive is omitted, the
licenses are installed at the default locations for FLEXlm licenses.
See the section on FILES above.
The Host directive is used to specify the name of the installation
host. License blocks that can be installed on any host can omit
this line or specify the hostname Any. If a license block cannot be
installed because the host name does not match, the block is written
to a License Block Save File located at
/var/flexlm/save/license_install.Host_Name where Host_Name is the
name of the host to which this license block should be installed.
The Control directive is used to specify the installation control
argument. Currently, one of two options can be specified. The first
is noReplace, which causes the licenses in the block to be installed
without replacing any existing licenses. The second is
strictReplace, which behaves just like the normal license
replacement policy if the feature name and version match exactly --
otherwise it behaves just like the noReplace directive.
### FlexLM License File FLMLF 1.0
### Filename: License_File
### Host: Host_Name
### Control: noReplace
Note that because each license installation block can install to
only one file, and because SGI recommends that FLEXlm nodelock
licenses be kept in files separate from files holding floating
licenses, each license block should contain either nodelock licenses
for one host or concurrent licenses for one host. This limitation
applies only to a license installation block, and not to the license
installation file.
License Block Save Files
These files contain the license installation blocks that could not
be installed by License Manager because the hostname did not match
when License Manager was executed with a License Installation File
argument. These files can be transferred to their appropriate host
and the licenses contained in them can be installed by executing
License Manager on these files.
The files containing these saved license installation blocks are
located at /var/flexlm/save/license_install.Host_Name.
ENVIRONMENT
LM_LICENSE_FILE
If set, specifies the name of one or more FLEXlm license files.
Multiple files can be specified by separating them with a colon (:).
Page 9
LicenseManager(1M)LicenseManager(1M)
The value of this variable overrides the list of files specified by
the License File Database.
LM_LICENSE_DB
If set, specifies the name of the license file database. A license
file database is a file which contains a list of one or more FLEXlm
license files and/or directories containing FLEXlm license files.
If LM_LICENSE_DB is not defined, the default license file database,
/var/flexlm/licensefile.db, is used.
LM_VENDOR_MODE
If set, the value of this variable is treated like the -vendor
argument documented above. The value of this variable is overrident
if -vendor is specified in the command line.
LICENSEMGR_DEBUG
When set, License Manager runs in debug mode, and prints assorted
output to standard out during license installation.
LICENSEMGR_FILE_ROOT
Determines the root, which is prepended to all pathnames of
permanent files that are written by License Manager. If this
variable is not set, all file names are assumed to be relative to
the root file system /.
LICENSEMGR_NO_GUI
Specifies that License Manager run without a graphical user
interface. This mode has an effect when running License Manager in
the automatic license installation mode. All output messages are
printed to stdout and all prompts default to OK.
DEFAULT LICENSE FILE
If no license files have been defined by either the LM_LICENSE_FILE or by
the License File Database, the default FLEXlm license file is
/var/flexlm/license.dat when the vendor mode is unspecified or specified
as sgi, and /var/flexlm/aw.dat when the vendor mode is specified as aw.
This license file will be the only FLEXlm license recognized by License
Manager or by any licensed application from Silicon Graphics or Alias |
Wavefront.
XLV licenses may need to be be placed in /etc/flexlm/license.dat.
Page 10
LicenseManager(1M)LicenseManager(1M)LICENSE REPLACEMENT POLICY
When a new FLEXlm license is installed into a file which already has a
license with the same feature name, a lower or equal version number, and
a lower or equal count, the old license is automatically deleted. If the
new license does not have either a higher version number, a higher count,
and a later expiration date, the new license is not installed. For the
other cases, the user is prompted on whether to replace the older license
with the newer one.
This replacement policy can be overriden by either using one of the
license installation replacement policies: noreplace and strictreplace.
Installing a license noreplace will always add a license without removing
any installed ones. Installing a license strictreplace will be identical
to installing a license under the normal replacement policy if the
feature name and version number of the new license match. Otherwise it
will behave just like the noreplace policy.
The replacement policy is controlled using the license installation file
Control directive as documented above, or by using the Miscellaneous
field in the License Entry Dialogs. Licenses with the optional argument
dist_info=noreplace will be installed using noreplace replacement policy.
Licenses with the optional argument strictreplace will be installed using
strictreplace replacement policy.
SEE ALSOls_admin(1M), license.dat(5), lmcksum(1), lmdown(1), lmhostid(1),
lmremove(1), lmreread(1), lmstat(1), lmutil(1), lmver(1), lmgrd(1),
sysinfo(1), FLEXlm End User Manual.
Page 11
