Install Guide
Install Guide
R2014a
Product enhancement suggestions Bug reports Documentation error reports Order status, license renewals, passcodes Sales, pricing, and general information
508-647-7000 (Phone) 508-647-7001 (Fax) The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098
For contact information about worldwide offices, see the MathWorks Web site. Installation Guide COPYRIGHT 19962014 by The MathWorks, Inc.
The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. No part of this manual may be photocopied or reproduced in any form without prior written consent from The MathWorks, Inc. FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation by, for, or through the federal government of the United States. By accepting delivery of the Program or Documentation, the government hereby agrees that this software or documentation qualifies as commercial computer software or commercial computer software documentation as such terms are used or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern the use, modification, reproduction, release, performance, display, and disclosure of the Program and Documentation by the federal government (or other entity acquiring for or through the federal government) and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the governments needs or is inconsistent in any respect with federal procurement law, the government agrees to return the Program and Documentation, unused, to The MathWorks, Inc.
Trademarks
MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See www.mathworks.com/trademarks for a list of additional trademarks. Other product or brand names may be trademarks or registered trademarks of their respective holders.
Patents
MathWorks products are protected by one or more U.S. patents. Please see www.mathworks.com/patents for more information.
Revision History
December 1996 May 1997 March 1998 January 1999 November 1999 November 2000 June 2001 July 2002 June 2004 October 2004 March 2005 September 2005 March 2006 September 2006 March 2007 September 2007 March 2008 October 2008 March 2009 September 2009 March 2010 September 2010 April 2011 September 2011 March 2012 September 2012 March 2013 September 2013 March 2014
First printing Second printing Third printing Fourth printing Fifth printing Sixth printing Seventh printing Eighth printing Ninth printing Tenth printing Eleventh printing Twelfth printing Thirteenth printing Fourteenth printing Online only Online only Online only Online only Online only Online only Online only Online only Online Online Online Online Online Online Online only only only only only only only
New for MATLAB 5.0 (Release 8) Revised for MATLAB 5.1 (Release 9) Revised for MATLAB 5.2 (Release 10) Revised for MATLAB 5.3 (Release 11) Revised for MATLAB 5.3.1 (Release 11.1) Revised for MATLAB 6.0 (Release 12) Revised for MATLAB 6.1 (Release 12.1) Revised for MATLAB 6.5 (Release 13) Renamed as Installation Guide for Windows Revised for MATLAB 7.0 (Release 14) Revised for MATLAB 7.0.1 (Release 14SP1) Revised for MATLAB 7.0.4 (Release 14SP2) Revised for MATLAB 7.1 (Release 14SP3) Revised for MATLAB 7.2 (Release 2006a) Revised for MATLAB 7.3 (Release 2006b) Revised for MATLAB 7.4 (Release 2007a) Revised for MATLAB 7.5 (Release 2007b) Revised for MATLAB 7.6 (Release 2008a) Revised for MATLAB 7.7 (Release 2008b) Revised for MATLAB 7.8 (Release 2009a) Revised for MATLAB 7.9 (Release 2009b) Revised for MATLAB 7.10 (Release 2010a) Revised for MATLAB 7.11 (Release 2010b) Renamed as Installation Guide Revised for MATLAB 7.12 (Release 2011a) Revised for MATLAB 7.13 (Release 2011b) Revised for MATLAB 7.14 (Release 2012a) Revised for MATLAB 8.0 (Release 2012b) Revised for MATLAB 8.1 (Release 2013a) Revised for MATLAB 8.2 (Release 2013b) Revised for MATLAB 8.3 (Release 2014a)
Contents
Installation and Activation Procedures
1
Installation and Activation . . . . . . . . . . . . . . . . . . . . . . . . . MATLAB and Simulink Student Version . . . . . . . . . . . . . Student Use Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Install Products Using a MathWorks Account . . . . . . . . Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . Step 2: Install Using a MathWorks Account . . . . . . . . . . . . Step 3: Review the Software License Agreement . . . . . . . . Step 4: Log In to Your MathWorks Account . . . . . . . . . . . . Step 5: Select the License You Want to Install . . . . . . . . . . Step 6: Specify the Installation Folder . . . . . . . . . . . . . . . . Step 7: Specify Products to Install . . . . . . . . . . . . . . . . . . . . Step 8: Specify Installation Options . . . . . . . . . . . . . . . . . . Step 9: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . Step 10: Complete the Installation . . . . . . . . . . . . . . . . . . . Upgrade an Existing Installation . . . . . . . . . . . . . . . . . . . . Activate an Installation Using a MathWorks Account . . Step 1: Start the Activation Application . . . . . . . . . . . . . . . Step 2: Choose Whether to Activate Automatically or Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 3: Log In to Your MathWorks Account . . . . . . . . . . . . Step 4: Select the License You Want to Activate . . . . . . . . Step 5: Select an Activation Type . . . . . . . . . . . . . . . . . . . . Step 6: Specify the User Name . . . . . . . . . . . . . . . . . . . . . . . Step 7: Confirm Your Activation Information . . . . . . . . . . . Step 8: Complete the Activation . . . . . . . . . . . . . . . . . . . . . Install Products With a File Installation Key . . . . . . . . . Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1-3 1-3 1-4 1-4 1-6 1-7 1-10 1-11 1-14 1-16 1-18 1-19 1-21 1-22 1-24 1-25 1-25 1-26 1-28 1-31 1-33 1-34 1-35 1-36 1-38 1-38 1-40
Step 2: Install With a File Installation Key . . . . . . . . . . . . Step 3: Review the License Agreement . . . . . . . . . . . . . . . . Step 4: Specify the File Installation Key . . . . . . . . . . . . . . . Step 6: Specify the Installation Folder . . . . . . . . . . . . . . . . Step 7: Specify Products to Install . . . . . . . . . . . . . . . . . . . Step 8: Specify Installation Options . . . . . . . . . . . . . . . . . . Step 9: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . Step 10: Complete the Installation . . . . . . . . . . . . . . . . . . . Activate an Installation Without the Internet . . . . . . . . Step 1: Start the Activation . . . . . . . . . . . . . . . . . . . . . . . . . Step 2: Specify the Path to the License File . . . . . . . . . . . . Step 3: Complete the Activation . . . . . . . . . . . . . . . . . . . . . Installation Management Tasks . . . . . . . . . . . . . . . . . . . . . Start MATLAB Software . . . . . . . . . . . . . . . . . . . . . . . . . . . Update Your License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Your MATLAB Startup Folder . . . . . . . . . . . . . . . . . . . Set Up MATLAB Environment Options . . . . . . . . . . . . . . . Find Information About MATLAB Software . . . . . . . . . . . . Uninstall MathWorks Products . . . . . . . . . . . . . . . . . . . . . Remove Products on Windows Systems . . . . . . . . . . . . . . . . Uninstall Products on Linux Systems . . . . . . . . . . . . . . . . . Uninstall Products on Mac OS X Systems . . . . . . . . . . . . . . Deactivate an Installation . . . . . . . . . . . . . . . . . . . . . . . . . . System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1-42 1-42 1-43 1-46 1-46 1-47 1-49 1-50 1-52 1-52 1-53 1-55 1-57 1-57 1-58 1-58 1-58 1-59 1-60 1-60 1-63 1-63 1-64 1-70
2
Installation Procedures for Administrators . . . . . . . . . . Install on an Individual Computer . . . . . . . . . . . . . . . . . . Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 2-3 2-3 2-3
vi
Contents
Step 2: Choose the Log In Option . . . . . . . . . . . . . . . . . . . . Step 3: Review the Software License Agreement . . . . . . . . Step 4: Log In to Your MathWorks Account . . . . . . . . . . . . Step 5: Choose Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 6: Select the License . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 7: Specify the Installation Folder . . . . . . . . . . . . . . . . Step 8: Specify Products to Install . . . . . . . . . . . . . . . . . . . . Step 9: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . Step 10: Complete the Installation . . . . . . . . . . . . . . . . . . . Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Download Products Without Installation . . . . . . . . . . . . Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Download and Start the Installer . . . . . . . . . . . . . . Step 2: Choose Log In Option . . . . . . . . . . . . . . . . . . . . . . . . Step 3: Review the Software License Agreement . . . . . . . . Step 4: Log In to Your MathWorks Account . . . . . . . . . . . . Step 5: Choose Download Only Option . . . . . . . . . . . . . . . . Step 6: Specify the Download Folder and Platform . . . . . . Step 7: Specify Products to Download . . . . . . . . . . . . . . . . . Step 8: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . Step 9: Complete the Download . . . . . . . . . . . . . . . . . . . . . . Install and Activate the Downloaded Software . . . . . . . . . .
2-5 2-7 2-8 2-9 2-10 2-12 2-12 2-14 2-14 2-15 2-16 2-16 2-16 2-17 2-19 2-20 2-21 2-22 2-23 2-24 2-25 2-26
3
Understanding License Files . . . . . . . . . . . . . . . . . . . . . . . License File Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . License File Search Path . . . . . . . . . . . . . . . . . . . . . . . . . . . Plan Your Network Installation . . . . . . . . . . . . . . . . . . . . . Designing Your Network Installation . . . . . . . . . . . . . . . . . Suggested Installation Procedures . . . . . . . . . . . . . . . . . . Install License Manager Using a File Installation Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 3-2 3-3 3-4 3-5 3-9
3-10 3-10
vii
Step 1: Step 2: Step 3: Step 4: Step 5: Step 6: Step 7: Step 8: Step 9: Step 9:
Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . Select Use a File Installation Key . . . . . . . . . . . . . . Review the Software License Agreement . . . . . . . . Specify the File Installation Key . . . . . . . . . . . . . . . Specify the Installation Folder . . . . . . . . . . . . . . . . Select the License Manager for Installation . . . . . Specify the Location of the License File . . . . . . . . . Configure the License Manager . . . . . . . . . . . . . . . . Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . . Complete the Installation . . . . . . . . . . . . . . . . . . . .
3-12 3-14 3-15 3-15 3-16 3-17 3-18 3-19 3-21 3-22
Install the License Manager Using A MathWorks Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . Step 2: Select Log in with a MathWorks Account . . . . . . . . Step 3: Review the Software License Agreement . . . . . . . . Step 4: Log In to Your MathWorks Account . . . . . . . . . . . . Step 5: Choose Install Option . . . . . . . . . . . . . . . . . . . . . . . . Step 6: Select the License You Want to Install . . . . . . . . . . Step 7: Specify the Installation Folder . . . . . . . . . . . . . . . . Step 8: Select License Manager for Installation . . . . . . . . . Step 9: Specify the Location of the License File . . . . . . . . . Step 10: Configure the License Manager . . . . . . . . . . . . . . . Step 11: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . Step 12: Complete the Installation . . . . . . . . . . . . . . . . . . . Download the License Manager Daemons . . . . . . . . . . . . Provide Products and Licensing Information to Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Install MathWorks Software on Client Systems in Network Configurations . . . . . . . . . . . . . . . . . . . . . . . . . Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1: Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . Step 2: Choose an Installation Method . . . . . . . . . . . . . . . . Step 3: Review the Software License Agreement . . . . . . . . Step 4: Specify the File Installation Key . . . . . . . . . . . . . . . Step 5: Log In to Your MathWorks Account . . . . . . . . . . . . Step 6: Select the License You Want to Install . . . . . . . . . . Step 7: Specify the Installation Folder . . . . . . . . . . . . . . . .
3-24 3-24 3-26 3-28 3-29 3-30 3-31 3-32 3-33 3-34 3-36 3-36 3-38 3-41 3-42
3-43
viii
Contents
Step 8: Specify Products to Install . . . . . . . . . . . . . . . . . . . . Step 9: Specify the License File Location . . . . . . . . . . . . . . Step 10: Specify Installation Options . . . . . . . . . . . . . . . . . Step 11: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . Step 12: Complete the Installation . . . . . . . . . . . . . . . . . . . License Manager Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . Start the License Manager . . . . . . . . . . . . . . . . . . . . . . . . . . Editing Boot Scripts on Linux Systems . . . . . . . . . . . . . . . . Configuring the License Manager to Start Automatically on Mac OS X Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Manage the License Manager . . . . . . . . . . . . . . . . . . . . . . . Install Noninteractively (Silent Installation) . . . . . . . . . When to Install Noninteractively . . . . . . . . . . . . . . . . . . . . . Using an Installer Properties File . . . . . . . . . . . . . . . . . . . . Uninstall Noninteractively . . . . . . . . . . . . . . . . . . . . . . . . .
3-55 3-57 3-58 3-59 3-62 3-63 3-63 3-64 3-66 3-68 3-73 3-73 3-73 3-75
Troubleshooting
4
Problems During Installation . . . . . . . . . . . . . . . . . . . . . . . Installer Does Not Start Automatically . . . . . . . . . . . . . . . . Why is a Product Dependency Message Displayed? . . . . . . How Do I Specify Proxy Server Settings? . . . . . . . . . . . . . . How Can I Activate Without a MathWorks Account? . . . . . Problems After Installation . . . . . . . . . . . . . . . . . . . . . . . . . What Does This License Manager Error Mean? . . . . . . . . . How Do I Allow Access to License Manager Daemons? . . . 4-2 4-2 4-2 4-2 4-3 4-6 4-6 4-7
ix
Contents
1
Installation and Activation Procedures
This chapter describes how to install MathWorks products on your computer and activate your installation. Installation and Activation on page 1-2 MATLAB and Simulink Student Version on page 1-3 Install Products Using a MathWorks Account on page 1-4 Upgrade an Existing Installation on page 1-24 Activate an Installation Using a MathWorks Account on page 1-25 Install Products With a File Installation Key on page 1-38 Activate an Installation Without the Internet on page 1-52 Installation Management Tasks on page 1-57 Uninstall MathWorks Products on page 1-60 Deactivate an Installation on page 1-64 System Requirements on page 1-70
1-2
1-3
1-4
Note While you use an administrator account or root privileges to install the software, you typically do not want to activate the software for an administrative user account. Specify the non-privileged account that will use the software when you activate it. Running MATLAB as a user with administrator privileges or root privileges is not recommended.
Windows Get the name and password for an account on your computer that has administrator privileges. Linux Make sure you have write permissions for the directory where you want to install MATLAB software. Mac OS X Get the name and password of the administrator account on your computer. The administrator account is the user account you set up when you configured your Mac OS X system; this is not your MathWorks Account. During installation, you must enter this name and password in the Authenticate dialog box.
Consider disabling anti-virus software and Internet security applications on your system during installation. These applications can slow the installation process or cause it to appear unresponsive (or to hang). If you do not have an Internet connection during installation, see Install Products With a File Installation Key on page 1-38.
1-5
MathWorks DVD. When you select an installer on the website, you receive the files that the installer needs to run on your selected platform, not the product files. Run the installer to select products that you want to install on the computer where you are logged in. The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on
your platform and whether you download the installer from the MathWorks website or use a DVD. Windows Downloaded installer file If you click Run when you select the installer on the MathWorks website, the installer starts automatically. If you saved the installer instead, double-click the self-extracting installer file in the folder where you saved it. The name of the self-extracting installer file is matlab_release_$ARCH, where release is the release you are installing (for example R2014a) and $ARCH is the selected architecture. The installer should start automatically after file extraction is complete. To restart the installer at a later time, click setup.exe. This file is located in the top level of the folder where you extracted the files. DVD installation Insert the DVD into the DVD drive connected to your system. The installer usually starts automatically. Mac OS X Downloaded installer file Double-click the archive file to extract the files that you downloaded from the MathWorks website. After
1-6
extracting the files, open the installer folder and double-click InstallForMacOSX.app . DVD installation Insert the DVD into the DVD drive connected to your system. When the DVD icon appears on the desktop, double-click the icon to display the DVD contents, and then double-click the InstallForMacOSX icon to begin the installation.
Linux Downloaded installer file Use the unzip command to extract the files from the archive file that you downloaded from the MathWorks website. After extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your system and execute this command:
/path_to_dvd/install &
Depending on how your system is configured, you might have to mount the DVD first. Make sure you mount it with execute permissions, as in the following example. Note that the name of the DVD drive might be different on your system.
mount -o exec /media/cdrom0
1-7
1-8
If your Internet connection requires a proxy server, click Connection Settings. Enter the server name, port, and password in the Connection Settings page. MathWorks supports Basic authentication and Digest authentication proxy configurations.
Note On Windows systems, the installer uses your system proxy settings, by default. If your proxy server requires you to log in, the installer prompts you for your login information.
1-9
1-10
1-11
The Activation Key identifies the license you want to install. The administrator of this license can retrieve the key by visiting the License Center at the MathWorks website. If you purchased MATLAB and Simulink Student Version, your product package includes the Activation Key Note Entering dashes or spaces for the Activation Key is optional. Click Next to create your account.
1-12
Note When you create a new MathWorks Account, you must verify your email address before you can proceed with installation. Before you click Next in the Email Verification Required dialog box, go to your email program, open the message sent to you by MathWorks, and click the verification link. Then return to this dialog box and click Next.
1-13
An Activation Key is the unique code that identifies a license. Use it to activate a license or allow licensed end users to associate their MathWorks Account with a license. The administrator contact on the license can retrieve the key by visiting the License Center on the MathWorks website. If you purchased Student Version, your product package includes the Activation Key or you can visit the License Center at the MathWorks website to retrieve the key.
1-14
1-15
1-16
1-17
1-18
After selecting the products you want to install, click Next to continue with the installation.
Windows
On Windows, the Installation Options dialog box lets you choose whether to put shortcuts for starting MATLAB in the Start menu and on the desktop. After selecting installation options, click Next to proceed with the installation.
Linux
On Linux systems, you can specify whether you want to create symbolic links to the matlab and mex scripts. Specify a folder to which you have write access and that is common to all your users paths, such as /usr/local/bin .
1-19
After selecting installation options, click Next to proceed with the installation.
1-20
1-21
1-22
If you choose to exit the installer without activating the software, clear the Activate MATLAB option and click Finish (the button label changes). Use the activation application to activate the software at a later time. If you havent activated the software, the activation application starts automatically when you start MATLAB.
Related Topics
For step-by-step instructions on the activation process, see Activate an Installation Using a MathWorks Account on page 1-25.
1-23
1-24
1-25
Mac OS X Double-click the activation application icon in the MATLAB application package. To view the contents of the MATLAB application package, right-click (or Ctrl+click) the package and select Show Package Contents.
1-26
If you were not logged in to your MathWorks Account during installation, or you started the activation application independently, you must choose whether to activate automatically or manually. If you are connected to the Internet, leave the Activate automatically using the Internet option selected. MathWorks recommends activating automatically. If you are not connected to the Internet, select Activate manually without the Internet. If you select this option, you need a License File to activate manually. Your License File identifies the products you can run. You may have received this License File from the administrator of the license.
1-27
1-28
1-29
Note When you create a new MATLAB account, you must verify your email address before you can proceed with activation. Before you click Next in the Email Verification Required dialog box, go to your email program, open the message sent to you by MATLAB, and click the verification link. Then return to this dialog box and click Next.
1-30
1-31
Information identifying the license option and the activation type. If an activation type has not yet been set on the license, the word Unset appears. If you want to activate products on a license that is not associated with your MathWorks Account, select the Enter an Activation Key for a license not listed option, enter an Activation Key, and click Next. An Activation Key is the unique code that identifies a license. You can use the key to activate a license or associate a license with your account. Ask the administrator of the license for the Activation Key. Note Entering dashes or spaces for the Activation Key is optional. If you are activating MATLAB and Simulink Student Version, your product package includes the Activation Key or you can visit the License Center at the MathWorks website to retrieve the key.
1-32
1-33
1-34
1-35
1-36
1-37
1-38
Note While you use an administrator account or root privileges to install the software, you typically do not want to activate the software for an administrative user account. Specify the non-privileged account that will use the software when you activate it. Running MATLAB as a user with administrator privileges or root privileges is not recommended.
Windows Systems Get the name and password of the administrator account on your computer. The installer modifies the system registry during installation. Linux Systems Get the root password. You can install MATLAB software without superuser privileges, however, it limits certain installation options. For example, if you want to setup symbolic links to the matlab command, install product files in a protected folder, or edit the system boot script, you must have superuser status. Mac OS X Systems Get the name and password of the administrator account on your computer. The administrator account is the user account you set up when you configured your Mac OS X system; this is not your MathWorks Account. During installation, you must enter this name and password in the Authenticate dialog box, shown below.
Consider disabling virus-checking software and Internet security applications on your system for the duration of the installation process. These applications can slow down the installation process or cause it to appear unresponsive (or to hang).
1-39
If you have an Internet connection, follow the instructions in Install Products Using a MathWorks Account on page 1-4. MathWorks recommends installing and activating using an Internet connection. You can use this procedure to install one of the standalone or network license options. If you use this with a network license option, you must specify the License File path and choose whether to configure the license manager. See Install MathWorks Software on Client Systems in Network Configurations on page 3-44 for more information about these additional steps.
MathWorks DVD. When you select an installer on the website, you receive the files that the installer needs to run on your selected platform, not the product files. Run the installer to select products that you want to install on the computer where you are logged in. The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on
your platform and whether you download the installer from the MathWorks website or use a DVD. Windows Downloaded installer file If you click Run when you select the installer on the MathWorks website, the installer starts automatically. If you saved the installer instead, double-click the self-extracting installer file in the folder where you saved it. The name of the self-extracting installer file is matlab_release_$ARCH, where release is the release you are installing (for example R2014a) and $ARCH is the selected architecture. The installer should start automatically after file extraction is complete.
1-40
To restart the installer at a later time, click setup.exe. This file is located in the top level of the folder where you extracted the files. DVD installation Insert the DVD into the DVD drive connected to your system. The installer usually starts automatically. Mac OS X Downloaded installer file Double-click the archive file to extract the files that you downloaded from the MathWorks website. After extracting the files, open the installer folder and double-click InstallForMacOSX.app . DVD installation Insert the DVD into the DVD drive connected to your system. When the DVD icon appears on the desktop, double-click the icon to display the DVD contents, and then double-click the InstallForMacOSX icon to begin the installation.
Linux Downloaded installer file Use the unzip command to extract the files from the archive file that you downloaded from the MathWorks website. After extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your system and execute this command:
/path_to_dvd/install &
Depending on how your system is configured, you might have to mount the DVD first. Make sure you mount it with execute permissions, as in the following example. Note that the name of the DVD drive might be different on your system.
mount -o exec /media/cdrom0
1-41
1-42
1-43
1-44
the installer. On Windows and Linux systems, you can click Print to print out the information.
2 Go to a computer with an Internet connection and log in to your account
MathWorks uses this information to generate a License File and a File Installation Key for your license.
4 Return to your computer and run the installer again. With the File
Installation Key and a License File, you can install and activate the software without an Internet connection.
1-45
1-46
After selecting the products you want to install, click Next to continue with the installation.
Windows Systems
On Windows, the Installation Options dialog box lets you choose whether to put shortcuts for starting MATLAB in the Start menu and on the desktop. After selecting installation options, click Next to proceed with the installation.
1-47
Linux Systems
On Linux systems, you can specify whether you want to create symbolic links to the matlab and mex scripts. Specify a folder to which you have write access and that is common to all your users paths, such as /usr/local/bin . After selecting installation options, click Next to proceed with the installation.
1-48
1-49
1-50
1-51
1-52
1-53
Host ID. Release number (for example R2014a). Operating system user name (Note that user names are case-sensitive in activation.) Save the information displayed in this dialog box. For example, you can print a copy by clicking Print. Take the information to a computer with an Internet connection and visit the License Center at the MathWorks website. MathWorks uses this information to generate a File Installation Key and a License File. You must have this information with you when you return to the computer on which you want to install and activate the software. To exit the activation application, click Finish. Note Your installation will not be activated. You cannot run MATLAB until you retrieve your License File.
1-54
1-55
1-56
On systems running Windows 8, go to the Windows Start screen or the desktop and click the MATLAB R2014a icon.
On systems running Windows 7, click the Windows Start menu, and then select MATLAB R2014a . On systems running Windows XP, click the Windows Start menu, and then select Programs > MATLAB > R2014a, and click MATLAB R2014a. If you chose to create a shortcut on your desktop during the installation, you can double-click the MATLAB icon on the desktop.
Navigate to matlabroot/bin, where matlabroot is your MATLAB installation folder, and double-click matlab.exe.
1-57
Linux Systems:
Enter the matlab command at the system prompt. If you did not set up symbolic links on the Installation Options dialog box during installation, you must enter the full path name, matlabroot/bin/matlab, where matlabroot is the name of your MATLAB installation folder. Navigate to your installation folder and double-click the MATLAB icon.
Mac OS X Systems:
1-58
Perform any additional configuration by typing the appropriate command at the MATLAB command prompt. For example, to configure the MATLAB Notebook, type notebook -setup. To configure a compiler to work with the MATLAB External Interface, type mex -setup.
Get help with specific questions you cant find answered in the documentation
1-59
On systems running Windows 8, from the Start screen, search for Control Panel. In the Control Panel, select Uninstall a Program in the Programs category. From the list of products displayed, click MATLAB R2014a. On systems running Windows 7, click the Start menu, and select Control Panel. In the Control Panel, select Uninstall a Program in the Programs category. From the list of products displayed, click MATLAB R2014a. On systems running Windows XP, click the Start menu, select Settings > Control Panel > Add or Remove Programs. Select MATLAB R2014a from the list of products and click Change/Remove. Navigate to the matlabroot/uninstall/bin/$ARCH folder, where matlabroot is your MATLAB installation folder and $ARCH is a platform-specific subfolder, such as win64. Double-click the uninstaller executable, uninstall.exe. To learn how to use an uninstaller properties file to run the uninstaller noninteractively, see Uninstall Noninteractively on page 3-75.
1-60
3 In the Uninstall Products dialog box, select the products you want to
remove and click Uninstall. If you select MATLAB, you automatically remove all other MathWorks products.
You might receive a message telling you that the product you want to uninstall has other products that depend on it. For example, all MathWorks products require the MATLAB product. To dismiss the message and continue removing products, click OK. To change the products you had selected for deletion, click Cancel. If you also want to remove your MATLAB user preferences, click the Uninstall MATLAB preference files check box. By default, the uninstaller does not delete these preference files. MATLAB preference files contain your environment settings, such as command history and Help favorites. To find where MATLAB stores your preferences, use the prefdir command at the MATLAB prompt, as in the following example:
1-61
MATLAB installation folder contains the archive files for downloaded products, the uninstaller displays a message asking if you want to delete these archive files. The installer stores these archive files in the matlabroot/archives folder of your installation. To remove these files, click Yes.
5 To proceed with the removal, click the Uninstall button. The uninstaller
displays the status of the operation as it progresses and displays a dialog box when the operation is complete. Click Finish to exit the uninstaller. When you uninstall a MATLAB installation, the uninstaller displays a dialog box suggesting that you deactivate the installation. For more information about deactivation, see Deactivate an Installation on page 1-64.
1-62
rm -rf matlabroot
where matlabroot represents the name of your top-level MATLAB installation folder.
OS X system. Depending on where you installed MATLAB software, you might need administrator privileges to remove it.
2 Exit MATLAB before removing a MATLAB installation. You can use the
1-63
Deactivate an Installation
Deactivating an installation renders the MathWorks software unusable on a particular computer. Deactivation can be a useful way to manage usage of the software on multiple computers. For example, if you want to install and activate the software on a new computer, and youve already performed all the activations allowed by your license, you can deactivate one of your existing installations to enable activation on your new computer. The deactivation process has two parts: the license must be deactivated on your computer and must also be deactivated in MathWorks systems. If you have Internet connectivity, the MathWorks deactivation application can take care of both parts of the process. If you do not have Internet connectivity, the deactivation application disables the software on your computer and gives you a deactivation string. To complete the deactivation process, you must visit the MathWorks website, log in to your account, and deactivate using the deactivation string. When you deactivate a license, you deactivate all the installations of that license on a particular computer. Note Deactivating a license and removing the software are separate activities. You can deactivate a license without removing the software from your computer. For information about removing an installation, see Uninstall MathWorks Products on page 1-60. To deactivate a license on your computer, follow this procedure:
1 Start the deactivation application using any of the following methods.
Choose to start deactivation after running the uninstaller. Choose to start deactivation after a validation check that finds the installation is inactive. Choose the deactivate option from the Help > Licensing menu in the MATLAB desktop. Navigate to your MATLAB installation folder. matlabroot, and launch the deactivation application executable.
1-64
Deactivate an Installation
Window Systems:
matlabroot\uninstall\bin\win64\deactivate_matlab.exe
Linux Systems:
matlabroot/bin/deactivate_matlab.sh
Mac OS X Systems:
/Applications/MATLAB_R2014a.app/bin/deactivate_matlab.sh
On systems running Windows 7, click the Start menu and select MATLAB. The deactivation application should appear on the list. On systems running Windows XP, you can also click the Start menu and choose Programs > MATLAB > R2014a > Deactivate MATLAB R2014a
2 Select the license that you want to deactivate and click Deactivate.
When the deactivation application starts, it displays the licenses you currently have installed and activated on your system. If you start the application from within MATLAB, the license you are using is preselected.
1-65
If your Internet connection requires a proxy server, click the Connection Settings button and enter the server name and port information. Click OK to return to the MathWorks Software Deactivation dialog box.
to contact MathWorks.
If the deactivation application can deactivate the license on your computer and in MathWorks systems, it displays the Deactivation Complete dialog box. Click OK to return to the MathWorks Software Deactivation dialog box, where you can choose to deactivate other licenses.
1-66
Deactivate an Installation
1-67
If the deactivation application can deactivate the license on your computer but not in MathWorks systems, it displays the Deactivation Next Steps dialog box. This dialog box contains the deactivation string. To complete deactivation, you must go to the MathWorks website, log in to your account, and deactivate with the deactivation string. See the License Center help for more information. Click OK to return to the MathWorks Software Deactivation dialog box.
Deactivation string.
Click OK.
dialog box displays an additional column listing the status of the licenses. To deactivate another license, select it from the list and click Deactivate. If you are finished, click Close to exit the deactivation application.
1-68
Deactivate an Installation
1-69
System Requirements
For the most up-to-date information about system requirements, go to the MathWorks website (www.mathworks.com).
1-70
2
Installation for Administrators
Installation Procedures for Administrators on page 2-2 Install on an Individual Computer on page 2-3 Download Products Without Installation on page 2-16
Download products for multiple platforms. Install the downloaded software on one or more computers.
Activation for both installation methods is the same as activation for licensed-end user installations. For more information about activation, see Activate an Installation Using a MathWorks Account on page 1-25.
2-2
MathWorks DVD. When you select an installer on the website, you receive the files that the installer needs to run on your selected platform, not the product files. Run the installer to select products that you want to install on the computer
2-3
where you are logged in. The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on
your platform and whether you download the installer from the MathWorks website or use a DVD. Windows Downloaded installer file If you click Run when you select the installer on the MathWorks website, the installer starts automatically. If you saved the installer instead, double-click the self-extracting installer file in the folder where you saved it. The name of the self-extracting installer file is matlab_release_$ARCH, where release is the release you are installing (for example R2014a) and $ARCH is the selected architecture. The installer should start automatically after file extraction is complete. To restart the installer at a later time, click setup.exe. This file is located in the top level of the folder where you extracted the files. DVD installation Insert the DVD into the DVD drive connected to your system. The installer usually starts automatically. Mac OS X Downloaded installer file Double-click the archive file to extract the files that you downloaded from the MathWorks website. After extracting the files, open the installer folder and double-click InstallForMacOSX.app . DVD installation Insert the DVD into the DVD drive connected to your system. When the DVD icon appears on the desktop, double-click the icon to display the DVD contents, and then double-click the InstallForMacOSX icon to begin the installation.
Linux
2-4
Downloaded installer file Use the unzip command to extract the files from the archive file that you downloaded from the MathWorks website. After extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your system and execute this command:
/path_to_dvd/install &
Depending on how your system is configured, you might have to mount the DVD first. Make sure you mount it with execute permissions, as in the following example. Note that the name of the DVD drive might be different on your system.
mount -o exec /media/cdrom0
2-5
2-6
If your Internet connection requires a proxy server, click Connection Settings. Enter the server name, port, and password in the Connection Settings page. MathWorks supports Basic authentication and Digest authentication proxy configurations.
Note On Windows systems, the installer uses your system proxy settings, by default. If your proxy server requires you to log in, the installer prompts you for your login information.
2-7
2-8
2-9
2-10
1 Select the Enter an Activation Key for a license not listed option. 2 Enter an Activation Key and click Next.
An Activation Key is the unique code that identifies a license. Use it to activate a license or allow licensed end users to associate their MathWorks Account with a license. The administrator contact on the license can retrieve the key by visiting the License Center on the MathWorks website. If you purchased Student Version, your product package includes the Activation Key or you can visit the License Center at the MathWorks website to retrieve the key.
2-11
2-12
Note If the products you select exist in your computers default download location or on a DVD, the installer uses the local files for installation instead of downloading them from the MathWorks Web site. The installer checks if any of the products you selected depend on other products. If there are product dependencies that are not satisfied, the installer issues a warning. Consider adjusting your product selection.
2-13
After selecting the products to install, click Next to continue with the installation.
2-14
If you choose to exit the installer without activating the software, clear the Activate MATLAB option and click Finish (the button label changes). Use the activation application to activate the software at a later time. If you havent activated the software, the activation application starts automatically when you start MATLAB.
Activation
Activation for this procedure is the same as activation for Licensed end users. For more information, see Activate an Installation Using a MathWorks Account on page 1-25.
2-15
When you select an installer from the Web site, you receive the files that the installer needs to run on your selected platform, not the product files.
2-16
Run the installer to select products for Windows, Linux, and Mac OS X platforms. The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on
your platform. Windows If you click Run when you select the installer on the MathWorks Web site, the installer starts automatically. If you saved the installer instead, double-click the self-extracting installer file in the folder where you saved it. The installer should start automatically after file extraction is complete. To restart the installer at a later time, click setup.exe. This file is located in the top level of the folder where you extracted the files. Mac OS X Double-click the archive file to extract the files that you downloaded from the MathWorks Web site. After extracting the files, open the installer folder and double-click InstallForMacOSX.app . Linux Use the unzip command to extract the files from the archive file that you downloaded from the MathWorks Web site and execute this command:
./install
Note You can start the installer from a DVD, however, the installer downloads the product files from the MathWorks Web site instead of using the products on the DVD.
2-17
2-18
If your Internet connection requires a proxy server, click the Connection Settings button. Enter the server name, port, and password in the Connection Settings dialog box. MathWorks supports Basic authentication and Digest authentication proxy configurations.
Note On Windows systems, the installer uses your system proxy settings, by default. If your proxy server requires you to log in, the installer prompts you for your login information.
2-19
2-20
2-21
software. You can accept the default download folder or click Browse to select a different one. If the folder doesnt exist, the installer creates it.
2 Select one or more platforms.
After the download completes, the root folder or directory in the download location includes the installer for each selected platform.
2-22
2-23
2-24
2-25
2-26
3
Installing Network License Options
This topic describes how to activate and install MathWorks products on computers in a network configuration, such as Concurrent or Network Named User. The computers can be running the Microsoft Windows operating system (32-bit or 64-bit), the Linux operating system (64-bit), or the Mac OS X operating system. Understanding License Files on page 3-2 Plan Your Network Installation on page 3-4 Suggested Installation Procedures on page 3-9 Install License Manager Using a File Installation Key on page 3-10 Install the License Manager Using A MathWorks Account on page 3-24 Download the License Manager Daemons on page 3-42 Provide Products and Licensing Information to Clients on page 3-43 Install MathWorks Software on Client Systems in Network Configurations on page 3-44 License Manager Tasks on page 3-63 Install Noninteractively (Silent Installation) on page 3-73 Uninstall Noninteractively on page 3-75
BC9DE773A77D15AF8 VENDOR_STRING=83 HOSTID=DEMO SN=12345 4C9D3348561BE9E3B USER_BASED DUP_GROUP=U SN=12345 1CD148466EF58DF8B USER_BASED DUP_GROUP=U SN=12345 INCREMENT Signal_Toolbox MLM 18 01-sep-2010 1 # END---------cut here-------CUT HERE-------END 6CF74B458BA143DC3 USER_BASED DUP_GROUP=U SN=12345
3-2
argument. You can specify a list of paths to search. When you use the -c option, you explicitly prohibit the searching of the environment variables. When using the -c option, keep in mind the following: If the path to your License File contains a space, enclose the path name in quotation marks. If you are specifying more than one License File, make sure to enclose the entire list of License Files in quotation marks.
2 If no License File is specified at the MATLAB command, MATLAB searches
two environment variables, described in the following table. MATLAB searches the vendor specific environment variable, MLM_LICENSE_FILE first. Environment Variable
MLM_LICENSE_FILE
Purpose Specifies the location of the License File, but only for MathWorks products. (Recommended, because it affects only MathWorks products.) Specifies the location of the License File for all applications using FlexNet licensing on this server.
LM_LICENSE_FILE
MATLAB searches the profile folder of the person starting the program. For licenses that are locked to individual users, the activation application puts the License File in a folder in your user profile.
4 If it doesnt find any License File specified in environment variables or in
your user profile, MATLAB checks the \licenses folder in your MATLAB installation for files named license.dat or any file with the extension .lic.
3-3
There are several possible configurations. You must decide whether users will install MATLAB on their computers or access MATLAB over a network.
2 Install the software on the computers required by the configuration
You must install the license manager on a server and, depending on your configuration, either install MathWorks products on a server or install the products on client systems. You can use the MathWorks installer to perform all of these installations. See Install the Software in a Concurrent License. Note You must activate the license for the installation before you run the installer. To retrieve the License File needed for your configuration, visit the License Center at the MathWorks website. You must provide the Host ID of the system on which you intend to run the license manager when requesting a License File. You specify the location of your License File during installation.
3-4
3-5
Client
Client
Client
If your license server runs the Windows operating system, follow the instructions in the installation guide. Your configuration can include a mixture of systems, e.g., a Linux license server can serve clients running Windows. In remote client access configurations, it can be helpful to give clients a script that sets up a shortcut to the network copy of MATLAB and specifies a default startup folder for MATLAB.
3-6
Client MATLAB
Client MATLAB
Client MATLAB
You use the same basic network installation procedure to install MathWorks products on a client system.
3-7
Installing MathWorks products on each client system If your network configuration calls for users to install MathWorks products on their own systems and only access the license server over the network, then you must install the product files on each system. The client systems must be able to connect to the license server over a network. See Install MathWorks Software on Client Systems in Network Configurations on page 3-44 Instead of performing the installation procedures interactively, providing the information requested by each dialog box, you can run the installer noninteractively. In this mode, you enter into a properties file all the information you would normally provide using the installer dialog boxes. For more information, see Install Noninteractively (Silent Installation) on page 3-73.
3-8
3-9
In this section... Before You Install on page 3-10 Step 1: Start the Installer on page 3-12 Step 2: Select Use a File Installation Key on page 3-14 Step 3: Review the Software License Agreement on page 3-15 Step 4: Specify the File Installation Key on page 3-15 Step 5: Specify the Installation Folder on page 3-16 Step 6: Select the License Manager for Installation on page 3-17 Step 7: Specify the Location of the License File on page 3-18 Step 8: Configure the License Manager on page 3-19 Step 9: Confirm Your Choices on page 3-21 Step 9: Complete the Installation on page 3-22
3-10
4 Specify the operating system type and Host ID of the computer on which
you intend to run the license manager. You can optionally assign a descriptive label to the activation as well. Click Continue.
5 Choose whether to download the License File and File Installation Key
or receive them in email. Click Continue. Shut down the license manager, if it is running. See Start the License Manager on page 3-63 for more information. If you are installing the license manager only, run the installer from the MathWorks website or use a DVD. If you want to install the license manager and the rest of your MathWorks products at the same time, the MathWorks products must be available on your computer or on a DVD. Use the MathWorks installer to download products without installing them, if you dont have a DVD. Make sure you have the correct permissions to perform the installation. If you have questions about this, ask your system administrator.
Windows Systems Get the name and password of the administrator account on your computer. Linux Systems Get the root password. You can install MATLAB software without superuser privileges, however, it limits certain installation options. For example, if you want to set up symbolic links to the matlab command, install product files in a protected folder, or edit the system boot script, you must have superuser status. Mac OS X Systems Get the name and password of the administrator account on your computer. The administrator account is the user account you set up when you configured your Mac OS X system; this is not your MathWorks Account. During installation, you must enter this name and password in the Authenticate dialog box, shown below.
3-11
Consider disabling virus checking software and Internet security applications on your system for the duration of the installation process. These applications can slow down or cause the installation process to appear to become unresponsive (hang). You only need to install the license manager once at a site. For information about installing MathWorks software on clients, see Install MathWorks Software on Client Systems in Network Configurations on page 3-44.
MathWorks DVD. When you select an installer on the website, you receive the files that the installer needs to run on your selected platform, not the product files. Run the installer to select products that you want to install on the computer where you are logged in. The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on
your platform and whether you download the installer from the MathWorks website or use a DVD. Windows
3-12
Downloaded installer file If you click Run when you select the installer on the MathWorks website, the installer starts automatically. If you saved the installer instead, double-click the self-extracting installer file in the folder where you saved it. The name of the self-extracting installer file is matlab_release_$ARCH, where release is the release you are installing (for example R2014a) and $ARCH is the selected architecture. The installer should start automatically after file extraction is complete. To restart the installer at a later time, click setup.exe. This file is located in the top level of the folder where you extracted the files. DVD installation Insert the DVD into the DVD drive connected to your system. The installer usually starts automatically. Mac OS X Downloaded installer file Double-click the archive file to extract the files that you downloaded from the MathWorks website. After extracting the files, open the installer folder and double-click InstallForMacOSX.app . DVD installation Insert the DVD into the DVD drive connected to your system. When the DVD icon appears on the desktop, double-click the icon to display the DVD contents, and then double-click the InstallForMacOSX icon to begin the installation.
Linux Downloaded installer file Use the unzip command to extract the files from the archive file that you downloaded from the MathWorks website. After extracting the files, execute the installer command:
./install
3-13
DVD installation Insert the DVD into the DVD drive connected to your system and execute this command:
/path_to_dvd/install &
Depending on how your system is configured, you might have to mount the DVD first. Make sure you mount it with execute permissions, as in the following example. Note that the name of the DVD drive might be different on your system.
mount -o exec /media/cdrom0
3-14
3-15
3-16
3-17
After making your selections, click Next to proceed with the installation. After clicking Next, you might receive a message telling you that one or more of the products you selected depend on other products.
3-18
3-19
Windows Systems
MathWorks recommends configuring the license manager service. This provides automatic startup at system boot time and centralizes administration of the license manager through the Windows Services control panel. To review the default license manager configuration settings, click View Default Settings. If you choose not to configure the license manager service, you can do it later. Note If you have an existing license manager that you want to continue to use until you install this new one, select the Do NOT configure license manager service option. The installer still installs the license manager files. After installation, you can stop your existing license manager and start your new license manager.
3-20
Mac OS X Systems
To add an entry for the license manager to your system Startup Items folder, leave the option selected and click Next. Specify the user name that will own the license manager process. For security reasons, this name cannot be root.
3-21
3-22
3-23
3-24
2 Select the license to activate. 3 Select the Activation and Installation tab and click Activate. 4 Specify the operating system type and Host ID of the computer on which
you intend to run the license manager. You can optionally assign a descriptive label to the activation as well. Click Continue.
5 Choose whether to download the License File or receive it email. Click
Continue. Shut down the license manager, if it is running. See Start the License Manager on page 3-63 for more information. Make sure you have your email address and your MathWorks Account password handy. You will need them to log in to your account during installation. If you have multiple licenses associated with your account, know the number of the license you want to install. If you dont have a MathWorks Account, you can create one during installation. However, you must have an Activation Key. An Activation Key is the unique code that identifies a license. It is used to activate the license. The Activation Key also allows licensed end users to associate their MathWorks Account with a license. Ask the administrator of the license for the Activation Key. Make sure you have the correct permissions to perform the installation. If you have questions about this, ask your system administrator.
Windows Systems Get the name and password of the administrator account on your computer. Linux Systems Get the root password. You can install MATLAB software without superuser privileges, however, it limits certain installation options. For example, if you want to set up symbolic links to the matlab command, install product files in a protected folder, or edit the system boot script, you must have superuser status. Mac OS X Systems Get the name and password of the administrator account on your computer. The administrator account is the user account you set up when you configured your Mac OS X system; this is not your MathWorks Account. During installation, you must enter this name and password in the Authenticate dialog box, shown below.
3-25
Consider disabling virus checking software and Internet security applications on your system for the duration of the installation process. These applications can slow down or cause the installation process to appear to become unresponsive (hang). You only need to install the license manager once at a site. For information about installing MathWorks software on clients, see Install MathWorks Software on Client Systems in Network Configurations on page 3-44.
MathWorks DVD. When you select an installer on the website, you receive the files that the installer needs to run on your selected platform, not the product files. Run the installer to select products that you want to install on the computer where you are logged in. The installer downloads the products that it needs from MathWorks, if necessary.
2 Start the installer. The method you use to start the installer depends on
your platform and whether you download the installer from the MathWorks website or use a DVD. Windows
3-26
Downloaded installer file If you click Run when you select the installer on the MathWorks website, the installer starts automatically. If you saved the installer instead, double-click the self-extracting installer file in the folder where you saved it. The name of the self-extracting installer file is matlab_release_$ARCH, where release is the release you are installing (for example R2014a) and $ARCH is the selected architecture. The installer should start automatically after file extraction is complete. To restart the installer at a later time, click setup.exe. This file is located in the top level of the folder where you extracted the files. DVD installation Insert the DVD into the DVD drive connected to your system. The installer usually starts automatically. Mac OS X Downloaded installer file Double-click the archive file to extract the files that you downloaded from the MathWorks website. After extracting the files, open the installer folder and double-click InstallForMacOSX.app . DVD installation Insert the DVD into the DVD drive connected to your system. When the DVD icon appears on the desktop, double-click the icon to display the DVD contents, and then double-click the InstallForMacOSX icon to begin the installation.
Linux Downloaded installer file Use the unzip command to extract the files from the archive file that you downloaded from the MathWorks website. After extracting the files, execute the installer command:
./install
3-27
DVD installation Insert the DVD into the DVD drive connected to your system and execute this command:
/path_to_dvd/install &
Depending on how your system is configured, you might have to mount the DVD first. Make sure you mount it with execute permissions, as in the following example. Note that the name of the DVD drive might be different on your system.
mount -o exec /media/cdrom0
3-28
If your Internet connection requires a proxy server, click Connection Settings. Enter the server name, port, and password in the Connection Settings page. MathWorks supports Basic authentication and Digest authentication proxy configurations.
Note On Windows systems, the installer uses your system proxy settings, by default. If your proxy server requires you to log in, the installer prompts you for your login information.
3-29
3-30
3-31
3-32
3-33
3-34
3-35
3-36
Windows Systems
MathWorks recommends configuring the license manager service. This provides automatic startup at system boot time and centralizes administration of the license manager through the Windows Services control panel. To review the default license manager configuration settings, click View Default Settings. If you choose not to configure the license manager service, you can do it later. Note If you have an existing license manager that you want to continue to use until you install this new one, select the Do NOT configure license manager service option. The installer still installs the license manager files. After installation, you can stop your existing license manager and start your new license manager.
3-37
Mac OS X Systems
To add an entry for the license manager to your system Startup Items folder, leave the option selected and click Next. Specify the user name that will own the license manager process. For security reasons, this name cannot be root.
3-38
As it copies files to your hard drive, the installer displays a status dialog box to show the progress of the installation.
3-39
3-40
3-41
location for the license manager files is the matlabroot\etc\$ARCH folder, where matlabroot is your MATLAB installation folder and $ARCH is a platform-specific subfolder.
4 Restart the license manager and configure it as needed.
3-42
3-43
If products are located on a shared DVD or on a server, obtain the File Installation Key from your license administrator. If you are expected to use your MathWorks Account to install products, make sure you have your email address and your MathWorks Account password handy. You will need them to log in to your account during installation.
3-44
If necessary, obtain the Activation Key. If you dont have a MathWorks Account, you need the Activation Key to create one during installation. An Activation Key is the unique code that identifies a license. It also allows licensed end users to associate their MathWorks Account with a license. Obtain the client License File. The License File must include the correct SERVER line for the license server you need to use. Make sure you have the correct permissions to perform the installation. If you have questions about this, ask your system administrator.
Windows Systems Get the name and password of the administrator account on your computer. The installer modifies the system registry during installation. Linux Systems Get the root password. You can install MATLAB software without superuser privileges, however, it limits certain installation options. For example, if you want to setup symbolic links to the matlab command, install product files in a protected folder, or edit the system boot script, you must have superuser status. Mac OS X Systems Get the name and password of the administrator account on your computer. The administrator account is the user account you set up when you configured your Mac OS X system; this is not your MathWorks Account. During installation, you must enter this name and password in the Authenticate dialog box, shown below.
3-45
Consider disabling virus checking software and Internet security applications on your system for the duration of the installation process. These applications can slow down or cause the installation process to appear to become unresponsive (hang). If you have many client installations to perform, you can create an installer initialization file and run the installer noninteractivelysee Install Noninteractively (Silent Installation) on page 3-73.
your platform and whether the license administrator downloaded the installer from the MathWorks website or you are using a DVD. Windows Downloaded installer file Double-click the self-extracting installer file in the folder where the downloaded files are located. The installer should start automatically after file extraction is complete. To restart the installer at a later time, click setup.exe. This file is located in the top level of the folder where you extracted the files. DVD installation Insert the DVD into the DVD drive connected to your system. The installer usually starts automatically. Mac OS X Downloaded installer file Double-click the archive file in the folder where the downloaded files are located. After extracting the files, open the installer folder and double-click InstallForMacOSX.app .
3-46
DVD installation Insert the DVD into the DVD drive connected to your system. When the DVD icon appears on the desktop, double-click the icon to display the DVD contents, and then double-click the InstallForMacOSX icon to begin the installation.
Linux Downloaded installer file Use the unzip command to extract the files from the archive file in the folder where the downloaded files are located. After extracting the files, execute the installer command:
./install
DVD installation Insert the DVD into the DVD drive connected to your system and execute this command:
/path_to_dvd/install &
Depending on how your system is configured, you might have to mount the DVD first. Make sure you mount it with execute permissions, as in the following example. Note that the name of the DVD drive might be different on your system.
mount -o exec /media/cdrom0
3-47
3-48
3-49
3-50
3-51
Note When you create a new MathWorks Account, you must verify your email address before you can proceed with installation. Before you click Next in the Email Verification Required dialog box, go to your email program, open the message sent to you by MathWorks, and click the verification link. Then return to this dialog box and click Next.
3-52
Because the Activation Key you entered specifies a particular license, the installer skips the license selection step.
3-53
Information identifying the license option and the activation type. If you do not see the license you want in the list, select Enter an Activation Key for a license not listed and enter an Activation Key.
3-54
3-55
3-56
3-57
On Windows Systems
On Windows, the Installation Options dialog box lets you choose whether to put shortcuts for starting MATLAB in the Start menu and on the desktop. After selecting installation options, click Next to proceed with the installation.
On Linux Systems
On Linux systems, you can specify whether you want to create symbolic links to the matlab and mex scripts. Specify a folder to which you have write access and that is common to all your users paths, such as /usr/local/bin . After selecting installation options, click Next to proceed with the installation.
3-58
3-59
3-60
3-61
3-62
Windows Systems
You can start the license manager on Windows systems using any of the following methods:
3-63
Use the Windows Services control panel to start or stop the license manager, if you chose to configure it as a service during installation. On the Windows Start menu, select Settings > Control Panel > Administrative Tools > Services Use the license management utility, lmtools.exe, included in your MATLAB installation in the matlabroot\etc\$ARCH folder, where $ARCH is a platform-specific subfolder. Start the lmtools.exe application and select the Start/Stop/Reread tab.
Note A user other than root should run the lmstart script because it is a security risk to run any program as root that does not require root permissions. The license manager (lmgrd) does not require root permissions. If you must start the license manager as root, use the su command to start lmgrd as a nonprivileged user:
su username -c "lmgrd -c license_file -l /var/tmp/LM_TMW.log"
3-64
describe how to insert these Bourne shell code fragments for all supported platforms:
1 Log in as root. 2 Create the following links, if they do not already exist.
your platform in the following table. Distribution Debian or SUSE Red Hat or Fedora Core Command
cp matlabroot/etc/flexnet.boot.linux /etc/init.d/flexnet cp matlabroot/etc/flexnet.boot.linux /etc/rc.d/init.d/flexnet
4 Edit the copy you made of the boot script file, named flexnet in the
previous step, replacing the username argument to the lmboot_TMW script in the code with a valid user name, other than root. For security reasons the license manager daemons cannot be owned by superuser.
5 Look in /etc/inittab for the default run level. 6 Create a link in the rc folder associated with the default run level. The
following table lists the appropriate commands for supported Linux distributions for 64-bit systems, where rc<runlevel> represents the appropriate run level directory for your operating system. Distribution Debian Red Hat or Fedora Core SUSE Command
cd /etc/rc<runlevel>.d; ln -s ../init.d/flexnet S90flexnet cd /etc/rc.d/rc<runlevel>.d; ln -s ../init.d/flexnet S90flexnet cd /etc/init.d/rc<runlevel>.d; ln -s ../flexnet S90flexnet
3-65
7 Make sure that the license manager boot scripts start at the very end of
the boot sequence. For the license manager to start correctly, the network must already be running. Use whatever mechanism your version of Linux provides to ensure the boot sequence. For example, on systems running SUSE version 10, you can specify the boot sequence in the .depend.start file in the /etc/init.d folder. To ensure that the license manager is started after networking, append the following to the end of /etc/init.d/.depend.start file:
flexnet: network
On some systems, simply renaming the S90flexnet symlink, created in step 6, to a higher number, such as S99flexnet, will ensure that the license manager starts after networking is running. For the most current information about the boot scripts, see this solution: How do I get the FLEXnet License Manager to start automatically at boot time on Linux or Solaris?
folder.
4 Run the config_lm.sh script, which is included in the /etc/MATLABlmgr
folder. Open a terminal window (run the Terminal program in /Applications/Utilities) and in the Terminal window enter the commands:
cd /Library/StartupItems/MATLABLmgr ./config_lm.sh
3-66
5 Enter the name of the folder where your MathWorks products are
whoami command as the default. Accept the default or enter a different user name.
7 When the script finishes, restart your machine.
During startup, the message Starting MATLAB License Manager should appear on the screen.
/Library/StartupItems/MATLABLmgr
and click Go. A window titled MATLABLmgr appears, containing several files.
3 Rename the file StartupParameters.plist to
StartupParameters_disabled.plist.
You can re-enable the license manager to start at startup by following steps 1 to 3 above and renaming StartupParameters_disabled.plist back to StartupParameters.plist.
3-67
/Library/StartupItems/MATLABLmgr
and click Go. A window titled MATLABLmgr appears, containing several files.
3 Drag the MATLABLmgr folder to the trash, and then select Empty Trash
matlabroot\etc\$ARCH folder, where matlabroot is your MATLAB installation folder and $ARCH is a platform-specific subfolder, such as win64.
2 Select the Server Status tab. 3 Click the Perform Status Enquiry button. LMTOOLS displays the same
3-68
The -a option requests a verbose listing. You must also include the-c option to specify the License File to use. You must use this with every lmutil option. If your installation path contains spaces, enclose the path in quotes. The following is a portion of the information returned.
3-69
lmutil - Copyright (c) 1989-2010 Flexera Software Inc. All Rights Reserved. Flexible License Manager status on Tue 11/5/2014 10:11 [Detecting lmgrd processes...] License server status: 27000@ah-jcustomer License File(s) on customerj: C:\Program Files\MATLAB\R2013b\etc\license.dat: customerj: license server UP (MASTER) v.11.9 Vendor daemon status (on ah-jcustomer): MLM: UP v11.9 Feature usage info: Users of MATLAB: (Total of 5 licenses available) Users of SIMULINK: (Total of 5 licenses available) Users of Control_Toolbox: (Total of 5 licenses available) Users of Identification_Toolbox: (Total of 5 licenses available).
To get help for a particular utility, type the name of the utility with the -h option, as in the following;
lmutil lmstat -h
On Linux and Mac OS X systems, these license management utilities are individual executables, available in the matlabroot/etc folder. For example, to view the status of the license manager, use the lmstat utility, as follows:
lmstat -a lmutil - Copyright (c) 1989-2010 Flexera Software Inc. All Rights Reserved. Flexible License Manager status on Tue 11/5/2013 10:11
3-70
License server status: 27000@ah-jcustomer License File(s) on customerj: /user/local/MATLAB/R2013b/etc/license.dat: customerj: license server UP (MASTER) v.11.9 Vendor daemon status (on customerj): MLM: UP v11.9 Feature usage info: Users of MATLAB: (Total of 5 licenses available) Users of SIMULINK: (Total of 5 licenses available)
To get help for a particular utility, use the -h option, as in the following;
lmstat -h
The following table lists the names of the most useful license management tools included. Utility
lmdiag lmdown lmhostid lmreread
Description Diagnose license checkout problems. Shut down all license daemons (both lmgrd and all vendor daemons) on the license server node. Report the host ID of a system. Make the license manager daemon reread the License File and start any new vendor daemons. Note: When you use lmreread to reprocess a License File for a user-based license, changes to INCLUDE statements in the associated FlexNet options file take effect after a 15-minute delay.
lmstat
3-71
Utility
lmswitchr lmver
Description Switch the report log file. Determine the version of a library or binary file.
3-72
Make a copy of the installer properties file template, named installer_input.txt. This file is located in the top-level folder on the MathWorks DVD or in the top level of the folder where you downloaded the software (typically,
C:\Users\user\AppData\Local\Temp\mathworks_downloads).
3-73
for all the specified parameters. For example, to specify where you want to install products, set the value of the destinationFolder= parameter to the full path of the installation folder.
destinationFolder=C:\Program Files\MATLAB\R2013b
The installer properties file template contains descriptions of each parameter along with valid values. Specify your File Installation Key as the value of the fileInstallationKey= parameter.
3 Save your changes to the file. 4 Start the installer using the -inputFile option to specify the full path of
your installer properties file as a command-line argument. For example, on Windows systems, click the Start menu and select the Run option. In the Run dialog box, enter
setup.exe -inputFile C:\temp\my_installer_input.txt
For information about specifying an installer properties file on Linux and Mac OS X systems, see the instructions in the installer properties file template.
3-74
Uninstall Noninteractively
Uninstall Noninteractively
Note For information about installing MATLAB noninteractively, see Install Noninteractively (Silent Installation) on page 3-73. To run the uninstaller noninteractively, perform these steps:
1 Create an uninstaller properties file.
Make a copy of the uninstaller properties file template, named uninstaller_input.txt, located in the uninstall folder in your MATLAB installation folder. For example, on a Windows system, you might execute this command:
copy matlabroot\uninstall\uninstaller_input.txt C:\temp\my_uninstall.txt
2 Open your uninstaller properties file using any text editor, and enter
values for all the specified parameters. For example, you can specify the name of the output log file using the outputFile= parameter. The template contains detailed descriptions of each parameter with examples. By default, the uninstaller removes all the products in a particular MATLAB installation, however, you can specify which products to delete. In the product list in the template, remove the comment character at the beginning of the product name. In silent mode, if you specify a product for deletion that is not one of your installed products, the uninstaller exits and writes a message to your log file. If you specified mode=automated, the uninstaller displays the Product Selection dialog box and pauses, waiting for you to adjust the product selection.
3 Save your changes to the file.
3-75
the properties file as a command-line argument. For example, click the Start button and select the Run option. In the Run dialog box, enter the uninstall command, specifying the full path of the properties file as a command-line argument:
uninstall.exe -inputFile C:\temp\my_uninstall.txt
3-76
4
Troubleshooting
This topic provides information that can help you solve common problems that you might encounter installing MathWorks software. Problems During Installation on page 4-2 Problems After Installation on page 4-6 If you cannot find a description here that matches your problem, check the MATLAB Release Notes documentation that you received with your MathWorks products. That document contains the most up-to-date information available about products and installation procedures. Installation troubleshooting information is also available at the MathWorks Web site on the Support page, www.mathworks.com/support/.
Troubleshooting
Note If the installer appears to become unresponsive (hang), you might want to turn off any virus-checking software you are running on your system and restart the installer.
4-2
supports several types of proxy configurations: Basic authentication and Digest authentication. To specify proxy information during installation, click Connection Settings in the first dialog box displayed by the installer. To specify proxy information during activation, click Advanced Options in the first dialog box displayed by the activation application. (For information about Unassociated Activation, see How Can I Activate Without a MathWorks Account? on page 4-3.)
Enter server name, port, and other required information.
Click OK.
4-3
Troubleshooting
1 Get a File Installation Key for the license you want to install. The
administrator on the license can obtain this key from the MathWorks License Center.
2 Start the MathWorks installer. Insert the DVD into your DVD drive and
Install without using the Internet option. Both paths let you specify your File Installation Key.
4 When the installation is complete and the installer displays the Installation
Complete dialog box, leave the Activate MATLAB option selected and click Next.
5 In the MathWorks Software Activation dialog box:
Choose Activate automatically using the Internet. To perform unassociated activation, you must use the Internet. Click Advanced Options. In the Advanced Options dialog box, select the Activate without associating to a license option and click OK.
4-4
Click OK.
When you return to the MathWorks Software Activation dialog box, click Next.
6 Enter an Activation Key in the Activation Key dialog box and click Next.
Because you are not logged into an account, you must enter an Activation Key to identify a license. Note The only activation type available for unassociated activation is Designated Computer.
7 Click Activate.
4-5
Troubleshooting
www.mathworks.com/support/install.
2 Select the License Manager category at the top of the page and click
Find.
3 Select the error number from the License Manager Errors menu in the
Select an error.
4-6
You can also get information about license manager error messages in the License Administration Guide for the FlexNet Publisher Licensing Toolkit, available in PDF format in matlabroot\etc\LicenseAdministration.pdf.
4-7