Utilities

Mentor provides command-line and graphical user interface (GUI) utilities for Linux and Windows systems.

This section provides, in alphabetical order, reference information for Mentor and some FlexNet command-line and GUI licensing utilities. The beginning of each utility description shows the applicable operating system.

On Linux, find the Mentor commands in the .../mgls/bin directory in the application tree or in the mgls_version.vco/bin directory in the licensing tree. For example: /usr1/mgls_v9-13_5-2-0.aol/bin.

On Windows, access the GUI utilities through the Start menu, and find the command-line utilities in the C:\MentorGraphics\Licensing directory.

For detailed information about the FlexNet Licensing utilities, refer to the FlexNet Publisher License Administration Guide published by Flexera Software.

Note:

Mentor Standard Licensing currently does not support the lmadmin command. Use the commands listed in this appendix to manage your license server, and disregard the lmadmin documentation in the FlexNet Publisher License Administration Guide.

Table 1. Utility Summary

Utility

Description

lmdown(FlexNet) Shuts down selected license daemons on all systems in the license file list. This is useful when you need to make changes or updates to the licensing software.
lmgrd(FlexNet) Starts a license server. lmgrd is the main license daemon program for FlexNet Licensing and handles requests from the end user’s applications.
lmhostid(FlexNet) Reports the host identification (host ID) number of a system.
lmreread(FlexNet) Tells the license daemon to reread the license file and start any new vendor daemons that have been added. This command is useful for adding new licenses or for picking up simple changes to the options file such as defining a new LM_PROJECT.
lmstat(FlexNet) Reports the status of all network licensing activities, including license files, daemons that are running, users of individual features, and users of features served by a specific vendor daemon.
LMTOOLS(FlexNet) Starts, stops, and configures FlexNet license servers; retrieves system information, including host IDs; and obtains server status. While LMTOOLS performs other functions, these are the most commonly used.
mgls_admin(MGLS) Displays version information for the MGLS environment.
mgls_ok(MGLS/PCLS) Checks out and checks in a specified feature and reports success or failure.
pcls_ok(PCLS) Checks out and checks in a specified license and reports any problems. This application, which is useful for verifying the license file, reports the version of the licensing software and displays the environment and registry settings for MGLS_LICENSE_FILE and LM_LICENSE_FILE and for the default location C:\flexlm\license.dat.
pkgmap(PCLS) Displays Mentor feature information for a specified product.