Export (0) Print
Expand All
2 out of 13 rated this helpful - Rate this topic

Walkthrough: Setting up a Remote Office with Team Foundation Server

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

For the best performance with source control, place a Team Foundation Server Proxy computer at each location. Use this walkthrough to understand the steps required in setting up a Team Foundation Server Proxy in your remote offices for use with source control.

For more information about planning, see Planning for Remote Offices.

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 on how to configure a Team Foundation client to use Team Foundation Server Proxy, see How to: Configure Team Foundation Source Control to use Proxy Server.

Required Permissions

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

NoteNote

To examine cache performance for Team Foundation Server Proxy using Perfmon.exe, you must be at least a member of the Performance Monitor Users security group on the Team Foundation Server Proxy computer.

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

To install Team Foundation Server Proxy

  1. Install and complete the prerequisites for a Team Foundation Server Proxy computer:

    1. Install Windows Server 2003 with Service Pack 1 (SP1), Enterprise or Standard Edition.

    2. Add the Team Foundation Server Setup account (for example, Domain\TFSSETUP) to the local Administrators group. For more information, see "User Accounts Required for Team Foundation Server Setup" in the Team Foundation Installation Guide. The latest version of the Team Foundation Installation Guide is available online at http://go.microsoft.com/fwlink/?linkid=40042.

    3. Install Internet Information Services 6.0 and enable ASP.NET. For more information, see "How to: Install Internet Information Services for Team Foundation Server Proxy" in the Team Foundation Installation Guide. The latest version of the Team Foundation Installation Guide is available online at http://go.microsoft.com/fwlink/?linkid=40042.

    4. Install Team Foundation Server on this computer, or elsewhere.

  2. On the Team Foundation Server Proxy computer, log on to Windows using the Team Foundation Server Setup account (for example, Domain\TFSSETUP). On the Team Foundation Server installation media, locate the \atp folder and run setup.exe.

    The Visual Studio 2005 Team Foundation Server Proxy Setup wizard starts.

  3. On the Welcome to Setup page, click Next.

  4. On the End-User License Agreement and Product Key page, review the license agreement. If you accept the terms and conditions, select I accept the terms of the License Agreement, and then click Next.

  5. On the System Health Check page, the setup wizard scans your system for conditions that could cause setup to fail, or cause issues later during server operation. After completing the system scan, setup reports the status of the system health check. If the system health check finds any issues, you can click a link to review a report about specific warnings and blocks. Warnings should be addressed before continuing with setup, but should not prevent setup from completing. Blocks must be addressed before continuing with setup. If the system health check did not find any blocks, click Next. Otherwise, click Cancel and run setup again after fixing any blocking issues.

  6. On the Destination Folder page, accept the default destination folder and click Next.

  7. On the next page, accept the default cache folder and click Next.

  8. On the Service Account page, type the Windows domain user account you created for the Team Foundation Server Service account (for example, Domain\TFSSERVICE) in the Account Name box, type the password in the Password box, and then click Next. For more information, see "User Accounts Required for Team Foundation Server Setup" in the Team Foundation Installation Guide. The latest version of the Team Foundation Installation Guide is available online at http://go.microsoft.com/fwlink/?linkid=40042.

    NoteNote

    For this release, you must use the same Windows domain user account as the Team Foundation Server Service account.

  9. On the Ready to Install page, click Install.

  10. On the Installing Components page, you can monitor the installation of the Team Foundation Server Proxy.

  11. On the Setup Completed Successfully page, click Finish.

For more information about Team Foundation Server Proxy installation, see the Team Foundation Installation Guide located online at http://go.microsoft.com/fwlink/?linkid=40042 or the TFSInstall.chm file included with the product.

To enable source control caching after installing Team Foundation Server Proxy

  1. On the Team Foundation Server Proxy computer, open Windows Explorer, and locate the proxy installation directory at …Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Web Services\VersionControlProxy.

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

  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."

    For example, the following line describes what the <Uri> element might look like 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 configuring Team Foundation Server Proxy, see Managing Remote Connections to Team Foundation Server Proxy.

To view cache performance for Team Foundation Server Proxy by using Perfmon.exe

  1. Click Start, point to Administrative Tools, and then click Performance.

    - or -

    Open a Command Prompt window, and at the command prompt, type perfmon.

    The Performance monitor appears.

  2. In the left pane, expand Console Root, and then click System Monitor.

    The system monitor appears in the right pane.

  3. Right-click the system monitor pane, and then click Add Counters.

    The Add Counters dialog box appears.

  4. In the Add Counters dialog box, click Select counters from computer.

  5. In the Select counters from computer box, make sure that the name of the computer that has Team Foundation Server Proxy installed is displayed. Otherwise, type or select the name of that computer.

  6. In the Performance object box, select TFS Proxy Server.

    In the Select counters from list box, the performance counters for this performance object are displayed.

  7. Select one of the following:

    • To select all counters, click All counters, click Add, and then click Close.

    • To select individual counters, click Select counters from list, select the counters you want to add, click Add, and then click Close.

      NoteTip

      To select a continuous range of counters, press and hold the SHIFT key when you select the first and last counter in the range. To select a discontinuous range, press and hold the CTRL key when you select each counter.

    In the system monitor pane, the performance counters for the cache are added to the System Monitor window.

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

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

    NoteNote

    You can call the QueryProxyStatistics operation only from the local computer that has Team Foundation Server Proxy installed.

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

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

    The Web page for the ProxyStatistics Web service and its operations is displayed.

  3. Click QueryProxyStatistics to view 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 look like the following:

    <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" /> 
    
    NoteNote

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

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 Source Control to use Proxy Server.

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.