Main Content

Install and ConfigureMATLABParallel Serverfor Third-Party Schedulers

If you already have a cluster with a scheduler, follow these instructions to integrate MATLAB®with your scheduler usingMATLAB Parallel Server™. If you do not have an existing scheduler in your cluster, see:Install and Configure MATLAB Parallel Server for MATLAB Job Scheduler and Network License Manager.

These instructions guide you through the following tasks:

After you integrate MATLAB with a scheduler, you can access workers in your cluster from a desktop MATLAB client session with Parallel Computing Toolbox™.Workersare MATLAB computational engines that typically correspond to a core.

The setup in these steps uses the network license manager.

Activate YourMATLABParallel ServerLicense

To installMATLAB Parallel Server, you must activate your license. To activate yourMATLAB Parallel Serverlicense:

  1. Navigate to//www.tatmou.com/licensecenter.

  2. Log into the Administrator’s MathWorks Account.

  3. Select yourMATLAB Parallel Serverlicense, and click theInstall and Activatetab.

  4. At the rightmost side, underRELATED TASKS, selectActivate to Retrieve License File.

  5. Fill in the requested information. This information must refer to the machine that hosts the license manager. In these instructions, it is the head node. For more information, seeInstall License Manager.

  6. After filling in the information, download or email the License File and copy the File Installation Key. These are used later in the process.

Note

Activation is not necessary for trials. Contact your sales representative to obtain the License File and the File Installation Key.

Get the Installation Files

To save time and eliminate the need for the installer-based download process for each computer in your cluster, download the installation files prior to installation. Doing so facilitates installation in a large number of machines. If you have access to an Administrator’s account for your license, you can use the installer to download files without installing them. If not, contact the administrator of your license to obtain a copy of the installation files. For more information, seeDownload Products Without Installing. When using the installer to download the files, choose the following options:

  • Select the appropriate operating system for the cluster nodes.

  • Select all products for download.MATLAB Parallel Servercannot run jobs requiring products that are not installed.

There are three server-side components ofMATLAB Parallel Server:

  1. The license manager, which hosts theMATLAB Parallel Serverlicense used by each worker. For more information, seeInstall License Manager.

  2. Your third-party job scheduler, which runs on the head node and manages jobs on your cluster. You integrate this scheduler withMATLAB Parallel Server. For more information, seeInstall License ManagerandConfigure Your Cluster.

  3. MATLAB Parallel Server, which runs on the compute nodes. For more information, seeInstall Software on Compute Nodes.

Install License Manager

Choose a computer node to host the license manager. For the installation, use the offline installer from the previous step. For more information on the offline installation procedure, seeInstall Products Using File Installation Key.

  1. Start the MATLAB installer from the installation files acquired inGet the Installation Files.

  2. SelectAdvanced Options>I want to install network license manager.

  3. In the License File step, browse to yourlicense.licfile (obtained fromActivate Your MATLAB Parallel Server License).

  4. Continue through the prompts to complete the network manager installation. For more information about the procedure, seeInstall License Manager on License Server

  5. 启动许可证manager.

Install Software on Compute Nodes

This procedure is similar toInstall License Manager. For more information on the offline installation procedure, seeInstall Products Using File Installation Key.

  1. Start the MATLAB installer from the installation files acquired inGet the Installation Files.

  2. SelectAdvanced Options>I have a File Installation Keyand continue through the prompts.

  3. Select all products. Alternatively, to save space, install only the products that the users of the cluster are licensed for.

  4. Use thelicense.datfile from the head node. You can obtain this file from thematlabroot /等folder, wherematlabrootis the MATLAB installation folder.

For best performance, install locally on each node. However, you can also install in a network share location.

Note

Install noninteractively (silently) instead if you want to

  • Install the software on a machine without graphical user interface (GUI).

  • Save the time that it takes to configure the installer for each compute node.

For more information, seeInstall Noninteractively.

You can test the installation and licensing by running the following command in a command-line interface.matlabrootis the MATLAB installation folder.filenameis the location to write the log file to, for example, a temporary location. You must have write permissions in this location.

matlabroot/toolbox/parallel/bin/checkLicensing -logfilefilename

Note

你不need to start the mjs service when you want to configureMATLAB Parallel Serverfor a third-party scheduler.

Install Software on Local Desktop

To useMATLAB Parallel Server, you must use a local desktop running MATLAB and Parallel Computing Toolbox. Install the MathWorks®products for which you are licensed, including Parallel Computing Toolbox, on the local desktops from which you want to submit jobs to the cluster. For help with this step, seeInstallation and Licensing.

Any MATLAB cluster workers that you start use dynamic licensing: they can use all the functionality you are licensed for in the MATLAB client, while checking out onlyMATLAB Parallel Serverlicenses in the cluster.

Configure Your Cluster

When the cluster and client installations are complete, you can proceed to configure the products for the job scheduler of your choice. Use this table to choose a suitable guide to complete your configuration.

Next step 更多的信息

Use out-of-the-box support If

  • Your scheduler has out-of-the-box support in MATLAB. These schedulers are Slurm, PBS Pro, OpenPBS, Torque, LSF®, and HPC Pack.

  • There is a shared file system between the client machine and the cluster nodes.

  • The client machine has the third-party scheduler submission tools installed. You can check this by executing the relevant commands in a command line. For example, the Slurm submission script issbatch.
Use out-of-the-box support if you have a Hadoop®cluster.

Use the generic scheduler interface.

See Also