Home

Installation Guide for Windows

1. 2 5 Step 1 Before You Install 0 0 0 cece nes 2 6 Step 2 Start the Installer 0 0 ccc ene 2 8 Step 3 Enter Identification and License Information 2 8 Step 4 Specify Location of License File 2 9 Step 5 Review the Software Licensing Agreement 2 10 Step 6 Specify Type of Installation 04 2 11 Step 7 Specify Folder and Products 0055 2 13 Step 8 Configure the License Manager as a Service 2 14 Step 9 Specify Installation Options 04 2 15 Step 10 Confirm Your Choices 0 000 ee ee eeee 2 16 Step 11 Read Product Configuration Notes 2 17 Step 12 Complete the Installation 04 2 18 Installing MATLAB on a Client System 2 21 License File Location 0 0 0 cece eee ene ene 2 22 Setting Up Network Named User Licensing 2 23 Checking the FLEX m Options File 2 23 License Management Licensing Components 0 0 0 0 e cece eens 3 2 License Management Daemons 000 ee susu 3 2 Licensing Information 0 0000 cece eee eens 3 3 Creating a License File 0 0 ccc ee ees 3 5 License File Processing on a License Server 3 6 License File Processing on Client Systems 3 7 Managing the License Manager 004 3 8 Installing t
2. Note You must restart the license manager after making any changes to the License File on the license server e Check your License File to see if you are licensed to use this product Your license file should contain an INCREMENT line for each licensed product e Make sure that your License File does not contain extra carriage returns or tabs To avoid this make sure that each line begins with either SERVER DAEMON or INCREMENT and replace any tab characters in INCREMENT lines with spaces One way to check for extraneous tabs and carriage returns is to open your License File in a text editor and view all nonprinting characters Remove these tabs and replace with them spaces e Make sure that your system date is set to a date after the date that your license was made See License Manager Error 10 License Checkout Failed Feature Has Expired on page 4 9 to learn how to reset the system date License Manager Error 8 License Checkout Failed Encryption Code in License File Is Inconsistent This error typically indicates that you are running the license manager on a host that has a different host ID than the one for which your License File was generated Note You must restart the license manager after making any changes to the License File on the license server e Verify that the host ID specified in the License File matches the system s host ID See Finding the Host ID on a Windows System on page 1 24 e Ma
3. 1 25 1 Standard Installation Procedure 1 26 Note Disk space varies depending on size of partition and installation of online help files The MathWorks Installer informs you of the hard disk space requirement for your particular partition Installation size will be determined by the installer and can vary for NTFS and FAT formats Graphics e 16 24 or 32 bit OpenGL capable graphics adapter strongly recommended Other Requirements and Recommendations e Microsoft Windows supported graphics accelerator card printer and sound card e Office 2000 or Office XP is required to run the MATLAB Notebook MATLAB Builder for Excel Excel Link Database Toolbox and MATLAB Web Server Compilers for MEX Files For the most up to date information about compilers see the support area at the MathWorks Web site www mathworks com Network Installation Procedure This chapter describes how to install the MathWorks Release 14 family of products in network access configurations Use this procedure for license options that can be installed in a network configuration Setting Up a Network Installation Describes the different types of configurations you can set p 2 2 up with network licenses This section can help you determine on which systems you will install the license manager and on which systems you will install the MathWorks products Basic Network Installation Procedure Provides a step by step procedure for in
4. 0 0 0 0 cee 1 4 Step 3 Enter Identification and License Information 1 5 Step 4 Review the Software Licensing Agreement 1 6 Step 5 Choose Installation Type 0 0 00 e eee 1 6 Step 6 Specify Installation Folder and Products 1 8 Step 7 Specify Installation Options Custom Only 1 10 Step 8 Confirm Your Choices 0 0 00 cece e eee 1 11 Step 9 Read Product Configuration Notes 1 13 Step 10 Complete the Installation 00 1 14 Step 11 After You Install nananana nauan 1 15 Updating a License 0 0 0 es 1 18 Installing Additional Products 1 21 Obtaining Your Licenses 0 00000 e eens 1 23 Finding the Host ID on a Windows System 1 24 System Requirements 0 00 c cece neces 1 25 General Requirements 0 000 e eee ee eens 1 25 Platform Specific Requirements 0 00 0 eee 1 25 Graphics 30 54 ceded bce acs ewes ood Mad ae Se Re wee os 1 26 Other Requirements and Recommendations 1 26 Compilers for MEX Files 0 0 0 0 eee eee ee 1 26 li Contents Network Installation Procedure Setting Up a Network Installation 2 2 Network Configuration Options 0000s eens 2 2 Local Client Access Configuration 000 eee 2 3 Basic Network Installation Procedure
5. Installing Additional Products on page 1 21 for information Enter next CD x Insert CD 2 in the CD ROM drive and then click OK To complete the installation of products from CD 1 without installing products from CD 2 click Skip CD 2 Skip CD 2 1 12 Basic Installation Procedure Step 9 Read Product Configuration Notes Depending upon which products you install the MathWorks Installer might display a dialog box containing two types of information e Product configuration information Certain products require additional configuration If you installed one of these products the installer lists the configuration commands in this dialog box You can copy this command to your system clipboard for use after the installation is completed See Configuring Certain Products on page 1 16 for more information Click Next to proceed with the installation Product Configuration Notes k o x Your installation may require additional configuration steps See MATLAB emes naonta merienn SIMULINK 1 To configure Real Time Windows Target you must type rtwintgt setup in a MATLAB command window The MathWorks Cancel Help Click Next Available product updates During installation the installer attempts to contact the MathWorks Web site to determine if a more recent version of one or more of the products you installed is available for download Sometimes newer versions of product
6. see Running Multiple Versions of MATLAB on page 3 14 MATLAB Preferences The installer does not overwrite existing MATLAB preference files on your system Multiple MATLAB installations on the same system use the same preference files Note however that if you plan to remove a Release 12 or earlier installation you might want to first save your MATLAB preference files Before Release 12 1 the uninstaller provided with MATLAB automatically deleted MATLAB preferences files See Using the Uninstaller on page 3 23 for more information 2 Network Installation Procedure Step 2 Start the Installer Insert the MathWorks product CD into the CD ROM drive or double click the installer file you downloaded from the MathWorks Web site The MathWorks installer starts automatically displaying the Welcome to the MathWorks Installer dialog box Select the Install option and click Next The Update license option is useful when you purchase a product after a trial and just want to update your license without reinstalling products See Updating a License on page 1 18 Select Install Welcome to the MathWorks Installer MATLAB SIMULINK Welcome to the MathWorks Installer This program will install the MATLAB family of products C Update license without installing anything using a new PLP WARNING These programs are protected by copyright laws By entering into the Software License Agreement that follows within
7. 1 Obtain the current IP address for your server If you are on UNIX or Linux use the ifconfig command On a PC running Windows you can use the ipconfig command at a DOS prompt 2 Edit the hosts file on your system and change the IP address for your server s entry to be the correct IP address On UNIX or Linux systems edit the etc hosts file On Windows NT and Windows 2000 systems edit the C WINNT system32 drivers etc hosts file License Manager Error 97 License Checkout Failed This error can occur when trying to start the license manager while an existing vendor daemon mlm exe is already running To resolve this open the Task Manager and terminate any mlm exe processes that are running If you cannot end the process in the Task Manager reboot your computer Once you reboot restart the license manager If the same error occurs after rebooting it is also possible that the vendor daemon is trying to run on an occupied port To specify an open port for the vendor daemon edit the DAEMON line in the license dat file found in the MATLAB f1lex1m folder where MATLAB is the root MATLAB folder DAEMON MLM MATLAB flexlm mlm exe port where is an open port You can use any unused port number between 0 and 64000 By default the license manager uses a port in the range 27000 to 27009 Troubleshooting an Installation That Uses Dongles Troubleshooting an Installation That Uses Dongles If your MATLAB installatio
8. 2 11 2 Network Installation Procedure 2 12 Select Custom Installation Type 5 xi MATLAB SIMULINK Typical Installs all your licensed products using default settings Note Cannot be used to install the license manager Specify values for all installation options and install the license manager RELEASE The MathWorks Cancel Help Click Next Product Update Information A PLP can identify a product that is not on any of CDs This can happen when a new product is released after the MathWorks CDs were produced When this occurs the installer displays the names of these new products in the Product Update Notification dialog box You must go to the MathWorks Web site to download these products after installation is complete Take note of the names of these products and click Next to continue with the installation You can also copy this information to your system clipboard from the Product Configuration Notes dialog box later in the installation procedure Basic Network Installation Procedure Product Update Notification 5 x A Th A B Some of the products you are licensed for are not available on this SIMULINK To install all of the products you are licensed for you must 1 Complete this installation 2 Go to www mathworks com to download the following products New Toolbox New Blockset The MathWorks Cancel Help Click Next Step 7 Specify
9. SIMULINK To install all of the products you are licensed for you must 1 Complete this installation 2 Go to www mathworks com to download the following products New Toolbox New Blockset The MathWorks Cancel Help Click Next Step 6 Specify Installation Folder and Products The dialog box you use to specify where you want to install MATLAB varies depending on which type of installation you are performing e Typical Installation You specify only the installation folder e Custom installation You specify the installation folder and select the products you want to install A Custom installation also provides access to installer options Step 7 Typical Installation In a Typical installation you use the Folder Selection dialog box to specify the name of the folder into which you want to install MATLAB You can accept the default destination folder or specify the name of a different installation folder If the folder doesn t exist the installer creates it To continue with the installation click Next and go to Step 8 Confirm Your Choices on page 1 11 In a Typical installation the installer does not provide access to installer options Basic Installation Procedure Note The installer includes the online documentation in compressed form for each product you install This does not include documentation in PDF format which is only available at the MathWorks Web site S
10. copy MATLAB uninstall uninstaller ini C temp my_uninstall ini 3 25 3 License Management 2 Open your copy of the initialization file using any text editor and enter all the required information For example use the directory parameter to specify the name of the root folder of the installation you want to remove directory D MATLAB7 In this initialization file you can specify the name of the products you want to remove and other parameters By default the uninstaller removes all products If your initialization file is missing a required parameter the uninstaller stops and writes an error to the output log Two optional parameters you might want to set are Controlling visibility By default when you run the uninstaller in silent mode the uninstaller still displays the dialog box even though no interactive response is required If you want to suppress the display of this dialog box set the value of the visible parameter to false visible false Requesting an output log To request that the uninstaller create an output log file that reports on the status of removing an installation specify the full path name as the 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 the initialization file as a command line argument For example click the Start button and select the Run option In the Run dialog
11. 3 18 2 Request a License File from The MathWorks Once you have chosen the servers determine the host IDs of each server and provide them to The MathWorks when you request your License File The MathWorks will generate an appropriate License File The following example shows a License File that supports redundant servers Note that the License File lists three Host IDs BEGIN cut here CUT HERE BEGIN MATLAB license passcode file for use with FLEX1m LicenseNo 12345 HostID 00034660893e HostID 00053327865e HostID 00470635883e INCREMENT TMW_Archive MLM 14 01 jan 0000 0 8D50540DG9BCDD33692C VENDOR_STRING b HOSTID DEMO SN 12345 INCREMENT MATLAB MLM 14 01 jan 0000 10 DE40F3ADB9CC7490132D DUP_GROUP UH SN 12345 INCREMENT SIMULINK MLM 14 01 jan 0000 10 7D20159D87373CBCA3E0 DUP_GROUP UH SN 12345 INCREMENT Identification Toolbox MLM 14 01 jan 0000 10 5DCOF5FD10FDEB2F830B DUP_GROUP UH SN 12345 END cut here CUT HERE END Install the license manager on the three server systems in the redundant configuration During each installation the installer processes the License File adding SERVER and DAEMON lines For example on the system named pooh the processed License File might contain these lines SERVER pooh 08002be68759 27000 DAEMON MLM usr local matlab7 etc 1m_matlab Edit the processed License File MATLAB etc license dat on each server so that each License File
12. Back Cancel Help Click Next Basic Installation Procedure Step 3 Enter Identification and License Information Enter your name company name and Personal License Password PLP in the License Information dialog box and click Next Your PLP identifies the products you are licensed to install If your PLP identifies a product that is not on any of CDs the installer notifies you see Product Update Information on page 1 7 To avoid typing errors copy the PLP from the license e mail and paste it into this dialog box If your e mail program has caused the PLP to wrap onto two lines make sure you copy the entire PLP Note Do not confuse your PLP with your License Number A PLP is a series of five digit numbers prefixed with a two digit release code such as 14 12345 12345 12345 12345 12345 If you do not have your PLP you can click the Get my PLP button to obtain it To get your PLP this way you must have an Internet connection and a MATLAB Access Login Access Login is free of charge and available to all customers If you do not already have one you can create an Access Login at the MathWorks Web site Enter name company name and PLP License Information MATLAB SIMULINK Please enter your name and company Name Company Please enter your Personal License Password PLP You should have received this via e mail or fax Ht Ifyou do not have your PLP click the button to get
13. SIMULINK Select destination folder for installation DAApplicationsiMATLAB7 Browse Space available 22095 M Space required OM The MathWorks Back nexe Cancel Help Click Next 6 Verify your choices in the Confirmation dialog box Note that the Additional Options section specifies Update License Only To proceed with the license update click Update Note When you click Update the installer updates your license but does not install any products 1 19 1 Standard Installation Procedure Ix MATLAB Confirm the installation options you have selected SIMULINK Individual Installation Product Folder D Applications MATLAB Additional Options Update License Only The MathWorks Cancel Help Update only Click Update 7 When the installer finishes it displays the Setup Complete dialog box In this dialog box you can choose to start MATLAB as you exit the installer Click Finish to exit the installer 1 20 Installing Additional Products Installing Additional Products When you order additional products The MathWorks sends you a new Personal License Password PLP You must use this new PLP when you install your new products This section briefly outlines the procedure to install an additional product For more detailed information about any step see Basic Installation Procedure on page 1 2 1 Before you i
14. The utility returns the following information about the current license manager status lmutil Copyright c 1989 2003 by Macrovision Corporation All rights reserved 3 License Management Flexible License Manager status on Fri 1 16 2004 16 57 License server status 27000 smithj License File s on smithj C matlabr14 flexlm license dat smithj license server UP MASTER v 9 2 Vendor daemon status on smithj MLM UP v9 2 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 Using the FLEXIm Utilities Graphical User Interface FLEXIm provides a graphical user interface GUD called LMTOOLS to its license management utilities The GUI provides access to the same set of tools as the lmutil command and displays the results returned in an integrated display window For example to use LMTOOLS to monitor the status of network license activity perform this procedure 1 Start LMTOOLS by double clicking the lmtools exe file in the MATLAB f lex1m folder 2 Click the Server Status tab 3 Click the Perform Status Enquiry button LMTOOLS displays the same information as if you had entered the command lmutil lmstat a 3 12 Managing the License Manager LMTOOLS by Macrovision Corporation http www macrovision com
15. www mathworks com and click Support See Getting Help with License Manager Problems on page 4 4 for more information License Manager Error License Manager Error 2 License Checkout Failed Invalid License File Syntax on page 4 6 License Manager Error 3 License Checkout Failed Cannot Connect to a License Server on page 4 7 License Manager Error 5 License Checkout Failed No Such Feature Exists on page 4 7 License Manager Error 8 License Checkout Failed Encryption Code in License File Is Inconsistent on page 4 8 License Manager Error 9 License Checkout Failed Invalid Host on page 4 9 License Manager Error 10 License Checkout Failed Feature Has Expired on page 4 9 License Manager Error 12 License Checkout Failed Invalid Return Data from License Server on page 4 10 License Manager Error 13 License Checkout Failed No SERVER Line in License File on page 4 10 License Manager Error 14 License Checkout Failed Cannot Find SERVER Hostname in Network Database on page 4 11 4 Troubleshooting License Manager Error License Manager Error 15 License Checkout Failed Cannot Connect to License Server on page 4 11 License Manager Error 16 License Checkout Failed Cannot Read Data from License Server on page 4 11 License Manager Error 18 License Checkout Failed License Server Does Not Support This Feature on
16. Folder and Products In a Custom installation you use the Product and Folder Selection dialog box to specify the name of the folder into which you want to install MATLAB called the destination folder and to select which products you want to install Specifying the Destination Folder This dialog box includes a default destination folder but you can specify another folder If the folder doesn t exist the MathWorks Installer creates it Specifying Products to Install If you are setting up a remote access configuration leave all the products in the list selected for installation In this configuration you install MATLAB and the other products on your license server You must also select the license manager in the product list by clicking the check box next to its name By default the license manager is not preselected for installation If you are setting up a local access configuration clear all the product check boxes in the product list and select only the license manager In this configuration you only run the license manager on your license server users on client systems run local copies of MATLAB After making your selections click Next to proceed with the installation 2 13 2 Network Installation Procedure Note The installer includes the documentation in compressed form for each product it installs The installer does not install product documentation in PDF format this is only available at the MathWorks Web sit
17. Part 227 7202 1 DFARS Part 227 7202 3 DFARS Part 252 227 7013 and DFARS Part 252 227 7014 The terms and conditions of The MathWorks Inc Software License Agreement shall pertain to the government s use and disclosure of the Program and Documentation and shall supersede any conflicting contractual terms or conditions If this license fails to meet the government s minimum needs or is inconsistent in any respect with federal procurement law the government agrees to return the Program and Documentation unused to MathWorks MATLAB Simulink Stateflow Handle Graphics and Real Time Workshop are registered trademarks and TargetBox is a trademark of The MathWorks Inc Other product or brand names are trademarks or registered trademarks of their respective holders Printing History December 1996 First printing New for MATLAB 5 May 1997 Second printing Revised for MATLAB 5 1 January 1999 Third printing Revised for MATLAB 5 3 Release 11 November 2000 Fourth printing Revised for MATLAB 6 0 Release 12 June 2001 Fifth printing Revised for MATLAB 6 1 Release 12 1 July 2002 Sixth printing Revised for MATLAB 6 5 Release 13 Renamed as Installation Guide for Windows June 2004 Seventh printing Revised for MATLAB 7 0 Release 14 Contents Standard Installation Procedure 1 Basic Installation Procedure 0 05 1 2 Step 1 Before You Install 0 0 0 0 cece 1 3 Step 2 Start the Installer
18. Step 12 Complete the installation Not applicable on client systems Same Same Same The license manager must be running on your license server before you can run MATLAB ona client License File Location For client installations you must specify the location of the processed License File created by the installer during the license manager installation on the license server Processed license files contain the SERVER and DAEMON lines See Licensing Information on page 3 3 for more information This table lists the location of the processed License File on PC and UNIX license servers License Server Platform Location of Processed License File on Server PC running Windows UNIX MATLAB flex1m license dat MATLAB etc license dat In a client installation the installer replaces the DAEMON line with the line USE_SERVER The installer puts this version of the License File in the MATLAB bin win32 folder If your license server is a UNIX system you must remove the UNIX line ending characters from the license dat file before using it on a PC For example on Sun systems use the unix2dos utility to perform this function Setting Up Network Named User Licensing Setting Up Network Named User Licensing Note This is only required for Network Named User licenses Concurrent licenses do not require this task If you have a Network Named User license you might need to e Check the FLEXIm option
19. deleted MATLAB preferences files See Using the Uninstaller on page 3 23 for more information Step 2 Start the Installer Insert CD 1 into the CD ROM drive connected to your system or double click on the installer file you downloaded from the MathWorks Web site The MathWorks Installer starts automatically displaying the Welcome to the MathWorks Installer dialog box The installer will prompt you if you need to insert other CDs during installation see Installing Products from the Other CDs on page 1 12 Select the Install option and click Next The Update license option is useful when you purchase a product after a trial and just want to update your license without reinstalling products See Updating a License on page 1 18 Select Install Welcome to the MathWorks Installer 5 xj Welcome to the MathWorks Installer This program will install the MATL AB MATLAB family of products C Update license without installing anything using a new PLP WARNING These programs are protected by copyright laws By entering into the Software License Agreement that follows within this installation process you will also agree to additional restrictions on your use of these programs Any unauthorized use reproduction or distribution may result in severe civil and criminal penalties The MathWorks Please note that the installer will try to contact the MathvVorks Web site to retrieve product version information
20. information in the SERVER line of your license dat file For example if your SERVER line looks like this SERVER hostname INTERNET 128 36 2 12 27000 Add the following line to your TCP IP hosts file 128 36 2 12 hostname 3 Save the changes to the TCP IP hosts file License Manager Error 13 License Checkout Failed No SERVER Line in License File This error indicates that your License File is missing the SERVER line DAEMON line or both These lines should be added to the License File by the MathWorks Installer during the installation process To remedy this problem run the installer again or manually edit the License File MATLAB flexlm license dat adding the SERVER line See Licensing Information on page 3 3 for information about the format and contents of the SERVER and DAEMON lines Problems After Installation Before modifying your License File verify that the HostID of your license server matches the HostID given in the commented line of the file If your system s HostID does not match the HostID used to generate your License file contact The MathWorks you will need your license regenerated for the correct HostID Note You must restart the license manager after making any changes to the License File on the license server License Manager Error 14 License Checkout Failed Cannot Find SERVER Hostname in Network Database If this error occurs on a client system make sure that the hostname on the SERVER
21. installation D Applications MATLAB MAT SIMULINK r Select products to install V MATLAB 7 0 a Simulink 6 0 V Aerospace Blockset 1 6 V CDMA Reference Blockset 1 1 V Communications Blockset 3 0 M Communications Toolbox 3 0 Control System Toolbox 5 3 Dials and Gauges Blockset 1 2 The MathWorks V Embedded Target for Motorola MPC555 2 0 E Space available 22141 M Space required 1164M Back L nexe Cancel Help Select the products you Click Next want to install Step 7 Specify Installation Options Custom Only For Custom installations you can specify several installation options in the Custom Installation dialog box including e Setting the permissions of all installed files to read only This option is more commonly used in network installations see Step 9 Specify Installation Options on page 2 15 e Determining whether the MathWorks Installer puts shortcuts for MATLAB in the Start menu the Quick launch bar and on the desktop e Specifying which files the Windows operating system associates with MATLAB based on their file extension For example if you associate files Basic Installation Procedure with the m file extension with MATLAB Windows displays MATLAB M file as the type in the Window Explorer window After selecting installation options click Next to proceed with the installation Custom Installation lol x Please select the options you would li
22. line in the license dat file on your client system matches the hostname on the SERVER line in the license dat file on your license server Edit the SERVER line in the client license dat file if necessary Also make sure that the server s hostname included in the SERVER line is listed in the C WINNT system32 drivers etc hosts file License Manager Error 15 License Checkout Failed Cannot Connect to License Server This error indicates that MATLAB cannot connect to the license server e Verify that both license manager daemons 1lmgrd and mlm are running on the server You can check this via the Task Manager which can be accessed by pressing the Ctrl Alt Delete key sequence If the license manager isn t running see Starting and Stopping the License Manager on page 3 9 for information about starting it e Verify that you have read permission to your MATLAB installation folder For additional suggestions go to the Support page on the MathWorks Web site www mathworks com and search for this license manager error number License Manager Error 16 License Checkout Failed Cannot Read Data from License Server This error indicates that the path to the MATLAB vendor daemon on the DAEMON line in your License File is incorrect The DAEMON line can vary 4 Troubleshooting 4 12 depending on your license type See Licensing Information on page 3 3 for an examples License Manager Error 18 License Checkout Failed
23. lines 3 Copy the license information from the e mail message and paste it into the open text file In general do not edit the licensing information you may invalidate a license However note the following Make sure you remove any line breaks that your e mail program may have inserted between the start and end of an INCREMENT line If an INCREMENT line must continue onto more than one line use the backslash character as in the following INCREMENT Identification_Toolbox MLM 14 01 mar 2004 1 EC5C175AGG025G2AD73A DUP_GROUP UH SN 12345 Make sure that there is a space between each field in the INCREMENT line Do not use tabs to separate these fields Do not change the case of any characters License Files are case sensitive If you received your license passcodes in a fax create the License File by typing in the license passcode information exactly as it appears in the fax 4 Save the file as a plain ASCII text file naming it license dat and store it in any convenient folder 3 5 3 License Management License File Processing on a License Server When you install the license manager as part of a network installation the installer processes your License File adding two lines to the file the SERVER line and the DAEMON line These lines provide information about the location of the license server and daemon The installer puts this processed version of the License File into the MATLAB flex1m folder The f
24. or access product demonstrations programs To get information about specific MATLAB features To get help with specific questions you can t find answered in the documentation Read the Release Notes documentation Use the Start button in the MATLAB desktop Choose the Help item in the MATLAB menu bar to view reference and tutorial information in hyperlinked HTML form Go to the MathWorks Web site www mathworks com click on Support and use the Technical Support solution search area to find more information 1 Standard Installation Procedure 1 18 Updating a License When you extend the expiration date of a demo license or convert a demo license to a standard license The MathWorks sends you a new PLP You must use the MathWorks Installer to update your existing installation with this new license The installer Update license option lets you update your license without having to reinstall any products You can also use this option to update your license when you move an installation onto a new system This section briefly outlines the procedure to update a license For more detailed information about any step see Basic Installation Procedure on page 1 2 1 Before you install Have your new PLP handy Exit any existing copies of MATLAB you might have running 2 Insert the MathWorks CD 1 into the CD ROM drive connected to your system or double click the installer file you downloaded from the MathWor
25. reason the license manager daemons do not connect take the daemons down on each machine and rerun the procedure Network traffic can affect synchronization so it may require several attempts to establish a proper connection Set up the client systems that access the redundant servers To ensure that client systems can switch servers in the event of a failure you must create an environment variable named MLM_LICENSE_FILE on each client system FLEXIm reads this environment variable to determine which License Files to use On client systems specify the hostname and port for all the servers in the redundant configuration Use a semicolon to separate the names For example 3 19 3 License Management port server1 port server2 port servers3 Alternatively you can specify the License files when you start MATLAB on aclient using the c option with the matlab command To do this right click on the MATLAB icon on the desktop and choose Properties In the Target field of the Properties dialog box add the c option to the command For example D MATLAB7 bin win32 matlab exe c port server1 port server2 port server3 3 20 Running the Installer Noninteractively Running the Installer Noninteractively If you have many MATLAB installations to perform and the information you need to enter for each installation is the same you can put this information in an installer initialization file and run the MathWorks Installer noninter
26. server system When MATLAB starts the license file points to the wrong version of the license manager To remedy this problem update the license manager on the server to the latest version of FLEXIm that is included on the MathWorks CD License Manager Error 84 USER_BASED license has no specified users The license manager cannot find your options file Some possible resolutions are e Verify that the installer created an options file during the installation procedure The full path of the options file is MATLAB flex1m MLM opt where MATLAB is your MATLAB installation folder See Setting Up Network Named User Licensing on page 2 23 for more information e Verify that the DAEMON line in your License File includes the full pathname of your options file Check the processed License File 4 Troubleshooting 4 14 MATLAB flexlm license dat If the DAEMON line wraps onto a second line make sure there is a line continuation character at the end of the first line e Verify that you are listed as a valid user of the product you are trying to use License Manager Error 96 License Checkout Failed Server Node is Down or Not Responding This error can occur if you are running DHCP to obtain a dynamically assigned IP address on your license server MATLAB cannot connect with the license manager because it uses TCP IP protocols for communication and the IP address is changing To fix this problem follow this procedure
27. 0 entry On the MATLAB menu click the R14 Uninstaller AA maTLas 7 0 al M file Editor G R14 Uninstaller Alternatively you can remove an installation using the Windows Add Remove Programs control panel Select MATLAB 7 0 from the list of products When you start the uninstaller it displays the Uninstall Product List dialog box 3 23 3 License Management Select the products you want to remove Uninstall Products 15 x Please check the products you wantto remove If TLAB you select the MATLAB product all other products MAT will be removed SIMULINK Uninstalling from D Applications MATLAB M MATLAB V Control System Toolbox V Signal Processing Toolbox The MathWorks Specify whether to remove I Uninstall MATLAB preference files including Command History references P E Cancel 3 Select the products you want to remove by selecting the check box next to their names Note Ifyou select MATLAB you automatically remove all other MathWorks products as well 4 Optional Specify whether you want to remove your MATLAB preferences file The MathWorks stores your MATLAB environment preferences such as command history and Help favorites in a set of preference files These preference files are stored in a system folder that is associated with a particular user To find where your preferences are located use the prefdir command at the MATLAB prompt For example on Windows 200
28. 0 systems prefdir returns 3 24 Removing Uninstalling an Installation prefdir ans C WINNT Profiles username MATHWORKS Application Data MathWorks MATLAB R14 where username is the username of the person performing the uninstall By default the uninstaller does not delete these preference files If you want to remove these files select the Uninstall MATLAB preferences check box When you make this selection the uninstaller deletes the contents of the preferences folder 5 To proceed with the removal click the Uninstall button The uninstaller leaves the MATLAB installation folder on your system empty except for the uninstall folder and the work folder if it contains files To completely remove a MATLAB installation you must delete these folders yourself You might want to move any M files you created in the work folder to another folder before deleting it Running the Uninstaller Noninteractively You can run the uninstaller noninteractively In this mode you create an uninstaller initialization file specifying the root folder of the installation you want to remove and the products you want to remove To run the uninstaller noninteractively perform these steps 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 Make a copy of this template file giving it any name you want
29. 1 21 for information Enter next CD E xj Insert CD 2 in the CD ROM drive and then click OK To complete the installation of products from CD 1 without installing products from CD 2 click Skip CD 2 Skip CD 2 Step 11 Read Product Configuration Notes Depending upon which products you install the MathWorks Installer might display a dialog box containing two types of information e Product configuration information Certain products require additional configuration If you installed one of these products the installer lists the configuration commands in this dialog box You can copy this command to your system clipboard for use after the installation is completed See Configuring Certain Products on page 1 16 for more information Available product updates During installation the installer attempts to contact the MathWorks Web site to determine if a more recent version of one or more of the products you installed is available for download Sometimes newer versions of products are made available on the MathWorks Web site after the CD is produced If any of the products you installed have updates available the installer lists them in this dialog box You must go to the MathWorks Web site to download them after installation is complete 2 Network Installation Procedure 2 18 ici Your installation may require additional configuration steps See MATL AB the notes below for instructions SIMI J LINK 1 T
30. 12345 12345 Your PLP identifies the products that you are licensed to install When you purchase products The MathWorks sends you a PLP by e mail or fax If you don t have your PLP you can get it by clicking the Get my PLP button on the License Information dialog box or by contacting The MathWorks See Obtaining Your Licenses on page 1 23 for more information e Exit any existing copies of MATLAB you have running e Make sure your system satisfies the requirements of the software you intend to install For more information see System Requirements on page 1 25 e Get administrator privileges In addition consider disabling virus checking on your system for the duration of the installation process Virus checkers can slow down the installation process Upgrade Installations When upgrading an existing installation always install MATLAB in a new installation folder You do not need to delete an existing MATLAB installation before installing Release 14 You can run multiple versions of MATLAB on the same system 1 Standard Installation Procedure 1 4 MATLAB Preferences The installer does not overwrite existing MATLAB preference files on your system Multiple MATLAB installations on the same system use the same preference files Note however that if you plan to remove a Release 12 or earlier installation you might want to first save your MATLAB preference files Before Release 12 1 the uninstaller automatically
31. AB 7 not the License File created during the original installation To set up this configuration follow these instructions After completing this procedure you can start either version of MATLAB that you have installed on your system 1 Shut down your previously installed version of MATLAB 2 Stop the license manager See Starting and Stopping the License Manager on page 3 9 3 Remove the license manager service See Removing the License Manager Service on page 3 9 3 14 Creating Advanced Configurations Install MATLAB 7 on your client systems See Installing MATLAB on a Client System on page 2 21 Replace the License File used by your existing MATLAB installation with the License File created by the installer during the new installation This table lists the location of the License File on client systems for different MATLAB releases MATLAB Version Location of License File on Client Systems MATLAB 6 x MATLAB bin win32 license dat MATLAB 5 2 x or 5 3 x MATLAB bin license dat Using Concurrent Toolboxes in a Stand alone Installation If you have an Individual license in a stand alone installation you can still use toolboxes that have a Concurrent license and are made available over the network from a license server You must use two License Files one for the individual licensed products and another for the concurrently licensed products Note This capability is only available for
32. ID in the SERVER line must match the host ID in the comment section of the License File 3 6 Licensing Components e TCP_PortNumber specifies the TCP IP port to use for communication with the daemons Do not change this number unless you know it conflicts with other software A valid port number is any unused port number between 0 and 64000 If no TCP IP port number is specified FLEXIm uses a port number in the range 27000 to 27009 DAEMON Line The DAEMON line identifies the name and location of the vendor daemon using the format DAEMON vendor vendor_daemon_path options options file path where e vendor is the name of the vendor daemon MLM for The MathWorks e vendor_daemon_pathis the fully specified path to the daemon executable for example C MATLAB7 flexlm mlm exe e options file path is the full path of the options file for Named User licenses for example options C MATLAB7 flex1m MLM opt License File Processing on Client Systems In client installations in network configurations you specify the name of the processed License File in the License File dialog box during the installation procedure The installer deletes all the INCREMENT lines and the DAEMON line in the License File and replaces them with a single line USE_SERVER On client systems the installer puts the processed License File license dat in the MATLAB bin win32 folder If by mistake you use your original License File instead of the proces
33. LINK F eanna The MathWorks Click Finish MATLAB Top level Folder Structure After a successful installation your MATLAB installation folder contains the folders listed in the following table Your installation might include additional folders depending on which products you installed Folder Description BIN WIN32 The MATLAB executable and associated files DEMOS MATLAB demonstration programs EXTERN Tools for building external interfaces to MATLAB 2 19 2 Network Installation Procedure 2 20 FLEXLM HELP JA JAVA NOTEBOOK SYS TOOLBOX UNINSTALL WORK The FLEXIm license manager and license management utilities network installations only Help system MATLAB internationalization files MATLAB Java Jar files MATLAB Notebook Tools and operating system libraries that MATLAB depends on The MathWorks toolboxes The MATLAB Uninstaller program Default initial current folder Installing MATLAB on a Client System Installing MATLAB on a Client System This section describes how to install MATLAB on a client system running Windows in a local client access configuration See Local Client Access Configuration on page 2 3 for information about this type of installation The installation procedure on a client system is almost identical to the procedure on a server however there are some differences For example in a client installation you do not install the license m
34. License File D Applications MATLAB7ifleximilicense dat Log File D Applications MATLAB ifleximiUmlog bt RELEASE Do NOT configure service files will still be installed You must manually set up the license manager service using the Imtools exe utility found in the flexim folder of your installation The MathWorks folder Cancel Help Click Next Step 9 Specify Installation Options For Custom installations you can specify several installation options in the Custom Installation dialog box including e Setting the permissions of all installed files to read only This option can be useful for remote access configurations where users access the MATLAB files on your license server e Determining whether the MathWorks Installer puts shortcuts for MATLAB in the Start menu the Quick launch bar and on the desktop e Specifying which files the Windows operating system associates with MATLAB based on their file extension For example if you associate files with the m file extension with MATLAB Windows displays MATLAB M file as the type in the Window Explorer window After selecting installation options click Next to proceed with the installation 2 15 2 Network Installation Procedure Custom Installation 3 15 x Please select the options you would like to use MATLAB M Set permissions of installed files to read only useful for SIMULINK installations on mapped or shared drives when you do not want user
35. License Server Does Not Support This Feature This error typically indicates that you have updated your License File without restarting the license manager Restart the license manager and try to start MATLAB again If you get this error on the client but not the server the license dat file on the client probably needs to be updated Make sure that the INCREMENT line in your License File exactly matches the INCREMENT line in the license information you received from The MathWorks License Manager Error 21 License Checkout Failed License File Does Not Support This Version If you are getting this error on your license server make sure you have installed the version of FLEXIm included with Release 14 Release 14 License Files will not work with the older FLEXIm versions If you have updated an existing license dat file with new Release 14 passcodes you still need to install the latest version of FLEXIm from the Release 14 CD If you are getting this error on one of your client systems and not on the license server make sure the License File on the client is in the following format SERVER host hostname port_num USE_SERVER The SERVER line in the client system License File should be the same as the SERVER line found in the License File on the license server Also make sure you are using your Release 14 license and not a license from a previous release License Manager Error 25 License Checkout Failed License Server Does
36. MATLAB SIMULINK Computation Visualization Programming Modeling Simulation Implementation Installation Guide for Windows Release 14 Product Family lt A The MathWorks X C o How to Contact The MathWorks www mathworks com comp soft sys matlab support mathworks com suggest mathworks com bugs mathworks com doc mathworks com service mathworks com info mathworks com Web Newsgroup Technical support 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 Mail 3 Apple Hill Drive Natick MA 01760 2098 For contact information about worldwide offices see the MathWorks Web site Installation Guide for Windows COPYRIGHT 1996 2004 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 repro duced 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 or for the federal government of the United States By accepting delivery of the Program the government hereby agrees that this software qualifies as commercial computer software within the meaning of FAR Part 12 212 DFARS
37. MATLAB bin win32 is still current If the dates have already passed contact the Customer Service department at The MathWorks through the Web or through e mail at service mathworks com When contacting The Mathworks include your License Number and the Host ID of your license server If none of your product licenses has expired verify that the system date and time on your computer are correct 1 Click the Start menu 2 Choose Settings 3 Click Control Panel 4 Choose Date Time 4 9 4 Troubleshooting 4 10 License Manager Error 12 License Checkout Failed Invalid Return Data from License Server This error can be caused by your network setup When the license manager tries to connect to the server the DNS Server does not find the server because it does not add the domain name suffix into the search If all of your client systems are having this problem change the name of the server in the SERVER line in the License File on client systems located in MATLAB bin win32 to the fully qualified name and restart the license manager on the server See Starting and Stopping the License Manager on page 3 9 If only some of the clients in your network installation are having this problem add the hostname of your license server to the TCP IP Hosts file on your client systems 1 Open the file C WINNT system32 drivers etc hosts 2 Add the hostname of your license server to this file You can find your license server
38. MLM 14 01 may 2004 1 2C4E6709123C87893A9B DUP_GROUP UH SN 12345 NCREMENT Control_Toolbox MLM 14 01 may 2004 1 AC2E789974A6965DDC10 DUP_GROUP UH SN 12345 INCREMENT Identification_Toolbox MLM 14 01 may 2004 1 ACOED7C979217F359783 DUP_GROUP UH SN 12345 INCREMENT Stateflow MLM 14 01 may 2004 1 9C0E34891ED3503BA8B DUP_GROUP UH SN 12345 INCREMENT Database_Toolbox MLM 14 01 may 2004 1 3CAE9769DEB256724EB7 DUP_GROUP UH SN 12345 END cut here CUT HERE END H Increment Lines The following figure details the components of an INCREMENT line The INCREMENT lines in your License File may not include every element The backslash character at the end of a line indicates that the line continues onto the next line Product Vendor Release Expiration Number of Encrypted Passcode Daemon Date Users INCREMENT MATLAB MLM 14 01 jan 0000 5 9C7B2ADE9409CEF91AA USER_BASED DUP_GROUP UH SN 12345 Identifies Group License Named User Identifier Number Licenses Licensing Components Creating a License File You must create a License File from the licensing information you received in your license passcode e mail message from The Mathworks Follow these instructions 1 Open a text file using any ASCII text editor 2 In the license passcode e mail message select all the information from the BEGIN line to the END line Make sure to copy all the information contained in this section including the comment
39. Not Support This Version of This Feature This error indicates that you are trying to run MATLAB with an old license You must update your license dat file with your new license passcodes Problems After Installation If you do not have your MATLAB Release 14 license contact Customer Service at The MathWorks License Manager Error 31 License Checkout Failed Feature Not Yet Available This error indicates that the system date is set to a date that is earlier than the date MATLAB was installed Make sure that your system date is set to a date after the date that your license was made See License Manager Error 10 License Checkout Failed Feature Has Expired on page 4 9 to learn how to reset the system date License Manager Error 39 User Host Not on INCLUDE List for Feature This error can indicate that your FLEXIm options file contains an incorrect username on the INCLUDE line For Stand Alone Named User and Network Named User the FLEXIm options file requires an INCLUDE line for all licensed products See Setting Up Network Named User Licensing on page 2 23 for more information In addition make sure that each user named in the FLEXI m options file must have read permissions for the options file License Manager Error 83 License Checkout Failed FLEXIm Version of Client Newer Than Server This error usually indicates that the version of the license manager on the client system is newer than the license manager on the
40. R line in each License File Configuring Redundant License Servers If a large number of licenses are governed by a single license server failure of the server become a serious problem To prevent problems you may want to set up redundant servers so that if one server goes down the license manager can still function In the redundant server configuration three systems are designated to be license servers All three systems must be running at the time the license manager is started However once the license manager is running only two systems need to be running at any time this is called a quorum Once the daemons are up and connected on all three machines only two machines are needed for a quorum the loss of any one machine will not cause any licenses to be revoked Setting up a Redundant Installation Perform these steps to configure a redundant installation 1 Choose the systems that you intend to use as servers When choosing servers keep in mind The servers should be able to handle the network traffic associated with license management A primary server must be chosen This is the system to which clients connect first and which receives the majority of the network traffic The primary server is the first server listed in the License File If this system fails the next server listed in the License File becomes primary The servers should be running supported versions of their operating systems 3 License Management
41. Viewing the License Manager Log File To view the license manager log file open the MATLAB flex1m 1mlog txt file with any text editor You cannot access this file while the license manager is running 3 13 3 License Management Creating Advanced Configurations Using the MathWorks Installer and following the instructions in Chapter 2 Network Installation Procedure you can set up a network installation with little knowledge of license management However there are configurations that require some additional setup including e Running Multiple Versions of MATLAB e Using Concurrent Toolboxes in a Stand alone Installation on page 3 15 e Running MATLAB with Other FLEX m Applications on page 3 16 e Configuring Redundant License Servers on page 3 17 Running Multiple Versions of MATLAB You can run multiple stand alone installations of MATLAB on the same system without any special considerations Running multiple versions of MATLAB on a license server however requires some additional configuration If you want to continue running a previously installed version of MATLAB after you install MATLAB 7 note the following e The previously installed version of MATLAB must be 5 2 x or higher e Both versions of MATLAB must use the latest version of the license manager FLEXIm MATLAB 7 requires FLEX m 9 2 e The existing MATLAB installation must use the License File created during the installation of MATL
42. actively The initialization file provides the installer with the information that you would otherwise provide using installer dialog boxes Noninteractive installs also called silent installs can save time and prevent errors Using an Installer Initialization File To run the installer noninteractively perform these steps 1 Create your installer initialization file The MathWorks provides an initialization file template named installer ini located in the top level folder on the MathWorks CD Using Windows Explorer create a copy of this template file in any convenient folder giving it any name you want For example you might create the initialization file C temp my_install ini 2 Open your copy of the initialization file using any text editor and enter all the required installation information The initialization file template includes parameters for all the information you need to enter For example to specify where you want to install products set the value of the destination parameter to the full path of the installation folder destination D matlabr14 There are several required parameters such as name company name and PLP If your initialization file is missing a required field the installer stops the installation and writes an error to the output log The following describes several optional parameters that you might want to set Controlling visibility By default when you run the installer in silent mode
43. an Individual license stand alone installation on a PC running the Windows operating system To set up this configuration follow these instructions Perform a stand alone installation of the products for which you have an Individual license if you have not already done so Use the PLP for your Individual license in this installation See Basic Installation Procedure on page 1 2 to learn how Move the processed License File license dat created by this installation out of the MATLAB bin win32 folder to any convenient folder such as the desktop 3 License Management 3 16 3 Run the installer again this time to install the toolboxes that have a Concurrent license Use the PLP for your concurrent license in this installation 4 Specify the location of the processed License File on your license server MATLAB flex1m license dat when asked by the installer See Step 4 Specify Location of License File on page 2 9 5 Specify the same installation folder as your stand alone installation and select only the products you want to use that are not already part of your Individual license installation See Step 7 Specify Folder and Products on page 2 13 for more information 6 After the installation is finished rename the processed License File created by this installation Open the MATLAB bin win32 folder and change the name of the license dat file to license lic 7 Move the original License File license d
44. anager This table lists all the steps in the network installation procedure and notes where they are different on client systems For more detailed information about any of the steps go to the description of the step in Basic Network Installation Procedure on page 2 5 Basic Network Installation Procedure Client Installation Notes Step 1 Before you install You do not have to stop the license manager Step 2 Start the installer Same Step 3 Enter identification and licensing Use the PLP that you used for your license Information server installation Step 4 Specify location of License File Specify the location of the processed License File that was created during the license manager installation on the license server See License File Location on page 2 22 for more information Step 5 Review the software licensing Same agreement Step 6 Specify type of installation You can select either Typical or Custom Choose Custom to specify which products you want to install Step 7 Specify folder and products Do not select the license manager in the product list You do not need to install the license manager on client systems 2 21 2 Network Installation Procedure 2 22 Basic Network Installation Procedure Client Installation Notes Step 8 Configure the license manager as a Service Step 9 Specify installation options Step 10 Confirm your choices Step 11 Read product configuration notes
45. at that was created during the standalone installation back into the MATLAB bin win32 folder 8 Start MATLAB You can now run the toolboxes with a concurrent license from your stand alone installation Running MATLAB with Other FLEXIm Applications If you have another application that uses FLEXIm for license management you can share a single license manager or run separate license managers either on the same or different hosts The following sections describe these options For more information go to the Support page at the MathWorks Web site and see Technical Support solution 20746 You can also read the FLEXIm End User Manual available in PDF form in MATLAB flex1m enduser pdf or go to the Macrovision Corporation Web page at www macrovision com for more information Sharing a Single License Manager To share a license manager with other applications combine the DAEMON and INCREMENT lines from both License Files into a single License File In the combined License File keep only one SERVER line that identifies the license server host If the other applications are using a different version of the Creating Advanced Configurations FLEXI software than the MathWorks products run the newest version of the license manager Running Separate License Managers To run separate license managers use separate License Files If you are running the license managers on the same host be sure to use a different TCP port number on the SERVE
46. box enter the uninstall command specifying the full pathname of the initialization file as a command line argument uninstall exe if C temp my_uninstall ini 3 26 Removing Uninstalling an Installation Removing Installations That Use Dongles In some installations MATLAB requires a dongle A dongle is a hardware based security device that attaches to the USB port on your computer It uses embedded codes and passwords to control access to software applications If your system uses dongles the uninstaller asks if you want to delete the dongle drivers If other applications you run on your system use dongles do not delete these drivers For more information see Troubleshooting an Installation That Uses Dongles on page 4 15 3 27 3 License Management 3 28 Troubleshooting This chapter provides information that can help you solve common problems that you might encounter installing MATLAB on a PC running Microsoft Windows Problems During Installation p 4 2 Provides answers to some common problems encountered during a MATLAB installation Problems After Installation p 4 4 Provides answers to some common problems encountered after a successful installation In particular this section provides information about common license manager errors Troubleshooting an Installation That Describes how to use the MATLAB utility program Uses Dongles p 4 15 dongleutil exe to diagnose problems with a MATLAB in
47. contains SERVER lines for all three license servers During an installation the installer only adds one SERVER line to the License File Do not copy the DAEMON lines the License Files should contain only one DAEMON line Note in the following example that the License File contains three SERVER lines and one DAEMON line Creating Advanced Configurations BEGIN cut here CUT HERE BEGIN MATLAB license passcode file for use with FLEXI1m LicenseNo 12345 HostID 00034660893e HostID 00053327865e HostID 00470635883e SERVER pooh 00034660893e 27000 SERVER piglet 00053327865e 27000 SERVER rabbit 00470635883e 27000 DAEMON MLM usr local matlab7 etc 1m_matlab INCREMENT TMW_Archive MLM 14 01 jan 0000 0 8D50540DG9BCDD33692C VENDOR_STRING b HOSTID DEMO SN 12345 INCREMENT MATLAB MLM 14 01 jan 0000 10 DE40F3ADB9CC7490132D DUP_GROUP UH SN 12345 INCREMENT SIMULINK MLM 14 01 jan 0000 10 7D20159D87373CBCA3E0 DUP_GROUP UH SN 12345 INCREMENT Identification_Toolbox MLM 14 01 jan 0000 10 5DCOF5FD10FDEB2F830B DUP_GROUP UH SN 12345 END cut here CUT HERE END Put a copy of this edited License File in the MATLAB f1lex1m folder on all of the systems in the redundant configuration Start the license manager on each system in the redundant configuration and wait for the license manager daemons on the three systems to synchronize with each other This may take a few minutes If for some
48. cribes how to integrate MATLAB into a pre existing licensing scheme running multiple versions of MATLAB at the same time and create redundant configurations Describes how to use an initialization file with the installer Describes how to remove a MATLAB installation 3 License Management 3 2 Licensing Components Note The information in this section pertains to network installations only You do not need to read this section if you are performing an individual installation In a network installation The MathWorks uses a license manager program called FLEXIm a product of Macrovision Corporation to control access to its software This section describes License Management Daemons Licensing Information on page 3 3 Creating a License File on page 3 5 License File Processing on a License Server on page 3 6 License File Processing on Client Systems on page 3 7 Throughout this section MATLAB refers to your MATLAB installation folder Note For more detailed information about FLEXIm and license management see the FLEXIm End User Manual available in PDF format in MATLAB f1lex1m enduser pdf where MATLAB is your installation folder License Management Daemons FLEXIm uses a group of processes called daemons to control access to software applications These daemons run on a server in your network In this section this server is referred to as your license server Lice
49. d click Support On the support page under Installation amp Licensing click the Get assistance link You can also obtain your PLP by contacting The MathWorks via e Access Login Go to the MathWorks Web site at www mathworks com and click Access Login If you have an Access Login you can see all of your licenses e E mail at service mathworks com e Telephone at 508 647 7000 ask for Customer Service Customers outside North America should contact their local office To find the phone number of one of our international offices go to the MathWorks Web site at www mathworks com and click Contact Us at the top of the page e Fax at 508 647 7001 Depending on you request please have ready or include in your e mail or fax these items e Your License Number If you have not previously installed MATLAB at your site you can find your License Number on the upper right corner of the packing slip If you have a previous version of MATLAB running at your site you can obtain your License Number by entering the license command or the ver command at the MATLAB command prompt e Your e mail address 1 23 1 Standard Installation Procedure 1 24 e The host ID of the server on which you intend to run the license manager network installations only To learn how to get a host ID see Finding the Host ID on a Windows System on page 1 24 Finding the Host ID on a Windows System For network installations you need to suppl
50. e Specify the name of the destination folder 15 x Browse Product and Folder Selection MATLAB SIMULINK t destination folder for installation D Applications MATLAB Select products to install Click here to select the F License Manager 9 2 5 license manager M MATLAB 7 0 M Simulink 6 0 V Aerospace Blockset 1 6 Select the products you M Bioinformatics Toolbox 14 tto install V CDMA Reference Blockset tA want To install V Communications Blockset 3 0 zm g M Communications Toolbox 3 0 The MathWorks IZ Control System Toolbox 53 H Space available 22095 M Space required 1915 M lt Back L nexe Cancel Help Click Next Step 8 Configure the License Manager as a Service Installing the license manager as a service provides automatic startup at system boot time and centralizes administration of the license manager through the Windows Services control panel If you choose not to install the license as a service you can do it later See Installing the License Manager as a Service on page 3 8 for more information 2 14 Basic Network Installation Procedure Choose an option License Manager Configuration 15 xi C Configure license manager service The installer will create a license manager service on your machine using the following settings Service Name MATLAB License Server Imgrd D Applications MATLAB7fleximimard exe
51. enses 1 18 dongles troubleshooting 4 15 uninstalling 3 27 dongleutil exe 4 15 E error messages license manager 4 5 expiration date extending 1 18 F FLEXIm installation folder 3 2 troubleshooting 4 4 H Host ID determining on license server 1 24 in License File 3 3 hosts file 4 14 l INCREMENT line in License Files 3 4 initial current folder 1 16 initialization file using with installer 3 21 installation folder moving 1 18 installation procedure basic 1 2 network 2 5 noninteractive 3 21 prerequisites concurrent licenses 2 6 individual licenses 1 3 selecting products concurrent installations 2 13 turning off virus checking software 4 2 installer running noninteractively 3 21 starting concurrent installations 2 8 standard installations 1 4 Index 1 Index updating a license 1 18 installer initialization file specifying 3 21 installer ini 3 21 installing MATLAB adding products 1 21 basic procedure 1 2 network procedure 2 3 ipconfig 1 24 L License Files checking line breaks in 3 5 combining licenses 1 23 creating 3 5 definition 3 3 encryption code inconsistency 4 8 location on client system 3 7 processing by installer 2 9 running separate license servers 3 17 sharing with other applications 3 16 specifying path 2 9 understanding 3 3 license management overview 3 2 license manager administration 3 2 daemons 3 2 error messages 4 5 installation folder 3 2 sharing with other applica
52. eplace sysadmin in these INCLUDE statements with the usernames of the licensed users If multiple users are licensed for the same product you must create a separate INCLUDE line for each user or use the FLEXIm GROUP syntax The number of users must not exceed the number of license keys available for that product This example shows both methods Note Usernames are case sensitive In addition make certain that there are no extra space characters at the end of a line GROUP matlab_users tom judy mike jean brad GROUP signal_users tom mike brad INCLUDE MATLAB GROUP matlab_users INCLUDE Signal_Toolbox GROUP signal_users INCLUDE Optimization_Toolbox USER mike INCLUDE Optimization_Toolbox USER jean License Management This chapter describes the licensing architecture used by The MathWorks and provides information about monitoring the license manager in a network installation This information can be valuable if you want to integrate MATLAB into an existing FLEXIm licensing scheme Licensing Components p 3 2 Managing the License Manager p 3 8 Creating Advanced Configurations p 3 14 Running the Installer Noninteractively p 3 21 Removing Uninstalling an Installation p 3 23 Describes the primary licensing components such as the License File and the daemons that are used by FLEXIm Describes the license management tools provided with MATLAB and describes how to use them to monitor license activity Des
53. f license option you choose A PLP is a series of five digit numbers prefixed with a two digit release code such as 14 12345 12345 12345 12345 12345 Depending on your license 2 6 Basic Network Installation Procedure option you might receive a PLP for stand alone installations as well as a PLP for network installations A License File is a specially formatted text file that contains an INCREMENT line for each licensed product See Licensing Components on page 3 2 for an example If you don t have your licensing information see Obtaining Your Licenses on page 1 23 e Exit any existing copies of MATLAB you may have running e Shut down the FLEXIm license manager if it is running See Starting and Stopping the License Manager on page 3 9 for instructions e Make sure your system satisfies the requirements of the software you intend to install For more information see System Requirements on page 1 25 e Get administrator privileges for the system on which you plan to install MATLAB In addition consider disabling virus checking on your system for the duration of the installation process Virus checkers can slow down the installation process Upgrade Installations When upgrading an existing installation always install MATLAB in a new installation folder You do not need to delete an existing MATLAB installation before installing Release 14 You can run multiple versions of MATLAB on the same system
54. he License Manager as a Service 3 8 Removing the License Manager Service 4 3 9 Starting and Stopping the License Manager 3 9 Using FLEXIm License Management Utilities 3 10 Viewing the License Manager Log File 3 13 Creating Advanced Configurations 3 14 Running Multiple Versions of MATLAB 3 14 Using Concurrent Toolboxes in a Stand alone Installation 3 15 Running MATLAB with Other FLEXIm Applications 3 16 Configuring Redundant License Servers 3 17 Running the Installer Noninteractively 3 21 Using an Installer Initialization File 3 21 Removing Uninstalling an Installation 3 23 Using the Uninstaller 00 ccc ene 3 23 Running the Uninstaller Noninteractively 3 25 Removing Installations That Use Dongles 3 27 Troubleshooting Problems During Installation 4 2 Problems After Installation 005 4 4 Getting Help with License Manager Problems 4 4 License Manager Error Messages 0 20 ee ees 4 5 Troubleshooting an Installation That Uses Dongles 4 15 Index iii iv Contents Standard Installation Procedure This chapter describes how to install the MathWorks Release 14 family of products on a computer running Microsoft Wi
55. he License Manager has been installed as a service on your machine Before running MATLAB you must manually start the license manager by using Imtools exe found in the lexim folder of your installation folder or by rebooting your machine For more information see the Installation Guide for Windows The MathWorks Cancel Help Click Next Step 12 Complete the Installation When the MathWorks Installer finishes it displays the Setup Complete dialog box In this dialog box you can choose to start MATLAB as you exit the installer If you do not want to start MATLAB clear this check box Click Finish to exit the installer For information about how to start MATLAB after exiting the installer and other post installation tasks see Step 11 After You Install on page 1 15 For Network Named User licenses you might need to modify the options file created by the installer during installation See Setting Up Network Named User Licensing on page 2 23 for more information Basic Network Installation Procedure Note If you installed the license manager as a service The MathWorks recommends that you restart your computer now The license manager must be running to start MATLAB As a service the license manager gets started automatically at system boot time To learn more see Starting and Stopping the License Manager on page 3 9 oix Setup is complete Click finish to exit MATLAB E SIMU
56. he Typical installation procedure is designed to simplify the installation Choose a Typical installation if you e Have an Individual license e Do not need to pick and choose among the products you want to install e Do not need to access any installation options such as setting the access permissions of installed files Choose a Custom installation if you need to select which products to install or need to access installation options Select the installation type and click Next 1 6 Basic Installation Procedure Select Typical or Custom Installation Type MATLAB SIMULINK Typical Installs all your licensed products using default settings Custom Specify values for all installation options The MathWorks Cancel Help Click Next Product Update Information A PLP can identify a product that is not on any of CDs This can happen when a new product is released after the MathWorks CDs were produced When this occurs the installer displays the names of these new products in the Product Update Notification dialog box The installer also includes this information in the Product Configuration Notes dialog box You must go to the MathWorks Web site to download them after installation is complete Click Next to continue with the installation 1 7 1 Standard Installation Procedure Product Update Notification i x T A Some of the products you are licensed for are not available on this MATLAB co
57. identifies the products that you are licensed to install Do not confuse your PLP with your License Number License File A License File is a specially formatted ASCII text file that contains encrypted product passcodes for each product you are licensed to run Each product passcode identifies the number of keys available for each product The license manager grants or denies access to a product depending on the availability of the license keys associated with each product MATLAB client installations use the License File to determine how to connect to the license server The following figure presents a sample of a License File sent by The MathWorks Each line in the License File that begins with the keyword INCREMENT identifies a product you purchased The lines that begin with a pound sign are comments The MathWorks Installer uses the information in these comment lines license server host ID or Internet address when it processes the License File during installation 3 3 3 License Management 3 4 License Server Host ID Licensed Products BEGIN cut here CUT HERE BEGIN MATLAB license passcode fille for use with FLEX1m LicenseNo 12345 HostID INTERNET 144 212 101 43 INCREMENT TMW_Archive MLM 14 01 may 2004 O DCOE07D489483CC8E89 VENDOR_STRING 20008001200000000f HOSTID DEMO SN 12345 INCREMENT MATLAB MLM 14 01 may 2004 1 EC1E777897879DB7E4EA DUP_GROUP UH SN 12345 INCREMENT SIMULINK
58. igit release code such as 14 12345 12345 12345 12345 e You have a current PLP PLPs are version specific Do not use an old PLP with a new version of MATLAB License File Could Not Be Updated You can receive this error message when you are using the installer to update your licenses see Updating a License on page 1 18 There are two reasons why you received this message e The license file license dat in the MATLAB bin win32 folder is invalid Problems During Installation e You have multiple valid license files in the specified folder e g demo lic and license dat For information about troubleshooting License File issues see Licensing Information on page 3 3 Failure Overwriting an Existing Toolbox Stop any versions of MATLAB or a toolbox that may be running before attempting to run the installation procedure 4 3 4 Troubleshooting Problems After Installation 4 4 After a successful installation you may encounter problems starting MATLAB Many of these problems originate in the license manager FLEXIm used by the MathWorks products This section describes e Getting Help with License Manager Problems e License Manager Error Messages on page 4 5 Getting Help with License Manager Problems When a problem occurs the license manager displays an error message in a window on your display and also writes the message to the FLEXIm log file lmlog txt in the MATLAB f
59. iles You can however use any folder as your MATLAB initial current folder To specify another folder as your initial current folder right click the MATLAB shortcut that the installer creates on your desktop and select the Properties option Specify the name of the folder in the Start in field Setting Up MATLAB Environment Options To include welcome messages default definitions or any MATLAB expressions that you want executed every time MATLAB is invoked create a file named startup min the MATLAB toolbox 1local folder Every time you start MATLAB it executes the commands in the startup m file Configuring Certain Products Certain products require additional configuration The following table lists these products and the commands used to configure them If you installed any of these products see the documentation for that product for detailed configuration information Product Command MATLAB Notebook notebook setup Real Time Windows Target rtwintgt setup Basic Installation Procedure Finding Information About MATLAB After successfully installing MATLAB you are probably eager to get started using it This list provides pointers to sources of information and other features you may find helpful in getting started with MATLAB Task Description To get an overview of Read the MATLAB Getting Started MATLAB and its documentation capabilities To find out what s new in this release To start a product
60. in at the MathWorks Web site Enter name company name and PLP License Information MATLAB SIMULINK Please enter your nami Jan come Name Company Please enter your Personal License Password PUP You should have received this via e mail or fax Pee If you do not have your PLP click the button to get it via the Web The MathWorks Get my PLP Back Cancel Help Click Next Step 4 Specify Location of License File In the License File dialog box specify the full path of your License File and click Next Your License File identifies the products you are licensed to run Ifyou are installing the license manager use the License File you created from the license passcode e mail See Licensing Information on page 3 3 for more information If you are installing MATLAB on a client system see Installing MATLAB on a Client System on page 2 21 for instructions 2 9 2 Network Installation Procedure Enter full path of your License File ixi l TLAB Enter the full path of your license file S Ifyou do not already have a license file create one from the IMULINK passcode email sent by the Mathworks Ifthellicense manager has already been installed use the license file from the FLEXIm folder on your license server Browse The MathWorks Back L nexe Cancel Help Click Next Step 5 Review the Software Licensing Agreement Review
61. ion MATLAB SIMULINK D Applications MATLAB Select products to install MATLAB 7 0 Al I Simulink 6 0 I CDMA Reference Blockset 1 1 V Communications Blockset 3 0 V Communications Toolbox 3 0 I Control System Toolbox 5 3 I Curve Fitting Toolbox iti I Filter Design Toolbox 3 0 The MathWorks Real Time Workshop Space available 21752 M Space required 112M Back Cancel Help Select only your new products Click Next 7 Ifyou are not installing MATLAB you can ignore the Custom Installation dialog box Click Next to proceed 8 Verify your choices in the Confirmation dialog box To proceed with the installation click Install As it copies files to your hard drive the installer displays a status dialog box to show the progress of the installation 9 Depending on which products you installed the installer might display the Product Configuration Notes dialog box Copy any configuration commands for later use See Configuring Certain Products on page 1 16 for more information 10 Click Finish in the Setup Complete dialog box to exit the installer 1 22 Obtaining Your Licenses Obtaining Your Licenses If you need to e Obtain your licenses e Transfer a license to another CPU e Combine licenses Move toolboxes from one license to another e Change a license registration e Update your contact information go to the MathWorks Web site at www mathworks com an
62. it via the Web The MathWorks Get my PLP Back Cancel Help Click Next 1 5 1 Standard Installation Procedure Step 4 Review the Software Licensing Agreement Review the software licensing agreement and if you agree with the terms select the Yes check box and click Next You can view the license agreement after installation in the file License txt located in the top level MATLAB installation folder sox The Mathworks Inc Software License Agreement E Licensee may receive a full refund if within thirty 30 days from the date of delivery the Acceptance Period Licensee does not accept the terms and conditions of this License and the applicable Addendum or if Licensee terminates this License for any reason within the Acceptance Period LICENSE GRANT The MathyVorks Inc Mathworks hereby grants to Licensee a nonexclusive License to install and use the Programs and accompanying Documentation as provided herein The licensed Programs and Documentation shall at all times remain the property of MathWorks and or its Licensors and Licensee shall have no right title or interest therein except as expressly set forth in this Aareement zj Do you accept the terms of the license agreement lt Back Cancel Help Select Yes Click Next Step 5 Choose Installation Type Using the MathWorks Installer you can perform two types of installations Typical or Custom T
63. ke sure that your License File does not contain extra carriage returns or tabs To avoid this make sure that each line begins with either SERVER DAEMON or INCREMENT and replace any tab characters in INCREMENT lines with spaces One way to check for extraneous tabs and carriage returns is to open your License File in a text editor and view all nonprinting characters Remove these tabs and replace with them spaces Problems After Installation e Make sure that the license information in your License File matches the license information The MathWorks sent you License Manager Error 9 License Checkout Failed Invalid Host If you get this error on a system running an individually licensed MATLAB this error typically indicates that you are not running MATLAB on the same system it was installed on You can also get this error if you e Replaced your hard drive e Changed the partition on an existing hard drive e Do not have a C drive e Tried to clone an installation from one system to another To remedy this situation rerun the installer At Step 2 Start the Installer on page 1 4 select the Update license option This option lets you update your license without requiring that you reinstall MATLAB License Manager Error 10 License Checkout Failed Feature Has Expired This error indicates that one or more of your license keys has expired Verify that the expiration date on each of the INCREMENT lines in your License File
64. ke to use MATLAB I Set permissions of installed files to read only useful for SIMULINK installations on mapped or shared drives when you do not want users to have write privileges gt Add MATLAB Shortcuts to IV Desktop IV Programs folder on the Start Menu J Quick Launch bar Associate file types with this application The MathWorks Mm Mfg Mp Vv mat I mdl Back Cancel Help Click Next Step 8 Confirm Your Choices Before it begins copying files to your hard disk the MathWorks Installer displays a summary of the installation To change a setting click the Back button To proceed with the installation click Install 1 Standard Installation Procedure Ix MAT LA B Eann he Maaton item voue See SIMULINK Demo Installation Product Folder D Applications MATLAB Products selected MATLAB 7 0 Simulink 6 0 Control System Toolbox 5 3 Signal Processing Toolbox 6 2 The MathWorks Cancel Help Click Install After you click Install the installer displays a dialog box indicating the progress of the installation Installing Products from the Other CDs If you are installing products that are not on CD 1 the installer prompts you to insert another CD in your CD ROM drive After switching the CDs click OK to continue with the installation If you do not want to install these products click Skip CD 2 You can always install these products later See
65. ks Web site The MathWorks Installer starts automatically displaying the Welcome to the MathWorks Installer dialog box To update a license select the Update license check box and click Next Welcome to the MathWorks Installer 5 x Welcome to the Mathorks Installer This program will install the MATL AB MATLAB family of products C Install WARNING These programs are protected by copyright laws By entering into the Software License Agreement that follows within this installation process you will also agree to additional restrictions on your use ofthese programs Any unauthorized use reproduction or distribution may result in severe civil and criminal penalties The MathWorks Please note that the installer will try to contact the MathVVYorks Web site to retrieve product version information Back Cancel Help Select the Update option Click Next to continue Updating a License 3 Enter your new Personal License Password PLP in the License Information dialog box and then click Next You cannot edit the Name and Company fields when updating a license 4 Review the software licensing agreement and if you agree with the terms select the Yes check box and then click Next 5 Specify the location of your existing MATLAB installation in the Folder Selection dialog box and click Next Specify the name of your existing installation folder Note Zero bytes required Folder Selection MATLAB
66. l Client Access Configuration on page 2 3 Remote Client Access Configuration In a remote client access configuration you install MATLAB and the license manager on a central file server These instructions refer to this system as your license server Users on client systems access MATLAB over the network This figure shows one possible configuration The license manager FLEXIm and MATLAB can be installed on the same server or on separate servers Setting Up a Network Installation erver Client Client Client If your license server is a PC follow the instructions in Basic Network Installation Procedure on page 2 5 If your license server is a UNIX system follow the instructions in the installation documentation for UNIX systems A UNIX license server can serve PC clients and a PC server can serve UNIX clients 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 See Licensing Components on page 3 2 for more setup suggestions Local Client Access Configuration In a local client access configuration you install the license manager on a server and you install MATLAB on each client system When users on client systems start MATLAB it contacts the license manager over the network to check out a license key This figure shows one
67. lex1m folder Read the error message carefully it provides information that can help solve the problem The section License Manager Error Messages on page 4 5 contains brief descriptions of many common error messages with recommended solutions For more complete diagnostic information about an error message go to the MathWorks Web site ww mathworks com and click Support The Support page includes a Search facility that lets you search the support database for help with an error message by error number You can select the error number from the License Manager Errors menu shown in the following figure If the error message you are interested in does not appear on this menu enter the exact error message including the error number in the search text box for example license manager error number 100 Search Solutions and Technical Notes for advanced search search tips License Manager Errors 2 Select error message by number Problems After Installation You can also get information about license manager error messages in the FLEXIm End User Manual available in PDF format in MATLAB flex1m enduser pdf or at the Macrovision Corporation Web site www macrovision com License Manager Error Messages This section provides brief descriptions of some common license manager errors listed in order by error number For more complete diagnostic information about an error message go to the MathWorks Web site
68. n requires the use of dongles it can potentially run into conflicts with other applications you may be running that also use dongles A dongle is a hardware based security device that attaches to the USB port of a computer To use a dongle MATLAB requires a specific set of dongle drivers If you remove other applications from your computer these applications may delete the MATLAB dongle drivers as well as their own To help troubleshoot problems with dongles MATLAB includes a utility program called dongleutil exe The dongle utility program can be used to e Determine the version of the currently installed dongle drivers The MathWorks Technical Support might request this information if you call e Specify the minimum version of the dongle drivers required by MATLAB e Install the dongle drivers required by MATLAB If an installation uses dongles the installer includes the dongleutil exe utility in the MATLAB bin win32 folder where MATLAB represents your MATLAB installation folder 4 Troubleshooting 4 16 A adding products 1 21 C client systems accessing MATLAB 2 3 location of processed License File 3 7 concurrent access configurations 2 2 concurrent installations procedure on client systems 2 21 configuration after installation 1 16 contacting The MathWorks 1 23 current folder initial 1 16 D DAEMON line in License Files 3 7 deleting a MATLAB installation 3 23 demo licenses converting to standard lic
69. nager as a service the license manager gets started automatically at system boot time You can also start or stop the license manager using the Windows Services control panel To start or stop the license manager using the Services control panel 1 Click the Start menu 2 Select the Settings option 3 On the Settings menu select the Control Panel option 3 9 3 License Management 4 Open the Services control panel The method to open this control panel varies depending on the operating system you are running on your computer Operating System Instructions Windows XP From the Control Panel menu select Performance and Maintenance and then select Administrative Tools The Services option is on this menu Windows 2000 From the Control Panel menu select Administrative Tools and then select Services Windows NT In the Control Panel dialog box double click on the Services control panel icon 5 In the Services control panel scroll through the list of services and right click on the MATLAB License Server entry Select Start or Stop from the menu Using FLEXIm License Management Utilities FLEXIm provides license management utilities that you can use to monitor the license manager These utilities are available at the command line or through a graphical user interface Using the Imutil Command The lmutil command available in the MATLAB f1ex1m folder provides access to all the FLEXIm license management utilitie
70. ndows Use this procedure if you have an Individual license With an Individual license you can install MATLAB on any system to which you have access such as your office home and lab systems or your laptop For information about setting up the network license options see Chapter 2 Network Installation Procedure Basic Installation Procedure p 1 2 Provides detailed step by step instructions Updating a License p 1 18 Describes how to update your license from a demo license without having to reinstall MathWorks products Installing Additional Products p 1 21 Describes how to add products to an existing installation Obtaining Your Licenses p 1 23 Describes how to get the license information needed for installation if you don t already have it System Requirements p 1 25 Describes the minimum system requirements to run MathWorks products 1 Standard Installation Procedure 1 2 Basic Installation Procedure This section provides step by step instructions for installing MathWorks products on your computer If you encounter any problems during installation see Chapter 4 Troubleshooting for possible solutions Instead of running the MathWorks Installer and answering the questions posed by each dialog box you can run the installer noninteractively In this mode all the information that you would normally provide using the installer dialog boxes you enter in an installer initialization file For more i
71. nformation see Running the Installer Noninteractively on page 3 21 Note During installation the installer attempts to contact the MathWorks Web site to determine if newer versions of products are available See Step 9 Read Product Configuration Notes on page 1 13 for more information The installer does not send any personal information from your computer to The MathWorks The following table summarizes the steps in the installation procedure If you encounter any trouble during installation see Chapter 4 Troubleshooting for answers to some common installation problems Installation Steps Step 1 Before you install Step 2 Start the installer Step 3 Enter identification and license information Step 4 Review the software licensing agreement Step 5 Choose the installation type Step 6 Specify installation folder For Custom installations you can also specify which products you want to install Step 7 Specify installation options Custom installations only Basic Installation Procedure Installation Steps Step 8 Confirm your choices Step 9 Read product configuration notes Step 10 Complete the installation Step 11 After you install Step 1 Before You Install Before you run the MathWorks Installer program e Have your Personal License Password PLP handy A PLP is a series of five digit numbers prefixed with a two digit release code such as 14 12345 12345 12345
72. nse Manager Daemon The main daemon is the license manager daemon MATLAB flex1m 1mgrd exe This daemon is responsible for managing the initial communication between the licensed application and the vendor daemons associated with each licensed application Licensing Components Vendor Daemon Every vendor that uses FLEX m to manage the licensing of its products must supply a vendor daemon The vendor daemon is responsible for keeping track of how many license keys are available for a particular application and for granting or denying access to the application depending on the current usage of these license keys The MathWorks vendor daemon is MATLAB flex1m m1m exe When users start applications that use FLEXIm license management the applications contact the license manager daemon running on the license server requesting permission to run the application The license manager daemon forwards this request to the vendor daemon associated with the application that grants or denies the request Licensing Information When you purchase one of the network license options The MathWorks sends you licensing information in an e mail or fax This licensing information varies depending on your license option but can include a Personal License Password PLP and a License File Personal License Password PLP A PLP is a series of five digit numbers prefixed with a two digit release code such as 14 12345 12345 12345 12345 12345 that
73. nstall Have your new PLP handy Exit any existing copies of MATLAB you might have running 2 Insert the MathWorks CD 1 into your CD ROM drive or double click the file you downloaded from the MathWorks Web site The installer starts automatically displaying the Welcome to the MathWorks Installer dialog box Select the Install option and click Next 3 Enter your name company name and your new Personal License Password PLP in the License Information dialog box and then click Next 4 Review the software licensing agreement and if you agree with the terms select the Yes check box and then click Next 5 Select the Custom option on the Installation Type dialog box If you want to install only your new products you must choose the Custom option because it enables you to select which products you want to install Click Next to continue 6 Specify the location of your existing MATLAB installation and select the products you want to install in the Product and Folder Selection dialog box By default the MathWorks Installer lists all the products you are licensed to install and preselects them for installation To only install the new products clear the check boxes next to the names of the products that you do not want to install 1 21 1 Standard Installation Procedure Specify the name of your existing installation folder 15 x Browse Product and Folder Selection Select destination folder for installat
74. ollowing is a sample of a processed License File Note the addition of the SERVER and DAEMON lines at the top of the file SERVER yourserver INTERNET 144 212 101 43 27000 DAEMON MLM C matlabri4beta2 flexlm mlm exe options C matlabr14beta2 flexlm MLM opt BEGIN cut here CUT HERE BEGIN MATLAB license passcode file for use with FLEX1m LicenseNo 12345 HostID INTERNET 144 212 101 43 INCREMENT TMW_Archive MLM 14 01 may 2004 0 DCOE0O7D489483CC8E89 VENDOR_STRING 20008001200000000f HOSTID DEMO SN 12345 INCREMENT MATLAB MLM 14 01 may 2004 1 EC1E777897879DB7E4EA DUP_GROUP UH SN 12345 INCREMENT SIMULINK MLM 14 01 may 2004 1 2C4E6709123C87893A9B DUP_GROUP UH SN 12345 INCREMENT Control_Toolbox MLM 14 01 may 2004 1 AC2E789974A6965DDC10 DUP_GROUP UH SN 12345 INCREMENT Identification_Toolbox MLM 14 01 may 2004 1 ACOED7C979217F359783 DUP_GROUP UH SN 12345 INCREMENT Stateflow MLM 14 01 may 2004 1 9C0E34891ED3503BA8B DUP_GROUP UH SN 12345 INCREMENT Database_Toolbox MLM 14 01 may 2004 1 3CAE9769DEB256724EB7 DUP_GROUP UH SN 12345 END cut here CUT HERE END SERVER Line The SERVER line identifies the system on which the license manager is running using the format SERVER hostname HostID TCP_PortNumber where e hostname is the name of your license server i e the system on which the license manager is running e hostID is the host ID of the license server The host
75. page 3 21 Note During installation the installer attempts to contact the MathWorks Web site to determine if newer versions of products are available See Step 11 Read Product Configuration Notes on page 2 17 for more information The installer does not send any personal information from your computer to The MathWorks 2 5 2 Network Installation Procedure The following table summarizes the steps in the network installation procedure If you encounter any trouble during installation see Chapter 4 Troubleshooting for answers to some common installation problems Network Installation Procedure Step 1 Before you install Step 2 Start the installer Step 3 Enter identification and license information Step 4 Specify location of License File Step 5 Review the software licensing agreement Step 6 Specify type of installation must choose Custom Step 7 Specify folder and products Step 8 Configure the license manager as a service Step 9 Specify installation options Step 10 Confirm your choices Step 11 Read product configuration notes Step 12 Complete the installation Step 1 Before You Install Before you run the installation program e Have your Personal License Password PLP and your License File handy A PLP identifies the products that you are licensed to install a License File identifies the products you can run The licensing information you receive varies depending on the type o
76. page 4 12 License Manager Error 21 License Checkout Failed License File Does Not Support This Version on page 4 12 License Manager Error 25 License Checkout Failed License Server Does Not Support This Version of This Feature on page 4 12 License Manager Error 31 License Checkout Failed Feature Not Yet Available on page 4 13 License Manager Error 39 User Host Not on INCLUDE List for Feature on page 4 13 License Manager Error 83 License Checkout Failed FLEXIm Version of Client Newer Than Server on page 4 13 License Manager Error 84 USER_BASED license has no specified users on page 4 13 License Manager Error 96 License Checkout Failed Server Node is Down or Not Responding on page 4 14 License Manager Error 97 License Checkout Failed on page 4 14 License Manager Error 2 License Checkout Failed Invalid License File Syntax This error typically indicates that there is a problem in your License File On client systems make sure your License File MATLAB bin win32 license dat has the following format SERVER host hostID port_num USE_SERVER Problems After Installation Note that there should be a carriage return immediately following the USE_SERVER line License Manager Error 3 License Checkout Failed Cannot Connect to a License Server This error can indicate that the SERVER or DAEMON lines in your License File is incorrect or missing To remed
77. pecify the name of the destination folder 15 x Browse Space available 22186 M Space required 557 M Folder Selection MATLAB SIMULINK ect destination folder for installation D Applications MATLAB The MathWorks Cancel Help Click Next Custom Installation In a Custom installation you use the Product and Folder Selection dialog box to specify the name of the folder into which you want to install MATLAB and to select which products you want to install You can accept the default installation folder or specify the name of a different installation folder If the folder doesn t exist the installer creates it The Product and Folder Selection dialog box also lists all the products you are licensed to install preselected for installation If you do not want to install a particular product clear the check box next to its name You can always install a product later See Installing Additional Products on page 1 21 for more information To continue with the installation click Next 1 Standard Installation Procedure 1 10 Note The installer includes the online documentation in compressed form for each product you install This does not include documentation in PDF format which is only available at the MathWorks Web site Specify the name of the destination folder oxi Browse Product and Folder Selection TLAB ect destination folder for
78. possible configuration Server Client Client Client 2 3 2 Network Installation Procedure You use the same basic network installation procedure to install MathWorks products on a client system However there are some differences See Installing MATLAB on a Client System on page 2 21 for complete information Basic Network Installation Procedure Basic Network Installation Procedure This section describes the basic installation procedure for network installations in both remote and local access configurations For either configuration you must first install the license manager on your license server During this installation the MathWorks Installer performs some necessary processing of your License File You will use this processed License File for all subsequent client installations See Installing MATLAB on a Client System on page 2 21 for more information If you have a remote access configuration you must also install MATLAB on your license server You can install MATLAB and the license manager at the same time Instead of running the installer and answering the questions posed by each dialog box you can run the installer noninteractively In this mode all the information you would normally provide using the installer dialog boxes you enter in an initialization file For more information see Running the Installer Noninteractively on
79. s To view a list of all the capabilities of the lmutil exe utility open a Command Prompt window go to the MATLAB flex1lm folder and type lmutil 3 10 Managing the License Manager Note You must run the lmutil function on the system on which the license manager is running The following table lists the names of the most useful tools available through 1lmutil For more detailed information see the FLEXlm End User Manual included in PDF format in your MATLAB installation MATLAB f lex1m enduser pdf Utility Description lmdiag Diagnose license checkout problems 1mdown Shut down all license daemons both 1mgrd and all vendor daemons on the license server node lmhostid Report the host ID of a system Imreread Make the license manager daemon reread the License File and start any new vendor daemons lmstat Display the status of all network licensing activities lmswitchr Switch the report log file lmver Determine the FLEXIm version of a library or binary file For example to view the current status of the license manager open a DOS command prompt window and enter the lmutil command specifying the name of the lmstat utility The example uses the a option to get a verbose listing of available licenses and the c option to specify the location of the License File to use You must specify the c option with every tool invoked through lmutil exe lmutil lmstat a c C matlabr14 flexlm license dat
80. s are made available on the MathWorks Web site after the CDs are produced If any of the products you installed have updates available the installer lists them in this dialog box You must go to the MathWorks Web site to download them after installation is complete 1 13 1 Standard Installation Procedure 1 14 Step 10 Complete the Installation When the MathWorks Installer finishes it displays the Setup Complete dialog box In this dialog box you can choose to start MATLAB as you exit the installer If you do not want to start MATLAB clear this check box For information about how to start MATLAB after exiting the installer see Starting MATLAB on page 1 15 Click Finish to exit the installer ox Setup is complete Click finish to exit MATLAB Do you want to SIMULINK aTa The MathWorks Click Finish MATLAB Top level Folder Structure After a successful installation your MATLAB installation folder contains the folders listed in the following table Your installation might include additional folders depending on which products you installed Folder Description BIN WIN32 The MATLAB executable and associated files DEMOS MATLAB demonstration programs EXTERN Tools for building external interfaces to MATLAB HELP Help system Basic Installation Procedure JA MATLAB internationalization files JAVA MATLAB Java JAR files NOTEBOOK MATLAB Notebook SYS Tools and operating system librarie
81. s file includes all licensed users See Checking the FLEXIm Options File on page 2 23 for more information e Check that the DAEMON line in your License File includes the options file specification opt ions MATLAB flex1m MLM opt where MATLAB is your MATLAB installation folder Note Do not confuse your License File with your FLEXIm options file The License File contains the encrypted passcodes for each product you are licensed to install and run The FLEXIm options file is a text file that contains license manager options statements such as INCLUDE EXCLUDE and GROUP statements Checking the FLEXIm Options File The installer creates the options file MATLAB f1lex1m MLM opt as part of the installation process The installer puts in the options file an INCLUDE line for each product you are licensed to install and run By default the installer puts the username of the person who performed the install in these INCLUDE lines If you performed your own installation the options file might not need editing However if you performed the installation for another user or if you had root privileges when you performed the installation you will need to edit this options file For example if your username is sysadmin the options file would look like this INCLUDE MATLAB USER sysadmin INCLUDE Signal_Toolbox USER sysadmin INCLUDE Optimization_Toolbox USER sysadmin 2 23 2 Network Installation Procedure 2 24 You must r
82. s that MATLAB depends on TOOLBOX The MathWorks toolboxes UNINSTALL The MATLAB Uninstaller program WORK Default initial current folder Step 11 After You Install This step describes several optional tasks you can perform after a successful installation Starting MATLAB Setting Your Initial Current Folder on page 1 16 Setting Up MATLAB Environment Options on page 1 16 Configuring Certain Products on page 1 16 Finding Information About MATLAB on page 1 17 Starting MATLAB To start MATLAB you can use any of these methods Double click the MATLAB icon called a shortcut that the MathWorks Installer creates on your desktop 2 MATLAB 7 0 e Click the Start button select Programs and click the MATLAB 7 0 entry On the application menu select MATLAB 7 0 1 Standard Installation Procedure 1 16 A maTLas 7 0 a M file Editor G R14 Uninstaller e Using Windows Explorer open your top level MATLAB installation folder and double click the shortcut to the MATLAB executable MATLAB 7 0 Setting Your Initial Current Folder By default when you start MATLAB using the shortcut the installer puts on your desktop the initial current folder is the MATLAB work folder where MATLAB represents the name of your installation folder The work folder is a good place to store the M files you modify and create because the MATLAB uninstaller does not delete the work folder if it contains f
83. s to have write privileges gt Add MATLAB Shortcuts to IV Desktop IV Programs folder on the Start Menu J Quick Launch bar Associate file types with this application V im V fig Vp V ma M mdl lt Back i Cancel Help Click Next Step 10 Confirm Your Choices Before it begins copying files to your hard disk the MathWorks Installer displays a summary of your installation choices To change a setting click the Back button To proceed with the installation click Install ox MATLAB SIMULINK Confirm the installation options you have selected Demo Installation License File Micense dat Product Folder D Applications MATLAB Products selected License Manager 9 2 MATLAB 7 0 Simulink 6 0 Curve Fitting Toolbox 1 1 1 Virtual Reality Toolbox 4 0 athWorks Additional Options License Manager Service zi Cancel Help Click Install 2 16 Basic Network Installation Procedure After you click Install the installer displays a dialog box indicating the progress of the installation Installing Products from the Other CDs If you are installing products that are not on CD 1 the installer prompts you to insert another CD in your CD ROM drive After switching the CDs click OK to continue with the installation If you do not want to install these products click Skip CD 2 You can always install these products later See Installing Additional Products on page
84. sed License File the installer proceeds with the installation creating a template License File in MATLAB bin win32 You cannot run MATLAB until you edit this License File adding the SERVER line from the processed License File 3 License Management Managing the License Manager You typically do not need to know anything about the license manager However there can be times when you want to get the current status of the license manager or perform other license management tasks FLEXIm provides a set of utilities that you can use to help manage the licensing activities on the network The following sections describe e Installing the License Manager as a Service e Removing the License Manager Service on page 3 9 e Starting and Stopping the License Manager on page 3 9 e Using FLEXIm License Management Utilities on page 3 10 e Viewing the License Manager Log File on page 3 13 Note Ifyou want to make changes to your licenses such as combining several licenses or moving an existing toolbox license you must contact The MathWorks See Obtaining Your Licenses on page 1 23 for contact information Installing the License Manager as a Service The MathWorks Installer gives you the option of installing the license manager as a service Installing the license manager as a service provides for automatic startup at system boot time and centralizes administration of the license manager through the Windo
85. setting up 2 2 removing a MATLAB installation 3 23 requirements see system requirements S SERVER line in License Files 3 6 sharing License Files 3 16 troubleshooting 4 10 setup exe in noninteractive installations 3 21 standard installations 4 2 with if option 3 26 shortcut MATLAB shortcut on desktop 1 15 silent installations running without screen displays 3 21 software license agreement 1 6 starting MATLAB 1 15 troubleshooting 4 4 starting the license manager 3 9 start up folder 1 16 system requirements 1 25 T toolboxes adding 1 21 transferring licenses 1 23 troubleshooting during installation 4 2 FLEXIm 4 4 starting MATLAB 4 4 Index 3 Index U uninstall exe starting 3 23 uninstalling MATLAB 3 23 upgrade installations network installations 2 7 standard installations 1 3 USE_SERVER client License File 3 7 user based licensing setting up 2 23 V virus checking software disabling in a standard installation 1 3 disabling in network installations 2 7 troubleshooting installations 4 2 W work folder 1 16 Index 4
86. stallation that uses dongles If you cannot find a description here that matches your problem check the MATLAB Release Notes documentation that you received with your MATLAB products This 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 4 Troubleshooting Problems During Installation 4 2 This section provides answers to some problems commonly encountered during installation Note Ifthe MathWorks Installer appears to hang you may want to turn off any virus checking software you are running on your system and restart the installer The Installer Does Not Start Automatically The installer should start automatically when you insert the MathWorks CD into your CD ROM drive or when you double click on the installer file you downloaded from the MathWorks Web site If the installer does not start open a Windows Explorer window select your CD ROM drive and double click the setup exe program in the top level folder Invalid Personal License Password During installation you must enter your PLP If your PLP is invalid you cannot continue with the installation Verify that e You entered your PLP in the Personal License Password dialog box Do not confuse your License Number with your PLP A PLP is a series of five digit numbers prefixed by a two d
87. stalling MATLAB p 2 5 on your system Installing MATLAB on a Client System Highlights the differences between installing MATLAB p 2 21 on a client system and on a server Setting Up Network Named User Describes post installation tasks Licensing p 2 23 2 Network Installation Procedure Setting Up a Network Installation For network installations The MathWorks uses a license manager program called FLEXI1m to control access to its products FLEXIm is a product of Macrovision Corporation To set up these installations you must install the license manager as well as the MathWorks products you purchased You use the MathWorks Installer to perform both installations Before you install MATLAB in a network installation you must decide what type of configuration you want to set up This decision will determine how many installations you need to perform This section describes these options Using the MathWorks Installer you can set up a network installation with little knowledge of license management software However if you want to integrate the MathWorks products into an already established license management scheme you may need a more thorough understanding of product licensing For an overview of how The MathWorks uses FLEXI m see Chapter 3 License Management Network Configuration Options You can set up a MATLAB network installation in two configurations e Remote Client Access Configuration e Loca
88. the installer still displays the dialog boxes as it progresses through the installation even though no interactive response is required If you want to suppress the display of these dialog boxes during a silent installation set the value of the visible parameter to false 3 21 3 License Management Requesting an output log To request that the installer create an output file that reports on the status of the installation specify the full pathname as the value of the outlog parameter 3 Save your changes to the file 4 Run the installer setup exe using the if flag to specify the initialization file as acommand line argument You must specify the full pathname of the initialization file For example click the Start menu and select the Run option In the Run dialog box enter setup exe if C temp my_install ini 3 22 Removing Uninstalling an Installation Removing Uninstalling an Installation To remove MathWorks products from your system use the MathWorks uninstaller program uninstall exe This section describes e Using the Uninstaller e Running the Uninstaller Noninteractively on page 3 25 e Removing Installations That Use Dongles on page 3 27 Using the Uninstaller To remove MathWorks products from your system follow this procedure 1 Shut down MATLAB before trying to uninstall it 2 Start the uninstaller Click on the Start button choose the Programs option and select the MATLAB 7
89. the software licensing agreement and if you agree with the terms select the Yes check box and click Next You can view the license agreement after installation in the file 1icense txt located in the top level MATLAB installation folder 2 10 Basic Network Installation Procedure License Agreement iol x The Mathworks Inc Software License Agreement E Licensee may receive a full refund if within thirty 30 days from the date of delivery the Acceptance Period Licensee does not accept the terms and conditions ofthis License and the applicable Addendum or if Licensee terminates this License for any reason within the Acceptance Period LICENSE GRANT The MathvVorks Inc MathVVorks hereby grants to Licensee a nonexclusive License to install and use the Programs and accompanying Documentation as provided herein The licensed Programs and Documentation shall at all times remain the property of MathvVorks and or its Licensors and Licensee shall have no right title or interest therein except as expressly set forth in this Aareement zl Do you accept the terms of the license agreement lt Back Select Yes Click Next Step 6 Specify Type of Installation For network installations that include the license manager you must choose the Custom option For information about network installations that do not include the license manager see Installing MATLAB on a Client System on page 2 21
90. this installation process you will also agree to additional restrictions on your use of these programs Any unauthorized use reproduction or distribution may result in severe civil and criminal penalties The MathWorks Please note that the installer will try to contact the MathVVYorks Web site to retrieve product version information Cancel Help Click Next Step 3 Enter Identification and License Information Enter your name company name and Personal License Password PLP in the License Information dialog box and click Next Your PLP identifies the products you are licensed to install If your PLP identifies a product that is not on any of CDs the installer notifies you see Product Update Information on page 2 12 To avoid typing errors copy the PLP from the license e mail and paste it into this dialog box Take care to copy the entire PLP if your e mail program has caused it to wrap onto two lines Basic Network Installation Procedure Note Do not confuse your PLP with your License Number A PLP is a series of five digit numbers prefixed with a two digit release code such as 14 12345 12345 12345 12345 12345 If you do not have your PLP you can click the Get my PLP button to obtain it To get your PLP this way you must have an Internet connection and a MATLAB Access Login Access Login is free of charge and available to all customers If you do not already have one you can create an Access Log
91. tions 3 16 starting 3 9 troubleshooting 4 4 License Number 1 23 License Password See Personal License Password Index 2 license servers defined 2 2 redundant 3 17 license dat creating 3 5 definition 3 3 license txt software license agreement text 1 6 licenses administration tools 3 8 extending expiration date 1 18 managing 1 23 types of 1 1 user based 2 23 licensing troubleshooting 4 4 viewing the log file 4 4 lmgrd exe 3 2 lmlog txt license manager log file 4 4 local client access 2 3 log files license manager 4 4 M MATLAB getting started 1 17 installing basic procedure 1 2 in network configurations 2 3 moving an installation 1 18 removing an installation 3 23 running multiple versions 1 3 2 7 troubleshooting 4 14 starting 1 15 Index N network installation procedure installing MATLAB in network configurations 2 5 instructions 2 1 on client systems 2 21 Notebook configuration 1 16 P passcode encrypted in license file 3 4 password See Personal License Password Personal License Password PLP compared to License Number 1 3 definition 3 3 installing additional products 1 21 specifying concurrent installations 2 8 standard installations 1 5 when updating a license 1 19 port number changing 4 14 used for license manager 3 6 products adding 1 21 selecting concurrent installations 2 13 R Real Time Windows Target configuration 1 16 redundant license servers 3 17 remote client access
92. ws Services control panel To use install exe to install the license manager as a service follow this procedure 1 Open a DOS Command Prompt window 2 Move to the MATLAB flex1m folder where MATLAB represents your MATLAB installation folder 3 Enter the command 3 8 Managing the License Manager install c MATLAB flexim license dat e MATLAB flex1m 1lmgrd exe where the c flag specifies name of your processed License File and the e flag specifies the name of the license manager daemon Specifying the Name of the License Manager Service By default the license manager service is called the MATLAB License Server in the Windows Services control panel Using the install exe utility you can specify the name of the license manager service as it will appear in the Windows Services control panel To specify a different name use install exe with the n flag install c MATLAB flexlm license dat e MATLAB flexim lmgrd exe n my server Removing the License Manager Service To remove the license manager service use install exe with the r flag and the e flag If the name of the license service is not MATLAB License Server you must specify it on the command line using the n flag install e MATLAB flexlm lmgrd exe n my server r To get more information about the syntax of the install exe program enter install at the command prompt Starting and Stopping the License Manager If you installed the license ma
93. y the host ID of the server on which you intend to run the license manager On PCs running the Windows operating system you use the Ethernet address or IP address as the host ID To get this information open a command prompt window and run the ipconfig command C WINNT system32 ipconfig all Note Be sure to get the host ID of the system on which you plan to run the license manager not the host ID of a client workstation System Requirements System Requirements Note For the most up to date information about system requirements go to the support area at the MathWorks Web site www mathworks com and click Support General Requirements e CD ROM drive for installation from CD e Netscape Navigator 4 0 and above or Microsoft Internet Explorer 4 0 and above is required e Adobe Acrobat Reader 3 0 is required to view and print the MATLAB documentation in PDF format e Some license types require a license server running FLEXI m 9 2 which is provided by the MathWorks Installer e TCP IP is required on all platforms when using a license server e An available USB port for licenses that require a hardware lock Platform Specific Requirements Operating System Processors Disk Space RAM Windows XP Pentium III IV 345 MB MATLAB 256 MB Minimum f Xeon Pentium M only with help Windows 2000 ERE 4 j 512 MB Service Pack 3 or 4 Athlon XP Athlon MP Recommended Windows NT 4 0 Service Pack 5 or 6a
94. y this error try the following Note If you make any changes to the License File on the license server you must restart the license manager e Make sure that the SERVER line in your License File matches the SERVER line in the License File on your license server On client systems the License File is MATLAB bin win32 license dat on your license server the License File is MATLAB flexlm license dat where MATLAB is the root MATLAB installation folder Make sure that your License File includes a DAEMON line See DAEMON Line on page 3 7 for more information Make sure the TCP port number at the end of the SERVER line in your License File is not already being used by another application On Windows 2000 and Windows NT systems run C WINNT system32 netstat p tcp If the local system appears on the Foreign Address list then the port number listed is being used Change the port number on the SERVER line to a port that is not being used By default if a port is not specified FLEXIm uses a port number in the range 27000 to 27009 e Make sure that you do not have multiple MathWorks vendor daemons mlm exe running Check your FLEXIm log file MATLAB flex1lm 1mlog txt for the error Multiple MLM Servers Running License Manager Error 5 License Checkout Failed No Such Feature Exists This error usually indicates that you are trying to use a product for which you are not licensed 4 7 4 Troubleshooting 4 8

Installation Guide for Windows

Contents

Download Pdf Manuals

Related Search

Related Contents