Use Azure Files for network derived data cache with Unreal Engine
Important
Azure Game Development Virtual Machine is scheduled for retirement on February 1st, 2024. Learn more.
It is essential that you understand the Azure Files performance and redundancy, and Active Directory authentication and authorization features to support the requirement of using Derived Data Cache (DDC) for the Unreal Engine.
Prerequisites
- An Azure account with an active subscription. Create an account for free.
- This article assumes that you know what Azure Files is and the benefits it provides.
Plan Azure Files
The first thing to be done is to plan for an Azure Files for deployment. Since the Game Development Virtual Machine is running on the Windows operating system, the SMB file protocol is recommended. For more information about what to take into consideration when planning Azure Files for deployment refer to the following articles:
- SMB file shares in Azure Files
- SMB Multichannel performance
- Azure Files scalability and performance targets
- Azure Files identity-based authorization
When you’re ready to deploy, you will first need to create an Azure file share. Your Azure File share should look like the following:
Mount Azure Storage File Share
There are two different methods to mount the Azure Storage File Share.
Method 1: Mount Azure File automatically during Game Development Virtual Machine creation
- Begin walking through the steps to create a Game Development Virtual Machine with Unreal Engine.
- When you get to the Data Storage tab, select to Mount an existing Azure Storage File Share.
- Select the Storage Account.
- Select the File Share.
- Finish creating the VM.
Method 2: Mount Azure File manually after Game Development Virtual Machine creation
- Follow the instructions to mount the SMB Azure File share manually.
- Verify that the mounted Azure file is accessible with permission to read/write files and folders after successful remote Game Development Virtual Machine access.
Setup and use DDC
You can now follow the Epic Games documentation to setup and use shared DDC using Azure file share.
Below is the example of completed configuration of shared DDC, the Global Network DDC, in the Epic Unreal Engine Editor. The S:/test path is now connected to the Azure File share on your Game Development Virtual Machine.
Next steps
Continue using Unreal Engine with a shared DDC set up on Azure Files. This improves the team collaboration experience with faster processing time.