LicenseManager(1M)
LicenseManager - view and manage FLEXlm and NetLS software licenses
As shipped in IRIX 6.5. First release of IRIX 6.5.
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 License Password, Miscellaneous, Expiration Date, 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 causes licenses to be replaced only if the feature name and version match exactly. This allows different version of a feature to be installed in the file at the same time. ### 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. 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 replace a license only if the feature name and version number of the new license is identical to those of the installed license. 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.