Mathematica Tutorial

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 Me:

1. Open an MS-DOS window. (From the Start menu, choose Programs ► MS-DOS 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. Type .\mathlm and press Enter. The mathlm process prints a startup message and runs in the foreground. You cannot start MathLM manually and run it in the background.

To start MathLM under Windows NT/2000/XP:

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 on Windows 2000/XP and in the Control Panel folder on Windows NT. To change settings for services, you will need administrative privileges.

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

4. On Windows 2000/XP, double-click the service name to open the Properties dialog box; then click Start. On Windows NT, click the Start button on the Services control panel.

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

To stop MathLM under Windows Me:

1. From the desktop, press Ctrl+Alt+Del. The Close Program dialog box appears.

2. Select mathlm from the list of tasks.

3. Click End Task.

To stop MathLM under Windows NT/2000/XP:

1. Double-click the Services icon located in the Control Panel\Administrative Tools folder on Windows 2000/XP and in the Control Panel folder on Windows NT. To change settings for services, you will need administrative privileges.

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

3. On Windows NT/XP, select the service and click the Stop button on the Services control panel. On Windows 2000, 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 Me machine is rebooted:

1. Open an MS-DOS window. (From the Start menu, choose Programs ► MS-DOS 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.

4. Reboot the machine. The mathlm program will be launched automatically, and a console window will flash briefly. This is normal.

To prevent MathLM from starting each time a Windows Me machine is rebooted:

1. Open an MS-DOS window.

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

To start MathLM each time a Windows NT/2000/XP 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 on Windows 2000/XP and in the Control Panel folder on Windows NT. To change settings for services, you will need administrative privileges.

5. Select Mathematica 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.

On Windows NT/2000/XP, 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. On Windows Me, however, you must reboot the machine for any changes in configuration to take effect.

To prevent MathLM from starting each time a Windows NT/2000/XP machine is rebooted:

2. Select Mathematica 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 Unix, Linux, and Mac OS X

To start MathLM on Unix and 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 Unix and Linux

To do this, create a new startup script containing the following lines, or add them to an existing system startup script.

if [ -f /usr/local/Wolfram/MathLM/mathlm]; 
then /usr/local/Wolfram/MathLM/mathlm -logfile filename;
fi

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.

#!/bin/sh
. /etc/rc.common
##
#  This script will start up the Mathematica License Manager, mathlm.
##
if [  "${MATHLM:=-YES-}" = "-YES-" ]; then
 ConsoleMessage "Starting the Mathematica License Manager"
 /usr/local/Wolfram/MathLM/mathlm 
else
 ConsoleMessage "The Mathematica License Manager was not started"
fi

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

chmod 755 MathLM

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

{
 Description = "Mathematica License Manager";
 Provides = ("MathLM");
 Requires = ("Core Services");
 OrderPreference = "None";
 Messages = {
    start = "Starting Mathematica License Manager";
    stop  = "Stopping Mathematica License Manager";
            };
}

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