Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Default TEMP Folder Size is too Small on Web/Worker role

Updated: November 17, 2014

Applies to: Azure SDK 1.0 through SDK1.4 using Web and Worker Roles

Symptom: The temporary directory for the hosted service runs out of space or you need data to persist in the temporary directory across the lifecycle of the hosted service.

Cause: The standard Windows environment variables TEMP and TMP are available to code running in your application. Both TEMP and TMP point to a single directory that has a maximum size of 100 MB. Any data stored in this directory is not persisted across the lifecycle of the hosted service; if the role instances in a hosted service are recycled, the directory is cleaned.

Resolution: Implement one of the following alternatives:

  • Configure a local storage resource, and access it directly instead of using TEMP or TMP. To access a local storage resource from code running within your application, call the RoleEnvironment.GetLocalResource method. For more information about setting up local storage resources, see Configure Local Storage Resources.

  • Configure a local storage resource, and point the TEMP and TMP directories to point to the path of the local storage resource. This modification should be performed within the RoleEntryPoint.OnStart method.

The following code example shows how to modify the target directories for TEMP and TMP from within the OnStart method:

using System;
using Microsoft.WindowsAzure.ServiceRuntime;

namespace WorkerRole1
   public class WorkerRole : RoleEntryPoint
      public override bool OnStart()
         // The local resource declaration must have been added to the
         // service definition file for the role named WorkerRole1:
         // <LocalResources>
         //    <LocalStorage name="CustomTempLocalStore" 
         //                  cleanOnRoleRecycle="false" 
         //                  sizeInMB="1024" />
         // </LocalResources>
         string customTempLocalResourcePath = 
         Environment.SetEnvironmentVariable("TMP", customTempLocalResourcePath);
         Environment.SetEnvironmentVariable("TEMP", customTempLocalResourcePath);
         // The rest of your startup code goes here…
         return base.OnStart();

See Also

© 2015 Microsoft