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

  • Article

After you have installed Team Foundation Server Proxy, you can configure it to manage a cache of version 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. 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 2008 Team Foundation Server\Web Services\VersionControlProxy.

For more information about proxy installation, see the Team Foundation Installation Guide at the Microsoft Web site.

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 Version 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 version control caching after installing Team Foundation Server Proxy

  1. On the Team Foundation Server Proxy computer, open Windows Explorer, and locate the proxy installation folder.

  2. Open the Proxy.config file in a text or XML editor.

    Note

    Even if you are logged on with administrative credentials, you must open Notepad as an administrator to perform this function on a server that is running Windows Server 2008. To open Notepad as an administrator, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.

  3. Locate the <Servers> node, the <Server> element, and then the <Uri> element.

  4. 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>http://ApplicationTierServerName:8080</Uri>
</Server>

  5. 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>http://ApplicationTierServerName:8080</Uri>
</Server>

  6. (Optional) 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.

  7. Save and close the Proxy.config file.

  8. Restart IIS by opening a Command Prompt window, typing iisreset, and pressing ENTER.

    Note

    Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.

    The most recent Proxy.config file is retrieved.

To enable caching for additional servers at any time

  1. Log on to the Team Foundation Server Proxy server by using the Team Foundation Server Setup account (for example, Domain\TFSSETUP).

  2. Open Windows Explorer, and locate the proxy installation folder.

  3. Locate and open the Proxy.config with a text editor such as Notepad.

    Note

    Even if you are logged on with administrative credentials, you must open Notepad as an administrator to perform this function on a server that is running Windows Server 2008. To open Notepad as an administrator, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.

  4. 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>http://ApplicationTierServerName:8080</Uri>
</Server>

  5. Save and close the Proxy.config file.

  6. Restart IIS by opening a Command Prompt window, typing iisreset, and pressing ENTER.

    Note

    Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.

    The most recent Proxy.config file is retrieved.

See Also

Tasks

How to: Disable Version Control Caching for Team Foundation Server

How to: Examine Cache Performance By Using Performance Monitor

Troubleshooting Team Foundation Server Proxy

Concepts

The Team Foundation Server Proxy Config File