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 XP/Vista/7:

1.  Open the Control Panel. (From the Start menu, choose SettingsControl 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 Mathematica 8.0 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 2000/XP/Vista:

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 Mathematica 8.0 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 2000/XP/Vista 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 Mathematica 8.0 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 2000/XP/Vista 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 Mathematica 8.0 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 OS X

To start MathLM on Linux, you may need root privileges. To start MathLM on Mac OS X, you must have administrative privileges.

You can start MathLM manually at any time using the command-line 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.

Starting MathLM Automatically on Mac OS X

To do this, you can write a startup item for MathLM. Startup items are programs (such as shell scripts) that are run during the last phase of booting a Mac OS X system. They can be configured to perform tasks such as clearing away temporary files or starting system daemons.

To Create a Startup Item for MathLM :

1.  Create a directory called /MathLM in /Library/StartupItems. You might need to create the directory /Library/StartupItems first.

2.  In /Library/StartupItems/MathLM, create a file called MathLM with the following contents. The name of the file must be the same as the name of the directory.

3.  Change permissions on the file to make it executable.

4.  In the same directory, /Library/StartupItems/MathLM, create a file called StartupParameters.plist with the following contents.

5.  Change permissions on the file to make it read-only.

6.  Edit the /etc/hostconfig file, and add the following text in the Services section.

7.  To start MathLM without rebooting, run the following command.

MathLM Command-Line Options

The following are command-line options for MathLM.

-foregroundkeep MathLM in the foreground and print server messages to stdout
-helpprint the list of all command-line options and the MathID
-language langspecify the language in which to display server messages
-localtimeuse local time instead of GMT in server messages
-logfile filewrite server messages to a specified log file
-logformat stringspecify the format for displaying server messages
-loglevel nspecify the level of verbosity of server messages
-mathidprint the MathID of the machine running MathLM
-noremotemonitorspecify that MathLM cannot be remotely monitored via MonitorLM
-pwfile filespecify a file in which to look for Mathematica passwords
-restrict filespecify a policy file that describes how to allocate Mathematica licenses
-timeout nreturn suspended licenses after a specified number of hours
-trfile filespecify 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 OS X.

-sysloglog messages to syslogd

mathlm command-line options specific to Linux and Mac OS X.

The following additional command-line options are accepted on Windows.

-installinstall MathLM as a service program and automatically start the service
-uninstallstop 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.

1report server startup/shutdown errors and print a successful startup message
2report everything from level 1 and all runtime error messages
3report everything from level 2, all license activity, and startup messages pertaining to the process ID and socket number
4report 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.

New to Mathematica? Find your learning path »
Have a question? Ask support »