How to: Connect Team Foundation Server Proxy to Team Foundation Server

You must connect Team Foundation Server Proxy to Visual Studio Team Foundation Server for the proxy server to cache copies of version control files in the location of the distributed team. To complete this procedure, you will need the URL for the deployment of Team Foundation Server for which you want the proxy server to cache files.

Tip

You can use the Team Foundation Administration Console on the server running the application tier to determine the URL for a deployment of Team Foundation Server. To determine the URL, use Public URL on the Application Tier page. To determine the URL with the collection name, use URL on the Team Project Collections page.

Required Permissions

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

To connect Team Foundation Server Proxy to Team Foundation Server

  1. Click Start, point to All Programs, point to Microsoft Team Foundation Server 2010, and then click Team Foundation Administration Console.

    Team Foundation Administration Console appears.

  2. Click Proxy Server, and then click the path in Configuration File.

    Proxy.config opens in the associated text or XML editor.

    Note

    To edit proxy.config on a server that is running Windows Server 2008, you must open it as an administrator, even if you are logged on with administrative credentials. For more information, see the Microsoft Web site.

    To open Notepad as an administrator, click Start, right-click Command Prompt, and click Run as administrator and then type notepad. In Notepad, navigate to the Proxy.config file using the path in Configuration File.

  3. In the Proxy.config file, locate the <Servers> node, the <Server> element, and then the <Uri> element.

  4. Locate the @H\_TFSSERVER@ token. Replace this token with the URL for a deployment of Team Foundation Server. Depending on the scope of version control files you want the proxy server to cache, use one of the following options:

    • If you want the proxy server to cache files for every collection in deployment of Team Foundation Server, use this URL format: http://ServerName:Port/Directory/

    • If you want the proxy server to cache files for specific collections, use this URL format in one or more URI elements: http://ServerName:Port/Directory/CollectionName/

      Where ServerName is the server or DNS name of the deployment of Team Foundation Server. Where Port is the port number on which Team Foundation Server listens for client requests (by default 8080). Where Directory is the virtual directory (by default, tfs). Where CollectionName is the name of the team project collection (by default, DefaultCollection).

    For example, if you wanted to cache version control files for every collection in a deployment of Team Foundation Server, the <Uri> element might look like this:

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

    If you wanted to cache version control files for multiple collections, you would use multiple <Uri> elements that look like this:

    <Servers>
       <Server> 
           <Uri>https://Server:8080/tfs/Collection1/</Uri>
       </Server>
       <Server>
           <Uri>https://Server:8080/tfs/Collection2/</Uri>
       </Server>
    </Servers>
    
  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.

See Also

Tasks

How to: Connect Team Foundation Server Proxy to Team Foundation Server

How to: Examine Cache Performance By Using Performance Monitor

Concepts

Managing Team Foundation Server Proxy

Team Foundation Server Proxy Config File