Skip to content

Latest commit

 

History

History
110 lines (70 loc) · 10.8 KB

online-licensing-instructions.md

File metadata and controls

110 lines (70 loc) · 10.8 KB
Raw

MATLAB on Microsoft Azure using Online Licensing

Requirements

Before starting, you will need the following:

Deployment Steps

Step 1. Launch the Template

Click the Deploy to Azure button to deploy MATLAB on Azure. This will open the Azure Portal in your web browser.

Release OS Launch
MATLAB R2019b Ubuntu 18.04

Step 2. Configure Cloud Resources

Provide values for parameters in the custom deployment template on the Azure Portal :

Parameter Name Value
Subscription Choose an Azure subscription to use for purchasing resources.

Example: Massachusetts
Resource group Choose a name for the resource group that will hold the resources. It is recommended you create a new resource group for each deployment. This allows all resources in a group to be deleted simultaneously.

Example: Boston311
Location Choose the region to start resources in. Ensure that you select a location which supports your requested instance types. To check which services are supported in each location, see Azure Region Services. We recommend you use East US or East US 2.

Example: East US
VM Size Specify the size of the VM you plan on using for deployment. Use MATLAB system requirements as a guide in choosing the appropriate VM size. The template defaults to: Standard_D3_v2. This configuration has 4 vCPUs and 14 GiB of Memory. For more information, see Azure documentation.

Example: Standard_D3_v2
Client IP Addresses This is the IP address range that will be allowed to connect to this instance using the Remote Desktop Protocol. The format for this field is IP Address/Mask.

Example:

10.0.0.1/32
  • This is the public IP address which can be found by searching for "what is my ip address" on the web. The mask determines the number of IP addresses to include.
  • A mask of 32 is a single IP address.
  • Use a CIDR calculator if you need a range of more than one IP addresses.
  • You may need to contact your IT administrator to determine which address is appropriate.
User Name Enter a username you would like to use to connect to the virtual machine in the cloud using remote desktop.
User Password Enter a password you would like to use to connect to the virtual machine in the cloud using remote desktop.

Agree to the Azure Marketplace terms and conditions and click Purchase to begin the deployment. Creating a resource group on Azure can take at least 10 minutes.

Step 3. Connect to the Virtual Machine in the Cloud

Note: Complete these steps only after your resource group has been successfully created.

  1. In the Azure Portal, on the navigation panel on the left, click Resource groups. This will display all your resource groups.

  2. Select the resource group you created for this deployment from the list. This will display the Azure blade of the selected resource group with its own navigation panel on the left.

  3. Select the resource labeled matlab-public-ip. This resource contains the public IP address to the virtual machine that is running MATLAB.

  4. Copy the IP address from the IP address field.

  5. Launch any remote desktop client, paste the IP address in the appropriate field, and connect. On the Windows Remote Desktop Client you need to paste the IP address in the Computer field and click Connect.

  6. In the login screen that's displayed, use the username and password you specified while configuring cloud resources in Step 2.

Step 4. Launch MATLAB

Double-click the MATLAB icon on the instance desktop to launch MATLAB. The first time you start MATLAB, you should see a login dialog in the terminal. Enter a valid MathWorks account email address and password. Choose one of the listed licenses associated with your account (you only need to do this the first time you start MATLAB). For more information, see MATLAB Licensing in the Cloud.

Note:It may take a few minutes for activation to complete and MATLAB to start. You will experience this delay only the first time you start MATLAB.

Additional Information

Delete Your Resource Group

You can remove the resource group and all associated cluster resources when you are done with them. Note that there is no undo.

  1. Login to the Azure Portal.
  2. Select the resource group containing your cluster resources.
  3. Select the Delete resource group icon to destroy all resources deployed in this group.
  4. You will be prompted to enter the name of the resource group to confirm the deletion.

FAQ

How do I save my changes in the VM?

All your files and changes are stored locally on the virtual machine. They will persist until you either terminate the virtual machine instance or delete the resource group. Stopping the instance does not destroy the data on the instance. If you want your changes to persist before you terminate an instance you’ll need to:

  • copy your files to another location, or
  • create an image of the virtual machine.

What happens to my data if I shutdown the instance?

You may want to shutdown the instance when you aren’t using it. Any files or changes made to the virtual machine will persist when shutting down and will be there when you restart.

How do I save an image?

You can save a copy of your current virtual machine. Locate the Azure VM in your resource group in the Azure Portal, click “Capture Image” and follow the instructions.

How do I customize the image?

You can customize an image by launching the reference architecture, applying any changes you want to the virtual machine such as installing additional software, drivers and files and then saving an image of that virtual machine using the Azure Portal. For more information, see How do I save an image?. When you launch the reference architecture, click “Edit Template”, replace the baseImageUri in the “variables” section with the URL from your custom image. Save and finish the deployment steps by filling out parameters, accepting the terms and clicking “Purchase”.

How do I use a different license manager?

The VM image uses MathWorks Hosted License Manager by default. For information on using other license managers, see Configure MATLAB Licensing on the Cloud.

How do I deploy into an existing virtual network?

You will need to edit the template and replace the appropriate sections with your own virtual network and subnet resource ids.

Enhancement Request

Provide suggestions for additional features or capabilities using the following link: https://www.mathworks.com/cloud/enhancement-request.html

Technical Support

Email: cloud-support@mathworks.com