This is documentation for Mathematica 6, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)

Troubleshooting MathLM

Diagnostics

The following techniques are useful for debugging problems with client connections to the license server.
  • Launch MathLM with the option -foreground. This option allows you to see how requests are handled by MathLM in real time.
  • Log MathLM messages to a file with an increased level of verbosity by launching MathLM with the options -logfile and -loglevel. This allows you to see how requests are handled by MathLM over a certain period of time.
  • From a command line on the client, run the Mathematica kernel with the option -lmverbose and examine the messages produced. This option prints diagnostic information on connecting to the license manager.

Problems and Solutions

MathLM cannot find the password file.

MathLM will not start if it cannot find the password file. In that case, the following error message will be displayed on your screen.
To successfully start MathLM, use the option -pwfile followed by the full pathname of the mathpass file.

The client cannot connect to the license server when Mathematica is first launched.

If this happens, the following dialog box appears.
1.gif
You can choose one of three options:

Enter Password—brings up the front end password dialog box. See "Entering a Single-Machine Password" for details.

Quit—exits Mathematica. You are given the option of saving your work.

Retry server—attempts to reconnect to the server.

If you are running the kernel only, the following message will be displayed.
You can press Ctrl+C to quit, or follow the instructions in "Entering a Single-Machine Password" to enter a single-machine password.
If these error messages are displayed, check that MathLM is running on the license server. If MathLM quits, it must be restarted in order to serve licenses. If there is a firewall between the license server and the client, verify that the firewall is configured to allow traffic through the proper port.

The client can connect to the license server, but is denied a license because the process limit has been reached.

If this happens, the following dialog box appears to notify you of an error.
2.gif
You can choose one of three options:

Enter Password—brings up the front end password dialog box. See Entering a Single-Machine Password for details.

Quit—exits Mathematica.

MathReader—launches Mathematica in MathReader mode. In this mode you cannot create or edit notebooks, but you can view and print them.

If you are running the kernel only, the following message will be displayed.
You can press Ctrl+C to quit, or follow the instructions in "Entering a Single-Machine Password" to enter a single-machine password.
You can purchase additional licenses by contacting Wolfram Research.

MonitorLM shows that there are available licenses, but the client is denied a license because the process limit has been reached.

If this happens, there are reserved licenses that are not in use. If necessary, you can reclaim an unused reserved license by removing the relevant line from the restriction script and restarting MathLM.

The client can connect to the license server, but is denied a license based on a restriction script.

If MathLM is configured to use a restriction script and an unauthorized client requests a license, the following message will be displayed.
3.gif
You can choose one of three options:

Enter Password—brings up the front end password dialog box. See Entering a Single-Machine Password for details.

Quit—exits Mathematica.

MathReader—launches Mathematica in MathReader mode. In this mode you cannot create or edit notebooks, but you can view and print them.

If the client that was denied should be allowed to request a license, edit the restriction script and restart MathLM.

The connection to the license server is lost after the client is connected to it.

Once Mathematica is running, the client contacts the license server every two minutes to refresh its license. If three successive attempts to contact the license server are unsuccessful, a dialog box will appear informing you that the license server could not be contacted. This happens six to eight minutes after the connection to the license server is lost.
If you are running the front end, the following dialog box appears.
4.gif
You can choose one of three options:

Enter Password—brings up the front end password dialog box. See Entering a Single-Machine Password for details.

Quit—exits Mathematica. You are given the option of saving your work.

Retry server—attempts to reconnect to the server.

If you are running the kernel only, you will receive the following prompt to indicate that the connection has been lost.
You may attempt to connect to the license server again, or you may exit Mathematica.