The Team Foundation Server Proxy Config File

  • Article

The Team Foundation Server Proxy has a separate XML configuration file that maintains information required for the proxy configuration. This topic describes the nodes found in this file and their effect on the Team Foundation Server Proxy configuration.

Team Foundation Server Proxy.Config Nodes

The following XML nodes are found in the Team Foundation Server Proxy configuration file, which is located at %ProgramFiles%\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControlProxy\proxy.config.

Node

Explanation

<ProxyConfiguration>

This is the root element of the proxy configuration file. For example:

<ProxyConfiguration 
    xlmns:xsd="http://www.w3.org/2001/XMLSchema" 
    xlmns:xsi="http://www.w3.org/2001/SMLSchema-instance">
<!-- Additional notes omitted for clarity -->
</ProxyConfiguration>

<Servers>

This node represents a collection of <Server> nodes that correspond to the application tier that the proxy serves files from. Each <Server> node contains a <Uri> node that specifies the URI of the virtual directory for version control on the application tier. For example:

<Servers>
    <Server>
        <Uri>https://ServerName:8080/</Uri>
    </Server>
</Servers>

<CacheRoot>

This node contains the root directory of the file cache. This directory contains one folder for each application tier for which the proxy is configured. For example:

<CacheRoot>C:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControlProxy\Data</CacheRoot>

<CacheLimitPolicy>

This node specifies at what point the proxy will run the clean-up routine to remove stale files. This can be configured in one of two ways: you can use a <PercentageBasedPolicy> node that runs the clean-up routine when a certain percentage of available disk space is filled, or you can use a <FixedSizeBasedPolicy> node to specify a fixed size for the cache (in megabytes). When the specified size is reached, the clean-up routine is run. For example:

<CacheLimitPolicy>    
    <!-- Cache limit expressed as percentage of disk space -->
    <PercentageBasedPolicy>75</PercentageBasedPolicy>    </CacheLimitPolicy>
<CacheLimitPolicy>
    <!-- Cache limit expressed as MB -->
    <FixedSizeBasedPolicy>500</FixedSizeBasedPolicy>
</CacheLimitPolicy>

<StatisticsPersistTime>

This node indicates how frequently (in hours) statistics should be written to disk. For example:

<StatisticsPersistTime>1</StatisticsPersistTime>

<ReaderChunkSize>

This node sets the reader chunk size. For example:

<ReaderChunkSize>1048576</ReaderChunkSize>

<WriterChunkSize>

This node sets the writer chunk size. For example:

<WriterChunkSize>1048576</WriterChunkSize>

Changing Proxy Configuration Settings

To change the proxy configuration, you must open the Proxy.config file in a text or XML editor and change the values specified manually. After saving the files, you must recycle the application pool for the changes take effect. For more information, see How to: Enable Version Control Caching for Team Foundation Server Proxy and How to: Change Cache Settings for Team Foundation Server Proxy.

See Also

Other Resources

Managing Configuration Settings for Team Foundation Server