Configure MATLAB Parallel Server Licensing for Cloud Platforms
Before You Begin
This document shows administrators how to set up a license for use with the MATLAB® Parallel Server™ cloud reference architectures. If you are an end user, contact your administrator.
To use the default MATLAB Parallel Server installation provided as part of a MathWorks reference architecture (Azure or AWS), you must be using release R2018a or later. The installation is configured to use online licensing by default. This license manager might differ from your current license configuration. Follow these instructions for setting up your license to use this installation.
If you have questions about any part of this license configuration process, contact MathWorks Cloud Support.
License Configuration Requirements
To set up your license to use MATLAB Parallel Server running in the cloud:
You must be an administrator of a MATLAB Parallel Server license. If you do not have a server license, you can request a free trial or contact your MathWorks sales representative. If you are not sure that you are an administrator, or if you are not sure if you are associated with a MATLAB Parallel Server license, sign in to your MathWorks Account. Click the MATLAB Parallel Server license. If you see a “Manage Users” tab, you are an administrator.
All licensed end users must be associated with the server license. (Instructions are included in this procedure.)
The end user’s MATLAB license must include Parallel Computing Toolbox . The toolbox is required so that jobs can be submitted to the cluster running the server. End users must be using the same release as the cluster.
Select Licensing Configuration Option
From the following scenarios, select a procedure for setting up the license manager with online licensing. Not all procedures are required for all scenarios.
If you have a license setup scenario that is not listed here, Contact Support.
You want to get a new on-demand license for MATLAB Parallel Server.
Select one of the following:
Change License Manager Type
Sign in to your MathWorks Account.
In your MathWorks Account, click the MATLAB Parallel Server license that you plan to use in the cloud.
Go to Install and Activate.
In the text box for License Manager, click the edit icon (a pencil).
Follow the steps shown and then click Change to Online Licensing.
To use the Network License Manager instead, repeat these steps to see instructions on switching back.
Add End Users to License
For online licensing to know which users have permission to check out a license, you must define a list of allowed users for that license. Allowed users must have a MathWorks Account associated with the on-demand license.
You can associate end users yourself or you can generate emails so that end users can associate themselves. Both actions are performed in License Center.
Sign in to the MathWorks Account that is associated with the license you want to use.
In your MathWorks Account, click on the MATLAB Parallel Server license.
Go to Manage Users.
Associate end users manually:
Click Add User.
Add an end user. Repeat this step for as many end users as you need to associate.
Invite end users to associate themselves:
Click Invite End Users to Add Themselves.
Enter email addresses in the template.
When you are finished, go to Disable Network License Manager for MATLAB Parallel Server.
Disable Network License Manager for MATLAB Parallel Server
To change your installed network license manager to online licensing, you must shut down the service and either delete the license (if the license manager was only for MATLAB Parallel Server) or modify the license (if license manager is managing other products in addition to the server).
If Network License Manager Manages Only MATLAB Parallel Server Cluster
Disable the network license manager, and delete the license.
If Network License Manager Manages Multiple Products
Modify the license to remove MATLAB Parallel Server.
Shut down the network license manager.
In your current LMtools.exe, navigate to the Start/Stop/Reread tab and choose Stop Server.
Open the MathWorks license file for editing:
The exact name of your license file and its location might vary. If you have trouble finding the license file, see Where are the license files for MATLAB located?
In the license file, locate and remove the entry that begins with the text:
INCREMENT MATLAB_Distrib_Comp_Engine ...
The entry might span more than one line in the file. Remove the entire entry and save the file.
Restart the network license manager for the license file change to take effect.
Network license manager utilities, such as
lmstat– can verify that only the proper products are licensed. To use the
lmstatfunction, open Terminal and run the following commands:
cd $MATLABROOT/etc/glnxa64 ./lmutil lmstat -a