lmgrd - License Server Manager
The license server manager is one of the components that make up a license server (the other being the vendor daemon). It handles the initial contact with FLEXenabled applications, passing the connection on to the appropriate vendor daemon. The purposes of the license server manager are to:
Start and maintain all the vendor daemons listed in the VENDOR lines of the license file used to start lmgrd.
Refer application checkout (or other) requests to the correct vendor daemon.
lmgrd is an application-based version of the license server manager. On most platforms it is controlled from a command-line. On Windows there is a GUI tool, LMTOOLS, that can be used to manage lmgrd.
A newer lmgrd can be used with an older vendor daemon or FLEXenabled application, but a newer vendor daemon or FLEXenabled application might not work properly with an older lmgrd. Always use the latest version of lmgrd, which is available from the download site.
lmgrd Command-Line Syntax
When you invoke lmgrd, it looks for a license file that contains information about vendors and features and starts those vendor daemons.
lmgrd [-c license_file_list] [-l [+]debug_log_path]
Starting the License Server Manager on Windows
This section provides procedural information on manual starts from the command line and how to configure the License Server Manager (lmgrd) as a service.
Manual Start from the Command Line
To start lmgrd from the command line:
Start lmgrd as an application from a Windows command shell using the following syntax:
C:\fnp> lmgrd -c license_file_list -L [+]debug_log_path
- license_file_list is one or more of the following:
- the full path to a single license file
- a directory, where all files named *.lic in that directory are used
- debug_log_path is the full path to the debug log file
Prepending debug_log_path with the + character appends logging entries.
Spaces in pathnames require double quotes around the path.
Configuring the License Server Manager as a Windows Service
To configure a license server manager (lmgrd) as a service, you must have Administrator privileges. The service will run under the LocalSystem account. This account is required to run this utility as a service.
Task: To configure a license server as a service:
- Run the lmtools utility.
- Click the Configuration using Services button, and then click the Config Services tab.
- In the Service Name, type the name of the service that you want to define, for example, DEMO License Manager. If you leave this field blank, the service will be named FLEXnet Licensing Service.
- In the Path to the lmgrd.exe file field, enter or browse to lmgrd.exe for this license server.
- In the Path to the license file field, enter or browse to the license file for this license server.
- In the Path to the debug log file, enter or browse to the debug log file that this license server writes. Prepending the debug log file name with the + character appends logging entries. The default location for the debug log file is the c:\winnt\System32 folder. To specify a different location, make sure you specify a fully qualified path.
- To save the new DEMO License Manager service, click Save Service.
Figure 10-1: Completed Config Services Tab
Manually Start the License Server Using the lmtools Utility
A graphical user interface to the license server manager tools is provided called lmtools. Some of the functions lmtools performs include:
- starting, stopping, and configuring license servers.
- getting system information, including hostids.
- getting server status.
In order to control the operation of lmgrd from the lmtools user interface, you first must configure it as a license server manager service. Follow the procedure in Configuring the License Server Manager as a Windows Service (see above) before proceeding.
Once the license server manager service is configured, lmgrd is started by starting the service from the lmtools interface.
Task: To start the service from the lmtools interface:
Figure 10-2: Service/License File Tab
- Start lmtools and display the Service/License File tab.
- Click Configuration using Services button.
- Select the service name from the list presented in the selection box. In this example, the service name is DEMO License Manager.
Figure 10-3: Start/Stop/Reread Tab
- Click the Start/Stop/Reread tab.
- Start DEMO License Manager by clicking the Start Server button. DEMO License Manager license server starts and writes its debug log output to c:\prods\i86_n3\debuglog.
Automatically Start the License Server when System Starts
In order for lmgrd to start up automatically at system start-up time, you first must configure it as a service. Follow the procedure in “Configuring the License Server Manager as a Windows Service” (see above) before proceeding, and then continue with the steps below.
Task: To configure lmgrd as a service:
Figure 10-4: Config Services Tab
- With lmtools started and the desired service name selected, click the Config Services tab.
- Make this license server manager a Windows service by selecting the Use Services check box.
- Configure it to start at system startup time by selecting the Start Server at Power Up check box.
From now on, when the system is rebooted, this license server manager starts automatically as a Windows service.