How to: Configure Team Foundation Build Service Using the Team Foundation Server Configuration Tool

  • Article

You can use this procedure to configure Team Foundation Build Service with the default options.

Note

You can skip the procedure for opening the Team Foundation Server Configuration tool from the Start menu if you opened the tool by selecting the check box at the end of the installation wizard for Visual Studio Team Foundation Server.

Required Permissions

To perform this procedure, you must be a member of the Administrators security group on the server on which you are configuring Team Foundation Build Service.

Tip

After you install the build service, you need to add the build service account (TFSBUILD) to a group on Team Foundation Server to use the service. This configuration is done automatically if you’re a member of the Project Collection Administrators group on the Team Foundation Server. If you’re not sure if you’re a member of this group, use this topic to perform the final configuration necessary to use the build service: Add the Build Service Account to the Project Collection Build Service Accounts Security Group.

Procedures

To open the Team Foundation Server Configuration tool from the Start menu

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

    The Team Foundation Administration Console appears.

  2. Click Build Configuration, and then click Configure Installed Features.

    The Team Foundation Server Configuration tool appears.

To configure Team Foundation Build Service

  1. Click Configure Team Foundation Build Service, and then click Start Wizard.

    The Build Service Configuration wizard appears.

  2. Read the Welcome screen, and then click Next.

  3. Perform one of the following steps, and click Next:

    • Click Browse, and click the team project collection to which you want this build controller to connect.

    • Click Clear to skip setting up a build controller on this instance of Team Foundation Build Service.

      Note

      If you do not connect to a team project collection, skip to step 5.

  4. Perform one of the following steps, and then click Next:

    • Click Use the default setting, and specify the number of build agents.

      If you installed Team Foundation Build Service on the same server as Team Foundation Server, the default setting for Number of build agents to run on this build machine is 1 (recommended).

    • Click Scale out build services, and then specify the number of build agents and a build controller.

      If you installed Team Foundation Build Service on its own server, the default setting for Number of build agents to run on this build machine is equal to the number of processor cores on this server.

    • Click Replace an existing build machine, and then specify the build machine to replace.

    • Click Configure later or Configure later or use with Team Foundation Lab Management to skip setting up any build controllers or agents on this instance of Team Foundation Build Service. 

  5. Under Run Team Foundation Build Service as, perform one of the following steps:

    • Click Use a system account, and then click a system account.

      For example, click NT Authority\Network Service to use Network Service.

    • Click Use a user account to use a domain or local account, and then type the account name and password. To test the user account and password, click Test.

    Network Service is the default value for the service account (TFSBUILD).

  6. Under Accept connections from Team Foundation Server on, perform one of the following steps, and then click Next:

    • Click Default port 9191 to accept the default setting.

    • Click Port Number to enter a custom port.

  7. Review the information. You can use the Properties links to open dialog boxes that allow you to inspect or change configurations for any build controllers or build agents that you have setup.

  8. Click Next.

    The wizard validates your configuration.

  9. Click Configure.

    The wizard applies configuration settings.

  10. Click Next.

  11. Click Close.

  12. Click Close.

    The Team Foundation Administration Console appears.

See Also

Reference

Checklist: Installing Team Foundation Build Service

Change History

Date

History

Reason

March 2012

Added permissions tip.

Information enhancement.