Stage 1 of 4

Stage 1 of 4: Installing MATLAB® Distributed Computing

Server™ 4.3 on a Windows® Operating System Cluster
Follow these instructions to install MATLAB® Distributed Computing
Server™ (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 MDCS
cluster nodes; but this is only one possible configuration. You can install MDCS
on the same system where your license manager runs, but this type of
installation is not discussed in this document.

MDCS Cluster
Head Node License server

MDCS
License Manager

Worker Node Worker Node Worker Node

MDCS MDCS MDCS

Product Installations for MDCS Cluster in a Local Access Configuration

Step 1: Update Your Existing License File

Update your current License File with the licensing information that you
download from the Web. Then follow the instructions that are appropriate for
the platform on which you run the license manager.

For help, contact the MathWorks install support team at 1

508-647-7000 or http://www.mathworks.com/support/contact_us/.
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 and

license manager. The MDCS installation does not start until Step 2, “Install
MDCS on Head Node.”

License Manager Runs on a UNIX® Operating System

Note In these instructions, matlabroot refers to the MATLAB installation

folder where the license manager is installed.

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

2 Visit the MathWorks Web site at

http://www.mathworks.com/managelicenses to access your account and
download your license file.

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

The information in the license file you obtain is one or more INCREMENT lines
that 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. Make
sure to select all the text in this section, including the comment lines. Copy
the selected text.

4 Open the License File (license.dat) located in the matlabroot/etc folder

using a text editing application (vi, emacs, etc.).

For help, contact the MathWorks install support team at 2

508-647-7000 or http://www.mathworks.com/support/contact_us/.
Installing MDCS 4.3 Stage 1 of 4

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 a

license. However, note the following:
- Make sure you remove any line breaks that you might 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 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 the
matlabroot/etc folder:
./lmstart

License Manager Runs on a Windows® Operating System

Note In these instructions, matlabroot refers to the MATLAB installation

folder 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 following

command from the matlabroot\flexlm folder.
lmtools.exe

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

For help, contact the MathWorks install support team at 3

508-647-7000 or http://www.mathworks.com/support/contact_us/.
Installing MDCS 4.3 Stage 1 of 4

2 Visit the MathWorks Web site at

http://www.mathworks.com/managelicenses to access your account and
download your license file.

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

The information in the license file you obtain is one or more INCREMENT lines
that 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. Make
sure to select all the text in this section, including the comment lines. Copy
the selected text.

4 Open the License File (license.dat) located in the matlabroot\flexlm

folder 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 a

license. However, note the following:
- Make sure you remove any line breaks that you might 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 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 the
Start/Stop/Reread panel in LMTOOLS.

For help, contact the MathWorks install support team at 4

508-647-7000 or http://www.mathworks.com/support/contact_us/.
Installing MDCS 4.3 Stage 1 of 4

Step 2: Install MDCS on the Head Node

In 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 each
dialog box:

Installer Dialog Actions

Box

MathWorks Select Install without using the Internet, then click

Installer Next.

License Review the license agreement and select Yes, then click
Agreement Next.

File Installation Select I have the File Installation Key for my

Key license. Enter your File Installation Key obtained from
your account on The MathWorks Web site, then click
Next.

Installation Select Typical installation, then click Next. (You can

Type choose Typical because you are not installing the
license manager. In a Typical installation, the installer
installs all the products you are licensed to install, by
default.)

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

License File Specify the License File (license.dat) that you

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

For help, contact the MathWorks install support team at 5

508-647-7000 or http://www.mathworks.com/support/contact_us/.
Installing MDCS 4.3 Stage 1 of 4

Installer Dialog Actions

Box

Product Read information about post-installation tasks. These

Configuration tasks are described later. Click Next to continue.
Notes

Installation Click Finish to exit the installer.

Complete

Note MDCS installations are intended to function only in conjunction with

Parallel Computing Toolbox. If you try to start a regular interactive MATLAB
session directly from the MDCS installation, you might receive license
manager error -18 because the installation does not include a license for
interactive MATLAB sessions.

Step 3: Install MDCS on Worker Nodes

In 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 each
dialog box. Repeat this process for every worker node:

Installer Dialog Actions

Box

MathWorks Select Install without using the Internet, then click

Installer Next.

License Review the license agreement and select Yes, then click
Agreement Next.

File Installation Select I have the File Installation Key for my

Key license. Enter your File Installation Key obtained from
your account on The MathWorks Web site, then click
Next.

For help, contact the MathWorks install support team at 6

508-647-7000 or http://www.mathworks.com/support/contact_us/.
Installing MDCS 4.3 Stage 1 of 4

Installer Dialog Actions

Box

Installation Select Typical installation, then click Next. (You can

Type choose Typical because you are not installing the
license manager. In a Typical installation, the installer
installs all the products you are licensed to install, by
default.)

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

License File When prompted for a License File, specify this file from
the head node: matlabroot\flexlm\license.dat (not
the 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.

Product Read information about post-installation tasks. These

Configuration tasks are described later. Click Next to continue.
Notes

Installation Click Finish to exit the installer.

Complete

Step 4: Test Worker Licensing

To verify that MDCS workers can start correctly on the worker nodes and
perform 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 the
text on a single line:
matlabroot\bin\matlab -logfile output.txt -dmlworker -nodisplay
-r exit

where matlabroot refers to the MDCS installation folder.

For help, contact the MathWorks install support team at 7

508-647-7000 or http://www.mathworks.com/support/contact_us/.
Installing MDCS 4.3 Stage 1 of 4

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

If the worker was able to check out a license, the file should contain
information 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 information
similar 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 at
508-647-7000.

© COPYRIGHT 2005–2010 by The MathWorks, Inc. MATLAB and Simulink are registered
trademarks of The MathWorks, Inc. See www.mathworks.com/trademarks for a list of
additional trademarks. Other product or brand names may be trademarks or registered
trademarks of their respective holders.
The MathWorks products are protected by one or more U.S. patents. Please see
www.mathworks.com/patents for more information.

For help, contact the MathWorks install support team at 8

508-647-7000 or http://www.mathworks.com/support/contact_us/.