Licensing requires little or no maintenance or monitoring, but you may need to
- Know the status of your licenses or license daemons
- Look at the log files
- Determine the license usage
- Control or restrict the access to licenses in some way
- Change the license file
- Start the license daemons
- Stop the license daemons
This reference assumes that the cdsmgr account you created during installation is the account you use to monitor and maintain Cadence licensing.
Because Flexera provides the LM_LICENSE_FILE variable to specify the path to the license file, set LM_LICENSE_FILE before you run the licensing utilities so that you do not have to type the path to the license file for each utility.
For example, to determine the status of the license daemons, you usually specify the license file name and type
lmstat -a -c /usr/cds/share/license/license.abcd1234
If you will be using many licensing utilities during a session, set this variable in the shell where you will run the utilities.
setenv LM_LICENSE_FILE /usr/cds/share/license/license.abcd1234
then to retrieve the status, you only need to type
lmstat -a
License and Daemon Status
Use lmstat to display the status of the license servers, Cadence daemons, features, and users of each feature.
lmstat - Copyright (c) 1989-2014 Flexera Software LLC. All Rights Reserved.
Flexible License Manager status on Fri 7/10/2015 11:57
License server status: 5280@lnxmfg
License file(s) on lnxmfg: /lan/license_10604B5C4201.dat.
lnx-mfgop1.cadence.com: license server UP (MASTER) v11.13.0
Vendor daemon status (on lnxmfg):
11:57:16 (cdslmd) TCP_NODELAY NOT enabled
cdslmd: UP v11.13.0
You can also use the port @ host format to display the status of the license servers, Cadence daemons, features, and users of each feature. If 5280 is the port number you are using and the license server is running on sunny, type
lmstat -c 5280@sunny
License Usage
The debug,report, and diagnostic log files collect different usage information.
Debug Log File
The license daemons record all license activity (licenses checked in and out, licenses denied, queues, and network problems) in a /usr/tmp/license.log debug log file (default).
Preferences
You can specify several debug log file preferences:
- Create a log file you can rename while the daemons are running (the default method of starting the daemons)
When you configure licensing, the utility creates an rc.lic file (from the rclic.sample file) that starts the licensing daemons with this line:
lmgrd | sh -c 'while read line; do echo "$line" >> log_file ; done'
When the daemons start with this method, you can rename the output log file without stopping the daemons. A new debug log file replaces it.
- Create a log file that the computer does not delete as it reboots
The default method of starting the daemons creates the log file in /usr/tmp (/usr/ tmp/license.log) instead of /tmp because the computer deletes the files in /tmp when the it reboots. You can modify the /etc/rc.lic file to place the debug log file in another location.
If the license-server boot script starts the license daemons the default way, /etc/ rc.lic renames the license.log file with a . month .day.time extension, such as license.log.Nov.24.09:20:23, and creates a new license.log file. - Limit the messages recorded in the log file by editing the options file.
Because the licensing daemons and other processes share the same log file, the log file can grow very large, especially when stable licensing daemons serve many licenses. You can periodically remove old license.log files to save disk space. Do not remove an old log file until you have generated any desired licensing reports from it. Portions of a debug log file follow:11:33:09 (lmgrd) -----------------------------------------------
11:33:09 (lmgrd) Please Note:
11:33:09 (lmgrd)
11:33:09 (lmgrd) This log is intended for debug purposes only.
11:33:09 (lmgrd) In order to capture accurate license
11:33:09 (lmgrd) usage data into an organized repository,
11:33:09 (lmgrd) please enable report logging. Use Flexera Software LLC's
11:33:09 (lmgrd) software license administration solution,
11:33:09 (lmgrd) FlexNet Manager, to readily gain visibility
11:33:09 (lmgrd) into license usage data and to create
11:33:09 (lmgrd) insightful reports on critical information like
11:33:09 (lmgrd) license availability and usage. FlexNet Manager
11:33:09 (lmgrd) can be fully automated to run these reports on
11:33:09 (lmgrd) schedule and can be used to track license
11:33:09 (lmgrd) servers and usage across a heterogeneous
11:33:09 (lmgrd) network of servers including Windows NT, Linux
11:33:09 (lmgrd) and UNIX. Contact Flexera Software LLC at
11:33:09 (lmgrd)
www.flexerasoftware.com for more details on how to
11:33:09 (lmgrd) obtain an evaluation copy of FlexNet Manager
11:33:09 (lmgrd) for your enterprise.
11:33:09 (lmgrd)
11:33:09 (lmgrd) -----------------------------------------------
11:33:09 (lmgrd)
11:33:09 (lmgrd)
11:33:09 (lmgrd) Server's System Date and Time: Fri Jul 10 2015 11:33:09 PDT
11:33:09 (lmgrd) SLOG: Summary LOG statistics is enabled.
licint@lnxmfg 11:33:09 (lmgrd) FlexNet Licensing (v11.13.0.3 build 165046 i86_lsb) started on lnxmfg (linux) (7/10/2015)
11:33:09 (lmgrd) Copyright (c) 1988-2014 Flexera Software LLC. All Rights Reserved.
11:33:09 (lmgrd) World Wide Web:
http://www.flexerasoftware.com
11:33:09 (lmgrd) License file(s): license_10604B5C4201.txt
11:33:09 (lmgrd) lmgrd tcp-port 5280
11:33:09 (lmgrd) (@lmgrd-SLOG@) ===============================================
11:33:09 (lmgrd) (@lmgrd-SLOG@) === LMGRD ===
11:33:09 (lmgrd) (@lmgrd-SLOG@) Start-Date: Fri Jul 10 2015 11:33:09 PDT
11:33:09 (lmgrd) (@lmgrd-SLOG@) PID: 23419
11:33:09 (lmgrd) (@lmgrd-SLOG@) LMGRD Version: v11.13.0.3 build 165046 i86_lsb ( build 165046 (ipv6))
11:33:09 (lmgrd) (@lmgrd-SLOG@)
11:33:09 (lmgrd) (@lmgrd-SLOG@) === Network Info ===
11:33:09 (lmgrd) (@lmgrd-SLOG@) Listening port: 5280
11:33:09 (lmgrd) (@lmgrd-SLOG@)
11:33:09 (lmgrd) (@lmgrd-SLOG@) === Startup Info ===
11:33:09 (lmgrd) (@lmgrd-SLOG@) Server Configuration: Single Server
11:33:09 (lmgrd) (@lmgrd-SLOG@) Command-line options used at LS startup: -c license_10604B5C4201.txt
11:33:09 (lmgrd) (@lmgrd-SLOG@) License file(s) used: license_10604B5C4201.txt
11:33:09 (lmgrd) (@lmgrd-SLOG@) ===============================================
11:33:09 (lmgrd) Starting vendor daemons ...
11:33:09 (lmgrd) Started cdslmd (internet tcp_port 52267 pid 23424)
11:33:09 (cdslmd) FlexNet Licensing version v11.13.0.3 build 165046 i86_lsb
CADENCE_INFO_MSG: Cadence kit version: 12.05-p001
The debug log file does not always give you the type of report you want for several reasons:
- Because the debug log file does not record information about uncounted licenses, you cannot generate reports about site license usage.
The license file lists the quantity of site or uncounted licenses as zero.
- If you prevent certain messages from being recorded with the NOLOG option, you cannot include that information in reports.
- The information you really want goes to the report log file.
For an enhanced report generator, contact Flexera.
Report Log File
You can generate additional usage information from the non-ASCII report log file by using FlexNet Manager.