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 2000/XP/Vista:
1. Open the Control Panel. (From the menu, choose .)
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 7.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 7.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 menu, choose .)
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 7.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 7.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 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.
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.
chmod 644 StartupParameters.plist
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.
SystemStarter start MathLM
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 Mathematica 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 Unix, Linux, and Mac OS X.
| -syslog | log messages to syslogd |
mathlm command-line options specific to Unix, Linux, and Mac OS X.
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.
