How to: Enable Source Control Caching for Team Foundation Server Proxy

Article
11/27/2007

After you have installed Team Foundation Server Proxy, you can configure it to manage a cache of source control files for the Team Foundation Server application-tier server. You can also enable the cache for additional application-tier servers now or in the future. For more information, see Team Foundation Server Proxy and Source Control.

You can perform these tasks by editing the Proxy.config file on the proxy server. The Proxy.config file is located in the proxy installation directory.

Note

The default proxy installation directory is …\Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Web Services\VersionControlProxy.

For more information about proxy installation, see the Team Foundation Installation Guide online at https://go.microsoft.com/fwlink/?linkid=40042.

Note

After you configure Team Foundation Server Proxy, you must configure the Team Foundation client to use Team Foundation Server Proxy. For more information, see How to: Configure Team Foundation Source Control to use Proxy Server.

Required Permissions

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

To enable source control caching after installing Team Foundation Server Proxy

On the Team Foundation Server Proxy computer, open Windows Explorer, and locate the proxy installation folder.
Open the Proxy.config file in a text or XML editor.
Locate the <Servers> node, the <Server> element, and then the <Uri> element.
Locate the @H_TFSSERVER@ token and replace it with the URL for your Team Foundation Server application-tier server. Append the URL with a colon (:) and port "8080."

Note

Port 8080 is the defined port for communication between Team Foundation Server Proxy and the application tier.

For example, the following line describes what the <Uri> element might look like after you make the appropriate substitution:
```
<Server> 
    <Uri>https://ApplicationTierServerName:8080/VersionControl</Uri>
</Server>
```
To configure Team Foundation Server Proxy to cache files from multiple Team Foundation servers, add a <Server> section for each server and include appropriate substitutions:
```
<Server>
   <Uri>https://ApplicationTierServerName:8080/VersionControl</Uri>
</Server>
```
Save and close the Proxy.config file.

You can also change the following cache settings in the Proxy.config file:

Specify a different cache root folder.
Change the point at which the proxy will remove old files.
Change the amount of cache to free when old files are removed.

For more information, see How to: Change Cache Settings for Team Foundation Server Proxy.

To enable caching for additional servers at any time

On the Team Foundation Server Proxy server, log on to Windows using the Team Foundation Server Setup account, for example, Domain\TFSSETUP.
Open Windows Explorer and locate the proxy installation folder.
Locate and open the Proxy.config with a text editor.
Locate the <Servers> node and add a <Server> section that specifies the URL for each Team Foundation Server that you want to enable caching:
```
<Server>
   <Uri>https://ApplicationTierServerName:8080/VersionControl</Uri>
</Server>
```
Save and close the Proxy.config file.
On the proxy server, on the Start menu, click Run, and type the following:

IISRESET

Performing this action retrieves the latest Proxy.config file.

How to: Enable Source Control Caching for Team Foundation Server Proxy

To enable source control caching after installing Team Foundation Server Proxy

To enable caching for additional servers at any time

See Also

Tasks

Concepts

Additional resources