7 Floating license setup¶
Overview
A floating license is tied to a particular computer acting as a token server. A token server is a service on Windows and a daemon on UNIX that serves license tokens to MOSEK client programs over the LAN.
You may think of the token server as a computer with a bag of license tokens. Whenever a client computer starts using MOSEK, a license token is requested from the token server, and when MOSEK completes it sends back the license token to the token server. The following diagram Fig. 7.1 conveys the overall idea.
Fig. 7.1 General floating license scheme: any MOSEK instances that can connect to the token server can get a valid license.¶
This implies that you cannot use more license tokens than are available at any given point in time. Moreover, MOSEK can be used on any computer connected to the token server through the local area network. In particular MOSEK can also be used on the token server itself.
Note that
a floating license file starts with the word
SERVER. The format is described in Sec. 5.2.1 (Floating license file). Installing a license file without aSERVERline with a token server is NOT needed and is NOT possible.The token server consists of two daemons:
lmgrd- the token server daemon running as a service, andMOSEKLM- a vendor daemon started bylmgrdspecifically for handling MOSEK licenses.at most one instance of
lmgrdcan be running on any given machine.
Choosing ports
The default floating licenses files issued by MOSEK will use the following ports for the token server to listen on:
lmgrd: port 27007MOSEKLM: not defined, will be assigned dynamically during startup.
If you are using a firewall then both of these ports must be open for inbound connections. Therefore in restricted environments it is strongly recommended to choose your own port numbers and ensure their accessibility; this applies especially to the second MOSEKLM vendor port, as otherwise it will change after each restart of the token server.
To achieve this, edit the license file as follows:
SERVER my_server 123456789ABC 27007
USE_SERVER
VENDOR MOSEKLM port=3084
using your chosen port numbers. The example above will assign port 27007 to lmgrd and port 3084 to MOSEKLM. Start the token server with your edited license file.
For more information and troubleshooting tips see Sec. 7.3 (Changing default ports and firewall and antivirus issues).
Installation
Sec. 7.1 (Windows: Token server setup) - installing the token server as a service on Windows using the graphical tool lmtools.
Sec. 7.2 (Linux, macOS: Token server setup) - starting the token server on Linux and macOS using the command-line tool lmgrd. The same instructions can also be used for a manual startup on Windows.
Additional troubleshooting
Sec. 7.3 (Changing default ports and firewall and antivirus issues) - more information about ports and firewalls.
Sec. 11.2 (Floating license issues) - licensing FAQ with solutions to all known floating license issues.