SGI Techpubs Library

IRIX 6.5  »  Man Pages
find in page

LicenseManager(1M)

 NAME

     LicenseManager - 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.

     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.

     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.

     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.

     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.

 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
          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
          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
          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 (:).

          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.

 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 ALSO

     ls_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.




home/search | what's new | help