How can I use 'dmlworker' to test the licensing for the worker nodes in my MATLAB Parallel Server cluster?
MATLAB: How to use ‘dmlworker’ to test the licensing and installation for the worker nodes in the MATLAB Parallel Server cluster
MATLAB Parallel Server
Related Solutions
You can install an Individual MATLAB and a MATLAB Parallel Server license on the same machine. For R2008a and above this process is done simply by performing two installations and activating the licenses accordingly.
You can also install a network copy of MATLAB and MATLAB Parallel Server on the same node, using the same set of files. To install a network copy of MATLAB and MATLAB Parallel Server license on the same node, run the installation once using the MATLAB Parallel Server installation key and license. Once this is complete, rename the network.lic under licenses to mdcs.lic, and save a copy of the network.lic from another MATLAB client under licenses
For versions prior to R2008a, this will work out of the box for Windows and Mac machines. For Linux machines, this will work provided the network license manager for MATLAB Parallel Server is setup correctly. See the information below for the instructions for versions prior to R2008a.
Windows/ Mac installations:
==========
1) Install MATLAB and any toolboxes for your Individual license according to our instructions in the Installation Guide.
2) Once this installation is complete, move the 'license.dat' file out of the $MATLABROOT\bin\win32 (Windows) or the $MATLAB/etc (Mac) directory to a convenient place (such as the desktop).
NOTE: $MATLABROOT refers to your root MATLAB directory.
3) Start the installation for the MATLAB Parallel Server license (you will need a copy of the 'license.dat' file from the license server for this Concurrent installation).
4) Choose the same installation directory you used for the Individual license install.
5) When prompted you can choose to skip any products that were already installed
6) After the installation is complete, rename the new $MATLABROOT\bin\win32\license.dat (Windows) or $MATLABROOT/etc/license.dat (Mac) file to 'license.lic'.
7) Move the original 'license.dat' file which you moved in Step 2 back to the $MATLABROOT\bin\win32 (Windows) or $MATLABROOT/etc (Mac) directory.
You should now be able to use your Individual MATLAB and MATLAB Parallel Server on the same machine.
Unix/Linux instructions:
==========
Network License Manager installations:
If this installation will serve as the license manager for MATLAB Parallel Server, you will need to have the license for the individual license locked to the same hostid as the license for MATLAB Parallel Server. Once these licenses have the same hostid, combine the INCREMENT lines from both licenses into one license.dat. Once combined, follow the standard installation for MATLAB Parallel Server from the installation guide here:
Once the installation is complete, you will need to configure the options file for the Individual license. Refer the to the installation guide for more information about configuring the options file here:
Client installations:
If this machine will act as a client for the MATLAB Parallel Server, follow the instructions below:
1) Install MATLAB and any toolboxes for your Individual license according to our instructions in the Installation Guide.
2) Once this installation is complete, move the 'license.dat' file out of the $MATLABROOT/etc directory to a convenient place (such as the desktop).
NOTE: $MATLABROOT refers to your root MATLAB directory.
3) Start the installation for the MATLAB Parallel Server license (you will need a copy of the 'license.dat' file from the license server for this Concurrent installation).
4) Choose the same installation directory you used for the Individual license install.
5) When prompted you can choose to skip any products that were already installed
6) After the installation is complete, rename the new $MATLABROOT/etc/license.dat file to 'license.lic'.
7) Move the original 'license.dat' file which you moved in Step 2 back to the $MATLABROOT/etc directory.
You should now be able to use your Individual MATLAB and MATLAB Parallel Server on the same machine.
NOTE: Starting in R2019a the following name changes occurred:
- MATLAB Distributed Computing Server was renamed to MATLAB Parallel Server
- mdce_def was renamed to mjs_def
- mdce binary was renamed to mjs
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
Also when submitting a request please reference Solution 1-BJRNU9.
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, go to one of the cluster nodes and open up a Windows Command Prompt by clicking on the Start Menu and go to All Programs, Accessories, and click on Command Prompt. In the command prompt, run the following commands:
cd $MATLAB\bin (where $MATLAB is the installation folder for MATLAB on the cluster)
matlab.exe -dmlworker -nodisplay -logfile C:\output.txt -r "ver;exit"
This will generate an output.txt file in C:\ that contains the ver output on the cluster. If the log file contains a license manager error, this is the issue. In that case, check the support site for the license manager error number and take the appropriate action to resolve the license error before proceeding.
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, check the releases of all the products in the list. The release of each product should match for all the products. Additionally, the release should match the release that is installed on the client where you ran the validation. To check the release on the client, run the ver command in MATLAB's command window. 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) Use the Admin Center to confirm that the cluster is configured properly
As of MATLAB R2009a, the MathWorks Job Manager has a new tool called the Admin Center which can be used to verify the cluster has been setup properly. This tool will allow you to verify the cluster configuration as well as run some tests on the cluster.
Verify your cluster using the Admin Center. For the instructions on how to use the Admin Center, see the documentation here:
NOTE: If the cluster fails the Admin Center tests, save the session and send the .mdcs file to Installation Support along with the other information requested above.
4) Manually set the client's return hostname
If there are multiple network configurations on the client computer, the client may be reporting the wrong return address. To change this, restart MATLAB and run the following command:
pctconfig('hostname','<ip address>')
where <ip address> refers to the external IP address of the client for which the cluster can contact. Once complete, retry validation to see if the return address was incorrect. If it validates, you can try reconfiguring the computer's network settings or create a startup.m file that calls the pctconfig each time MATLAB is launched. For more information about startup.m see the documentation here:
5) Check to ensure you have correctly configured the client configuration
In your client MATLAB, go to the Parallel menu to Manage Configurations. Right click on your jobmanager configuration and select Properties. For the Job Manager you must set the appropriate values for "LookupURL" (hostname of the Job Manager) and "Name" (the Job Manager name).
6) If automatic validation does not assist the troubleshooting process, you can run a manual validation test by submitting sample jobs to MATLAB Parallel Server. To do so, please reference the below article:
How do I manually validate my MATLAB cluster?
If the manual tests passed, your configuration is working and you should be able to submit jobs.
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
- mdce_def was renamed to mjs_def
- mdce binary was renamed to mjs
Related Question
- How to download the installation files for MATLAB Parallel Server
- Am I unable to validate the TORQUE/PBS Pro configuration in the Parallel Computing Toolbox
- Can I use the MATLAB Home license to submit to a MATLAB Parallel Server on EC2 cluster
- Am I unable to validate the SLURM configuration in the Parallel Computing Toolbox
- Do I receive license error 4401 when validating the MATLAB Parallel Server cluster
- Do I receive an error when attempting to start a worker for the MATLAB Parallel Server
- Do I receive the error message ‘”Submitting a task from a commercial Parallel Computing Toolbox license and running on a cluster with an educational MATLAB Parallel Server is disallowed…’ when I am using an Academic license
- How to configure the cluster to utilize an Online Licensing MATLAB Parallel Server License
Best Answer