Launching MathLM

Launching MathLM on Windows

Launching MathLM Manually

Once installed, MathLM starts running automatically by default each time the machine is rebooted. To start or stop MathLM manually, follow these instructions.
It is assumed here that MathLM is installed in the default location, C:\Program Files\Wolfram Research\MathLM.

To Start MathLM under Windows:

1.  Open the Control Panel. (From the Start menu, choose Settings Control Panel.)

2.  Double-click the Services icon located in the Administrative Tools folder. To change settings for services, you will need administrative privileges.

3.  Select Wolfram License Manager from the list of services.

4.  Double-click the service name to open the Properties dialog box; then click Start.

Alternatively, in a command prompt window run the command net start mathlm.

To Stop MathLM under Windows:

1.  Double-click the Services icon located in the Control Panel\Administrative Tools folder. To change settings for services, you will need administrative privileges.

2.  Select Wolfram License Manager from the list of services.

3.  Double-click the service name to open the Properties dialog box; then click Stop.

Alternatively, in a command prompt window run the command net stop mathlm.

Starting MathLM Automatically

Under normal conditions, the installer will install MathLM as a service on the machine. This means MathLM will start automatically each time the machine is rebooted. You can manually change the settings that control whether MathLM starts when the machine is rebooted.
It is assumed here that MathLM is installed in the default location, C:\Program Files\Wolfram Research\MathLM.

To Start MathLM Each Time a Windows Machine Is Rebooted:

1.  Open a command prompt window. (From the Start menu, choose Programs Accessories Command Prompt.)

2.  Use the cd command to change directories to C:\Program Files\Wolfram Research\MathLM. Remember to use double quotes around directory names that include spaces.

3.  Run .\mathlm -install.

If MathLM is already installed as a service but was previously disabled, you can enable it again using the following steps.

4.  Double-click the Services icon located in the Control Panel\Administrative Tools folder. To change settings for services, you will need administrative privileges.

5.  Select Wolfram License Manager from the list of services and double-click.

6.  In the dialog box that appears, set Startup type to Automatic.

7.  Click OK to close the dialog box.

You can start or stop MathLM without rebooting the machine. The MathLM service will give no indication that it has started, but the operating system will report if it fails to start.

To Prevent MathLM from Starting Each Time a Windows Machine Is Rebooted:

1.  Double-click the Services icon located in the Control Panel\Administrative Tools folder. To change settings for services, you will need administrative privileges.

2.  Select Wolfram License Manager from the list of services and double-click.

3.  In the dialog box that appears, set Startup type to Disabled.

4.  Click OK to close the dialog box.

Alternatively, in a command prompt window run the command .\mathlm -uninstall. This will remove MathLM from the Service list.

Launching MathLM on Linux and Mac
To start MathLM on Linux, you may need root privileges. To start MathLM on Mac, you must have administrative privileges.
You can start MathLM manually at any time using the commandline options listed in "Command-Line Options". However, it is typical to configure MathLM so it starts automatically when the system is rebooted.

Starting MathLM Automatically on Linux

To do this, create a new startup script containing the following lines, or add them to an existing system startup script.
MathLM Command-Line Options
The following are command-line options for MathLM.
-foreground
keep MathLM in the foreground and print server messages to stdout
-help
print the list of all command-line options and the MathID
-language lang
specify the language in which to display server messages
-localtime
use local time instead of GMT in server messages
-logfile file
write server messages to a specified log file
-logformat string
specify the format for displaying server messages
-loglevel n
specify the level of verbosity of server messages
-mathid
print the MathID of the machine running MathLM
-noremotemonitor
specify that MathLM cannot be remotely monitored via MonitorLM
-pwfile file
specify a file in which to look for Wolfram System passwords
-restrict file
specify a policy file that describes how to allocate Mathematica licenses
-timeout n
return suspended licenses after a specified number of hours
-trfile file
specify a file that defines substitutions for the text of error messages
mathlm command-line options.
The following additional command-line option is accepted on Linux and Mac.
-syslog
log messages to syslogd
mathlm command-line options specific to Linux and Mac.
The following additional command-line options are accepted on Windows.
-install
install MathLM as a service program and automatically start the service
-uninstall
stop any currently running MathLM processes and remove MathLM from the list of services
mathlm command-line options specific to Windows.
With -install, any arguments given are stored as a part of the service and used when starting MathLM automatically.
Possible values for lang in -language are English, French, German, and Japanese.
The four levels of verbosity in -loglevel are as follows.
1
report server startup/shutdown errors and print a successful startup message
2
report everything from level 1 and all runtime error messages
3
report everything from level 2, all license activity, and startup messages pertaining to the process ID and socket number
4
report everything from level 3, debugging information, and a license table for every license transaction
-loglevel verbosity levels.
If -foreground is specified, the default verbosity level is set to 4.
If -logfile is used without -loglevel, the default logging verbosity is set to 3.
If -loglevel is used without specifying a level, the verbosity defaults to 4.
The default format for log messages is the W3C common logfile format. MathLM log files can be imported using the Import format "ApacheLog".

Note: On Windows, a slash (/) or a dash (-) may be used to indicate options.