How to: Set up and Install Team Foundation Build

You typically install Team Foundation Build on a computer that is dedicated to running builds. You can install it on an application-tier server, data-tier server, or client computer for Team Foundation, but this practice is not recommended for security reasons.

Each build computer can be associated with only one Team Foundation application tier. However, a Team Foundation application tier can communicate with multiple build computers.

The Team Foundation Build default value is port 9191. You can change the port, but if you do, you must add the new port to the exceptions list. You must also configure the build agent to use the new port. For more information, see How to: Create and Manage Build Agents.

Note

If you change the service account for Visual Studio Team Foundation Build service, you must be sure that the account is a member of the Build Services group. Also, be sure that the account has read/write permissions to the temporary folders, the build drop shared folder, and the ASP.NET temporary folder. For more information, see How to: Add the Build Service Account to the Build Services Security Group.

Prerequisites

  • To run tests during a build, Test Edition must be installed on the build computer. In order to run unit testing, code coverage, or code analysis, Visual Studio Team System Development Edition must be installed on the build computer.

  • Visual C++ projects are built by VCBuild.exe. You must have Visual Studio installed on the build computer in order to build Visual C++ projects.

  • If the build computer has a firewall enabled, be sure that the following are in the exceptions list:

    • Visual Studio Team Foundation Build

    • Port 9191, the default port for Team Foundation Build that uses WCF (Windows Communication Foundation)

Required Permissions

To perform this procedure, you must belong to the Administrators security group on the computer that you are installing Team Foundation Build. For more information, see Team Foundation Server Permissions.

To set up a build computer

  1. On the computer for which you want to install the Visual Studio Team Foundation Build service, run setup to start the build setup, and follow the directions provided.

    Note

    The setup.exe and associated files are located on the Team Foundation Server installation CD under \BUILD.

  2. When the setup wizard prompts you for logon credentials, enter a valid Domain account or Workgroup account.

    Visual Studio Team Foundation Build service uses this account to run the builds.

    Note

    To build a team project, add the account that you are specifying in this procedure to the Build Services group for the project. For more information, see How to: Establish Permissions for Team Foundation Build Agent.

  3. After installation, click OK.

  4. Add the build service account to the Build Services security group. For more information, see How to: Add the Build Service Account to the Build Services Security Group.

  5. Create a build agent. For more information, see How to: Create and Manage Build Agents.

See Also

Tasks

How to: Uninstall Team Foundation Build from a Build Computer

Concepts

Team Build Requirements for Team Foundation