How to: Configure Team Foundation Server Proxy Using the Team Foundation Server Configuration Tool

  • Article

Team Foundation Proxy

You can use the procedures in this topic to configure Team Foundation Server Proxy.

Note

You can access the Team Foundation Server Configuration tool from the Start menu by launching Team Foundation Server Administration Console, choosing Proxy Server, and then choosing Configure Installed Features.

Required permissions

To follow this procedure, you must be a member of the Administrators security group on the server on which you are configuring Team Foundation Server Proxy. You must be a member of the Project Collection Administrators group on TFS. If you connect the proxy to a collection on Visual Studio Online, you need the Microsoft account you used to set up the service.

To configure Proxy Server, you must have TFS installed on a server operating system. For more information, see System requirements for Team Foundation Server.

To configure Team Foundation Server Proxy by using Team Foundation Server Configuration tool

  1. Choose Configure Team Foundation Server Proxy, and then choose Start Wizard.

    The Team Foundation Server Proxy Configuration wizard appears.

  2. Read the Welcome screen, and then choose Next. If you had a version of TFS 2013 proxy (this feature only works with TFS 2013 proxy and forward) set up on this server, you're prompted to restore your settings. If you want to configure this proxy server with different resources, choose No and move on to the next step. If you want to connect proxy to the same TFS servers, choose Yes. TFS will attempt to authenticate. If TFS successfully authenticates all endpoints, skip to step 4.

    If there is a problem with one or more endpoints, you have the following troubleshooting options for each failed connection:

    • Connect: Use this option to manually authenticate endpoints. Manual authentication is a good place to start with any failed connection.

    • Skip: Use this option to skip authentication. Skip is useful if you don’t have the password to authenticate this endpoint, but you want to save the connection information for another try, sometime in the future, perhaps when you have someone available who knows the password and can authenticate the endpoint.

    • Remove: Use this option to completely remove the endpoint.

    Tip

    Would you like more details about what happens with any of these options? See this blog post.

  3. Choose Browse, and then choose the team project collection to which you want this proxy server to connect. Choose Next.

    Note

    If your team project collection is on Visual Studio Online, you’re prompted to authenticate. Enter the Microsoft account you used to set up the service.

  4. Under Service Account, choose Use a system account to use Network Service or Use a user account to use a domain or local account. If you are using a user account, you must type the password. To test the user account and password combination, choose Test.

    Network Service is the default value for the proxy server service account.

  5. The following optional configurations appear under Advanced Configuration:

    • If you’re connected to the hosted service, Account Name appears here.

      When you created the instance of Team Foundation Server on the hosted service, Account Name was automatically created for you. This account will be added to the Project Collection Proxy Service Accounts group on the hosted service. To use a different account, enter the account name and choose Test. To reset to the default service account automatically created for you, choose Reset to default service account.

    • You can change authentication settings. Under Authentication Method, choose NTLM to use NTLM authentication or Negotiate (Kerberos) to first attempt Kerberos authentication, the more secure option, and if that fails, fall back to NTLM.

      NTLM is the default value.

  6. Choose Next.

  7. In Port, accept the default value of 8081 or type a different listener port number for incoming connections to Team Foundation Server Proxy.

    8081 is the default value.

  8. In Cache Root Directory, accept the default value, or type the path of a different location in which to store cache files.

    The default value is Drive:\Program Files\Microsoft Team Foundation Server 12.0\Version Control Proxy\ _tfs_data

    Drive is the letter of the drive on which you want to store cache files. You can specify a mapped network drive.

  9. Choose Next.

  10. On the Review page, review the settings, and then choose Next.

    The wizard validates your configuration.

  11. Choose Configure for the wizard to apply configuration settings.

  12. Choose Next on the success screen to read the detailed results on the next success screen. You will also find a link to a log on this screen that contains the results of the configuration.

  13. Choose Close twice and the TFS administration console will appear.