1.4.2 Mathematica Passwords
In order to install and use Mathematica, you must register with Wolfram Research and receive a password. To register, you will need the following information:
- Single-machine license—the MathID for the machine on which you are installing Mathematica.
- Network license—the hostname and MathID for the machine that will run the Mathematica license manager, MathLM.
The MathID is a machine-specific identification number that is automatically determined when running the installer on a machine. The MathID is displayed in the front end password dialog box when you first start Mathematica. On Unix platforms, the MathID is displayed and the password can be entered during the installation process using the command line.
In addition to the MathID, you will also need the license number for your copy of Mathematica. The license number is printed on the license certificate included with the Mathematica CD. Once you have this information, you can register and get a password in one of these ways:
- By fax—complete the printed registration form included in your Mathematica box. Fax the registration form to +1-217-398-1108. (In Europe: +44-(0)1993-883800.)
- By mail—complete the printed registration form included in your Mathematica box. Mail the registration form to:
Wolfram Research, Inc.
100 Trade Center Drive
Champaign, IL 61820-7237
Wolfram Research Europe Ltd.
10 Blenheim Office Park
Lower Road, Long Hanborough
Oxfordshire OX29 8RY
- By phone—call +1-800-WOLFRAM or +1-217-398-5151, Monday-Friday, 8am-5pm U.S. Central Time. (In Europe: +44-(0)1993-883400, Monday-Friday, 9am-5pm GMT.)
Be sure to write down the password and keep it for future reference. The MathID for your machine can change under certain circumstances, for example, if you change or reformat your hard disk. If the MathID changes, you will need to get a new password from Customer Service.
The mathpass File
To run Mathematica, you must enter a valid password. Your password depends on the type of license you have, your license number, the hostname of the machine (either where all processes are running or the license server), and the MathID. Some passwords have an expiration date.
All passwords are stored within a file called mathpass, which is typically located in the Configuration/Licensing directory in the top-level Mathematica directory. The mathpass file is usually created automatically by the installer, but you may find it necessary to edit the file by hand at times.
The mathpass file may contain many password entries, which may be for both single-machine and network licenses. Each line of the mathpass file contains information for a separate password. When you launch Mathematica, the mathpass file is parsed from top to bottom and the first valid password found is used. You can comment out any line in the mathpass file by placing a % sign at the start of the line.
For single-machine licenses, the password typically has the form dddd-ddd-ddd, where d stands for a digit 0-9 and n stands for the number of processes for the license. The password may have other fields in it for a time-limited or language-enabled license. The password is stored in the mathpass file in the following format:
hostname 7000-10419-18404 L1234-5678 1234-567-890
The hostname is the name of the machine on which the Mathematica processes will run. This is given first, followed by the MathID, the license number, and the password. The parts of the entry may be separated by spaces or tabs. When you receive your password, it is important that you write it down with all the dashes, colons, and numbers exactly as specified.
The mathpass file may have multiple single-machine passwords listed, and it may be shared across the network. The Unix installer allows you to link the password file across the network, which allows you to maintain a single mathpass file for multiple machines (see Section 3.3.4 for details).
When you receive your password, it is important that you write it down with all the dashes, colons, and numbers exactly as specified. For network licenses, the password typically has the form dddd-ddd-ddd:n:::CA. Here, d stands for a digit 0-9 and n stands for the number of processes for the license. In some passwords, the digit n may be replaced with a pair of digits n, m, which specify the number of kernel processes and front end processes, respectively. The password may have other fields in it for a time-limited or language-enabled license.
The capital letters at the end of the password refer to the license class, which determines what client platforms Mathematica can run on. Windows and Macintosh are class A, most Unix platforms are class B, but Linux is class X. A class B password is valid for both class A and class B clients. The mathpass file must contain separate password entries for each license class.
The password is stored in the mathpass file in the following format:
!hostname 7000-10419-18404 L1234-5678 1234-567-890:8:::CB
The name of the license server running MathLM is given first, followed by its MathID. The ! at the start of the line distinguishes a network license from a single-machine license. The license number is followed by the password. The parts of the entry may be separated by spaces or tabs. When you receive your password, it is important that you write it down with all the dashes, colons, and numbers exactly as specified.