Before starting, you need the following:
- A MATLAB® Production Server™ license that meets the following conditions:
- Linked to a MathWorks Account.
- Concurrent license type. To check your license type, see MathWorks License Center.
- Configured to use a network license manager on the virtual network. By default, the deployment of MATLAB Production Server includes a network license manager, but you can also use an existing license manager. In either case, activate or move the license after deployment. For details, see Configure MATLAB Production Server License for Use on the Cloud.
- A Microsoft Azure™ account.
You are responsible for the cost of the Azure services used when you create cloud resources using this guide. Resource settings, such as instance type, affect the cost of deployment. For cost estimates, see the pricing pages for each Azure service you are using. Prices are subject to change.
Use this guide to automate the process of running MATLAB Production Server on Azure using your Azure account. The automation is accomplished using an Azure Resource Manager (ARM) template. The template is a JSON file that defines the resources needed to deploy and manage MATLAB Production Server on Azure. Once deployed, you can manage the server using the MATLAB Production Server Dashboard—a web-based interface to configure and manage server instances on the cloud. For more information, see Manage MATLAB Production Server Using the Dashboard. For information about the architecture of this solution, see Architecture and Resources.
To deploy the reference architecture, select your MATLAB Production Server release from the table and follow the instructions to deploy the server using the provided template. A deployment of MATLAB Production Server supports MATLAB Runtime versions up to six releases back.
| Release | Supported MATLAB Runtime Versions |
|---|---|
| R2024a | R2024a, R2023b, R2023a, R2022b, R2022a, R2021b |
| R2023b | R2023b, R2023a, R2022b, R2022a, R2021b, R2021a |
| R2023a | R2023a, R2022b, R2022a, R2021b, R2021a, R2020b |
| R2022b | R2022b, R2022a, R2021b, R2021a, R2020b, R2020a |
| R2022a | R2022a, R2021b, R2021a, R2020b, R2020a, R2019b |
| R2021b | R2021b, R2021a, R2020b, R2020a, R2019b, R2019a |
Note: MathWorks provides templates for only the six most recent releases of MATLAB Production Server. Earlier templates are removed and are no longer supported.
Deploying this reference architecture will create several resources in your resource group.
Architecture on Azure
| Resource Name | Resource Name in Azure | Number of Resources | Description |
|---|---|---|---|
| Virtual network | mps-network |
1 | Provide support and security to the operation of MATLAB Production Server. |
| Storage account | serverlog<uniqueID> |
1 | Storage account where the deployable archives (CTF files) created by MATLAB® Compiler SDK™ will be stored. The deployable archives (CTF files) will be stored in a file share. |
| Application Insights | logs-apmservice |
1 | Enables storing and viewing of all logs associated with deployment. |
| Log analytics workspace | logs-workspace |
1 | Workspace that contains data collected from various sources. |
| Resource Name | Resource Name in Azure | Number of Resources | Description |
|---|---|---|---|
| Virtual machine scale set | vmss<uniqueID> |
1 | Manages the number of identical VMs to be deployed. Each VM runs an instance of MATLAB Production Server which in turn runs multiple MATLAB workers. |
| Application gateway | vmss<uniqueID>-agw |
1 | Provides routing and load balancing service to MATLAB Production Server instances. The MATLAB Production Server dashboard retrieves the HTTP/HTTPS endpoint for making requests to the server from the application gateway resource. NOTE: Provides HTTPS endpoint to the server for making requests. |
| Virtual network | vmss<uniqueID>-vnet |
1 | Enables resources to communicate with each other. |
| Network security group | vmss<uniqueID>-rdp-nsg |
1 | Filter network traffic to and from virtual machine scale set in an Azure virtual network. |
| Public IP address | Vmss<uniqueID>-pip |
1 | Provide public IP address to virtual machine scale set. |
| Resource Name | Resource Name in Azure | Number of Resources | Description |
|---|---|---|---|
| MATLAB Production Server dashboard virtual machine | admindashboard |
1 | Virtual machine (VM) that hosts the MATLAB Production Server dashboard. Use the dashboard to:
For more information, see Manage MATLAB Production Server Using the Dashboard. |
| MATLAB Production Server dashboard public IP | admindashboard-public-ip |
1 | Public IP address to connect to MATLAB Production Server dashboard. NOTE: Provides HTTPS endpoint to the dashboard for managing server instances. |
| Disk | admindashboard_OsDisk_<uniqueID> |
1 | Operating system disk attached to admin dashboard. |
| Network interface | admindashboard-nic |
1 | Provide network interface for admin dashboard. |
| Resource Name | Resource Name in Azure | Number of Resources | Description |
|---|---|---|---|
| Azure Cache for Redis | vmss<uniqueID>redis |
1 | Enables caching of data between calls to MATLAB code running on a server instance. |
| Network interface | redisPrivateEndpoint.nic.<uniqueID> |
1 | Provide network interface for Redis private endpoint. |
| Private DNS zone | privatelink.redis.cache.windows.net |
1 | Provide DNS resolution for the private endpoint of Redis cache. |
| Private endpoint | redisPrivateEndpoint |
1 | Private endpoint for Redis. |
Note: Some or all of these resources will get created depending on inputs provided to the deployment template. For example, Redis may or may not get created.
Why do requests to the server fail with errors such as “untrusted certificate” or “security exception”?
These errors occur either when CORS is not enabled on the server or when the server endpoint uses a self-signed certificate.
If you are making an AJAX request to the server, make sure that CORS is enabled in the server configuration. You can enable CORS by editing the property --cors-allowed-origins in the config file. For more information, see Edit Server Configuration.
Also, some HTTP libraries and JavaScript AJAX calls will reject a request originating from a server that uses a self-signed certificate. You may need to manually override the default security behavior of the client application. Alternatively, you can add a new HTTP/HTTPS endpoint to the application gateway. For more information, see Change SSL Certificate to Application Gateway.
Provide suggestions for additional features or capabilities using the following link: https://www.mathworks.com/solutions/cloud.html
If you require assistance or have a request for additional features or capabilities, please contact MathWorks Technical Support.