Walkthrough: Setting up a Remote Office with Team Foundation Server

  • Article

Your deployment of Team Foundation Server might require that you set up distributed, remote offices. In such a case, you might want to keep the bulk of the data and application-tier servers for Team Foundation in the main location but also set up Team Foundation Server Proxy in the remote offices.

For the best performance with source control, you should set up a computer to run Team Foundation Server Proxy at each location. You can use this walkthrough to understand the steps that are required to set up a computer to run Team Foundation Server Proxy in remote offices for use with source control.

Prerequisites

This walkthrough takes you through the procedure for setting up Team Foundation Server Proxy for use in a remote office. The procedures include instructions for installing, configuring, and monitoring performance for Team Foundation Server Proxy.

For information about how to configure a Team Foundation client to use Team Foundation Server Proxy, see How to: Configure Team Foundation Version Control to use Proxy Server.

Required Permissions

To perform this walkthrough, you must be a member of the Administrators group on the computer that is running Team Foundation Server Proxy and on the application-tier and data-tier servers for Team Foundation. You must also be a member of the Team Foundation Administrators group.

Note

To examine cache performance for Team Foundation Server Proxy by using Performance Monitor, you must be a member of the Performance Monitor Users security group on the computer that is running Team Foundation Server Proxy.

For more information about permissions, see Team Foundation Server Permissions.

To install Team Foundation Server Proxy

  • Install and complete the prerequisites for Team Foundation Server Proxy. For more information, see the installation guide for Team Foundation on the Microsoft Download Center.

To enable source control caching after you install Team Foundation Server Proxy

  1. On the computer that is running Team Foundation Server Proxy, open Windows Explorer, and locate the proxy installation directory at Drive:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControlProxy.

  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 the application-tier server for Team Foundation. Append the URL with a colon (:) and port "8080."

    For example, the <Uri> element might resemble the following line after you make the appropriate substitution:

    <Server> 
    <Uri>http://ApplicationTierServerName:8080/VersionControl</Uri>
</Server>

  5. Save and close the Proxy.config file.

    For more information about how to configure Team Foundation Server Proxy, see Managing Remote Connections to Team Foundation Server Proxy.

To view cache performance for Team Foundation Server Proxy by using Performance Monitor

To view cache performance for Team Foundation Server Proxy by using the ProxyStatistics Web service

  1. If you are not using the computer on which Team Foundation Server Proxy is installed, open a remote desktop connection to that computer.

    Note

    You can call the QueryProxyStatistics operation only from the local computer on which Team Foundation Server Proxy is installed.

  2. On the computer on which Team Foundation Server Proxy is installed, open Internet Explorer, and browse to the following URL:

    https://localhost:8081/VersionControlProxy/v1.0/proxystatistics.asmx

    The Web page for the ProxyStatistics Web service and its operations appears.

    Note

    To access Web services or Web sites on a computer that is running Windows Server 2008 or Windows Vista, you might need to add these sites to the list of trusted sites in Internet Explorer or start Internet Explorer as an administrator.

  3. Click QueryProxyStatistics to display information about the operation.

  4. Click Invoke to display an XML file that contains the performance counter statistics.

  5. Locate the <ProxyStatisticsInfo> element that contains these statistics.

    For example, some sample output might resemble the following text:

    <ProxyStatisticsInfo CurrentCacheSize="356352" NoOfRequests="82" OverallCacheHits="41" NoOfFilesInCache="41" OverallCacheMisses="41" CacheHitsPercentage="50" CacheMissPercentage="50" ServerId="643c23c1-3f47-43d2-b638-3bd0e7ea8bff" ServerUrl="http://TeamFoundationServerName:8080/VersionControl" />

    Note

    The following statistics are calculated at run time: OverallCacheMisses, CacheHitsPercentage, and CacheMissPercentage.

Next Steps

After you have installed and configured Team Foundation Server Proxy, you must also configure your Team Foundation client to use the proxy for source control. For more information, see How to: Configure Team Foundation Version Control to use Proxy Server.

See Also

Tasks

How to: Examine Cache Performance By Using Performance Monitor

How to: Examine Cache Performance by Using the ProxyStatistics Web Service

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

Concepts

Monitoring Performance