How to: Change Cache Settings for Team Foundation Server Proxy

You can change the settings for the version control file cache by editing the Proxy.config file on the server that is running Team Foundation Server Proxy. By default, this file is located in the installation directory for Team Foundation Server Proxy.

You can use Proxy.config in the following ways:

• Determine the location of the cache root folder.

• Change the cache limit beyond which old files are removed from the cache.

• Change the amount of space to free when old files are removed.

• Change the interval for saving information about cache performance to a file.

After you perform one or more of these tasks, you must recycle the application pool by using the IISRESET command to retrieve the most recent version of Proxy.config.

Required Permissions

To perform this procedure, you must be a member of the Administrators security group on the server that is running Team Foundation Server Proxy.

Even if you are logged on with administrative credentials, you may have to take these precautions on computers that are running Windows Server 2008 or Windows Vista:

• To follow a command-line procedure, you might have to open an elevated Command Prompt. Click Start, right-click Command Prompt, and then click Run as Administrator.

• To modify Proxy.config, you might have to open a text editor as an administrator. To open Notepad as an administrator, click Start, right-click Command Prompt, click Run as administrator, and then type notepad. In Notepad, locate the Proxy.config file by using the path in Configuration File.

For more information, see the following page on the Microsoft Web site: User Account Control.

To open the Proxy.config file

1. Click Start, point to All Programs, point to Microsoft Team Foundation Server 2010, and then click Team Foundation Administration Console.

   Team Foundation Administration Console appears.

2. Click Proxy Server, and then click the path in Configuration File.

   Tip

   You may have to open your text editor as an administrator to edit Proxy.config.

Determine the Cache Root Folder

You should not attempt to modify the cache root folder by editing Proxy.config.

To determine the specified cache root folder

1. Open Proxy.config in a text or XML editor.

2. Locate the <CacheRoot> element, which contains the location of the cache root folder in the file system.

   <CacheRoot>CacheRootFolderLocation</CacheRoot>

Change the Cache Limits for Removing Old Files

To change the limit at which old files are removed from the cache

1. Open Proxy.config in a text or XML editor.

2. Locate the <CacheLimitPolicy> element.

3. Perform one of the following tasks:

   • To specify a percentage of available disk space to fill before old files are removed from the cache, update the <PercentageBasedPolicy> element.

     For example, the following line specifies that the cache should fill up to 60% capacity of available disk space before old files are removed:

     <PercentageBasedPolicy>60</PercentageBasedPolicy>
     

   • To specify a fixed number of megabytes (MB) for the cache to reach before old files are removed, add or update the <FixedSizeBasedPolicy> element.

     For example, the following line specifies that the cache should reach 500 MB before old files are removed.

     <FixedSizeBasedPolicy>500</FixedSizeBasedPolicy>
     

   Note

   The <PercentageBasedPolicy> and <FixedSizeBasedPolicy> elements cannot be in effect at the same time.

4. Save and close the Proxy.config file.

5. Open a Command Prompt window, type iisreset, and then press ENTER.

To change the amount of cache to free when removing old files

1. Open Proxy.config in a text or XML editor.

2. Locate the <CacheDeletionPercent> element, and then update it by changing the percentage of cache space to free when old files are removed.

   For example, the following line specifies to free 50% of the cache when old files are removed.

   <CacheDeletionPercent>50</CacheDeletionPercent>
   

3. Save and close Proxy.config.

4. Open a Command Prompt window, type iisreset, and then press ENTER.

Changing the Interval for Saving Cache Performance Statistics

You can change the interval for saving cache performance statistics to an XML file that is named ProxyStatistics.xml. These statistics are tracked by performance counters that are installed by default. The ProxyStatistics.xml file is located in the App_Data folder in the installation directory for Team Foundation Server Proxy.

You can view these performance statistics from the Performance monitor or by using the ProxyStatistics Web service. For more information, see How to: Examine Cache Performance By Using Performance Monitor.

To change the interval for saving performance statistics to a file

1. Open Proxy.config in a text or XML editor.

2. Locate the <StatisticsPersistTime> element, and then update it by changing the number of hours for each interval.

   Note

   The default and minimum interval is one hour. The maximum interval is 24 hours.

   For example, the following line specifies that the statistics should be saved every two hours:

   <StatisticsPersistTime>2</StatisticsPersistTime>
   

3. Save and close Proxy.config.

4. Open a Command Prompt window, type iisreset, and then press ENTER.

See Also

Tasks

How to: Manage the Service Account or Authentication for Team Foundation Server Proxy

Concepts

Managing Team Foundation Server Proxy