Getting Started

System Administration Guide

Installing MathLM

1.3 Installing MathLM on Unix, Linux, and Mac OS X

To install and run MathLM on Unix and Linux, you may need root privileges. To install and run MathLM on Mac OS X, you must have administrator privileges.

To install MathLM on Unix, Linux, and Mac OS X:

On Mac OS X, open the Terminal application and type the commands that follow in the Terminal window.

Insert the MathLM CD into the CD-ROM drive.
Mount the CD. For information on mounting a CD, see Mounting a CD on Unix and Linux in the Appendix.

Note: This step is not required on Mac OS X and some Linux and Unix platforms, as the operating system automatically handles mounting.

Change the directory to the appropriate subdirectory beneath the CD mount point. Note that the exact location of the CD mount point might be different on Unix and Linux platforms.

Unix:

cd / cdrom /Unix

Mac OS X:

cd /Volumes/MathLM/Macintosh

Type the following command and press . Note that on Mac OS X, is equivalent to .

./MathLMInstaller

Your machine name and MathID number are displayed. To obtain your password, contact Wolfram Research (see Registration and Passwords in the Introduction for details). You will need to provide your license ID number (printed on your license certificate) and your MathID number.

Once you have your password, type the letter c and press

to proceed with the installation.

-----------------------------------------------------------------
MathLM Installer
-----------------------------------------------------------------
You can use this installer to install MathLM for the first time, or to
install a new version when you already have a previous version installed.
To complete the installation, you will need a MathLM password.

To receive a password, register your copy of MathLM by going to
register.wolfram.com. You can also find registration instructions
in the file SysAdminGuide.pdf on the MathLM CD, or on the web at
support.wolfram.com/networkmathematica/

To register and get a password you will need to supply the
following information:

Machine name: hostname
MathID: dddd-ddddd-ddddd

Enter 'c' to continue or 'e' to exit the installer [c]:

Enter your MathLM license ID number as it appears on your license certificate. Then press

Enter the license ID printed on your license certificate.
Your license ID should be of the form Lnnnn-nnnn, where
the n are digits.

Enter your license ID:

Enter your MathLM password. Then press

Enter your MathLM password:

The installer prompts you to specify the directory in which MathLM should be installed. The default location is /usr/local/Wolfram/MathLM. Press

to accept the default, or type in a new location and then press

The installer will copy relevant files from the distribution
CD-ROM into your MathLM directory. If you specify a
directory that already contains MathLM, the installer
will update components to the latest available version. To install
MathLM from scratch, specify a directory that does not
already exist.

Enter the MathLM directory [/usr/local/Wolfram/MathLM]:

Note: If you choose a directory that does not exist, the installer will create it for you. If a copy of MathLM already exists in the directory you specify, the installer will inform you before updating any files.

The installer prompts you to specify the directory in which symbolic links will be created. The default location is /usr/sbin. Press

to accept the default, or type in a new location and then press

The installer will copy relevant files from the distribution
CD-ROM into a linking directory. If you specify a directory
that already contains files from an older installation of
MathLM, the installer will update components to the latest
available version. To install MathLM from scratch, specify
a directory that does not already exist.

Enter the linking directory [/usr/sbin]:

Note: If you choose a directory that does not exist, the installer will create it for you. If symbolic links to an older copy of MathLM already exist in the directory you specify, the installer will inform you before updating them.

The installer begins copying files from the CD. Each directory created is listed on your screen, and the location of the password file is displayed. If any error messages are generated during installation, they are logged to the installation directory.

Once the installation is complete, you must start MathLM manually. First, change directory to the location in which MathLM is installed (the default location is /usr/local/Wolfram/MathLM). Then issue one of the following commands.

To start MathLM, type

./mathlm

To start MathLM and log messages to a file, type

./mathlm -logfile filename

Only a few options are presented here. A full discussion of the command-line options for MathLM is given in Section 2.1, Command-Line Options.

Starting MathLM automatically

You may start MathLM manually at any time using the command-line options listed in Section 2.1, 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:

Create a directory called MathLM in /Library/StartupItems. You might need to create the directory /Library/StartupItems first.
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

Change permissions on the file to make it executable.

chmod 755 MathLM

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";
            };
}

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

chmod 644 StartupParameters.plist

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

MATHLM=-YES-

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

SystemStarter start MathLM