Configure MATLAB Web App Server License for Use on the Cloud

Since R2021b

This document shows administrators how to set up a MATLAB^® Web App Server™ license for use on the cloud. If you are an end user, contact your administrator. To use the reference architecture, you must have R2021b or later.

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

License Configuration Requirements

To activate your license for use on the cloud:

You must be an administrator of a MATLAB Web App Server license. If you do not have a MATLAB Web App 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 Web App Server license you are using must be current on Software Maintenance Service. Learn more.

The MATLAB Web App Server reference architecture is configured to use a network license manager by default. The license manager is automatically installed on a virtual machine in the cloud. However, the reference architecture provides an option to use an existing license manager as well. 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 Web App 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 Web App Server in the Cloud

Deploy MATLAB Web App Server in the cloud using the reference architecture. 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 Web App 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.
You can get the MAC address of the network license manager from the Network License Manager for MATLAB dashboard that's deployed to the cloud. 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:
- 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

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 Web App 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.