Install guide

MATLAB® & Simulink® Release 2008bInstallation Guide for Windows®

How to Contact The MathWorks

www.mathworks.com Webcomp.soft-sys.matlab Newsgroupwww.mathworks.com/contact_TS.html Technical [email protected] Product enhancement [email protected] Bug [email protected] Documentation error [email protected] Order status, license renewals, [email protected] Sales, pricing, and general information

508-647-7000 (Phone)

508-647-7001 (Fax)

The MathWorks, Inc.3 Apple Hill DriveNatick, MA 01760-2098For contact information about worldwide offices, see the MathWorks Web site.Installation Guide for Windows®

© COPYRIGHT 1996–2008 by The The MathWorks™, Inc.The software described in this document is furnished under a license agreement. The software may be usedor copied only under the terms of the license agreement. No part of this manual may be photocopied orreproduced in any form without prior written consent from The MathWorks, Inc.FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentationby, for, or through the federal government of the United States. By accepting delivery of the Programor Documentation, the government hereby agrees that this software or documentation qualifies ascommercial computer software or commercial computer software documentation as such terms are usedor defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms andconditions of this Agreement and only those rights specified in this Agreement, shall pertain to and governthe use, modification, reproduction, release, performance, display, and disclosure of the Program andDocumentation 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 thegovernment’s needs or is inconsistent in any respect with federal procurement law, the government agreesto return the Program and Documentation, unused, to The MathWorks, Inc.

Trademarks

MATLAB and Simulink are registered trademarks of The MathWorks, Inc. Seewww.mathworks.com/trademarks for a list of additional trademarks. Other product or brand namesmay be trademarks or registered trademarks of their respective holders.Patents

The MathWorks products are protected by one or more U.S. patents. Please seewww.mathworks.com/patents for more information.

http://www.mathworks.com/trademarks

http://www.mathworks.com/patents

Revision HistoryDecember 1996 First printing New for MATLAB 5.0 (Release 8)May 1997 Second printing Revised for MATLAB 5.1 (Release 9)March 1998 Third printing Revised for MATLAB 5.2 (Release 10)January 1999 Fourth printing Revised for MATLAB 5.3 (Release 11)November 1999 Fifth printing Revised for MATLAB 5.3.1 (Release 11.1)November 2000 Sixth printing Revised for MATLAB 6.0 (Release 12)June 2001 Seventh printing Revised for MATLAB 6.1 (Release 12.1)July 2002 Eighth printing Revised for MATLAB 6.5 (Release 13) Renamed as

Installation Guide for WindowsJune 2004 Ninth printing Revised for MATLAB 7.0 (Release 14)October 2004 Tenth printing Revised for MATLAB 7.0.1 (Release 14SP1)March 2005 Eleventh printing Revised for MATLAB 7.0.4 (Release 14SP2)September 2005 Twelfth printing Revised for MATLAB 7.1 (Release 14SP3)March 2006 Thirteenth printing Revised for MATLAB 7.2 (Release 2006a)September 2006 Fourteenth printing Revised for MATLAB 7.3 (Release 2006b)March 2007 Online only Revised for MATLAB 7.4 (Release 2007a)September 2007 Online only Revised for MATLAB 7.5 (Release 2007b)March 2008 Online only Revised for MATLAB 7.6 (Release 2008a)October 2008 Online only Revised for MATLAB 7.7 (Release 2008b)

Contents

Standard Installation and ActivationProcedures

1Installing MathWorks Software in a StandaloneEnvironment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Step 1: Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Step 2: Choose Whether to Install Automatically orManually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Step 3: Review the Software License Agreement . . . . . . . . 1-5Step 4: Log In to Your MathWorks Account . . . . . . . . . . . . 1-6Step 5: Select the License You Want to Install . . . . . . . . . . 1-8Step 6: Choose Installation Type . . . . . . . . . . . . . . . . . . . . . 1-10Step 7: Specify Installation Folder . . . . . . . . . . . . . . . . . . . . 1-11Step 8: Specify the Products to Install (Custom Only) . . . . 1-12Step 9: Specify Installation Options (Custom Only) . . . . . . 1-14Step 10: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . 1-15Step 11: Complete the Installation . . . . . . . . . . . . . . . . . . . 1-17

Activating an Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19Step 1: Start the Activation Application . . . . . . . . . . . . . . . 1-19Step 2: Log In to Your MathWorks Account . . . . . . . . . . . . 1-22Step 3: Select the License You Want to Activate . . . . . . . . 1-24Step 4: Select Activation Type . . . . . . . . . . . . . . . . . . . . . . . 1-26Step 5: Specify User Name . . . . . . . . . . . . . . . . . . . . . . . . . . 1-27Step 6: Confirm Your Activation Information . . . . . . . . . . . 1-28Step 7: Complete Activation . . . . . . . . . . . . . . . . . . . . . . . . . 1-29

Installing and Activating Without an InternetConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-31Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-31Step 1: Choose Whether to Install Automatically orManually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-32

Step 2: Review the License Agreement . . . . . . . . . . . . . . . . 1-33Step 3: Specify the File Installation Key . . . . . . . . . . . . . . . 1-34Step 4: Choose Installation Type . . . . . . . . . . . . . . . . . . . . . 1-36Step 5: Specify Installation Folder . . . . . . . . . . . . . . . . . . . . 1-38Step 6: Specify Products to Install (Custom Only) . . . . . . . 1-38

v

Step 7: Specify Installation Options (Custom Only) . . . . . . 1-39Step 8: Confirm Your Choices and Begin Copying Files . . . 1-40Step 9: Complete Installation . . . . . . . . . . . . . . . . . . . . . . . . 1-41Step 10: Activate Your Installation . . . . . . . . . . . . . . . . . . . 1-42Step 11: Specify Path to License File . . . . . . . . . . . . . . . . . . 1-43Step 12: Complete the Activation . . . . . . . . . . . . . . . . . . . . 1-46

After You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-47Starting MATLAB Software . . . . . . . . . . . . . . . . . . . . . . . . . 1-47Validating an Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 1-48Setting Your Initial Current Folder . . . . . . . . . . . . . . . . . . . 1-48Setting Up MATLAB Environment Options . . . . . . . . . . . . 1-48Finding Information About MATLAB Software . . . . . . . . . 1-48

Uninstalling and Deactivating a MATLABInstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-50Uninstalling MathWorks Products . . . . . . . . . . . . . . . . . . . 1-50Deactivating a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-53Running the Uninstall Program Noninteractively . . . . . . . 1-56

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-58Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-58Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59Compilers (for MEX-Files) . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59License Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59Additional Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59

Network Installation Procedure2

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Installing MathWorks Software in a NetworkConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4Step 1: Choose Whether to Install Automatically orManually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

Step 2: Review the Software License Agreement . . . . . . . . 2-7Step 3: Log In to Your MathWorks Account . . . . . . . . . . . . 2-8

vi Contents

Step 4: Select the License You Want to Install . . . . . . . . . . 2-9Step 5: Specify Type of Installation . . . . . . . . . . . . . . . . . . . 2-11Step 6: Specify Installation Folder . . . . . . . . . . . . . . . . . . . . 2-12Step 7: Specify Products to Install . . . . . . . . . . . . . . . . . . . . 2-13Step 8: Specify Location of License File . . . . . . . . . . . . . . . 2-16Step 9: Configure the License Manager Service . . . . . . . . . 2-17Step 10: Specify Installation Options . . . . . . . . . . . . . . . . . 2-18Step 11: Confirm Your Choices . . . . . . . . . . . . . . . . . . . . . . 2-19Step 12: Complete the Installation . . . . . . . . . . . . . . . . . . . 2-22

After a Network Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24Starting and Stopping the License Manager . . . . . . . . . . . . 2-24Monitoring and Managing the License Manager . . . . . . . . 2-24Allowing Access to License Manager Daemons . . . . . . . . . . 2-27

Using an Installer Initialization File (SilentInstaller) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29

Troubleshooting

3Problems During Installation . . . . . . . . . . . . . . . . . . . . . . . 3-2Installer Does Not Start Automatically . . . . . . . . . . . . . . . . 3-2Cannot Browse to Folder Containing License File . . . . . . . 3-2Accessing Activation Options . . . . . . . . . . . . . . . . . . . . . . . . 3-3Product Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

Problems After Installation . . . . . . . . . . . . . . . . . . . . . . . . . 3-7

Index

vii

viii Contents

1

Standard Installation andActivation Procedures

This topic describes how to install and activate the MathWorks™ Release2008b (R2008b) products on a computer running the Microsoft® Windows®operating system (32-bit or 64-bit). Use this procedure if you have anIndividual license or Group license. For information about setting up thenetwork license options, see Chapter 2, “Network Installation Procedure”.

• “Installing MathWorks Software in a Standalone Environment” on page 1-2

• “Activating an Installation” on page 1-19

• “Installing and Activating Without an Internet Connection” on page 1-31

• “After You Install” on page 1-47

• “Uninstalling and Deactivating a MATLAB Installation” on page 1-50

• “System Requirements” on page 1-58

1 Standard Installation and Activation Procedures

Installing MathWorks Software in a StandaloneEnvironment

In this section...

“Step 1: Before You Install” on page 1-2“Step 2: Choose Whether to Install Automatically or Manually” on page 1-3“Step 3: Review the Software License Agreement” on page 1-5“Step 4: Log In to Your MathWorks Account” on page 1-6“Step 5: Select the License You Want to Install” on page 1-8“Step 6: Choose Installation Type” on page 1-10“Step 7: Specify Installation Folder” on page 1-11“Step 8: Specify the Products to Install (Custom Only)” on page 1-12“Step 9: Specify Installation Options (Custom Only)” on page 1-14“Step 10: Confirm Your Choices” on page 1-15“Step 11: Complete the Installation” on page 1-17

Step 1: Before You InstallBefore you run the installer:

• Make sure you have your e-mail address and your MathWorks Accountpassword handy. You will need them to log in to your account duringinstallation. If you have multiple licenses associated with your account,know the number of the license you want to install.

If you don’t have a MathWorks Account, you can create one duringinstallation. However, you must have an Activation Key. An ActivationKey is the unique code that identifies a license. It is used to activate thelicense. The Activation Key also allows licensed end users to associate theirMathWorks Account with a license. Ask the administrator of the license forthe Activation Key.

• Exit any existing copies of MATLAB® software you have running.

• Log in to an account with administrator privileges.

1-2

Installing MathWorks™ Software in a Standalone Environment

• Consider disabling virus-checking software and internet securityapplications on your system for the duration of the installation process.These applications can slow down the installation process or cause it toappear unresponsive (or to hang).

• If you do not have an Internet connection during installation, see “Installingand Activating Without an Internet Connection” on page 1-31.

• If you need to perform a network server or client installation, see Chapter2, “Network Installation Procedure”.

Upgrade InstallationsIf you are upgrading your MATLAB installation to the latest release, TheMathWorks recommends that you install the new version in a new installationfolder. You do not need to delete an existing MATLAB installation beforeinstalling this release. Each release is independent of previous releases andyou can run multiple releases on the same system.

Note If you choose to overwrite an existing installation from a prior release,the installer deletes all the products in your installation folder and installsonly those products included in your current license. This avoids potentialproduct incompatibilities. For example, if your existing installation includes10 products, but your current license only includes 9 of those products, yourMATLAB installation only includes the 9 products in your current license.

Step 2: Choose Whether to Install Automatically orManuallyInsert the DVD into the DVD drive connected to your system or double-clickthe installer file you downloaded from the MathWorks Web site. The installerstarts, displaying the welcome dialog box.

If you are connected to the Internet, the easiest way to install is by selectingthe Install automatically using the Internet option. During installation,you log in to your MathWorks account, select the license you want to install,and follow the prompts on the other installer dialog boxes. Choose to installmanually if you do not have an Internet connection.

1-3


Click Next to proceed with installation.

��

��

If your Internet connection requires a proxy server, click the ConnectionSettings button. You can enter the server name, port, and password in theConnection Settings dialog box. The MathWorks supports several typesof proxy configurations: Basic authentication, Digest authentication, andNTLM authentication.

1-4


Related TopicsIf you are not connected to the Internet during installation, see “Installingand Activating Without an Internet Connection” on page 1-31.

Step 3: Review the Software License AgreementReview the software license agreement and, if you agree with the terms, selectYes and click Next.

After the installation is complete, you can view or print the license agreementusing the file license.txt located in the top-level installation folder.

1-5


��

Step 4: Log In to Your MathWorks AccountEnter the e-mail address and password of your MathWorks Account and clickNext. If you do not have a MathWorks Account, select the I need to createa MathWorks Account option and click Next.

1-6


� �� !��

��

��

Creating a MathWorks AccountEnter your e-mail address, first name, last name, and Activation Key. Tocreate an account, you must provide an Activation Key. A newly createdaccount will not have any licenses associated with it. The Activation Keyidentifies the license you want to install. The administrator contact on thelicense can retrieve the key by visiting the License Center at the MathWorksWeb site. Click Next to create your account.

1-7


� �� "�� "��

�� #�� $��

Because the Activation Key you entered specifies a particular license, theinstaller skips the license selection step.

Step 5: Select the License You Want to InstallSelect a license from the list of licenses associated with your MathWorksAccount and click Next. The list contains the following information aboutthe licenses:

• License number.

• An optional descriptive text label that can help identify the license. Tolabel a license, go to the License Center at the MathWorks Web site. Seethe License Center Help for instructions.

• Information identifying the license option and the activation type. If anactivation type has not yet been set on the license, the word “Unset”appears.

1-8


If you want to install products on a license that is not associated with yourMathWorks Account, select the Enter an Activation Key for a license notlisted option and enter an Activation Key. An Activation Key is the uniquecode that identifies a license. It is used to activate the license. The ActivationKey also allows licensed end users to associate their MathWorks Account witha license. Ask the administrator of the license for the Activation Key.

�� %�� &��%��

�� #�� $��

Specify an Activation KeyIf there are no licenses associated with your account, or if permission toactivate is disabled on the license, you might see the Activation Key dialogbox. Enter an Activation Key and click Next. Ask the Administrator contacton the license for the Activation Key.

1-9


� ��

��

Step 6: Choose Installation TypeIn the Installation Type dialog box, specify whether you want to perform aTypical or Custom installation and click Next.

• Typical — Designed to simplify the installation, choose a Typicalinstallation if you:

- Have an Individual or Group license

- Do not need to specify which products you want to install

- Do not need to access any installation options, such as setting the accesspermissions of installed files

• Custom — Choose a Custom installation if you:

- Need to specify which products to install

- Need access to installation options

1-10


- Need to install the license manager (network license options only)

��'��

��

Step 7: Specify Installation FolderSpecify the name of the folder where you want to install MathWorks products.You can accept the default installation folder or specify the name of a differentinstallation folder. If the folder doesn’t exist, the installer creates it.

When specifying a folder name, do not specify a name that contains the @ sign,an exclamation point (!), the percent character (%), the plus sign (+), or thedollar sign ($) character. The full path of the installation folder must notinclude a folder named private. If you make a mistake while entering a foldername and want to start over using the default folder name, click RestoreDefault Folder. To continue with the installation, click Next.

1-11


��

��

If you chose a typical installation, the installer skips the product selectionand installation options steps.

Step 8: Specify the Products to Install (Custom Only)If you are performing a custom installation, you can specify which productsyou want to install in the Product Selection dialog box. This dialog box listsall the products associated with the license you selected or with the ActivationKey you specified. In the dialog box, all the products are preselected forinstallation. If you do not want to install a particular product, clear the checkbox next to its name.

After selecting the products you want to install, click Next to continue withthe installation. After clicking Next, you might receive a message tellingyou that one or more of the products you selected depend on other products.Consider adjusting your product selection.

1-12


��!� ��

��

If you asked the installer to determine if newer versions of your products areavailable at the MathWorks Web site, the installer displays both versions inthe product list. By default, the latest version is preselected for installation.When there are product updates available, the Product Selection dialog boxincludes a column, called Source, that identifies whether the product willbe installed from the DVD or must be downloaded. For product downloads,the Source column includes information about the size of the download file.The dialog box also includes information about the total download size forall the products you select.

If you do not want to download any product updates, click Select localversions only. This clears the selection of all the product downloads in theproduct list. If you want to install only the latest versions of all products,click Select newest versions.

After selecting the products you want to install, click Next to continue withthe installation.

1-13


�� ()(��! �� *�&�

+�� &��,��! ��

�� '��! ��,��

�� ! ��

��

Step 9: Specify Installation Options (Custom Only)For Custom installations, you can specify several installation options,including:

• Setting the permissions of all installed files to read only. (This option ismore commonly used with network licenses.)

• Determining whether the installer puts shortcuts for MATLAB software inthe Start menu and on the desktop.

• Specifying which files the operating system associates with MATLAB,based on their file extension. For example, if you associate files with the .mfile extension with MATLAB, the operating system identifies the type ofthese files as MATLAB M-file.

After selecting installation options, clickNext to proceed with the installation.

1-14


��

Step 10: Confirm Your ChoicesBefore it begins copying files to your hard disk, the installer displays asummary of your installation choices. To change a setting, click Back. Toproceed with the installation, click Install.

1-15


��

As it copies files to your hard drive, the installer displays a status dialog boxto show the progress of the installation.

Read Product Configuration NotesDepending upon which products you install, the installer might display adialog box containing several types of information:

• Product configuration information — Certain products requireadditional configuration. If you installed one of these products, theinstaller lists the configuration commands in this dialog box. You cancopy this command to your system clipboard for use after the installationis completed.

• Available product updates— If your license identifies products that arenot on the DVD, and you are not currently connected to the Internet or youchose not to download product updates, the installer lists these products inthis dialog box. After installation is complete, you can go to the MathWorksWeb site to download these products.

1-16


Click Next to proceed with the installation.

��

Step 11: Complete the InstallationWhen the installation successfully completes, the installer displays theInstallation Complete dialog box. In this dialog box, you can choose to activatethe software you just installed. You cannot use the software you installeduntil you activate it. The MathWorks recommends activating immediatelyafter installation. If you logged in to your MathWorks Account duringinstallation, your log-in session continues into the activation process. ClickNext to proceed with activation.

If you choose to exit the installer without performing activation, clear theActivate MATLAB option and click Finish (the button label changes). Youcan activate later using the activation application.

1-17


�� &��"�&�� &�� -��. ��

'��!��"��

Related TopicsFor step-by-step instructions on the activation process, see “Activating anInstallation” on page 1-19.

1-18

Activating an Installation


In this section...

“Step 1: Start the Activation Application” on page 1-19“Step 2: Log In to Your MathWorks Account” on page 1-22“Step 3: Select the License You Want to Activate” on page 1-24“Step 4: Select Activation Type” on page 1-26“Step 5: Specify User Name” on page 1-27“Step 6: Confirm Your Activation Information” on page 1-28“Step 7: Complete Activation” on page 1-29

Step 1: Start the Activation ApplicationActivation is a process that verifies licensed use of MathWorks™ products.This process validates the license and ensures that it is not used on morecomputers or by more users than allowed by the license option you haveacquired.

If you let the installer start the activation application, and you were logged into your MathWorks Account during installation, your log in session continuesinto the activation process. In the Activation Welcome dialog box, click Nextto continue.

1-19


��

If you were not logged to your MathWorks Account during installation, or youstarted the activation application independently, you must choose whetherto activate automatically or manually. If you are connected to the Internet,leave the Activate automatically using the Internet option selected. TheMathWorks recommends activating automatically. The option to activatemanually is useful if you do not have an Internet connection. Note that youneed a License File to activate manually.

1-20


�� "��

�� "��

'�� -��

If your Internet connection requires a proxy server, click the AdvancedOptions button. You can enter the server name and port informationin the Proxy Settings dialog box, and access other activation options.The MathWorks supports several types of proxy configurations: Basicauthentication, Digest authentication, and NTLM authentication. See“Accessing Activation Options” on page 3-3 for more information.

Starting the Activation ApplicationYou can start the activation application using any of the following methods:

• Leaving the Activate MATLAB option selected on the InstallationComplete dialog box and clicking Next. The installer starts the activationapplication for you automatically.

1-21


• Clicking the Windows Start menu, going toPrograms > MATLAB > MATLAB R2008b and clicking ActivateMATLAB R2008b.

• Starting a MATLAB installation that has not been activated. Theactivation application starts automatically.

• Clicking the MATLAB Help menu, selecting Licensing, and clickingActivate Software.

Step 2: Log In to Your MathWorks Account

Note If you continued on with activation immediately after installation, andyou logged in to your account during installation, the activation applicationskips this step.

Enter the e-mail address and password of your MathWorks Account and clickNext. If you do not have a MathWorks Account, select the I need to createa MathWorks Account option and click Next.

1-22


� �� !��

��

��

Creating a MathWorks AccountEnter your e-mail address, first name, last name, and Activation Key. Tocreate an account, you must provide an Activation Key. A newly createdaccount will not have any licenses associated with it. The Activation Keyidentifies the license you want to install. The administrator contact on thelicense can retrieve the key by visiting the License Center at the MathWorksWeb site. Click Next to create your account.

1-23


� �� "�� "��

�� #�� $��

Step 3: Select the License You Want to Activate

Note If you continued on with activation immediately after installation,the activation application assumes you want to activate the license you justinstalled and skips this step. Likewise, if you created a new account in theprevious step and specified an Activation Key, the activation application skipsthis step.

Select a license from the list of licenses associated with your MathWorksAccount and click Next. The list contains the following information aboutthe licenses:

• License number

1-24




If you want to install products on a license that is not associated with yourMathWorks Account, select the Enter an activation key for a license notlisted option and enter an Activation Key. An Activation Key is the uniquecode that identifies a license. It is used to activate the license. The ActivationKey also allows licensed end users to associate their MathWorks Account witha license. Ask the administrator of the license for the Activation Key.

�� %�� &��%��

�� #�� $��

1-25


Step 4: Select Activation Type

Note If the license you installed (or selected in the previous step) has theactivation type preset, the activation application skips this step.

Select an activation type for your license. If you want to ensure that youare the only person who can use the software, select the Standalone NamedUser option. If you want to share the installation for nonsimultaneous use byseveral people, choose the Designated Computer option.

After making your selection, click Next to proceed with activation.

��

��

1-26


Step 5: Specify User Name

Note If you picked the Designated Computer activation type for the license,the activation application skips this step. You do not need to specify a username.

If you selected the Standalone Named User activation type, you must specifythe operating system user name of the person who will use the software. Theoperating system user name is the ID under which a user gains access to acomputer. It is also known as computer login name. Standalone Named Useractivation types lock to this user name in addition to the computer host ID. Touse the MathWorks software, you must be logged into the computer as theuser name you specify. By default, the activation application fills in the username of the person running the application.

If you are the administrator of the license, you can activate the licensefor someone else. Select the Someone else option and specify their e-mailaddress, name, and operating system user name. The activation applicationlooks for their MathWorks Account or creates an account for them. ClickNext to continue with activation.

1-27


%�� !��!��

�� "�� !��!��!��

��

/�� --��

Step 6: Confirm Your Activation InformationIf all the information displayed is correct, click Activate.

To activate an installation, the MathWorks creates a License File that islocked to the computer, and to a particular user if you chose the StandaloneNamed User activation type, and copies this License File onto your computer.This License File enables you to run MathWorks products on your computer.The MathWorks also keeps a record of the activation in MathWorks systems.

1-28


)��

��#��

Step 7: Complete ActivationAfter activating your installation, you can run the MathWorks software. Ifyou do not want to run MATLAB now, clear the Start MATLAB option andclick Finish to exit the activation process.

1-29


��. ��

1-30

Installing and Activating Without an Internet Connection


In this section...

“Before You Install” on page 1-31“Step 1: Choose Whether to Install Automatically or Manually” on page 1-32“Step 2: Review the License Agreement” on page 1-33“Step 3: Specify the File Installation Key” on page 1-34“Step 4: Choose Installation Type” on page 1-36“Step 5: Specify Installation Folder” on page 1-38“Step 6: Specify Products to Install (Custom Only)” on page 1-38“Step 7: Specify Installation Options (Custom Only)” on page 1-39“Step 8: Confirm Your Choices and Begin Copying Files” on page 1-40“Step 9: Complete Installation” on page 1-41“Step 10: Activate Your Installation” on page 1-42“Step 11: Specify Path to License File” on page 1-43“Step 12: Complete the Activation” on page 1-46

Before You InstallBefore you run the installer:

• Have your File Installation Key and License File handy. You need boththese items to perform an off-network installation and activation.

The File Installation Key identifies the products you can install. TheLicense File activates the installation, identifying which products youcan run. The administrator contact on the license can retrieve the FileInstallation Key and License File by going to the License Center at theMathWorks Web site.

• Exit any existing copies of MATLAB software that you have running.

• Get administrator privileges on your computer.

1-31


• Consider disabling virus-checking software and Internet securityapplications on your system for the duration of the installation process.These applications can slow down the installation process or cause it toappear unresponsive (or to hang).

If you have an Internet connection, follow the instructions in “InstallingMathWorks Software in a Standalone Environment” on page 1-2. TheMathWorks recommends installing and activating automatically using anInternet connection.

You can use this procedure to install one of the standalone or network licenseoptions. If you use this with a network license option, you must specify theLicense File path and choose whether to configure the license manager. See“Installing MathWorks Software in a Network Configuration” on page 2-4 formore information about these additional steps.

Step 1: Choose Whether to Install Automatically orManuallyInsert the DVD into the DVD drive connected to your system or double-clickthe installer file you downloaded from the MathWorks Web site. The installerstarts, displaying the welcome dialog box. If you do not have an Internetconnection, select the Install manually without using the Internetoption and click Next.

1-32


��

��

Step 2: Review the License AgreementReview the software license agreement and, if you agree with the terms, selectYes and click Next.


1-33


��

Step 3: Specify the File Installation KeyIf you do not have an Internet connection, and choose to install manually, theinstaller displays the File Installation Key dialog box. A File Installation Keyidentifies the products you can install.

If you have the key, select the I have the File Installation Key formy license option, enter the File Installation Key, and click Next. Theadministrator contact on a license can retrieve the File Installation Key fromthe License Center at the MathWorks Web site.

If you do not have the key, select the I do not have the File InstallationKey option and click Next. The Installer will provide you with theinformation you need to get a key.

1-34


� ��.�� $��

��.�� $��"��

�� -�� -��.�� $��

If You Do Not Have the File Installation KeyIf you choose the I do not have the File Installation Key option, theinstaller displays the Installation and Activation Next Steps dialog box. Thisdialog box contains the information you need to retrieve your File InstallationKey from the License Center at the MathWorks Web site, including:

• Host ID of your computer

• Release version number of the MathWorks software (e.g., R2008b)

• Operating system

• Operating system user name (Note that user names are case-sensitive inactivation.)

1-35


• License number or Activation Key (You can get these items from yoursystem administrator.)

Save the information displayed in this dialog box. For example, you can printa copy by clicking Print. Take the information to a computer with an Internetconnection and visit the License Center at the MathWorks Web site. TheMathWorks uses this information to generate a File Installation Key and aLicense File. You must have this information with you when you return tothe computer on which you want to install and activate the software. To exitthe activation process, click Finish.

+��

��. ��

Step 4: Choose Installation TypeIn the Installation Type dialog box, specify whether you want to perform aTypical or Custom installation and click Next.

1-36










��'��

��

1-37




��

��

Step 6: Specify Products to Install (Custom Only)If you are performing a custom installation, you can specify which productsyou want to install in the Product Selection dialog box. This dialog box listsall the products associated with the license you selected or with the Activation

1-38


Key you specified. In the dialog box, all the products are preselected forinstallation. If you do not want to install a particular product, clear the checkbox next to its name.

After selecting the products you want to install, click Next to continue withthe installation.

��!� ��

��

Step 7: Specify Installation Options (Custom Only)For Custom installations, you can specify several installation options,including:



1-39




��

Step 8: Confirm Your Choices and Begin Copying FilesBefore it begins copying files to your hard disk, the installer displays asummary of your installation choices. To change a setting, click Back. Toproceed with the installation, click Install.

1-40


��


Step 9: Complete InstallationWhen the installation successfully completes, the installer displays theInstallation Complete dialog box. In this dialog box, you can choose to activatethe software you just installed. You cannot use the software you installeduntil you activate it. The MathWorks recommends activating immediatelyafter installation. If you logged in to your MathWorks Account duringinstallation, your log-in session continues into the activation process. ClickNext to proceed with activation.

If you choose to exit the installer without performing activation, clear theActivate MATLAB option and click Finish (the button label changes). Youcan activate later using the activation application.

1-41


�� &��"�&�� &�� -��. ��

'��!��"��

Step 10: Activate Your InstallationBecause you were not logged in to your MathWorks Account duringinstallation, or you started the activation application independently, you mustchoose whether to activate automatically or manually. Select the Activatemanually without using the Internet option and click Next.

1-42


�� "��

��

Step 11: Specify Path to License FileTo activate without an Internet connection, you must have a License File.The License File identifies which products you can run. The administratorcontact on the license can retrieve the License File from the License Centerat the MathWorks Web site.

Specify the location of your License File and click Next. If you do not haveyour License File, select the I do not have a license file option and see“When You Do Not Have a License File” on page 1-44 for more information.

1-43


��

��

��

��

When You Do Not Have a License FileIf you are activating manually and do not have your License File, the LicenseFile Retrieval dialog box explains how to get your License File and finishactivation. The dialog box displays the information you will need it to getyour License File, including:

• Host ID

• Release version number (e.g., R2008b)

• Operating system user name (Note that user names are case-sensitive inactivation.)

Save the information displayed in this dialog box. For example, you can printa copy by clicking Print. Take the information to a computer with an Internet

1-44


connection and visit the License Center at the MathWorks Web site. TheMathWorks uses this information to generate a File Installation Key and aLicense File. You must have this information with you when you return to thecomputer on which you want to install and activate the software. To exit theactivation application, click Finish.

Note Your installation will not be activated. You cannot run MATLAB untilyou retrieve your License File.

��

'�� "��+� ��

'�� "��. ��

1-45


Step 12: Complete the ActivationAfter activating your installation, you can run the MathWorks software. Ifyou do not want to run MATLAB now, clear the Start MATLAB option andclick Finish to exit the activation process.

��. ��

1-46

After You Install

After You Install

In this section...

“Starting MATLAB Software” on page 1-47“Validating an Installation” on page 1-48“Setting Your Initial Current Folder” on page 1-48“Setting Up MATLAB Environment Options” on page 1-48“Finding Information About MATLAB Software” on page 1-48

Starting MATLAB SoftwareTo start MATLAB software, you can use any of these methods:

• From the Desktop— Double-click the MATLAB icon (called a shortcut)that the installer creates on your desktop.

• From the Start menu — Click the Start button, select Programs, andmove the pointer over the MATLAB entry. Select the version of MATLAByou want to start and, on the application menu that appears, click theMATLAB entry.

• Using Windows Explorer — Navigate to your MATLAB installationfolder. Expand the MATLAB folder, expand the R2008b folder, and thendouble-click the shortcut to the MATLAB executable, MATLAB R2008b.

1-47


Validating an InstallationThroughout the term of your license, your MATLAB installation periodicallycontacts the The MathWorks™ to verify that your license is up-to-date. If yourlicense is up-to-date, the validation process is transparent. If it determinesthat you need to update your license, the validation process displays a dialogbox giving you the option to update your license.

You can disable validation at the License Center at the The MathWorks Website. See the License Center Help for step-by-step instructions.

Setting Your Initial Current FolderBy default, when you start MATLAB using the shortcut the installer puts onyour desktop, the initial current folder (or startup folder) is the MATLAB folder inyour My Documents folder. You can, however, use any folder as your MATLABinitial current folder. See “Startup Directory for the MATLAB Program”

Setting Up MATLAB Environment OptionsTo include welcome messages, default definitions, or any MATLABexpressions that you want executed every time MATLAB is invoked, create afile named startup.m in the matlabroot\toolbox\local folder. Every time youstart MATLAB, it executes the commands in the startup.m file. The localfolder includes a sample startup file, named startupsav.m, that you canrename and use as a starting point.

Finding Information About MATLAB SoftwareAfter successfully installing MATLAB, you are probably eager to get startedusing it. The following list provides pointers to sources of information andother features you might find helpful in getting started with MATLAB.

Task Description

To get an overview of MATLABand its capabilities

Read the MATLAB Getting Starteddocumentation.

To find out what’s new in thisrelease

Read the Release Notes documentation.

1-48

After You Install

Task Description

To start a product or accessproduct demonstrationprograms

Use the Start button on the MATLABdesktop.

To get information aboutspecific MATLAB features

Choose the Help item on the MATLABmenu bar to view reference and tutorialinformation in hyperlinked HTML form.

To get help with specificquestions you can’t findanswered in the documentation

Go to the MathWorks Web site(www.mathworks.com), click Support, anduse the Technical Support solution searcharea to find more information.

1-49

http://www.mathworks.com


Uninstalling and Deactivating a MATLAB Installation

In this section...

“Uninstalling MathWorks Products” on page 1-50“Deactivating a License” on page 1-53“Running the Uninstall Program Noninteractively” on page 1-56

Uninstalling MathWorks ProductsTo remove MathWorks products from your system, follow this procedure:

1 Shut down the MATLAB software.

2 Start the uninstaller.

On the Windows Start menu, select Settings > Control Panel > Add orRemove Programs. Select MATLAB R2008b from the list of products.(You can also start the uninstaller by navigating to your MATLABinstallation folder, opening the uninstall folder, and double-clickinguninstall.exe.) For information about using an initialization file to runthe uninstaller noninteractively, see “Running the Uninstall ProgramNoninteractively” on page 1-56.

The uninstaller displays a list of products associated with the release youselected.

1-50

Uninstalling and Deactivating a MATLAB® Installation

��!� ��

��0#'%#1��

��/ ��

3 Specify the products you want to remove by selecting the check box next totheir names. If you select MATLAB, you automatically remove all otherMathWorks products as well.

You might receive a message telling you that the product you want touninstall has other products that depend on it. For example, all MathWorksproducts require the MATLAB product. To dismiss the message andcontinue removing products, click OK. To change the products you hadselected for deletion, click Cancel. For more information, see “ProductDependencies” on page 3-6.

If your MATLAB installation folder contains the archive files associatedwith downloaded products, the uninstaller displays a message asking ifyou want to delete these archive files. The installer stores these archivefiles in the matlabroot/archives folder of your installation. To removethese files, click Yes.

1-51


4 (Optional) Specify whether you want to remove your MATLAB preferencesfile.

The MATLAB software stores your environment preferences, such ascommand history and Help favorites, in a set of preference files in a systemfolder associated with your user profile. To find where your preferencesare located, use the prefdir command at the MATLAB prompt, as in thefollowing example.

prefdir

ans =

C:\WINNT\Profiles\username\Application Data\MathWorks\MATLAB\R2008b

where username is the user name of the person running the uninstaller.

By default, the uninstaller does not delete these preference files. If youwant to remove these files, select the Uninstall MATLAB preferencescheck box. When you make this selection, the uninstaller deletes thecontents of your MATLAB preferences folder.

5 To proceed with the removal, click the Uninstall button. The uninstallerdisplays the status of the operation as it progresses and displays a dialogbox when the operation is complete. Click Finish to exit the uninstaller.When you uninstall a MATLAB installation, the uninstaller displays adialog box suggesting that you deactivate the installation. For completeinformation about deactivation, see “Deactivating a License” on page 1-53.

1-52


��. ��

Deactivating a LicenseDeactivating a license renders the MathWorks software unusable on aparticular computer. Deactivating a license and removing the software areseparate steps. You can deactivate a license without removing the softwarefrom your computer.

To deactivate a license on your computer, follow this procedure:

Note When you deactivate a license, you deactivate all the installations ofthat license on a particular computer.

1 Start the deactivation application. There are several ways to start thedeactivation application:

• Click the Windows Start menu and choosePrograms > MATLAB > R2008b > Deactivate MATLAB R2008b.

1-53


• Choose to start deactivation after running the uninstaller.

• Choose to start deactivation after a validation check that finds theinstallation is inactive.

• Choosing the deactivate option from the Help > Licensing menu inthe MATLAB desktop.

• Navigate to your MATLAB installation folder, open the uninstall folder,and double-click deactivate_matlab.exe.

The deactivation application displays the licenses you currently haveinstalled and activated on your system. If you start the application fromwithin MATLAB, the license you are using is preselected.

�� !� ��

��(�� !�

2 Select the license that you want to deactivate and click Deactivate Now.The deactivation application contacts The MathWorks to deactivate thelicense.

1-54


If it can deactivate the license at The MathWorks, the deactivationapplication displays the License Deactivation Complete dialog box. ClickFinish to exit the application.

��. ��

If it cannot contact The MathWorks, the deactivation application displaysthe Deactivation Next Steps dialog box. This dialog box contains thedeactivation string. To complete deactivation, you must go to theMathWorks Web site, log in to your account, click Manage Licenses,and enter the deactivation string. See the License Center help for moreinformation. Click Finish to exit the application.

1-55


(�� -� ��. ��

Running the Uninstall Program NoninteractivelyTo run the uninstaller noninteractively, perform these steps:

Note When run noninteractively, the uninstaller does not automaticallystart the deactivation application.

1 Create an uninstaller initialization file.

The MathWorks provides a template for this file, named uninstaller.ini,located in the uninstall folder in your MATLAB installation folder. Makea copy of this template file and rename it.

copy matlabroot\uninstall\uninstaller.ini C:\temp\my_uninstall.ini

2 Open your copy of the initialization file, using any text editor, and enterall the required information. For example, use the directory parameter tospecify the name of the root folder of the installation you want to remove:

1-56


directory=C:\Program Files\MATLAB\R2008b

In this initialization file, you can specify the name of the products youwant to remove and other parameters. By default, the uninstaller removesall products. If your initialization file is missing a required parameter,the uninstaller stops and writes an error to the output log. Two optionalparameters you might want to set are:

• visible= — By default, when you run the uninstaller in silent mode,the uninstaller still displays the dialog box, even though no interactiveresponse is required. If you want to suppress the display of this dialogbox, set the value of the visible parameter to false.

visible=false

• outlog=— To request that the uninstaller create an output log file thatreports on the status of removing an installation, specify the full path asthe value of the outlog parameter.

outlog=C:\temp\my_uninstall.log

3 Save your changes to the file.

4 Run the uninstaller (uninstall.exe), using the -if flag to specify theinitialization file as a command-line argument.

For example, click the Start button and select the Run option. In the Rundialog box, enter the uninstall command, specifying the full path of theinitialization file as a command-line argument.

uninstall.exe -if C:\temp\my_uninstall.ini

1-57


System Requirements

In this section...

“Windows ” on page 1-58“Graphics” on page 1-59“Compilers (for MEX-Files)” on page 1-59“License Management” on page 1-59“Additional Requirements” on page 1-59

Note For the most up-to-date information about system requirements, go toThe MathWorks Web site (www.mathworks.com).

Windows

32-bit MathWorks Products

Operating System Processors Disk Space RAM

Windows XP(Service Pack 1 or 2)Windows Server2003(Service Pack 1 or 2,R2)Windows Vista™

Intel® Pentium(Pentium 4 andabove)Intel CeleronIntel XeonIntel CoreAMD Athlon™AMD OpteronAMD Sempron

510 MB(MATLAB only)

512 MB(1024recommended)

1-58

http://www.mathworks.com/support/sysreq/current_release/

System Requirements

64-bit MathWorks Products

OperatingSystem

Processors Disk Space RAM

Windows XP(Service Pack 1or 2)Windows Server2003 x64(Service Pack 1or 2, R2)Windows Vista

Intel Pentium(Pentium 4 andabove)Intel CeleronIntel XeonIntel CoreAMD64

510 MB(MATLAB only)

1024 MB(2048recommended)

Disk space requirements vary depending on size of partition. The MATLABinstaller will inform you of the hard disk space requirement for yourparticular partition. Installation size is determined by the installer and canvary for NTFS and FAT formats.

Graphics

• 16-, 24-, or 32-bit OpenGL capable graphics adapter

Compilers (for MEX-Files)For the most up-to-date information about compilers, go to the MathWorksWeb site (www.mathworks.com) and click Support.

License Management

• Some license types require a license server running FLEXnet® 11.4, whichis provided by the MathWorks installer.

• TCP/IP is required on all platforms when using a license server.

Additional Requirements

• Microsoft Word 2002, 2003, or 2007 is required to run MATLAB Notebook

1-59

http://www.mathworks.com


• Microsoft® Excel® 2002, 2003, or 2007 is required to run MATLAB®Builder™ EX and Spreadsheet Link EX.

1-60

2

Network InstallationProcedure

This section describes how to install the MathWorks Release 2008b (R2008b)products on a computer running Microsoft Windows operating system (32-bitor 64-bit). Use this procedure for license options that can be installed ina network configuration, such as Concurrent or Network Named User.For information about performing standalone installations of MathWorksproducts, see Chapter 1, “Standard Installation and Activation Procedures”.

• “Overview” on page 2-2

• “Installing MathWorks Software in a Network Configuration” on page 2-4

• “After a Network Install” on page 2-24

• “Using an Installer Initialization File (Silent Installer)” on page 2-29

2 Network Installation Procedure

OverviewDepending on your network configuration, you might have to perform multipleinstallations:

• Installing the license manager on a server — For networkinstallations, you must install the FLEXnet license manager to controlproduct access. You install the license manager on a server that is availableto all your network users, referred to in this documentation your licenseserver. If you are already running the FLEXnet license manager at yoursite and are familiar with licensing, you can copy the daemons into theproper directories and use your existing installed license manager.

• Installing MathWorks products on a server — If your configurationcalls for users to use MathWorks products from a central location, ratherthan having them installed on their local system, you must install theproduct files on a server. If this server is the same system as your licenseserver (it doesn’t have to be), you can install MathWorks products at thesame time as you install the license manager.

• Installing MathWorks products on each client system — If yournetwork configuration calls for users to install MathWorks products ontheir own systems, and only access the license server over the network,then you must install the product files on each system. The client systemsmust be able to connect to the license server over a network.

You can use the MathWorks installer to perform all these installations — see“Installing MathWorks Software in a Network Configuration” on page 2-4for step-by-step instructions.

Instead of performing the installation procedures interactively, providingthe information requested by each dialog box, you can run the installernoninteractively. In this mode, all the information you would normallyprovide using the installer dialog boxes you enter in an initialization file. Formore information, see “Using an Installer Initialization File (Silent Installer)”on page 2-29.

2-2

Overview

Note For the network license options, you do not need to run the activationapplication to activate the software. Instead, you activate the license serverin the License Center at The MathWorks Web site before you install. Clientinstallations do not need to be activated.

2-3


Installing MathWorks Software in a NetworkConfiguration

In this section...

“Before You Install” on page 2-4“Step 1: Choose Whether to Install Automatically or Manually” on page 2-6“Step 2: Review the Software License Agreement” on page 2-7“Step 3: Log In to Your MathWorks Account” on page 2-8“Step 4: Select the License You Want to Install” on page 2-9“Step 5: Specify Type of Installation” on page 2-11“Step 6: Specify Installation Folder” on page 2-12“Step 7: Specify Products to Install” on page 2-13“Step 8: Specify Location of License File” on page 2-16“Step 9: Configure the License Manager Service” on page 2-17“Step 10: Specify Installation Options” on page 2-18“Step 11: Confirm Your Choices” on page 2-19“Step 12: Complete the Installation” on page 2-22

Note You use this procedure to install the license manager on a server orinstall MathWorks products on a client system. If your configuration calls forthe license manager and MATLAB software to run on the same machine, youcan perform both installations at the same time.

Before You InstallBefore you run the installation program:

• Have your License File handy. For network configurations, you activatethe license before you run the installer on the server. Visit the LicenseCenter at The MathWorks Web site, providing the Host ID of the computeron which you intend to run the license manager. The MathWorks creates a

2-4

Installing MathWorks™ Software in a Network Configuration

License File that you can download from the License Center. You specifythis License File during installation of the license manager on the server.Only the administrator contact on a network license option can activatethe software.

• Exit any existing copies of MATLAB you have running on the system whereyou are performing the installation.

• Shut down the license manager, if it is running. (License serverinstallations only. See “Starting and Stopping the License Manager” onpage 2-24 for more information.)

• Get administrator privileges for the system on which you plan to installMATLAB.

• Consider disabling virus checking software and internet securityapplications on your system for the duration of the installation process.These applications can slow down or cause the installation process toappear to become unresponsive (hang).

If you have many installations to perform, you can create an installerinitialization file and run the installer noninteractively—see “Using anInstaller Initialization File (Silent Installer)” on page 2-29.

Upgrade InstallationsIf you are upgrading your MATLAB installation to the latest release, TheMathWorks recommends that you install the new version in a new installationfolder. You do not need to delete an existing MATLAB installation beforeinstalling this release. You can run multiple versions of MATLAB on thesame system.

Note If you choose to overwrite an existing installation from a prior release,the installer deletes all the products in your installation folder and installsonly those products included in your current license, to avoid potentialproduct incompatibilities. For example, if your existing installation includes10 products, but your current license only includes 9 of those products, yourMATLAB installation only includes the 9 products included in your currentlicense.

2-5


Step 1: Choose Whether to Install Automatically orManuallyInsert the DVD into the DVD drive connected to your system or double-clickthe installer file you downloaded from the MathWorks Web site. The installerstarts, displaying the welcome dialog box.

If you are connected to the Internet, the easiest way to install is by selectingthe Install automatically using the Internet option. During installation,you log in to your MathWorks Account, select the license you want to install,and follow the prompts on the installer dialog boxes. The installer candetermine if newer versions of products that you are installing are availableat The MathWorks Web site and offers you the option of downloading theseupdated versions. Click Next to proceed with installation.

��

��

If your Internet connection requires a proxy server, click the ConnectionSettings button. You can enter the server name and port information in

2-6


the Advanced Options dialog box. The MathWorks supports several typesof proxy configurations: Basic authentication, Digest authentication, andNTLM authentication.

Related TopicsIf you do not have an Internet connection during installation, see “Installingand Activating Without an Internet Connection” on page 1-31. Note that anetwork installation has additional steps.

Step 2: Review the Software License AgreementReview the software license agreement and, if you agree with the terms, selectYes and click Next.


��

2-7


Step 3: Log In to Your MathWorks Account

Note Only the administrator contact on a license can activate a networklicense.

Enter the e-mail address and password of your MathWorks Account and clickNext. If you do not have a MathWorks Account, select the I need to createa MathWorks Account option and click Next.

� �� !��

��

��

Creating a MathWorks AccountEnter your e-mail address, first name, last name, and Activation Key. Tocreate an account, you must provide an Activation Key. A newly createdaccount will not have any licenses associated with it. The Activation Keyidentifies the license you want to install. The administrator contact on the

2-8


license can retrieve the key by visiting the License Center at the MathWorksWeb site. Click Next to create your account.

� �� "�� "��

�� #�� $��

Because the Activation Key you entered specifies a particular license, theinstaller skips the license selection step.

Step 4: Select the License You Want to Install

Note For server or client installations, select a license with one of thenetwork license options.

Select a license from the list of licenses associated with your MathWorksAccount and click Next. The list contains the following information aboutthe licenses:

2-9


• License number.



If you do not see the license you want in the list, select the Enter anactivation key for a license not listed option and enter an Activation Key.An Activation Key is the unique code that identifies a license.

�� !�� %�� &��%��

�� #�� $��

2-10


Step 5: Specify Type of Installation

Note For network installations that include the license manager, you mustchoose the Custom option. For a client installation, you can choose to performeither a typical or custom installation.

In the Installation Type dialog box, specify whether you want to perform aTypical or Custom installation and click Next.









2-11


'�� -��"��

��



2-12


��

��

Step 7: Specify Products to Install

Note For a client installation, do not select the license manager in theproduct list.

You can specify which products you want to install in the Product Selectiondialog box. This dialog box lists all the products you are licensed to install.The products in the list are preselected for installation, with the exceptionof the license manager. You must select the license manager. Each productincludes the online documentation, in compressed form. PDF documentationis only available at the MathWorks Web site.

If you are installing the license manager on a license server, select the licensemanager. If you are setting up a remote access configuration where users will

2-13


run MathWorks products on a central server, and this central server is yourlicense server, leave all the other products in the list selected for installation.

After making your selections, click Next to proceed with the installation.After clicking Next, you might receive a message telling you that one ormore of the products you selected depend on other products. See “ProductDependencies” on page 3-6 for more information.

�� -��

��

Product Selection When Updates Are AvailableIf you chose to download product updates, the installer displays both theversion that exists on the DVD and the new version of the product in theproduct list. The Product Selection dialog box also includes a column, calledSource, that identifies whether the product is going to be downloaded duringinstallation and provides information about the size of the product downloadfile. The dialog box also provides information about the total size of all theproducts to be downloaded.

2-14


By default, the latest version of a product is preselected for installation, butyou can choose which products you want to install. If you do not want todownload any product updates, click the Select local versions only button;this deselects all the product downloads in the product list. If you want toinstall only the latest versions of all products, click Select newest versions.After selecting the products you want to install, click Next to continue withthe installation.

�� ()(��! �� *�&�

+�� &��,��! ��

�� '��! ��,��

�� ! ��

��

2-15


Step 8: Specify Location of License File

Note For a client installation, specify the location of the License File onthe license server.

Specify the path for the License File and click OK.

The License File you specify depends on whether you are installing the licensemanager on a server or installing MathWorks software on a client computerin your network configuration. When installing on a license server, specifythe License File you received from the MathWorks. If you are installingMathWorks software on a client computer, specify the License File in theMATLAB installation folder on your server. See the License AdministrationGuide for information about network configurations.

��%�� .��

��

2-16


License File Processing on Server and ClientDuring a server installation, where you install the license manager, you mustspecify the location of the License File you received from The MathWorks.The installer performs the following processing of this License File:

• Makes a copy of your License File, naming it license.dat, and puts thiscopy in the \flexlm directory of your MATLAB installation directory.

• Adds a SERVER line and a DAEMON line to the file. The SERVER line identifiesthe server (host and port number). The DAEMON line identifies the name ofthe license manager daemon (matlabroot/flexlm/mlm.exe)

During a client installation, where you do not install the license manager,you must specify the location of the License File that the installer processedduring installation of the license manager on the server. The installerperforms this processing of the License File on client systems:

• Makes a copy of the License File on the server, naming it network.lic, andputs the file in the \licenses directory in your MATLAB client installationdirectory.

• Deletes all the product information and the DAEMON line in the License File,leaving the SERVER line. Adds the statement USE_SERVER to the file.

Step 9: Configure the License Manager Service

Note Only for license server installations.

Configuring the license manager service provides automatic startup at systemboot time and centralizes administration of the license manager through theWindows Services control panel. If you choose not to configure the licensemanager service, you can do it later.

2-17


��!�� -�� -��

��

Step 10: Specify Installation OptionsFor Custom installations, you can specify several installation options,including:





2-18


��

Step 11: Confirm Your ChoicesBefore it begins copying files to your hard disk, the installer displays asummary of your installation choices. To change a setting, click Back. Toproceed with the installation, click Install.

2-19


��


Read Product Configuration NotesDepending upon which products you install, the installer might display adialog box containing several types of information:

• Product configuration information — Certain products requireadditional configuration. If you installed one of these products, theinstaller lists the configuration commands in this dialog box. You cancopy this command to your system clipboard for use after the installationis completed.

• Available product updates— If your license identifies products that arenot on the DVD, and you are not currently connected to the Internet or youchose not to download product updates, the installer lists these products inthis dialog box. After installation is complete, you can go to the MathWorksWeb site to download these products.

2-20


Click Next to proceed with the installation.

��

2-21


Step 12: Complete the InstallationWhen the MathWorks Installer finishes, it displays the Installation Completedialog box. Click Finish to exit the installer.

If you installed the license manager as a service, The MathWorks recommendsthat you restart your computer now. The license manager must be running tostart MATLAB. As a service, the license manager gets started automaticallyat system boot time.

��. ��

2-22


If you performed a client installation, the Installation Complete dialog boxgives you the option of starting MATLAB. If you do not want to run MATLABnow, clear the Start MATLAB option and click Finish to exit the activationprocess.

2-23


After a Network Install

In this section...

“Starting and Stopping the License Manager” on page 2-24“Monitoring and Managing the License Manager” on page 2-24“Allowing Access to License Manager Daemons” on page 2-27

For general information about post-installation tasks, see the “After YouInstall” on page 1-47 in Chapter 1, “Standard Installation and ActivationProcedures”.

Starting and Stopping the License ManagerIf you configure the license manager as a service, you can use the WindowsServices control panel to start or stop the license manager service. On theWindows Start menu, select Settings > Control Panel > AdministrativeTools > Services.

You can also use the license management tools available in thematlabroot\flexlm folder. These tools provide better diagnostic messages.

Monitoring and Managing the License ManagerThis section describes several utilities provided by FLEXNET licensingthat you can use to monitor and manage the license manager. Fordetailed information about these utilities, see the FLEXnet LicensingEnd User Manual, included in PDF format in your MATLAB installation(matlabroot\flexlm\enduser.pdf

• “Using the LMTOOLS GUI” on page 2-24

• “Using the lmutil Command Line Utility” on page 2-25

Using the LMTOOLS GUIFLEXnet licensing includes a graphical user interface (GUI), calledLMTOOLS. Using LMTOOLS you can get the status of the license manager,configure the license manager as a service, start and stop the license manager,and perform many other license management tasks. To illustrate, the

2-24


following example shows how to use the LMTOOLS GUI to see the currentstatus of the license manager:

1 Start LMTOOLS by double-clicking the lmtools.exe file in thematlabroot\flexlm folder.

2 Click the Server Status tab.

3 Click the Perform Status Enquiry button. LMTOOLS displays the sameinformation as if you had entered the command lmutil lmstat -a.

Using the lmutil Command Line UtilityOn Windows systems, FLEXnet licensing packages all their licensemanagement utilities in a single, command line executable called lmutil.exe.The installer includes this utility in every server installation in thematlabroot\flexlm folder. To view a list of all the capabilities of the lmutilutility, open a Command Prompt window, go to the matlabroot\flexlm folderand type

2-25


lmutil

The following table lists the names of the most useful tools available throughlmutil.

Utility Description

lmdiag Diagnose license checkout problems.lmdown Shut down all license daemons (both lmgrd and all vendor

daemons) on the license server node.lmhostid Report the host ID of a system.lmreread Make the license manager daemon reread the License File

and start any new vendor daemons.Note: When you use lmreread to reprocess a License Filefor a user-based license, changes to INCLUDE statementsin the associated FLEXnet options file take effect after a15 minute delay.

lmstat Display the status of all network licensing activities.lmswitchr Switch the report log file.lmver Determine the fff version of a library or binary file.

To illustrate, the following example shows how to get the current status ofthe license manager.

Open a DOS command prompt window and enter the lmutil command,specifying the name of the lmstat utility.

lmutil lmstat -a -c "C:\Program Files\MATLAB\R2008b\flexlm\license.dat"

The example uses the -a option to get a verbose listing of available licensesand the -c option to specify the location of the License File to use. You mustspecify the -c option with every tool invoked through lmutil.exe. If yourinstallation path contains spaces, enclose the path in quotes.

View the status information returned.

lmutil - Copyright (c) 1989-2006 by Macrovision Europe Ltd. and/or Macrovision

Corporation. All rights reserved.

2-26


Flexible License Manager status on Thu 7/18/2008 16:57

[Detecting lmgrd processes...]

License server status: 27000@customerj

License File(s) on customerj: C:\Program Files\MATLAB\R2008b\flexlm\license.dat:

customerj: license server UP (MASTER) v.11.4

Vendor daemon status (on customerj):

MLM: UP v11.4

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).

Allowing Access to License Manager DaemonsIf you run the license manager on a server that is protected by a securityfirewall, you must open the firewall to allow client installations tocommunicate with the license manager daemons: mlm.exe and lmgrd.exe. (Forinformation about these daemons, see the License Administration Guide.)

Opening Access to the License Manager DaemonUsing the interface provided by your firewall program, allow access on port27000 for the license manager daemon. This is the default port used tocommunicate with the license manager. If you changed this port number,specify the port number used at your site. For more information aboutspecifying the license manager daemon port number, see the LicenseAdministration Guide.

2-27


Opening Access to the Vendor DaemonThe port used by the vendor daemon is assigned dynamically. If you need toopen access to the vendor daemon in your firewall, you must assign a portfor vendor daemon communication, rather than using this dynamic portassignment. You can then open the assigned port number in your firewall.

To specify the vendor daemon port number, edit the License File on yourlicense server and add the port= syntax to the DAEMON line. For moreinformation about specifying the vendor daemon port number, see the LicenseAdministration Guide.

2-28

Using an Installer Initialization File (Silent Installer)

Using an Installer Initialization File (Silent Installer)If you have many MATLAB installations to perform, and the informationyou need to enter for each installation is the same, you can put thisinformation in an installer initialization file and run the MathWorks Installernoninteractively. The initialization file provides the installer with theinformation that you would otherwise provide using installer dialog boxes.Noninteractive installs (also called silent installs) can save time and preventerrors.

To run the installer noninteractively, perform these steps:

Note You need a File Installation Key to use an initialization file.

1 Create an installer initialization file.

The MathWorks provides an initialization file template, namedinstaller.ini, located in the top-level folder on the MathWorks DVD.Using Windows Explorer, create a copy of this template file in anyconvenient folder, giving it any name you want. For example, you mightcreate the initialization file

C:\temp\my_install.ini

2 Open your copy of the initialization file, using any text editor, and enter allthe required installation information.

The initialization file template includes parameters for all the informationyou need to enter. For example, to specify where you want to installproducts, set the value of the destination parameter to the full path ofthe installation folder.

destination=C:\Program Files\MATLAB\R2008b

There are several required parameters, such as name, company name, andFile Installation Key. If your initialization file is missing a required field,the installer stops the installation and writes an error to the output log.Two optional parameters you might want to set are visible and outlog.

2-29


• visible=— By default, when you run the installer in silent mode, it stilldisplays the dialog boxes as it progresses through the installation, eventhough no interactive response is required. If you want to suppress thedisplay of these dialog boxes during a silent installation, set the value ofthe visible parameter to false.

• outlog= — To request that the installer create an output file thatreports on the status of the installation, specify the full path as the valueof the outlog parameter.

3 Save your changes to the file.

4 Run the installer (setup.exe), using the -if flag to specify the initializationfile as a command-line argument. You must specify the full path of theinitialization file. For example, click the Start menu and select the Runoption. In the Run dialog box, enter

setup.exe -if C:\temp\my_install.ini

2-30

3

Troubleshooting

This chapter provides information that can help you solve common problemsthat you might encounter installing MathWorks software on a PC running theMicrosoft Windows operating system

• “Problems During Installation” on page 3-2

• “Problems After Installation” on page 3-7

If you cannot find a description here that matches your problem, checkthe MATLAB Release Notes documentation that you received with yourMathWorks products. This document contains the most up-to-dateinformation available about products and installation procedures. Installationtroubleshooting information is also available at the MathWorks Web site onthe Support page, www.mathworks.com/support/.

3 Troubleshooting

Problems During Installation

In this section...

“Installer Does Not Start Automatically” on page 3-2“Cannot Browse to Folder Containing License File” on page 3-2“Accessing Activation Options” on page 3-3“Product Dependencies” on page 3-6

Note If the installer appears to become unresponsive (hang), you might wantto turn off any virus-checking software you are running on your system andrestart the installer.

Installer Does Not Start AutomaticallyThe installer should start automatically when you insert the MathWorksDVD into your DVD drive or when you double-click on the installer file youdownloaded from the MathWorks Web site.

If the installer does not start, open a Microsoft Windows Explorer window,select your DVD drive, and double-click the setup.exe program in thetop-level folder.

Cannot Browse to Folder Containing License FileOn computers running the Windows Vista operating system, you might not beable to browse to the folder containing your License File during installation.This can occur because you need to elevate your access level to administratorprivileges when running the installer and the mapped drives you set up as auser will not be available to you as administrator. To workaround this issue,set up a mapped drive as administrator and put the License File in a folder onthe drive before running the installer.

3-2


Accessing Activation Options

Specifying Proxy Server Connection SettingsIf your Internet connection requires a proxy server, click the AdvancedOptions button. You can enter the server name, port, and password inthe Advanced Options dialog box. (When you access this option from theinstaller welcome dialog box, it is called the Connection Settings dialogbox.) The MathWorks supports several types of proxy configurations: Basicauthentication, Digest authentication, and NTLM authentication.

� �� "��"�� 2��

��3$�

Activating Without a MathWorks AccountWhile every user can benefit from having a MathWorks Account, it is possibleto install and run MathWorks software without one. For example, at somesites, some users might not be able to create an account for security reasons.

To activate without providing MathWorks Account information, follow thisprocedure:

3-3

3 Troubleshooting

1 Install the software using the installer. On the installer’s welcome dialogbox, you can choose either to install automatically using the Internet ormanually without using an Internet connection. Select the install manuallywithout using the Internet. You will need a File Installation Key. See“Installing and Activating Without an Internet Connection” on page 1-31.

2 When the installer displays the Installation Complete dialog box, leave theActivate MATLAB option selected and click Next.

3 In the Activation Welcome dialog box:

• Choose Activate automatically using the Internet. To performunassociated activation, you must use the Internet.

• Click Advanced Options. In the Advanced Options dialog box, selectthe Activate without associating to a license option and click OK.

�� !��

��3$�

• When you return to the Activation Welcome dialog box, click Next.

4 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 ActivationKey to identify a license.

3-4


Note The only activation type available for unassociated activation isDesignated Computer.

5 Click Activate.

3-5

3 Troubleshooting

Product DependenciesAfter clicking Next in the Product Selection dialog box, you might receive amessage telling you that one or more of the products that you selected forinstallation have dependencies on other products that were not selected.To dismiss the message and continue with the installation, click OK. Fora Custom installation, if you want to adjust your product selections, clickCancel.

3-6

Problems After Installation

Problems After InstallationAfter a successful installation, you may encounter problems startingMATLAB software. Many of these problems originate in the FLEXnet licensemanager used by the MathWorks products. When a problem occurs, thelicense manager displays an error message in a window on your displayand also writes the message to the FLEXnet log file, lmlog.txt, in thematlabroot\flexlm folder. Read the error message carefully; it providesinformation that can help solve the problem. For information about viewingthe license manager log file, see “Monitoring and Managing the LicenseManager” on page 2-24.

For more complete diagnostic information about an error message, go to TheMathWorks Web site, www.mathworks.com, and click Support. The Supportpage includes a Search facility that lets you search the support database forhelp with an error message by error number. You can also select the errornumber from the License Manager Errors menu.

��

You can also get information about license manager error messages inthe FLEXnet Licensing End User Manual, available in PDF format inmatlabroot\flexlm\enduser.pdf.

3-7

3 Troubleshooting

3-8

Index

IndexAactivating MATLAB software

choosing automatic or manualon systems running Windows 1-19

choosing manual optionon systems running Windows 1-42

completing off-network activationon systems running Windows 1-46

confirming settings 1-28for someone else

on systems running Windows 1-27procedure 1-19selecting a license during activation

on systems running Windows 1-24starting activation application

on systems running Windows 1-17 1-19starting activation application after

off-network installationon systems running Windows 1-42

starting activation application afteroff-network installationson systems running Windows 1-41

starting the activation application 1-21without a MathWorks Account 3-3

activation applicationstarting

on systems running Windows 1-21Activation Key

creating an account during standaloneinstallationson systems running Windows 1-7

specifying 2-10specifying during activation 1-25specifying during standalone installations

on systems running Windows 1-8 to 1-9used to create MathWorks Account

on systems running Windows 1-23activation label

viewing during activationon systems running Windows 1-24

activation typeselecting during activation

on systems running Windows 1-26Advanced Options button

activating without a MathWorks Account 3-3

Ccurrent folder

initial 1-48

Ddaemons

opening access in security firewalls 2-27deactivating 1-53deactivation string

retrieving 1-55Designated Computer activation type

selecting during activationon systems running Windows 1-26

FFile Installation Key

entering for off-network installationon systems running Windows 1-34

obtaining 1-35required for off-network installations

on systems running Windows 1-31firewalls

opening access to license managerdaemons 2-27

FLEXnet®troubleshooting 3-7

Iinitial current folder 1-48initialization files

using with installer 2-29

Index-1

Index

installation folderspecifying

on systems running Windows 1-11specifying for off-network installations

on systems running Windows 1-38specifying in network installations

on systems running Windows 2-12installation options

specifying in network installations 2-18specifying in off-network installations 1-39

installation procedurenetwork 2-4noninteractive 2-29

installation typechoosing during standalone installations

on systems running Windows 1-10choosing typical or custom 1-36choosing typical or custom in network

installationson systems running Windows 2-11

installerrunning noninteractively 2-29

installer initialization filespecifying 2-29

installer.ini 2-29installing

starting the installer manually 3-2turning off virus-checking software during

installation 3-2installing MATLAB

choosing automatic or manual in networkinstallationson systems running Windows 2-6

choosing automatic or manual installationon systems running Windows 1-3

choosing manual for off-network installationson systems running Windows 1-32

in network configurationson systems running Windows 2-1

in standalone environments

on systems running Windows 1-2preparing for installation in standalone

environmentson systems running Windows 1-2

preparing for off-network installationson systems running Windows 1-31

preparing to install in a networkconfigurationon systems running Windows 2-4

setting permission of installed files to readonly 1-39

standard installation procedureson systems running Windows 1-1

installing MATLAB softwarefinishing network installation

on systems running Windows 2-22

LLicense Files

getting the information you need to obtainon systems running Windows 1-44

processing in installationon systems running Windows 2-17

required for off-network installationson systems running Windows 1-31

specifying during activation after off-networkinstallationon systems running Windows 1-43

specifying location in network installationon systems running Windows 2-16

license managerconfiguring in network installation

on systems running Windows 2-17troubleshooting 3-7using the LMTOOLS GUI 2-24utility programs 2-25

license numbersselecting during activation


Index-2

Index

license optionsviewing during activation

on systems running Windows 1-24licenses

selecting during installationon systems running Windows 1-8

selecting in network installationson systems running Windows 2-9

validatingon systems running Windows operating

system 1-48licensing

viewing the log file 3-7lmdiag

diagnosing license checkout problems 2-26lmdown

shutting down the license manager 2-26lmhostid

getting system host ID 2-26lmlog.txt

license manager log file 3-7lmreread

forcing license manager to reprocess theLicense File 2-26

lmstatviewing license manager status 2-26

lmswitchrspecifying the report log file 2-26

LMTOOLSusing the FLEXNET utilities GUI 2-24

lmtools.exeFLEXNET utilities GUI 2-25

lmutil.exelicense manager utilities 2-25

lmverget FLEXnet® version number 2-26

log fileslicense manager 3-7

login namespecifying during activation


MMathWorks Account

creating during activationon systems running Windows 1-23

creating during installationon systems running Windows 1-7

creating for someone else during activationon systems running Windows 1-27

installing without an account 3-3logging in

on systems running Windows 1-6logging in during activation

on systems running Windows 1-22logging in during network installations

on systems running Windows 2-8MATLAB

getting started 1-48starting 1-47

MATLAB installation folderspecifying

on systems running Windows 1-11specifying for off-network installations

on systems running Windows 1-38specifying in network installations


Nnetwork configurations

installing MATLAB softwareon systems running Windows 2-1

network installation procedureinstalling MATLAB in network

configurations 2-4post-installation tasks 2-24

Index-3

Index

Ooperating system user name

specifying during activationon systems running Windows 1-27

overwriting an existing installationindividual installation 1-3 2-5

Pport numbers

opening access in security firewalls 2-27preference files

removing 1-52product files

setting permission to read-only 1-14products

downloading during standalone installationson systems running Windows 1-12

selecting during installationon systems running Windows 1-12

selecting for off-network installationson systems running Windows 1-38

selecting in network installationson systems running Windows 2-13

proxy server settingssetting


Rread-only permission

setting permissions of installed productfiles 1-14

removing a MATLAB installation 1-50using initialization file 1-56

requirements. See system requirementsreviewing software license agreement

for network installationson systems running Windows 2-7


off-network installations 1-33

Ssecurity firewalls

opening access to license managerdaemons 2-27

selecting licensesin network installations

on systems running Windows 2-9on systems running Windows 1-8

selecting productsfor off-network installations

on systems running Windows 1-38in network installations

on systems running Windows 2-13on systems running Windows 1-12

setup.exein noninteractive installations 2-29starting 3-2

shortcutMATLAB shortcut on desktop 1-47

shortcuts to MATLAB executabledeciding where to include them 1-39

silent installationsrunning without screen displays 2-29

software license agreementreviewing

on systems running Windows 1-5reviewing for off-network installations

on systems running Windows 1-33reviewing in network installations

on systems running Windows 2-7Standalone Named User activation type

selecting during activationon systems running Windows 1-26

specifying user name during activationon systems running Windows 1-27

starting MATLAB 1-47troubleshooting 3-7

Index-4

Index

starting MATLAB softwareafter activation is complete

on systems running Windows 1-29startup folder 1-48system requirements 1-58

Ttroubleshooting

during installation 3-2FLEXnet® 3-7starting MATLAB 3-7

Uunassociated activation

defined 3-3uninstall.exe

using the -if option 1-57

uninstalling 1-50using initialization file 1-56

upgrading an installationnetwork installations 2-5standard installations 1-3

user nameselecting during activation


Vvalidating an installation

on systems running Windows operatingsystem 1-48

virus checking softwaredisabling during network installations 2-5

virus-checking softwareturning off during installation 3-2

Index-5

Date post:	31-Aug-2014
Category:	Technology
Upload:	solomon-tmariam
View:	386 times
Download:	4 times

Install guide

Technology