Follow these steps to deploy the R2024a MATLAB Production Server reference architecture on AWS. To deploy reference architectures for other releases, see Deploy Reference Architecture for Your Release.
Before launching the template, make sure that you have selected one of these supported AWS regions from the top navigation:
- US-East (N. Virginia)
- US-West (Oregon)
- Europe (Ireland)
- Asia Pacific (Tokyo)
Then, click the appropriate Launch Stack button to launch the stack configuration template for deploying resources onto your AWS account. You can deploy resources onto either a new or existing VPC.
| Release | New VPC | Existing VPC |
|---|---|---|
| R2024a |  |
|
The AWS Management Console opens in your web browser.
On the Create Stack page, specify these parameters:
| Parameter Name | Value |
|---|---|
| Stack name | Choose a name for the stack. After the deployment finishes, this name is displayed in the AWS console. Example: Boston |
| Server | |
| Number of Server VMs | Choose the number of AWS instances to start for the server. Example: 6 For example, if you have a 24-worker MATLAB Production Server license and select You can always underprovision the number instances, in which case you may end up using fewer workers than you are licensed for. |
| Server VM Type | Choose the AWS instance type to use for the server instances. All AWS instance types are supported. For more information, see Amazon EC2 Instance Types. Example: m6.xlarge |
| Server VM Operating System | Choose between Windows (Windows Server 2022) and Linux (Ubuntu 22) to use for the server instances. |
| Create ElastiCache for Redis | Choose whether you want to create a Redis ElastiCache service. Creating this service enables you to use the persistence functionality of the server. Persistence provides a mechanism to cache data between calls to MATLAB code running on a server instance. |
| Dashboard Login | |
| Username for MATLAB Production Server Dashboard | Specify the administrator username for logging in to the MATLAB Production Server Dashboard. |
| Password for MATLAB Production Server and License Server Dashboards | Specify the password to use for logging in to MATLAB Production Server Dashboard and Network License Manager for MATLAB Dashboard. |
| Confirm Password for MATLAB Production Server and License Server Dashboards | Reenter the password to use for logging in to the MATLAB Production Server Dashboard and Network License Manager for MATLAB Dashboard. |
| Network | |
| Name of Existing Key Pair | Select the name of an existing EC2 Key Pair to allow access to all the VMs in the stack. For information about creating an Amazon EC2 key pair, see Amazon EC2 Key Pairs. Example: boston-keypair |
| Allow Connections from IP Address | Specify the IP address range that is allowed to connect to the dashboard that manages the server. The format for this field is IP Address/Mask. Example: 10.0.0.1/32
|
| Make Solution Available over Internet | Choose 'Yes' if you want your solution to use public IP addresses. |
| ARN of SSL Certificate | Provide the Amazon Resource Name (ARN) of an existing certificate in the AWS Certificate Manager. This certificate enables secure HTTPS communication to the HTTPS server endpoint. For information on creating and uploading a self-signed certificate, see Create and sign an X509 certificate and Import SSL Certificate. Example: arn:aws:acm:us-east-1:12345:certificate/123456789012 |
Note: If you are deploying to a new VPC, skip this step.
To deploy MATLAB Production Server onto an existing VPC, specify these additional parameters.
| Parameter Name | Value |
|---|---|
| Network License Manager | |
| Deploy License Server | Specify whether you want to deploy the Network License Manager for MATLAB. This parameter is available only if you use the deployment template for an existing VPC. Instead of specifying values for the following two parameters, you may choose to configure the License Server manually. For manual configurtion steps for using an existing License Server with an existing VPC, see the Use Existing License Server in Existing VPC section. |
| IP Address and port number of Existing Network License Manager | Optional parameter: Specify the port number and private DNS name or private IP address of the network license manager that has already been deployed to the existing VPC. Specify it in the format port@privateDNSname, for example, |
| Security Group of Existing Network License Manager | Optional parameter: Specify the security group of the network license manager that has already been deployed to the existing VPC. Leave this field blank if you are deploying a new network license manager. |
| Existing VPC | |
| Existing VPC ID | ID of your existing VPC. |
| IP address range of existing VPC | IP address range from the existing VPC. To find the IP address range:
|
| Subnet 1 ID | ID of an existing subnet that will host the dashboard and other resources. |
| Subnet 2 ID | ID of an existing subnet that will host the application load balancer. |
- If Subnet 1 and Subnet 2 are public, then you must connect the EC2 VPC endpoint and the AutoScaling VPC endpoint to the VPC.
- If Subnet 1 and Subnet 2 are private, then you must either deploy a NAT gateway in the VPC, or connect all of these endpoints to the VPC:
- EC2 VPC endpoint
- AutoScaling VPC endpoint
- S3 VPC endpoint
- CloudFormation endpoint
For more information about creating endpoints, see the AWS documentation.
You also need to open these ports in your VPC:
| Port | Description |
|---|---|
443 |
Required for communicating with the dashboard and the MATLAB execution endpoint. |
8000, 8002, 9910 |
Required for communication between the dashboard and workers within the VPC. These ports do not need to be open to the Internet. |
27000, 50115 |
Required for communication between the Network License Manager and the workers. |
22, 3389 |
Required for Remote Desktop functionality. This can be used for troubleshooting and debugging. |
Review or edit your stack details. You must select the acknowledgements to create IAM resources. Otherwise, the deployment produces a Requires capabilities : [CAPABILITY_IAM] error and fails to create resources.
When you are satisfied with your stack configuration, click Create stack. AWS starts creating the resources for your server environment and opens you to the Events tab for the stack.
Note: Resource creation can take up to 20 minutes. After resource creation, it can take up to 15 minutes for the resources to be active.
- On the Events tab for your stack, wait for the status to reach CREATE_COMPLETE.
- On the Outputs tab, in the row for the
MatlabProductionServerLicenseServerkey, click the corresponding URL listed under Value to open the Network License Manager for MATLAB Dashboard login page. - Log in to the Network License Manager for MATLAB Dashboard.
- The username is manager.
- For the password, enter the password that you entered in the Dashboard Login section while creating the stack.
- Upload your MATLAB Production Server license by following the instructions in the dashboard.
Note: The Internet Explorer web browser is not supported for interacting with the dashboard.
- On the Outputs tab for your stack, in the row for the
MatlabProductionServerDashboardURLkey, click the corresponding URL listed under Value. This URL is the HTTPS endpoint to the MATLAB Production Server Dashboard and brings you to the dashboard login page. - Log in using the administrator username and password that you specified in the Dashboard Login section while creating the stack. For more information on how to use the dashboard, see Manage MATLAB Production Server Using the Dashboard.
You are now ready to use MATLAB Production Server on AWS.
To run applications on MATLAB Production Server, you need to create applications using MATLAB Compiler SDK. For more information, see Create Deployable Archive for MATLAB Production Server.
To manage MATLAB Production Server licenses, you can use an existing Network License Manager server for MATLAB instead of deploying a new one. To use an existing license server, on the Deploy License Server step of the deployment, select No.
The license manager must be in the same VPC and security group as MATLAB Production Server. You must also add the security group of the server VMs to the security group of the license server.
- In the AWS management console, select the license manager stack that you deployed.
- In the stack details page, click Resources.
- In the Logical ID named
MWSecurityGroupExternal, click the corresponding URL listed under Physical ID - In the stack details page for
MWSecurityGroupExternal, click Resources. - In the Logical ID named
SecurityGroup, click the corresponding URL listed under Physical ID to open the security group details. - Click the Inbound Rules tab, and then click Edit Inbound Rules.
- Click Add Rule.
- In the Type dropdown, select
All TCP. - Under Source, search and add the
MatlabProductionServerCloudStackElb1Sgsecurity group. - Click Save Rules.
You must also add the private IP address of the license server to the License Server property in the Settings tab of the dashboard.
You can find the IP address of the license server from the AWS management console.
- In the AWS management console, navigate to the EC2 dashboard.
- Select the license server instance.
- In the instance details, copy the value of Private IPs. For example: 172.30.1.126
- Add the private IP to the
License Serverproperty. For example:27000@172.30.1.126
Once you finish using your stack, to avoid incurring further cost, it is recommended that you delete all resources.
If you are using an existing license server, and have added the security group of the server VMs to the security group of the license server, you must delete the inbound rules before you delete the stack.
- In the AWS management console, select the stack that you deployed.
- On the details page your stack, click the Resources tab.
- In the Logical ID named
SecurityGroup, click the corresponding URL listed under Physical ID to open the security group details. - On the Inbound Rules tab, click Edit Inbound Rules.
- For each rule that has the Source tag set to
matlab-production-server-cloud-stack-elb-1-sg, click Delete Rule. - Click Save Rules.
To delete the stack, do the following:
- Log in to the AWS Console.
- Go to the AWS Cloud Formation page and select the stack that you created.
- Click Delete.
If you do not want to delete the entire deployment but want to minimize the cost, you can bring the number of instances in the Auto Scaling Group down to 0 and then scale it back up when the need arises.
The Network License Manager for MATLAB reference architecture manages the MATLAB Production Server license file. The deployment templates for the MATLAB Production Server reference architecture provide an option to deploy the license manager. You can also use an existing license manager that is located in the same VPC and security group as the MATLAB Production Server instances. For more information about the Network License Manager for MATLAB reference architecture, see Network License Manager for MATLAB.
NOTE: For a new license manager deployed with MATLAB Production Server, the license manager MAC address is available only after the deployment to the cloud is complete. For information on deploying the solution, see Deployment Steps.
To get the MAC address of the license manager:
- Log in to the Network License Manager for MATLAB Dashboard. For a license manager deployed with the MATLAB Production Server deployment, use the following credentials:
Username: manager
Password: Enter the password that you specified during the deployment process. - Click Administration and then License.
- Copy the license server MAC address displayed at the top.