Mathematica Tutorial

Installing MathLM

Requirements

MathLM is available for Windows, all Unix and Linux platforms on which Mathematica is supported, and Mac OS X. Visit www.wolfram.com/products/mathematica/platforms.html for a complete list of platform availability. Each MathLM license server can support any combination of client machines, regardless of the platform on which MathLM itself is running.

The machine that you choose as a license server should be stable and should have a reliable TCP/IP connection to the clients you want to serve. As MathLM requires minimal processor and memory resources, an older machine with a reliable network connection would be an acceptable license server. Ideally, there should not be any intervening firewalls between the license server and the clients. If there is an intervening firewall, you will need to configure the network to allow traffic to an appropriate port through the firewall. There is no restriction on the physical location of the license server.

To install and run MathLM, you must register with Wolfram Research and receive a password. See "Registration and Passwords" for further information.

Installing MathLM on Windows

To install MathLM on Windows NT/2000/XP/Vista, you must have administrative privileges.

To Install MathLM on Windows:

1. Insert the MathLM CD. The MathLM CD window appears on your screen. Click the button labeled Install MathLM to a hard disk.

2. The MathLM Setup dialog box appears. By default, MathLM is installed in the directory C:\Program Files\Wolfram Research\MathLM. To choose another destination directory, click Browse. Click Install to continue.

3. Your MathID number is displayed on the dialog box that appears. To obtain your password, contact Wolfram Research (see "Registration and Passwords" for details). You will need to provide your license number (printed on your license certificate) and your MathID number.

Once you have your password, enter your license number and password in the dialog box. Click Add to add the new password to the list of recognized passwords. Click Next to continue installing files.

4. The installation program will tell you when it is finished. Click Finish to quit the installer.

After the installation is completed, MathLM will start automatically. For information on configuring MathLM with additional options, refer to "Launching MathLM".

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

1. Insert the MathLM CD into the CD-ROM drive.

2. Mount the CD. For information on mounting a CD, see "Mounting a CD on Unix and Linux".

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

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

4. Type the following command and press Enter.

./MathLMInstaller

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

Once you have your password, type the letter c and press Enter 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]:

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

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:

7. Enter your MathLM password. Then press Enter.

Enter your MathLM password:

8. The installer prompts you to specify the directory in which MathLM should be installed. The default location is /usr/local/Wolfram/MathLM. Press Enter to accept the default, or type in a new location and then press Enter.

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.

9. The installer prompts you to specify the directory in which symbolic links will be created. The default location is /usr/sbin. Press Enter to accept the default, or type in a new location and then press Enter.

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.

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

11. 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 "Launching MathLM".