Installing Mathematica

Requirements for Installing Mathematica

Mathematica is available for Windows, Linux, and Mac OS X. For a complete list of platform availability, visit www.wolfram.com/mathematica/features/system-requirements.html. Any supported machine can act as a client for running Mathematica, provided the following two conditions are met:

  • The client has access to the Mathematica files, either locally or from a file server on the network.
    • The license server running MathLM is available on the TCP/IP network.

    A license server can also function as its own client. However, this is not recommended. If the machine has to be rebooted for any reason, the serving of licenses to all other clients on the network may be disrupted.

    If you wish to license Mathematica from a MathLM license server, MathLM should already be installed and running on a license server on the network (see "Installing MathLM" for details). To complete the Mathematica installation, you will need to know the name or IP address of the license server running MathLM.

    To install Mathematica, you must be logged in with administrative privileges, or be able to elevate to administrative privileges. You also must activate Mathematica using the Wolfram User Portal in order to run it (see "Activating Mathematica" for details).

Installing Mathematica from a File Server

One convenient way to install Mathematica on a client is to run the installer remotely from a file server. This is an efficient way of making Mathematica available to a large number of users without having to supply a CD/DVD to each one. You can install Mathematica from a file server on a client running any supported platform. It is not necessary that the client platform be the same as the file server platform.

To install Mathematica from a file server, you first must make the installer and Mathematica files available to the clients. You can do this by copying the contents of the CD/DVD to the file server and exporting the directory, or by exporting the CD/DVD mount point on the file server. Then, mount the directory with the Mathematica distribution on the client and change to this directory, and run the installer as usual.

Installing Mathematica from a file server requires first copying the installer executable and all files in the Mathematica distribution from the DVD onto the file server.

Starting the Mathematica Installer

The Windows Installer

Open the Windows directory from the DVD. Double-click the file Setup.exe to launch the installer and follow the prompts. The main Windows installer includes a custom setup option which allows you to control whether to install secondary components, including support for the Mathematica web browser plugin and components for indexing notebooks on the file system.

The Macintosh Installer

Mathematica may be installed by dragging the Mathematica application bundle into the Applications folder, as illustrated by the startup window when you insert the DVD. The DVD also includes an installer to install secondary components, including support for the Mathematica web browser plugin and for Spotlight and Quick Look support of Mathematica-created documents.

The Linux Installer

To install Mathematica under Linux,

1.  Mount the CD or DVD. For information on mounting a CD/DVD, see "Mounting a CD or DVD on Linux".

Note: This step may not be required on some Linux and Unix platforms, as some operating systems automatically handle mounting.

2.  Change directory to /cdrom/Unix/Installer. Note that the exact location of the CD/DVD mount point might be different for your platform.

cd / cdrom /Unix/Installer

3.  Run the installer.

./MathInstaller

4.  Follow the installer prompts.

Installing Mathematica from a Script

If you are installing Mathematica on multiple machines, it can be time consuming to respond to all of the installer prompts on each individual machine. By supplying command-line options to the installer, you can customize various features of the installation process or automate it entirely.

Windows

/dir="C:\path\here"specify the installation directory
DisableShellVerbsdisable file associations for .m, .nb, .nbp, etc. (enabled by default)
/group="start menu folder name"specify the start menu folder name
/noicons disable creation of start menu folder and shortcuts
/norestartdo not restart the system, even if necessary
/restartexitcode=codespecify the installer exit code to return if restart is necessary
/silentforce an automatic installation and suppress installation windows
/suppressmsgboxessuppress installer message boxes (only effective when used in conjuction with /silent)

Mathematica Installer supported command-line options.

Creating a Script That Performs a Silent Mathematica Installation:

The following instructions explain how to write a simple script to silently install Mathematica from a file server. These instructions require that you have a mathpass file with a valid password. See "Registrations and Passwords" for more information on sitewide mathpass configurations.

1.  Follow the instructions in the first part of "Installing Mathematica from a File Server" to copy the installer and files from the DVD to a file server.

2.  Copy your mathpass file to the same directory on the file server as the installer and Mathematica files.

3.  Open Notepad (Start Menu ► Programs ► Accessories ► Notepad) and type the following lines into a new file.

4.  Change all instances of \\server\math to the pathname of the network share where the Mathematica installation files and mathpass file were copied.

5.  Change "C:\Directory\Name" to the directory listed here for your version of Windows. Be sure to enclose the name of the directory in quotes.

Windows 7/Vista—"C:\ProgramData\Mathematica\Licensing"

Windows XP—"C:\Documents and Settings\All Users\Application Data\Mathematica\Licensing"

Note: These directories are the values of $BaseDirectory for different versions of Windows. See "Configuration Files" for further information.

6.  To save the file, choose File ► Save. Save the file in the same directory as the Mathematica installation files. Type the file name install.bat and choose All Files from the Save as type popup menu. Click Save, then quit Notepad.

Performing a Silent Mathematica Installation:

1.  On the client, open a Command Prompt window, type the pathname of the install.bat file, and press Enter. For example, if the network share is called \\server\math, type:

\\server\math\install.bat

The following messages are displayed.

2.  The installation is now complete. If you see any messages other than those printed here, check the file C:\Windows\Temp\install.log on the client machine for further information.

Installing Mathematica in this way eliminates the need to take the DVD to each client machine, and saves time by allowing you to run a simple script instead of responding to the installer questions.

Linux

-autoforce the installation to proceed automatically without prompting the user for any information
-createdir=valuespecify whether or not to create the directories specified by the options -targetdir and -execdir
-execdir=dirspecify the path to be used for the symbolic links to the executable scripts
-helpdisplay information about the installer options
-method=typedefine the type of installation you would like to perform
-overwrite=valuespecify whether the installer should overwrite any files that already exist in the target directory
-platforms=valuespecify the system ID of the Linux platform or platforms for which you want to do the installation
-selinux=valuespecify whether the installer should attempt to modify the security context of any included libraries so that it will function properly
-silentforce an automatic installation (equivalent to the -auto option)
-targetdir=dirspecify the installation directory
-verbosedisplay detailed information about the files and directories being installed

MathInstaller command-line options.

Note: Default values are used for any options that are not specified explicitly on the command line.

Valid input for -createdir is y for yes or n for no. By default, this value is set to y.

The default directory for -execdir is /usr/local/bin. This option only works with an automatic installation.

The values for -method may vary by product. When this option is applicable, the values can be determined by running the installer. The default value for this option is Full.

Valid input for -overwrite is y for yes or n for no. By default, this value is set to y. This option only works with an automatic installation.

The default for -platforms is the system you are installing on, if that information is available to the installer. This option only works with an automatic installation.

Valid input for -selinux is y for yes or n for no. By default, this value is set to n.

The option -silent suppresses any output from being displayed on the screen. The output is instead written to a file named InstallerLog-number. If the installation is unsuccessful, the log file is saved in the /tmp directory. Otherwise, the file is moved to the target directory and renamed InstallerLog.

The directory specified for -targetdir corresponds to the value of the global variable $InstallationDirectory. The default value is /usr/local/Wolfram/Mathematica/9.0. This option only works with an automatic installation.

To complete the installation in one step, run a command like the following.

./MathInstaller -auto -targetdir=/home/mathematica

To do the same using the sudo command, you may need to use sudo's -- flag.

sudo ./MathInstaller -- -auto -targetdir=/home/mathematica

This allows you to complete the installation automatically in one step, while still being able to customize various details such as the directory to install to. You are not prompted to enter your password using this method, so you will need to enter a password the first time Mathematica is launched.

If you are doing many installations, you might find it convenient to include the MathInstaller command with all the relevant options in a shell script. Running the shell script is then an easy way to do an identical customized installation on multiple machines. You can further simplify the installation process by including a line in your script that copies an existing mathpass file to the appropriate location on the newly installed machine. Note that MathInstaller must be run from the directory in which it is located, so your script may require a command to change directory. See "Registrations and Passwords" for information on sitewide mathpass configurations.

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