4.2 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.

You can choose one of three options:

Enter Password--brings up the front end password dialog box. See Section 4.3.1, Entering a Single-Machine Password in the Front End, 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 -c to quit, or follow the instructions in Section 4.3.2, Entering a Single-Machine Password from the Kernel, 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.

You can choose one of three options:

Enter Password--brings up the front end password dialog box. See Section 4.3.1, Entering a Single-Machine Password in the Front End, 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 -c to quit, or follow the instructions in Section 4.3.2, Entering a Single-Machine Password from the Kernel, 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.

You can choose one of three options:

Enter Password--brings up the front end password dialog box. See Section 4.3.1, Entering a Single-Machine Password in the Front End, 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.

You can choose one of three options:

Enter Password--brings up the front end password dialog box. See Section 4.3.1, Entering a Single-Machine Password in the Front End, 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.