MathLM License Manager - ReadMe.txt (C) 1988-2014 Wolfram Research, Inc. All rights reserved. ============================================================= TABLE OF CONTENTS ============================================================= * Contents of the MathLM CD * Registration and Obtaining a Password * Basic MathLM Installation Instructions * Testing the MathLM Installation * Further Information * Wolfram Research Contact and Copyright Information ============================================================= Contents of the MathLM CD ============================================================= The MathLM CD contains all the files for installing MathLM on Windows, Mac OS X, and Linux. There are separate subdirectories for Windows, Mac OS X, and Linux. The CD also contains this ReadMe file. ============================================================= Registration and Obtaining a Password ============================================================= To install and use MathLM, you must register with Wolfram Research and receive a password. Before registering, you must first begin the installation process according to the instructions in "Basic MathLM Instructions." Midway through the installation process, a MathID number will be displayed on your screen. This MathID number is a machine-specific identification number that is automatically determined when running the installer on a machine. In addition to your MathID number, you will need to provide the activation key located on your license certificate or in your download confirmation email. Once you have your MathID number, log into the Wolfram User Portal at https://user.wolfram.com/portal/passwordrequest.html. Create an account if necessary. You will need to provide your activation key and MathID number to generate a password. Please note that the MathID number for your machine can change under certain circumstances, for example, if you reformat your hard disk. If the MathID number changes and you need assistance getting your password, please contact Wolfram Research at http://www.wolfram.com/support. ============================================================= Basic MathLM Installation Instructions ============================================================= To install MathLM on Windows: Note: To install MathLM on Windows, you must have administrative privileges. 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. Select any previous MathLM installations you want to remove. Click the button labeled Next to continue. Note: If you are installing over a previous version of MathLM, your existing mathpass file, custom settings, and MonitorLM configuration files will not be deleted. 4. Your MathID number is displayed on the dialog box that appears. To obtain your password, complete the form at https://user.wolfram.com/portal/passwordrequest.html (you will be required to sign into the Wolfram User Portal). You will need to provide your activation key and your MathID number. Once you have your password, enter your activation key 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. 5. 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" at http://reference.wolfram.com/network. To install MathLM on Linux and Mac OS X: Note: To install and run MathLM on Linux, you may need root privileges. To install and run MathLM on Mac OS X, you must have administrator privileges. 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, refer to http://reference.wolfram.com/mathematica/tutorial/ MountingACDOrDVDOnLinux.html. Note: This step is not required on Mac OS X and some Linux 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 Linux platforms. Linux: cd /cdrom/Unix Mac OS X: cd /Volumes/MathLM/Macintosh 4. Type the following command and press Enter. Note that on Mac OS X, Return is equivalent to Enter. ./MathLMInstaller 5. Your machine name and MathID number are displayed. To obtain your password, complete the form at https://user.wolfram.com/portal/passwordrequest.html (you will be required to sign into the Wolfram User Portal). You will need to provide your activation key and MathID number. Once you have your password, type the letter c and press Enter to proceed with the installation. 6. Enter your MathLM license ID number as it appears on your electronic or printed license certificate. Then press Enter. 7. Enter your MathLM password. Then press Enter. 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. 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. Note: If you are installing over a previous version of MathLM, your existing mathpass file, custom settings, and MonitorLM configuration files will not be deleted. 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. 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 For information on configuring MathLM with additional options, refer to "Launching MathLM" at http://reference.wolfram.com/network. ============================================================= Testing the MathLM Installation ============================================================= If you want to test whether MathLM is running, you can try finding the process by running MonitorLM, a program that provides a "snapshot" of Mathematica license activity. MonitorLM is automatically included in the MathLM installation. To start MonitorLM: 1. Change directory to the location in which MathLM is installed. 2. On Windows, type .\monitorlm server and press Enter. On Mac OS X and Linux machines, type ./monitorlm server and press Return. The first argument of the monitorlm command specifies the name of the license server running MathLM. If you do not specify a server name explicitly, the local machine name is chosen as the default. For more information about using MonitorLM, including customizing the log file and using command-line options, see "Monitoring MathLM" at http://reference.wolfram.com/network. ============================================================= Further Information ============================================================= For more details about installing or running MathLM, such as options or troubleshooting, please go to http://reference.wolfram.com/network. If you need further assistance, please contact Technical Support at http://www.wolfram.com/support. ============================================================= Wolfram Research Contact and Copyright Information ============================================================= Wolfram Research, Inc. web: www.wolfram.com email: info@wolfram.com phone: +1-217-398-0700 fax: +1-217-398-0747 100 Trade Center Drive Champaign, IL 61820-7237 USA Wolfram Research Europe Ltd. web: www.wolfram.co.uk email: info@wolfram.co.uk phone: +44-(0)1993-883400 fax: +44-(0)1993-883800 10 Blenheim Office Park Lower Road, Long Hanborough Oxfordshire, OX29 8RY UNITED KINGDOM Wolfram Research Asia Ltd. web: www.wolfram.co.jp email: info@wolfram.co.jp Oak Ochanomizu Building 5F 3-8 Kanda Ogawa-machi Chiyoda-ku, Tokyo 101-0052 JAPAN (C) 1988-2014 Wolfram Research, Inc. All rights reserved. Wolfram Research, Inc. makes no representations, express or implied, with respect to the product, including without limitations, any implied warranties of merchantability, interoperability, or fitness for a particular purpose, all of which are expressly disclaimed.