Configure for HPC Server

Configure Cluster for Microsoft Windows HPC Server

    Note   You must have the 64-bit version of MATLAB® Distributed Computing Server™ installed on your cluster to use it with HPC Server. 32-bit MDCS does not support HPC Server.

Follow these instruction to configure your MDCS installation to work with Windows® HPC Server or Compute Cluster Server (CCS). In the following instructions, matlabroot refers to the MATLAB installation location.

    Note   If using HPC Server in a network share installation, the network share location must be in the "Intranet" zone. You might need to adjust the Internet Options for your cluster nodes and add the network share location to the list of Intranet sites.

  1. Log in on the cluster head node as a user with administrator privileges.

  2. Open a command window with administrator privileges and run the following file command

    matlabroot\toolbox\distcomp\bin\MicrosoftHPCServerSetup.bat -cluster 

    This command performs some of the setup required for all machines in the cluster. The location of the MATLAB installation must be the same on every cluster node.

      Note   If you need to override the script default values, modify the values defined in MicrosoftHPCServerSetup.xml before running MicrosoftHPCServerSetup.bat. Use the -def_file argument to the script when using a MicrosoftHPCServerSetup.xml file in a custom location. For example:

      MicrosoftHPCServerSetup.bat -cluster -def_file <filename>

      You modify the file only on the node where you actually run the script.

      An example of one of the values you might set is for CLUSTER_NAME. If you provide a friendly name for the cluster in this parameter, it is recognized by MATLAB's discover clusters feature and displayed in the resulting cluster list.

Configure Client Computer for HPC Server

This configuring applies to all versions of HPC Server.

    Note   If using HPC Server in a network share installation, the network share location must be in the "Intranet" zone. You might need to adjust the Internet Options for your cluster nodes and add the network share location to the list of Intranet sites.

  1. Open a command window with administrator privileges and run the following file command

    matlabroot\toolbox\distcomp\bin\MicrosoftHPCServerSetup.bat -client 

    This command performs some of the setup required for a client machine.

      Note   If you need to override the default values the script, modify the values defined in MicrosoftHPCServerSetup.xml before running MicrosoftHPCServerSetup.bat. Use the -def_file argument to the script when using a MicrosoftHPCServerSetup.xml file in a custom location. For example:

      MicrosoftHPCServerSetup.bat -client -def_file <filename>
  2. To submit jobs or discover the cluster from MATLAB, the Microsoft HPC Server client utilities must be installed on your MATLAB client machine. If they are not already installed and up to date, ask your system administrator for the correct client utilities to install. The utilities are available from http://www.microsoft.com/hpc/en/us/default.aspx.

Validate Installation Using Microsoft Windows HPC Server

This procedure verifies that your parallel computing products are installed and configured correctly for using Microsoft® Windows HPC Server or Compute Cluster Server (CCS).

Step 1: Define a Cluster Profile

In this step you define a cluster profile to use in subsequent steps.

  1. Start the Cluster Profile Manager from the MATLAB desktop by selecting on the Home tab in the Environment area Parallel > Manage Cluster Profiles.

  2. Create a new profile in the Cluster Profile Manager by selecting New > HPC Server.

  3. With the new profile selected in the list, click Rename and edit the profile name to be HPCtest. Press Enter.

  4. In the Properties tab, provide text for the following fields:

    1. Set the Description field to For testing installation with HPC Server.

    2. Set the NumWorkers field to the number of workers you want to run the validation tests on, within the limitation of your licensing.

    3. Set the Host field to the name of the host on which your scheduler is running. Depending on your network, this might be a simple host name, or it might have to be a fully qualified domain name.

      Note: The following four property settings (JobStorageLocation, ClusterMatlabRoot, ClusterVersion, and UseSOAJobSubmission) are optional, and need to be set in here in the profile only if you did not run MicrosoftHPCServerSetup.bat as described in Configure Cluster for Microsoft Windows HPC Server, or if you want to override the setting established by that script.

    4. Set the JobStorageLocation to the location where you want job and task data to be stored. This must be accessible to all the worker machines.

        Note   JobStorageLocation should not be shared by parallel computing products running different versions; each version on your cluster should have its own JobStorageLocation.

    5. Set the ClusterMatlabRoot to the installation location of the MATLAB to be executed by the worker machines, as determined in Chapter 1 of the installation instructions.

    6. Set the ClusterVersion field to HPCServer or CCS.

    7. If you want to test SOA job submissions on an HPC Server cluster, set UseSOAJobSubmission to true. Otherwise leave the setting Use default or false. If you plan on using SOA job submissions with your cluster, you should test this first without SOA submission, then later return and test it with SOA job submission.

      So far, the dialog box should look like the following figure:

  5. Click Done to save your cluster profile.

Step 2: Validate the Configuration

In this step you validate your cluster profile, and thereby your installation.

  1. If it is not already open, start the Cluster Profile Manager from the MATLAB desktop by selecting on the Home tab in the Environment area Parallel > Manage Cluster Profiles.

  2. Select your cluster profile in the listing.

  3. Click Validate.

The Validation Results tab shows the output. The following figure shows the results of a profile that passed all validation tests.

    Note   If your validation does not pass, contact the MathWorks install support team.

If your validation passed, you now have a valid profile that you can use in other parallel applications. You can make any modifications to your profile appropriate for your applications, such as NumWorkersRange, AttachedFiles, AdditionalPaths, etc. To save your profile for other users, select the profile and click Export, then save your profile to a file in a convenient location. Later, when running the Cluster Profile Manager, other users can import your profile by clicking Import.

Was this topic helpful?