MatLab DCS R2010a and Earlier

The MATLAB Distributed Computing Server (MATLAB DCS) is a parallel computing extension to MATLAB that enables processing to be spread across a large number of worker nodes, accelerating the speed at which compute intensive operations can complete.

UAB IT Research Computing maintains a 128 worker node license for the the Cheaha computing platform. In order to use DCS on Cheaha, you will need to [[MATLAB#Using_MATLAB|use a MATLAB instance] with the Parallel Computing Toolbox installed.

In order to leverage the MATLAB worker nodes on Cheaha the Parallel Computing Toolbox will need to be configured to communicate with Cheaha by following the steps in this document.

MATLAB from Your Desktop
Once SSH has been successfully configured, you are ready to continue setting up the MATLAB client.

MATLAB Parallel Computing Toolbox enables you to submit your MATLAB code to the cluster without leaving the graphical interface.

This section discusses the following steps:
 * 1) Download and extract the MATLAB submission functions
 * 2) Start the MATLAB client
 * 3) Add the cheaha Parallel Computing Toolbox configuration
 * 4) Perform the validation tests

MATLAB Submit Functions
In order for Parallel Computing Toolbox to work with our cluster, you will have to copy the special submit functions to your MATLAB PATH.

These steps document the DCS configuration for MatLab 2010a and earlier. For DCS configuration instructions on previous versions of MatLab, please visit the page MatLab DCS.

MATLAB Versions R2010a and prior

 * 1) Download the appropriate zipped file for your operating system (note that both Linux and Mac use the 'unix' submit functions)
 * 2) * Windows MATLAB R2010a and prior Submit Functions - Updated 05/13/2010
 * 3) * Linux MATLAB R2010a and prior Submit Functions - Updated 05/13/2010
 * 4) * Mac MATLAB R2010a and prior Submit Functions - Updated 05/13/2010
 * 5) Unzip the files to a directory on your MATLAB PATH. Typical MATLAB PATH locations are:
 * 6) * All Systems: $MATLABROOT/toolbox/local
 * 7) * Windows:    My Documents\MATLAB
 * 8) * Linux: $HOME/Documents/MATLAB
 * 9) * Mac: ???

Once the submit function files have been downloaded and unzipped to your MATLAB PATH, start/restart the MATLAB client.

NOTE: Your MATLAB PATH may be viewed/altered by starting the MATLAB client on your workstation and clicking File -> Set Path

Parallel Computing Toolbox Configuration
In this section we will add the cheaha configuration to the Parallel Computing Toolbox followed by a quick validation test.

MATLAB R2010a and Earlier
Prior to continuing, make sure that you've completed the following:
 * 1) Configured SSH and successfully tested passwordless authentication to Cheaha
 * 2) Loaded your SSH key
 * 3) * Windows users - means starting PuTTY Pagent and loading your SSH key
 * 4) * Linux users - means running ssh-agent to load the SSH key
 * 5) * Mac users - same as for Linux, run ssh-agent
 * 6) Downloaded and extracted the latest MATLAB submission scripts to your MATLAB PATH

Now that the prerequisites are complete:
 * 1) Download and save the Cheaha cluster configuration file for MATLAB R2010a and prior, this will be imported into MATLAB further down
 * 2) Start the MATLAB client on your workstation (Windows users should have a MATLAB icon on the desktop), Linux may have to use the command line. On Mac, from Finder click on the MATLAB icon located at /Applications/
 * 3) Click the Parallel menu
 * 4) Click Manage Configurations
 * 5) Click File -> Import
 * 6) Browse to the location where you saved the cheaha-R2010a.mat file select it and click Open

The Configuration Manager should now list a new entry for cheaha.

You may have to change the following settings (double click on cheaha in the Configuration Manager window):
 * Root directory of MATLAB installation for workers (ClusterMatlabRoot): /share/apps/mathworks/R2010a
 * Directory where job data is stored (DataLocation): C:\jobs\matlab

The configuration will look similar to this screen shot