Troubleshoot Azure Game Development Virtual Machine and Get Support

Important

Azure Game Development Virtual Machine is scheduled for retirement on February 1st, 2024. Learn more.

The Game Development Virtual Machine is built on top of common Windows images currently available in Azure, which allows you to use much of the same troubleshooting guidance found for general Azure VMs. For more details about how to get support with your Azure VMs, please visit the Azure support FAQ.

We are very eager to hear your feedback and invite you to share your experiences and feedback in our survey; however, be sure to create a ticket in the Azure Portal if you run into issues that require support to help unblock you. Additionally, join our Game Dev Discord channel to connect with thousands of game developers around the world and talk with the Game Development Virtual Machine team.

This article describes common support issues that customers might experience, and guidance from us about how to resolve them.

VM deployment support

Reached quota limits

Tip

If you are an independent game developer or startup interested in working with the Game Dev VM, joining the ID@Azure program is strongly recommended. This program will help with your quota ask; plus you get free access to developer tools and support from industry experts.

The most common issue when deploying the Game Development Virtual Machine is when the Azure region you are deploying to does not have the desired quota, especially for GPU SKUs which are high in demand. You may receive a similar error like the following when you deploy the VM: "Operation could not be completed as it results in exceeding approved standardNVSv3Family Cores quota."

If you can’t find your desired VM SKUs when you attempt to create the VM, it could be possible that your Azure subscription doesn’t have enough quota to deploy GPU-intensive VMs, or the region doesn’t support the SKUs, or your Azure offer doesn't support GPU. To check what Azure offers support GPU SKUs, please refer to this offer types chart.

Screenshot showing the Azure Portal dashboard to select a VM size

To check if your region supports the required SKUs, please go to Azure Products by Region and examine if NCasT4v3-series, NV-series, NVv3-series or NVadsA10 v5-series is available. You can also check resource usage against limits if you believe you need more quota. Select the location(s) you want to deploy the VM. And choose Microsoft.Compute as the Provider. Confirm that the VM sizes: Standard NV Family vCPUs, Standard NVSv3 Family vCPUs, Standard NCASv3_T4 Family vCPUs and Standard NVADSA10v5 Family vCPUs are available since these are the sizes supported by the Game Development VM.

Screenshot showing the available VM sizes and how to request quota increases

If you see the Usage is full, or an error message saying "VM size currently unavailable", you need click the icon to create a support request to increase quota or activate the unavailable VM size(s).

Screenshot showing how to request a quota increase

In some cases, if you see a pencil icon, then you click it and set up a new quota limit by yourself.

Screenshot showing how to set up a quota limit

Tip

If you prefer command line, you can run Bash in Azure Cloud Shell in the Azure portal. az vm list-skus, and az vm list-usage are useful commands to start with.

Example 1: Find out which regions have supported VM sizes for Game Dev VM, and whether those sizes are available for your Azure subscription.

az vm list-skus --all --output table | grep "Locations\b\|---\|\([[:alnum:]]\+[[:space:]]\+\)Standard_N\(V[[:digit:]]\+\(s_v3\)\?\|C[[:digit:]]\+as_T4_v3\)\b" | (sed -u 2q; sort)

Example 2: Get the compute resource usage, which supports Game Dev VM for the West US region in your Azure subscription.

az vm list-usage --location westus -o table | grep "Name\b\|---\|\(NV\|NVSv3\|NCASv3_T4\|A10v5\)\b" | (sed -u 2q; sort)

Validation failure

At the end of Game Development VM creation, the Azure Portal will validate whether all the required information has been filled in. If any information is missing or incorrect, you will see the error message: "Validation failed. Required information is missing or not valid."

Screenshot showing the validation error during VM creation

The Azure Portal highlights which tabs are missing information and what needs to be changed, by putting a red circle above the tab that requires attention. You need to go back to the tabs and complete the missing fields or make the correction.

Deployment failure

It usually takes about 10 to 15 minutes to deploy the VM. If deployment fails, Azure will return the error message in the Azure Portal notifications bar, which will display the reason for the failure, so you know how to resolve the issue. For more common VM deployment failure issues, refer to the troubleshooting VM deployments in Azure article.

Screenshot showing how to see why VM deployment failed

Teradici or Parsec license failure

If you choose Parsec or Teradici as the remoting tool into the VM, and the license information is incorrect or can’t be verified, you may notice the following failure with an error message at the end of deployment, when clicking on the Operation details link: "VM has reported a failure when processing extension 'CustomScriptExtension-Teradici'. Error message: "Command execution finished, but failed because it returned a non-zero exit code of: '1'. The command had an error output of: 'No license available.\r\nFailed to register with the cloud license server "https://teradici.compliance.flexnetoperations.com/instances/.../request".

An Azure Custom Script Extension is used to verify your license information with each partner. If the information is wrong or the verification can’t finish because of a network connection issue, the above failure occurs. You can still access the VM using RDP and manually register your remoting solution with the correct information. You don’t need to restart the whole deployment.

If none of the above scenarios are applicable to your VM Deployment issue, please open a support request. The request should have the Service type: Virtual Machine running Windows, Problem type: Cannot create a VM, and Problem subtype: Troubleshoot marketplace image deployment failures.

Screenshot showing what to include in support request when VM creation fails

VM access support

RDP

There are three methods to access this VM. RDP, Parsec or Teradici. RDP is the default option, and it is always available. If you have any VM Access issue, the first step is to troubleshoot the default RDP option. If you need other support with RDP, please open a support request. The request should have the Service type: Virtual Machine running Windows, Problem type: Cannot connect to my VM, and Problem subtype: Failure to connect using RDP or SSH port.

Screenshot showing what to include in support request when VM connection fails with RDP

Parsec

The pre-installed Parsec component in this Game Development VM is the Parsec application. No additional network port configuration or NSG is required to make Parsec work. If you can access the VM via RDP but not Parsec, please reach out to Parsec support Here are some additional Parsec technical resources:

Teradici

The pre-installed Teradici component in the Game Development VM is the Teradici PCoIP Graphics Agent for Windows 21.07. If you need, first follow the instructions to remote into the VM with Teradici. If you can access the VM via RDP but not Teradici, please make sure the ports: 4172, 443 and 60443 are not blocked by a firewall in your network environment.

Screenshot showing Teradici remote connections to a VM

Check if there’s any other NSG rules taking precedence. If networking is excluded as the cause of the issue, it’s possible the issue roots from software itself, and you’ll need to contact Teradici support.

Azure Active Directory

This Game Development VM supports Azure Active Directory (Azure AD) authentication when you enable Azure AD during VM creation. The user experience of Azure AD on Game Development VM is identical to regular Azure VM. If you have sign-in issues with Azure AD, please follow the troubleshooting steps.

The most common issue is that Azure role assignment is not configured after VM is created. You need to set up either Virtual Machine Administrator Login or Virtual Machine User Login role on the Game Development VM to authorize Azure AD login.

If the troubleshooting methods in the above links can’t resolve your issue, please open a support request. The request should have the Service type: Virtual Machine running Windows, Problem type: VM Extensions not operating correctly, and Problem subtype: Azure Active Directory Login extension issue.

Screenshot showing what to include in support request when VM extensions not operating correctly

Issue with pre-installed tools

This VM comes pre-installed with many different tools. If you have an issue with a partner’s tooling, please reach out directly to that partner for support on their specific solution. One common issue you may notice with pre-installed tools can be related to network restriction, as some tools use different network ports to communicate with other devices or services. The Azure Game Development VM doesn’t block those ports. However, you may have your own security policies which block certain ports on Azure. You need to check with your network administrator and make sure the network Access Control List (ACL) or other security mechanisms like Blueprint policies in your environment don’t block the required network connection.

To know which tools were successfully installed on your VM, you can find a log file named INSTALLED SOFTWARE.txt on the desktop after VM is deployed. This file lists all the pre-installed software and the installation status. This can be a valuable resource to troubleshoot pre-installed tooling related issues. If the issue you find relates to the pre-install tools, you should reach the respective support channels or leverage community resources, like our Discord channel, Microsoft Q&A, or Stack Overflow to get help. However, if you believe this is a Game Development VM related issue, please open a support request with the Service type: High Performance Computing (HPC), Problem type: HPC VM (N or H series), and the most relevant problem subtype.

Screenshot showing what to include in support request when there is an HPC issue