A.7.6 Network License Management
Single-machine and network licenses.
|single-machine license ||a process must always run on a specific machine |
|network license ||a process can run on any machine on a network |
Copies of Mathematica can be set up with either single-machine or network licenses. A network license is indicated by a line in the mathpass file starting with !name, where name is the name of the server machine for the network license.
Network licenses are controlled by the Mathematica license management program mathlm. This program must be running whenever a Mathematica with a network license is being used. Typically you will want to set up your system so that mathlm is started whenever the system boots.
Ways to start the network license manager under Microsoft Windows.
|• Type .\mathlm directly on the command line |
|• Add mathlm as a Windows service |
Ways to start the network license manager on Macintosh and Unix systems.
|• Type ./mathlm directly on the Unix command line |
|• Add a line to start mathlm in your central system startup script |
When mathlm is not started directly from a command line, it normally sets itself up as a background process, and continues running until it is explicitly terminated. Note that if one mathlm process is running, any other mathlm processes you try to start will automatically exit immediately.
Some command-line options for mathlm.
|-logfile file ||write a log of license server actions to file |
|-loglevel n ||how verbose to make log entries (1 to 4) |
|-logformat string ||use a log format specified by string |
|-language name ||language to use for messages (default English) |
|-pwfile file ||use the specified mathpass file (default ./mathpass) |
|-timeout n ||suspend authorization on stopped Mathematica jobs after n hours |
|-restrict file ||use the specified restriction file |
|-mathid ||print the MathID for the license server, and exit |
|-foreground ||run mathlm in the foreground, logging to stdout |
|-install ||install mathlm as a Windows service (Microsoft Windows only) |
|-uninstall ||uninstall mathlm as a Windows service (Microsoft Windows only) |
For more detailed information on mathlm, see the Mathematica Products System Administration Guide.
Monitoring network license activity.
|monitorlm ||a program to monitor network license activity |
|monitorlm name ||monitor activity for license server name |
If monitorlm is run in an environment where a web browser can be started, it will automatically generate HTML output in the browser. Otherwise it will generate plain text.
Some command-line options for monitorlm.
|-file file ||write output to a file |
|-format spec ||use the specified format (text, html or cgi) |
|-template file ||use the specified file as a template for the output |