Configure MATLAB Production Server License for Use on the Cloud

This document shows administrators how to set up a MATLAB^® Production Server™ license for use with the MATLAB Production Server cloud reference architecture. If you are an end user, contact your administrator.

To use the reference architecture, you must have R2018a or later. The cloud deployment is configured to use the network license manager by default. Follow these instructions for activating the license.

If you have questions about any part of this licensing configuration process, contact MathWorks Cloud Support.

License Configuration Requirements

To activate your license for MATLAB Production Server running on the cloud, you must be an administrator of a MATLAB Production Server license. If you do not have a MATLAB Production Server, you can request a trial by contacting your MathWorks sales representative. If you are not sure that you are an administrator, sign in to your MathWorks Account to check which licenses you are associated to as an administrator.

The MATLAB Production Server reference architecture is configured to use the network license manager by default. The license manager is automatically installed on a virtual machine in the cloud. From the following scenarios, select a procedure for activating your license:

Scenario	Procedure
You need to activate a license or trial that has never been activated before.	Activate a License for the First Time
Your MATLAB Production Server license has been previously activated in another location, on-premises, or in the cloud.	Move a License That Has Been Previously Activated

Activate a License for the First Time

Follow this procedure to activate a license or trial that has never been activated before.

Deploy MATLAB Production Server in the Cloud

Deploy MATLAB Production Server in the cloud using the reference architectures. To use the license manager in the cloud, you must provide a static MAC address when you activate the license. You can get a MAC address to the virtual machine hosting the license server only after the deployment is complete.

Activate License

Sign in to your MathWorks Account, and select the MATLAB Production Server license.
Go to Install and Activate.
Click Activate to Retrieve License File.
In the Host ID field, enter the static MAC address of the network license manager.
For R2019b and earlier releases, you can get the MAC address from the MATLAB Production Server cloud console. In the cloud console, click Administration > License.
Starting in R2020a, you can get the MAC address of the network license manager from the Network License Manager for MATLAB dashboard. In the dashboard, click Administration > Manage License.
Note
When you delete the cloud resources, you also delete the static MAC address. For hosting the license manager in the cloud, you must have a fixed address:
- Azure: When you create a virtual network, the virtual network MAC address is retained even when the virtual machine is in the deallocated state.
- AWS: Use an Elastic Network Interface (ENI), which contains a (non-changeable) static MAC address attribute.
Changing the static MAC address in MathWorks License Center is limited to 4 times per year.
Finish all fields, and click Continue to finish activation.

Upload License

For R2019b and earlier, you need to upload the license file you get from the activation process to the MATLAB Production Server cloud console. To upload a license file through the cloud console:

From the cloud console menu, select Administration > License.
Click Browse License File and select a file.
Click Upload.

Starting in R2020a, you need to upload the license file you get from the activation process to the Network License Manager for MATLAB dashboard. To upload a license file through the dashboard:

On the dashboard menu, select Administration > Manage License.
Click Browse License File and select a file.
Click Upload.

Move a License That Has Been Previously Activated

Follow this procedure to activate a license that has been previously activated in another location.

Shut Down the Current License Server

Platform	Procedure
Windows^®	In your current `LMtools.exe`, navigate to the Start/Stop/Reread tab and choose Stop Server. Navigate to the Config Services tab and choose Remove Service. Close out of the current `LMtools.exe`.
Linux^®	Run `lmdown`. Delete the existing network license manager by deleting the entire folder where you previously placed the license manager binaries.

Deactivate Existing License

Sign in to your MathWorks Account, and select the existing MATLAB Production Server license.
Go to Install and Activate.
Find your activated license, and click to deactivate your license.
Click Deactivate on the next screen to complete the process.

Activate License

Activate the license as described in Activate a License for the First Time.