MATLAB Installation Guide for Unix

Installation Procedure

Use this procedure to install the MathWorks products and documentation on your UNIX workstation.

Note    Depending on which products you purchased, you may need to perform this procedure a second time, with the second CD in the set. When you run this procedure for the second CD, steps 1 through 4 need not be repeated. If you encounter any problems during the installation process, refer to Troubleshooting.

1. Log in to your system.

1. Superuser status is required to install the symbolic links that add MATLAB to your users' paths and to edit the system boot script to start the MATLAB license manager automatically at system boot time. If you do not have superuser status, you can still install MATLAB, but MATLAB programs must be invoked using absolute pathnames.

Note    If you have superuser status and you are performing an installation for another user, you will need to update the license options file after the installation is complete. See Setting Up User-Based Licensing for information about updating the installation options file.

2. Mount the CD-ROM drive you intend to use to install MATLAB, following these instructions. (If your system does not require mounting the CD-ROM drive or if you have downloaded your products from the MathWorks Web site, skip ahead to step 3.)
1. Create a directory to be the mount point for the CD-ROM drive. For example,

• mkdir /cdrom

2. Put one of the MathWorks CDs in the CD-ROM drive with the label face up.

• If your CD-ROM drive requires placing the CD in a caddy before inserting it into the drive, make sure the arrow on the caddy is pointing towards the CD-ROM drive.

3. Execute the command to mount the CD-ROM drive on your system. You can install the software from either a locally mounted CD-ROM drive or from a remotely mounted CD-ROM drive. For more information about these options, see Mounting Your CD-ROM Drive.

• On HP systems, if you display a list of all the files on the CD after you mount it, the filenames appear in all capital letters.

3. Create the installation directory and move to it, using the cd command. For example, to install into the location /usr/local/matlab6p5, use these commands.

• cd /usr/local
  mkdir matlab6p5 (needed for first time installation only)
  cd matlab6p5
  

1. Subsequent instructions in this book refer to this directory as $MATLAB.

Note    Do not install MATLAB 6.5 over any previous released version of MATLAB.

4. Move your License File, named license.dat, into the $MATLAB directory. For more information about license files, see Creating a License File. The installer looks for the License File in the $MATLAB directory and, after processing it, moves the License File to $MATLAB/etc during installation.

1. If you are upgrading an existing MATLAB installation, rename the License File in $MATLAB/etc. The installer will not process the new license file if it finds an existing license file in $MATLAB/etc.

5. Run the installation script appropriate for your platform.

1. /cdrom/install* & (Sun, Alpha, IBM, SGI, and Linux platforms)
   /cdrom/INSTALL* & (HP platform)

   The installation script displays the following welcome screen.

   

6. Accept or reject the software licensing agreement displayed. If you accept the terms of the agreement, you may proceed with the installation.
7. Verify the name of the installation directory in the MATLAB Root Directory dialog box and then click OK to continue. If you specify a directory that does not exist, the installer creates it.

   

8. Verify your License File in the License File dialog box and click OK. You can edit the License File in the text window displayed or, if you prefer to use another text editor to edit your License File, press Cancel and use another editor. Make sure you edit the processed version of License File, $MATLAB/etc/license.dat, not the version of the License File you placed in the top-level installation directory in step 4.

Note    If you didn't put a copy of your License File in your $MATLAB directory, the installer displays a License File template. You can modify this template to create a valid License File.

1. When verifying your License File:
   • Make sure that the expiration date, number of keys, and passcode fields in each INCREMENT line match the license information you received from The MathWorks.
   • Delete INCREMENT lines for products with expired licenses. (This avoids the warning messages that appear in your log file when you start MATLAB.)
   • Make sure that your electronic mail program did not cause INCREMENT lines to wrap. You must use the continuation character (\) if INCREMENT lines get too long to fit on one line. Do not use tabs to separate the fields in an INCREMENT line.

9. Select the products and documentation you want to install in the Installation Options dialog box and then click OK to continue.

Note    The installer may display a message box that states that one or more of your licensed products are not available on this CD. These products are either on the other installation UNIX CD in the set or available at The MathWorks Web site, www.mathworks.com. In either case, click Close to continue with this installation and, when it completes, insert the other CD and repeat the installation procedure to install the additional products. To obtain products that have been released since this set of installation CDs was produced, visit the MathWorks Web site, www.mathworks.com, and download them.

1. This dialog box lists all the products and documentation you are licensed to install in the Items to Install box. To remove an item from the Items to install list, select it and press the Remove button. (A MATLAB installation includes MATLAB, the MATLAB Kernel, and the MATLAB Toolbox.)

   Select any additional platforms needed at your site from the column of check boxes. For information about which HP platform option to choose, HP-700 or HP-UX, see Additional System Requirement Notes.

10. Specify where you want to put symbolic links to the matlab and mex scripts the Installation Data dialog box and then click OK to continue.

    

1. Choose a directory such as /usr/local/bin that is common to all your users' paths. The installer fills in the License Number automatically.

11. Click OK to begin the installation.

    

12. After the installation is complete, the installer displays the Installation Complete dialog box, assuming your installation is successful. This dialog box informs you of some optional post-installation setup and configuration steps you may want to perform. See After You Install for more information. Click Exit to dismiss the installer.

Installing MATLAB

Installing MATLAB on a Client System