Installing Matlab

For help, contact the MathWorks install support team at 1508-647-7000 or http://www.mathworks.com/support/contact_us/.

Stage 1 of 4Stage 1 of 4: Installing MATLAB® Distributed ComputingServer™ 4.3 on a Windows® Operating System Cluster

Follow these instructions to install MATLAB® Distributed ComputingServer™ (MDCS) software:

• On nodes running Microsoft® Windows® operating systems

• Locally on each node in your cluster (nonshared file system)

• Using an existing MATLAB license manager on your network

To set up this configuration, you must install the MDCS on every cluster node.You do not need to install the license manager on any of the cluster nodes;instead, use an existing license manager.

This figure shows the installations that you must perform on your MDCScluster nodes; but this is only one possible configuration. You can install MDCSon the same system where your license manager runs, but this type ofinstallation is not discussed in this document.

Product Installations for MDCS Cluster in a Local Access Configuration

Step 1: Update Your Existing License FileUpdate your current License File with the licensing information that youdownload from the Web. Then follow the instructions that are appropriate forthe platform on which you run the license manager.

MDCS

Head Node

MDCS MDCS MDCS

Worker Node

MDCS Cluster

Worker Node Worker Node

License server

License Manager

Installing MDCS 4.3 Stage 1 of 4


• “License Manager Runs on a UNIX® Operating System” on page 2

• “License Manager Runs on a Windows® Operating System” on page 3

Note These instructions refer to your existing MATLAB installation andlicense manager. The MDCS installation does not start until Step 2, “InstallMDCS on Head Node.”

License Manager Runs on a UNIX® Operating System

Note In these instructions, matlabroot refers to the MATLAB installationfolder where the license manager is installed.

1 Stop the license manager. Open a terminal window and use the followingcommand from the matlabroot/etc folder.

./lmdown

2 Visit the MathWorks Web site athttp://www.mathworks.com/managelicenses to access your account anddownload your license file.

(If you have any trouble obtaining your license file, see the solution locatedat http://www.mathworks.com/support/solutions/data/1-5VWC8W.htmlor by searching for 1-5VWC8W on the MathWorks Support Web site.)

The information in the license file you obtain is one or more INCREMENT linesthat look similar to this:

INCREMENT MATLAB_Distrib_Comp_Engine MLM 17 01-dec-2000 8 \ BD530123654ECED8D04A SN=DEMO

3 Select all the information from the BEGIN line to the END line, inclusive. Makesure to select all the text in this section, including the comment lines. Copythe selected text.

4 Open the License File (license.dat) located in the matlabroot/etc folderusing a text editing application (vi, emacs, etc.).



5 Append the text copied from the Web to the end of the License File.

In general, do not edit the licensing information; you may invalidate alicense. However, note the following:

- Make sure you remove any line breaks that you might have insertedbetween the start and end of an INCREMENT line. If an INCREMENT line mustcontinue onto more than one line, use the \ (backslash) character, as in thefollowing:

INCREMENT MATLAB_Distrib_Comp_Engine MLM 17 01-dec-2000 8 \ BD530123654ECED9D04A SN=DEMO- Make sure that there is a space between each field in the INCREMENT line.

Do not use tabs to separate these fields.

- License Files are case sensitive.

6 Save and close the License File.

7 Restart the license manager using the following command from thematlabroot/etc folder:

./lmstart

License Manager Runs on a Windows® Operating System

Note In these instructions, matlabroot refers to the MATLAB installationfolder where the license manager is installed.

1 Stop the license manager, using the Macrovision LMTOOLS utility.

Open a terminal window and launch LMTOOLS using the followingcommand from the matlabroot\flexlm folder.

lmtools.exe

Click the Start/Stop/Reread tab and then click Stop Server.



2 Visit the MathWorks Web site athttp://www.mathworks.com/managelicenses to access your account anddownload your license file.

(If you have any trouble obtaining your license file, see the solution locatedat http://www.mathworks.com/support/solutions/data/1-5VWC8W.htmlor by searching for 1-5VWC8W on the MathWorks Support Web site.)

The information in the license file you obtain is one or more INCREMENT linesthat look similar to this:

INCREMENT MATLAB_Distrib_Comp_Engine MLM 17 01-dec-2000 8 \ BD530123654ECED8D04A SN=DEMO

3 Select all the information from the BEGIN line to the END line, inclusive. Makesure to select all the text in this section, including the comment lines. Copythe selected text.

4 Open the License File (license.dat) located in the matlabroot\flexlmfolder using a text editing application (vi, emacs, Notepad on Windows, etc.).

5 Append the text copied from the Web to the end of the License File.

In general, do not edit the licensing information; you may invalidate alicense. However, note the following:

- Make sure you remove any line breaks that you might have insertedbetween the start and end of an INCREMENT line. If an INCREMENT line mustcontinue onto more than one line, use the \ (backslash) character, as in thefollowing:

INCREMENT MATLAB_Distrib_Comp_Engine MLM 17 01-dec-2000 8 \ BD530123654ECED9D04A SN=DEMO- Make sure that there is a space between each field in the INCREMENT line.

Do not use tabs to separate these fields.

- License Files are case sensitive.

6 Save and close the License File.

7 Restart the license manager. Click the Start Server button on theStart/Stop/Reread panel in LMTOOLS.



Step 2: Install MDCS on the Head NodeIn this step, you install MDCS on the head node.

Start the MathWorks Installer by inserting the DVD into the drive on the node.Proceed through the installer process performing the specified action in eachdialog box:

Installer DialogBox

Actions

MathWorksInstaller

Select Install without using the Internet, then clickNext.

LicenseAgreement

Review the license agreement and select Yes, then clickNext.

File InstallationKey

Select I have the File Installation Key for mylicense. Enter your File Installation Key obtained fromyour account on The MathWorks Web site, then clickNext.

InstallationType

Select Typical installation, then click Next. (You canchoose Typical because you are not installing thelicense manager. In a Typical installation, the installerinstalls all the products you are licensed to install, bydefault.)

Folder Selection Specify a new installation folder, then click Next.

License File Specify the License File (license.dat) that youupdated in Step 1, then click Next.

Confirmation Review your installation choices. To change a setting,click the Back button. To proceed with the installation,click Install.



Note MDCS installations are intended to function only in conjunction withParallel Computing Toolbox. If you try to start a regular interactive MATLABsession directly from the MDCS installation, you might receive licensemanager error -18 because the installation does not include a license forinteractive MATLAB sessions.

Step 3: Install MDCS on Worker NodesIn this step, you install MDCS on each worker node.

Start the MathWorks Installer by inserting the DVD into the drive on the node.Proceed through the installer process performing the specified action in eachdialog box. Repeat this process for every worker node:

ProductConfigurationNotes

Read information about post-installation tasks. Thesetasks are described later. Click Next to continue.

InstallationComplete

Click Finish to exit the installer.

Installer DialogBox

Actions

MathWorksInstaller

Select Install without using the Internet, then clickNext.

LicenseAgreement

Review the license agreement and select Yes, then clickNext.

File InstallationKey

Select I have the File Installation Key for mylicense. Enter your File Installation Key obtained fromyour account on The MathWorks Web site, then clickNext.

Installer DialogBox

Actions



Step 4: Test Worker LicensingTo verify that MDCS workers can start correctly on the worker nodes andperform a license checkout, perform the following procedure:

1 Log in to a worker node.

2 Open a DOS command window and run the following command, entering thetext on a single line:

matlabroot\bin\matlab -logfile output.txt -dmlworker -nodisplay-r exit

where matlabroot refers to the MDCS installation folder.

InstallationType

Select Typical installation, then click Next. (You canchoose Typical because you are not installing thelicense manager. In a Typical installation, the installerinstalls all the products you are licensed to install, bydefault.)

Folder Selection Specify a new installation folder, then click Next.

License File When prompted for a License File, specify this file fromthe head node: matlabroot\flexlm\license.dat (notthe license file you created in Step 1), then click Next.

Confirmation Review your installation choices. To change a setting,click the Back button. To proceed with the installation,click Install.

ProductConfigurationNotes

Read information about post-installation tasks. Thesetasks are described later. Click Next to continue.

InstallationComplete

Click Finish to exit the installer.

Installer DialogBox

Actions



3 Enter the following command in the DOS command window to look at theoutput file, output.txt:

more output.txt

If the worker was able to check out a license, the file should containinformation similar to the following:

To get started, type one of these: helpwin, helpdesk, or demo. For product information, visit www.mathworks.com.

If the license checkout failed, the file output.txt should contain informationsimilar to the following:

License Manager Error ... Feature: MATLAB_Distrib_Comp_Engine … FLEXlm error: …

For further information, refer to the FLEXlm End User Manual, available at "www.macrovision.com".

For more information, see The MathWorks Support page at http://www.mathworks.com/support and search for "license manager error -1"

If you need help with this step, call The MathWorks install support team at508-647-7000.

© COPYRIGHT 2005–2010 by The MathWorks, Inc. MATLAB and Simulink are registeredtrademarks of The MathWorks, Inc. See www.mathworks.com/trademarks for a list ofadditional trademarks. Other product or brand names may be trademarks or registeredtrademarks of their respective holders.

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

Documents

Installing Matlab