There are several issues that can prevent the validation of the cluster. Run the following tests below to make sure that your configuration is setup properly. If at any point you receive an error message, you can submit a request to Installation support using the link at the bottom of the page. When submitting a request, be sure to include the following:
- Your license number
- The release of MATLAB on the client and the cluster
- The output of your validation (click details to get the full information)
- The results of the tests below
1) Test the licensing of MATLAB Parallel Server
The first step is to ensure that the licensing for MATLAB Parallel Server works on your cluster. This will also test to see if MATLAB is crashing on startup on your cluster. To test this follow the instructions here to test a single license checkout on one of the machines of your cluster:
2) Check the releases of MATLAB on the cluster and the client where you validated
If you get the output of the "ver" command in the log file of the previous step, check the releases of MATLAB and MATLAB Parallel Server. To work successfully these releases will need to match e.g. R2025a submitting to a cluster that can run R2025a. If the release of Parallel Computing Toolbox and MATLAB do not match the release of MATLAB and MATLAB Parallel Server on the cluster, you will not be able to use this configuration until the installations are at the same release.
3) Check to make sure that your configuration meets the scheduler requirements
In order to use MATLAB Parallel Server with LSF, there are some additional requirements in the setup. Check the scheduler requirements page here for more details:
Additionally, this configuration requires the following:
- Your cluster should be completely homogeneous. Mixing different platforms or distributions is not recommended especially for parallel computation.
4) Check to ensure you have correctly configured the cluster profile
In your client MATLAB, go to the Parallel menu to Manage Cluster Profiles. Right click on your LSF configuration and select Properties. You must set the appropriate values for:
- ClusterMatlabRoot the directory where is MATLAB installed on the cluster,
- JobStorageLocation where the data will be stored,
- NumWorkers the number of workers your license allows.
- OperatingSystem (Unix-based or PC)
- HasSharedFilesystem whether you have a shared file system. Set this property to true if a disk location is accessible to your machine and the workers on the cluster. Set this property to false if you do not have a shared file system.
Depending on your setup you may also need to set some AdditionalProperties in your cluster profile. Details on these are available here: Customize the Behavior of Sample Plugin Scripts
5) Run cluster validation tests
Using either the MATLAB GUI: How do I validate my parallel cluster profile in MATLAB?
Or using these steps if you do not have access to the MATLAB GUI:
If you are still having an issue, contact Installation support here:
NOTE
: Starting in R2019a the following name changes occurred:
- MATLAB Distributed Computing Server was renamed to MATLAB Parallel Server
