MATLAB Installation Guide for Unix

Installation Procedure

To install the MathWorks products on your UNIX workstation, follow these instructions. If you encounter any problems during the installation process, refer to Chapter 3, Troubleshooting.

1. Log in to your file server.

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.

2. If you are installing from a CD, mount the CD-ROM drive. 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. Place the software CD, or the documentation CD, label face up, into the CD-ROM drive. 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.
3. Create the installation directory and move into it, using the cd command. For example, to install into the location /usr/local/matlabr12, use these commands:

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

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

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

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

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 install script appropriate for your platform.

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

If you are installing software products, the installation script displays the following welcome screen.



If you are installing documentation, the installation script displays the same screen; however, the title bar contains the text Begin Documentation Installation. Click OK to continue.

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. If the pathname for the MATLAB root directory is correct, click OK.



8. Verify your License File in the License File dialog box. 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.

When verifying your License File, check that the expiration date, number of keys, and passcode fields in each INCREMENT line match the license information you received from The MathWorks. To avoid warning messages appearing in the log file when you start MATLAB, delete INCREMENT lines for products with expired licenses. Also 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. If you edit your License File, do not use tabs to separate the fields in an INCREMENT line.

If you prefer to use another text editor to edit your License File, press Cancel. Otherwise, click OK to continue.

9. If you are installing software, go to step 9a. If you are installing documentation, go to step 9b.
1. If you are installing software, the installer displays the Product Installation Options dialog box.

   

This dialog box lists all the products you are licensed to install in the Items to Install box. To remove a product 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.

2. If you are installing documentation, the installer displays the Documentation Installation Options dialog box.

   

This dialog box lists all the documentation you are licensed to install in the Items to Install list box. To remove a item from the list, select it and press the Remove button. To install the Japanese language version of the documentation, click the appropriate check box.

The documentation installation procedure continues with step 11.

10. If you are installing MATLAB, the installer displays the Installation Data dialog box.

Specify the location in your file system for symbolic links to the matlab and mex scripts. Choose a directory such as /usr/local/bin that is common to all your users' paths. The installer fills in the License Number automatically.

Click OK to continue.

11. The installer displays the Start Installation dialog box. Click OK to start 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.

Note    If you have a user-based license, see Setting Up User-Based Licensing for more information.

Distribution

After You Install