Skip to content

Commit 55306e6

Browse files
santhoshkatkurisanthoshkatkuri
committed
R2024a release!
1 parent 594c57c commit 55306e6

10 files changed

+1944
-14
lines changed

‎LICENSE.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ The files in this GitHub repository refer to commercial software products and se
44

55
The following license terms apply only to the files in this GitHub repository, including files in this folder and its subfolders, and do not apply to MathWorks Programs. References to “software” and “code” in the following license terms refer to the files in this GitHub repository.
66

7-
Copyright (c) 2023, The MathWorks, Inc.
7+
Copyright (c) 2024, The MathWorks, Inc.
88

99
All rights reserved.
1010

‎README.md

+14-13
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,28 @@
11
# Network License Manager for MATLAB on Microsoft Azure (Windows VM)
22

3+
This repository shows how to automate the process of starting a Network License Manager for MATLAB® running on a Windows® virtual machine, in your Azure® account. The cloud resources are created using Azure Resource Manager (ARM) templates. For information about the architecture of this solution, see [Learn about Architecture](#learn-about-architecture).
4+
35
# Requirements
46

5-
Before starting, you need:
7+
You need:
68

7-
- An Azure® account.
9+
- An Azure account.
810

9-
- A valid MathWorks® license. For more information on how to configure your license for cloud use, see [MATLAB Licensing in the Cloud](https://www.mathworks.com/help/licensingoncloud/matlab-on-the-cloud.html).
11+
- A valid MathWorks® license. For more information on how to configure your license for cloud use, see [License Requirements for MATLAB on Cloud Platforms](https://www.mathworks.com/help/licensingoncloud/matlab-on-the-cloud.html).
1012

11-
- To be an administrator of the network license that you want to use.
13+
- Administrator status for the network license you want to use.
1214

1315
# Costs
14-
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, will affect the cost of deployment. For cost estimates, see the pricing pages for each Azure service you will be using. Prices are subject to change.
16+
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 will be using. Prices are subject to change.
1517

16-
# Introduction
17-
The following guide will help you automate the process of launching a Network License Manager for MATLAB®, running on a Windows virtual machine, using your Azure account. The cloud resources are created using Azure Resource Manager (ARM) templates. For information about the architecture of this solution, see [Learn About Network License Manager for MATLAB Architecture](#learn-about-network-license-manager-for-matlab-architecture).
1818

1919
# Deployment Steps
2020

2121
To view instructions for deploying the Network License Manager for MATLAB reference architecture, select a MATLAB release:
2222

2323
| Release |
2424
| ------- |
25+
| [R2024a](releases/R2024a/README.md) |
2526
| [R2023b](releases/R2023b/README.md) |
2627
| [R2023a](releases/R2023a/README.md) |
2728
| [R2022b](releases/R2022b/README.md) |
@@ -34,24 +35,24 @@ To view instructions for deploying the Network License Manager for MATLAB refere
3435
| [R2019a\_and\_older](releases/R2019a_and_older/README.md) |
3536

3637

37-
## Learn About Network License Manager for MATLAB Architecture
38+
## Learn about Architecture
3839

39-
The network license manager and the resources required by it are created using [Azure Resource Manager templates](https://docs.microsoft.com/en-gb/azure/azure-resource-manager/resource-group-overview). The architecture of the server resources created by the template is illustrated in Figure 2. For more information about each resource, see the [Azure template reference.](https://docs.microsoft.com/en-us/azure/templates/)
40+
The network license manager and the resources it requires are created using [Azure Resource Manager templates](https://docs.microsoft.com/en-gb/azure/azure-resource-manager/resource-group-overview). The architecture of the server resources created by the template is illustrated in Figure 2. For more information about each resource, see the [Azure template reference.](https://docs.microsoft.com/en-us/azure/templates/)
4041

4142
![Server Architecture](img/FlexServer_in_Azure_architecture.png?raw=true)
4243

4344
*Figure 2: Network License Manager Architecture*
4445

4546
The following resources are created.
4647

47-
### Networking resources
48+
### Networking Resources
4849
* Virtual Network (Microsoft.Network/virtualNetworks) The Virtual Network includes the following components:
4950
* Subnet (Microsoft.Network/virtualNetworks/subnets)
5051
* Network Security Group (Microsoft.Network/networkSecurityGroups) : Ingress rules from client IP address:
5152
* Allow 3389: Required for Remote Desktop Protocol to connect to the network license manager server.
5253
* Allow 22: Required for SSH into the network license manager server.
5354
* Allow 443: Required for communication between client and network license manager for MATLAB Dashboard server.
54-
* Allow 27000-27001: Required for communication from MATLAB and MATLAB workers to the network license manager for MATLAB.
55+
* Allow 27000-27010: Required for communication from MATLAB and MATLAB workers to the network license manager for MATLAB.
5556
* Allow all internal traffic: Open access to network traffic between all cluster nodes internally.
5657
* Network interface (Microsoft.Network/networkInterfaces)
5758
* Public IP Address (Microsoft.Network/publicIPAddresses)
@@ -61,10 +62,10 @@ The following resources are created.
6162
* Custom Script Extension (Microsoft.Compute/virtualMachines/extensions): An extension which configures this instance at deployment time to start the network license manager for MATLAB Dashboard web server.
6263

6364
# Technical Support
64-
If you require assistance or have a request for additional features or capabilities, please contact [MathWorks Technical Support](https://www.mathworks.com/support/contact_us.html).
65+
To request assistance or additional features, contact [MathWorks Technical Support](https://www.mathworks.com/support/contact_us.html).
6566

6667
----
6768

68-
Copyright 2021-2023 The MathWorks, Inc.
69+
Copyright 2021-2024 The MathWorks, Inc.
6970

7071
----

‎releases/R2024a/README.md

+91
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
# Network License Manager for MATLAB on Microsoft Azure
2+
3+
## Step 1. Launch the Template
4+
5+
Click the **Deploy to Azure** button below to deploy the cloud resources on Azure®. This opens the Azure Portal in your web browser.
6+
7+
| Create Virtual network | Use Existing Virtual Network |
8+
| --- | --- |
9+
| Use this option if you would like to deploy the resources in a new virtual network:<br><br><a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fmathworks-ref-arch%2Flicense-manager-for-matlab-on-azure%2Fmaster%2Freleases%2FR2024a%2Fazuredeploy-R2024a.json" target="_blank"><img src="https://aka.ms/deploytoazurebutton"/></a></br></br> | Use this option if you would like to deploy the resources in an existing virtual network: <br><br><a href="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fmathworks-ref-arch%2Flicense-manager-for-matlab-on-azure%2Fmaster%2Freleases%2FR2024a%2Fazuredeploy-existing-vnet-R2024a.json" target="_blank"><img src="https://aka.ms/deploytoazurebutton"/></a></br></br> |
10+
11+
> Cluster Platform: Windows Server 2019
12+
13+
> MATLAB&reg; Release: R2024a
14+
15+
## Step 2. Configure the Cloud Resources
16+
17+
Clicking the **Deploy to Azure** button opens the "Custom deployment" page in your browser. You can configure the parameters on this page. It is easier to complete the steps if you position these instructions and the Azure Portal window side by side. Create a new resource group by clicking **Create New**. Alternatively, you can select an existing resource group, but this can cause conflicts if resources are already deployed in it.
18+
19+
1. Specify and check the defaults for these resource parameters:
20+
21+
| Parameter label | Description |
22+
| --------------- | ----------- |
23+
| **Instance Type** | Azure instance type, see https://docs.microsoft.com/en-us/azure/virtual-machines/windows/sizes. |
24+
| **Client IP Address** | The IP address range that can be used access the license manager. This must be a valid IP CIDR range of the form x.x.x.x/x. Use the value &lt;your_public_ip_address&gt;/32 to restrict access to only your computer. |
25+
| **Admin Username** | Admin username, this is used to login to the Network License Manager for MATLAB dashboard. |
26+
| **Admin Password** | Admin password for the chosen username. This is used to login to the Network License Manager for MATLAB dashboard. |
27+
| **Virtual Network Resource ID** | The Resource ID of an existing virtual network to deploy your server into. Specify this parameter only when deploying with the Existing Virtual Network option. Specify this parameter only when deploying with the Existing Virtual Network option. |
28+
| **Subnet Name** | The name of an existing subnet within your virtual network to deploy your server into. Specify this parameter only when deploying with the Existing Virtual Network option. Specify this parameter only when deploying with the Existing Virtual Network option. |
29+
30+
31+
**NOTE**: The port and hostname of the network license manager must be reachable from all virtual machines running MATLAB. It is therefore recommended that you deploy into a subnet within the same virtual network as the network license manager.
32+
33+
2. Tick the box to accept the Azure Marketplace terms and conditions.
34+
35+
3. Click the **Create** button.
36+
37+
# Step 3: Connect to the Dashboard
38+
39+
> **Note**: The Internet Explorer web browser is not supported for interacting with the dashboard.
40+
41+
1. In the Deployments for your resource group, select the Microsoft.Template deployment created in step 2 and select the **Outputs** section.
42+
2. Copy the URL listed in the `NETWORKLICENSEMANAGERADDRESS` field. This is the HTTPS endpoint to the network license manager for MATLAB Dashboard.
43+
44+
# Step 4: Sign in to the Dashboard
45+
1. Paste the network license manager Address URL into a web browser.
46+
2. Enter the username set at the time of the deployment along with the password for this user you created in Step 2.
47+
48+
![Console Login](../../img/Console_Login.png)
49+
50+
> **Note**: The dashboard uses a self-signed certificate which can be changed. For information on changing the self-signed certificates, see [Change Self-signed Certificate](#change-self-signed-certificate).
51+
52+
# Step 5: Upload the License File
53+
> **Note**: You will need the fixed network license manager Host ID to get a license file from the MathWorks&reg; License Center for your product. For more information, see the documentation for your product.
54+
55+
1. In the dashboard, go to **Administration > Manage License**.
56+
2. Click **Browse License File** to select the license file you want to upload and click **Open**.
57+
3. Click **Upload**.
58+
59+
![Console Upload](../../img/Console_Upload.png)
60+
61+
You are now ready to use the network license manager on Azure.
62+
63+
To configure your MATLAB products deployed in Azure to use the network license manager, see the product documentation. An example for MATLAB Parallel Server can be found at [MATLAB Parallel Server on Azure](https://github.com/mathworks-ref-arch/matlab-parallel-server-on-azure).
64+
65+
# Additional Information
66+
## Delete Your Cloud Resources
67+
You can remove the Resource Group and all associated resources when you are done with them. Note that you cannot recover resources once they are deleted.
68+
1. Sign in to the Azure Portal.
69+
2. Select the Resource Group containing your resources.
70+
3. Select the "Delete resource group" icon to destroy all resources deplyoyed in this group.
71+
4. You will be prompted to enter the name of the resource group to confirm the deletion.
72+
73+
![Resource Group Delete](../../img/Resource_Group_Delete.png)
74+
75+
## Change Self-signed Certificate
76+
You can change the self-signed certificate used to connect to the dashboard. To upload an HTTPS certificate:
77+
1. On the dashboard navigation menu, select **Administration** > **Manage HTTPS Certificate**.
78+
1. Click **Browse Certificate...** and select a certificate file. Only `.pfx` files are supported.
79+
1. Enter the certificate password in the **Certificate Password** field.
80+
1. Click **Upload**.
81+
82+
The server will automatically restart after uploading a certificate. You will need to sign out and sign back in.
83+
84+
## Troubleshooting
85+
If your resource group fails to deploy, check the Deployments section of the Resource Group. It will indicate which resource deployments failed and allow you to navigate to the relevant error message.
86+
87+
----
88+
89+
Copyright 2021-2024 The MathWorks, Inc.
90+
91+
----

0 commit comments

Comments
 (0)