Floating License Sever Setup
Floating licenses allow a group of users to share T-VEC licenses on a network. The licenses are managed by a license manager which limits the number of concurrent users of the tools to the number of licenses specified in a license file. T-VEC tools use the the FlexLM license manager to manage licenses.
In a FlexLM floating configuration, the T-VEC tools communicate with the FlexLM license manager to obtain licenses. The machine running the FlexLM license manager is referred to as the license server.
There are three components of the license manager:
- FlexLM license manager (lmgrd)
- License File
- T-VEC license (vendor) daemon (tveclmd)
On Windows, the FlexLM license manager, lmgrd, typically runs as a service and starts as part of Windows startup. lmgrd reads the license file associated with it and loads any vendor daemons specified in the license file. The T-VEC license vendor daemon is tveclmd. Once tveclmd is started by lmgrd, it manages the licenses for T-VEC tools.
The License File
A typical license for T-VEC tools looks like the following example.
SERVER license_server 00a02471cf70 TCP: 27007 DAEMON tveclmd c:\t-vec\license\tveclmd.exe PACKAGE TVGSCore tveclmd 1.0 0CC8812AF01F COMPONENTS="T-VECcomp \ T-VECvgen T-VECapi T-VECcov T-VECmake T-VECtdvr T-VECmap" \ OPTIONS=SUITE SIGN="0074 C705 80D7 32B1 0298 F40B 3FD3 CE00 \ 8AAA 6B26 540F B898 B352 77C7 9CBD" PACKAGE TVGSInterface tveclmd 1.0 94B2F00BEFA9 COMPONENTS="T-VECse \ T-VECcmd" OPTIONS=SUITE SIGN="000F 77D1 374F F534 99E3 06E1 \ 7046 A400 C77D 81E0 7425 D062 36F4 9BF5 28A5" FEATURE TVGSCore tveclmd 1.0 15-jan-2010 2 752D4BC5529B SIGN="008D \ F667 6345 965D DEE2 8F8B 6AF6 1400 F575 35D2 A2BD 8E01 C1B2 \ DD05 BDAF" FEATURE TVGSInterface tveclmd 1.0 15-jan-2010 2 8AFF7C916F24 \ SIGN="000C 6B8F 3EEB 4445 731C 337D 41CB 2E00 9A6E F706 0D54 \ BA2E 504B 13E5 09C7" FEATURE sl2tvec tveclmd 1.0 15-jan-2010 2 723000EB9CA9 SIGN="000C \ 4BAF C49E CC80 37BE 63E2 DB89 F800 B1B3 80C3 C074 2CF5 077B \ DC68 057D" FEATURE TTM_STD tveclmd 1.0 15-jan-2010 2 68A665466A72 SIGN="00C7 \ 376B 30B0 473C ADDE F958 2AB3 EC00 9242 783F 0974 FD30 CEEC \ 99AF 2453"
In this example, the license server is named "license_server". The server's ethernet address is "00a02471cf70". The license manager listens on port 27007 for client license requests. The vendor daemon for managing the license requests is tveclmd.exe. The information following the first two lines of the license file contain details on the licenses managed by this file.
The server name, port and path to the vendor daemon can be updated without invalidating the license file. It is good practice to use the full path to specify the vendor daemon.
SERVER [server] 00a02471cf70 TCP: [port] DAEMON tveclmd [path to vendor daemon]
Installing and Configuring the License Manager
While this section will provide information on installing and configuring FlexLM, FlexLM is known for its flexiblity. To learn more about FlexLM and alternate configurations, refer to the FlexLM documentation.
The files necessary to install and configure the license manager are included in the "license" directory of the T-VEC installation. These files include:
- lmgrd - FlexLM license manager
- tveclmd - T-VEC vendor daemon
- lmtools - Utility for configuring the license manager (GUI)
- lmutil - Command-line utility for configuring the license manager
It is possible to download and use the latest versions of the FlexLM software. Distribution of FlexLM has been handled by a couple different companies. A google search is probably most effective for finding the latest downloads. Find the Latest FlexLM
While the license manager can be configured in the T-VEC license directory, the default location for FlexLM license manager installations is c:\flexlm. As many vendors use FlexLM, it is wise to check the c:\flexlm directory to see if a FlexLM installation is already installed on the machine.
Obtain a License File
In addition to these files, a valid license file for the T-VEC tools is required to complete the setup. License files are distributed by T-VEC support. They are generated based on the license server's hostid which is typically it's ethernet (MAC) address. Send the server name and ethernet address to T-VEC Support to obtain a license file. See License_Management#Obtaining_Licenses for information on obtaining a license file for the license server.
Configuring with LMTools
The lmtools application which is included in the license directory of the T-VEC installation is the easiest way to configure the license manager. Start the license manager by double-clicking it (lmtools.exe).
To specify a new license manager service, click the "Config Services" tab. Specify a name of the new license manager service. Next specify the locations of
- license file (usually license.dat)
- log file location
See the image before for examples.
Enable the "Use Services" and "Start Server on Power Up" to have the license manager start automatically. Finally, click the "Save Service" button to apply the settings.
Starting the License Manager Service
To start the new license, click on the "Start/Stop/Reread" tab. Select the service from the list of services displayed, and then click the "Start Server" button.
Checking License Manager Status
To check the status of the license manager, click on the Server Status tab. Click the "Perform Status Enquiry" button and view the results in the window below.
Note that status will include information about all the FlexLM installations on the machine. If there are other FlexLM license managers active, their information will also be included in the status printout.
Verify the status printout includes license information for the T-VEC tools, such as, TVGSCore, sl2tvec and TTM.
-------- Status -------- Flexible License Manager status on Sun 6/1/2008 14:23 [Detecting lmgrd processes...] License server status: 27007@license_server License file(s) on electra: C:\T-VEC\license\license.dat: electra: license server UP (MASTER) v8.3 Vendor daemon status (on electra): tveclmd: UP v8.3 Feature usage info: Users of TVGSCore: (Total of 2 licenses issued; Total of 0 licenses in use) Users of TVGSInterface: (Total of 2 licenses issued; Total of 0 licenses in use) Users of sl2tvec: (Total of 2 licenses issued; Total of 0 licenses in use) Users of TTM_STD: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECse: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECcmd: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECcomp: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECvgen: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECapi: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECcov: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECmake: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECtdvr: (Total of 2 licenses issued; Total of 0 licenses in use) Users of T-VECmap: (Total of 2 licenses issued; Total of 0 licenses in use)
Debugging the License Manager
If the service fails to start or the status information indicates some sort of failure, check the log files for more information. The log can be viewed in a text editor or through lmtools. To view in lmtools, click the "View Log" button on the "Config Services" tab.
To configure clients to use the license manager, specify the server name and port as described here License_Management#Client_Setup