Share via

Add a SharePoint Web Application to Your Deployment

  • Article

To integrate team projects with SharePoint sites, you must add one or more SharePoint Web applications to standard and advanced installations of Visual Studio Team Foundation Server. However, you cannot add SharePoint Web applications to basic installations of Team Foundation Server. If you add SharePoint Web applications, members of your team can perform the following tasks:

  • Automatically create and configure a team project portal when they create a team project or a team project collection.

  • Create a shared documents folder for projects in Team Explorer.

  • Create, store, and share process guidance for your project based on the process template for that project.

To add a Web application, you must configure settings on the server that hosts the Web application and the server that hosts the application tier for Team Foundation. In addition, you must add the service account that SharePoint Products uses to the SharePoint Web Application Services group in Team Foundation Server. You perform all these tasks in the administration console for Team Foundation.

Note

Interactions and interdependencies between deployments of Team Foundation Server and SharePoint Products can be complex. For more information, see Interactions Between SharePoint Products and Team Foundation Server.

To integrate Team Foundation Server and SharePoint Products, you must ensure that all the following conditions are true:

  • Team Foundation Server must be configured with the location of each SharePoint Web application that you want to use in the deployment.

  • The server that hosts the SharePoint Web application must be configured with the location of Team Foundation Server.

  • The service account for each SharePoint Web application that you want to use must be added to the appropriate permissions group in Team Foundation Server.

  • The service account for Team Foundation Server (TFSService) must have the permissions that it requires to create sites or site collections within the SharePoint Web application.

Depending on your business needs, you might want to grant access for more than one SharePoint Web application to support your deployment of Team Foundation Server. For example, you can grant access to a SharePoint Web application that supports projects that you create in the current version of Team Foundation Server. You can then create a redirection to another Web application that supports projects that you created in the previous version of Team Foundation Server.

Required Permissions

To perform these procedures, you must be a member of the following groups or have the following permissions:

  • The Team Foundation Administrators group or your View instance-level information and Edit instance-level information permissions must be set to Allow.

  • The Administrators group on the server that is running the application tier.

  • The Administrators group on the server where the Team Foundation Server Extensions for SharePoint Products have been installed. The server on which the extensions are installed is hosting the SharePoint Web application for which you want to grant access.

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

To grant access between a SharePoint Web application and Team Foundation Server

  1. On the server where you have installed the Team Foundation Server Extensions for SharePoint Products, open the administration console for Team Foundation.

    For more information, see Open the Team Foundation Administration Console.

  2. Expand the tree, and click Extensions for SharePoint Products.

  3. In the Extensions pane, click Grant Access.

    The Access for Team Foundation Server window opens.

  4. In URL for Team Foundation Server, type the public URL for Team Foundation Server.

    You can look up this information in the Application Tier node of the administration console where you have installed the application tier for Team Foundation Server.

  5. In SharePoint Web Application, click the URL for the SharePoint Web application that you want to use.

    If you have installed the Team Foundation Server Extensions for SharePoint Products on the server that is hosting the SharePoint Web applications, all SharePoint Web applications on that server appear in the list. If no Web applications appear, either the extensions were not installed correctly, or no SharePoint Web applications have been configured. For more information about how to install the extensions, see "How to: Install Team Foundation Server Extensions for SharePoint Products" in the installation guide for Team Foundation. You can download this guide from this page on the Microsoft Web site: Installation Guide for Team Foundation. For more information about how to create a SharePoint Web application and site collection for use with Team Foundation Server, see Create SharePoint Web Applications and Sites for Use with Team Foundation Server.

  6. (optional) In Restrict site creation to the following path, type the path of the site collection where you want to create all sites that Team Foundation Server will use.

    This step is recommended for most deployments, because it helps ensure that the deployment can be backed up and restored correctly.

  7. In Enterprise Application Definition, type the name of the definition that you created for Team Foundation Server.

    This step is required only if you are configuring a Web application that is hosted on Microsoft Office SharePoint Server 2007 and you want reports and dashboards to operate correctly. If you are configuring a Web application that is hosted on Windows SharePoint Services 3.0, leave this field blank.

  8. When you have typed the required information, click OK.

    If all values are correct, access will be granted. This process might take several moments.

To create a redirection for a SharePoint Web application to support previous versions of Team Foundation Server

  1. On the server where you have installed the Team Foundation Server Extensions for SharePoint Products, open the administration console for Team Foundation.

    For more information, see Open the Team Foundation Administration Console.

  2. Expand the tree, and click Extensions for SharePoint Products.

  3. In the Extensions pane, click Create redirection for previous versions.

    The Redirection for Report Server window opens.

  4. In SharePoint Web Application, click the URL for the Web application that you want to use.

  5. (optional) In Relative path, type the path for the location where you want to create and support project sites for previous versions of Team Foundation Server.

    Important

    You must specify a path that already exists. You cannot create a path from this page.

  6. In Report Manager URL, type the URL (including the instance name, if applicable) for Report Manager.

  7. In Reporting Services Web Service URL, type the URL for the Web service for SQL Server Reporting Services.

    Note

    If you are not sure what values to specify for Report Manager and Reporting Services Web Service, open Team Explorer, and connect to the installation of Team Foundation Server for which you want create a redirection. In the navigation pane, right-click Reports, and then click Properties. The URL for Report Manager appears in URL, and you can extrapolate from that information the URL for the Web service for the server that is running SQL Server Reporting Services. You can also find this information in Reporting Services Configuration Manager or on the report server itself.

  8. When you have typed the required information, click OK.

    If all values are correct, the redirection will be created. This process might take several moments.

To grant access between Team Foundation Server and a SharePoint Web application

  1. On the server where you have installed the application tier for Team Foundation Server, open the administration console for Team Foundation.

    For more information, see Open the Team Foundation Administration Console.

  2. Expand the tree, and click SharePoint Web Applications.

  3. In the SharePoint Web Applications pane, click Add.

    The SharePoint Web Application Settings window opens.

  4. On the General tab, in Friendly Name, type a name for this SharePoint Web application.

    This name will appear in the list of Web applications. If you intend to use more than one SharePoint Web application in your deployment, consider specifying a name that will help users distinguish this access grant from the access grants for other SharePoint Web applications. You can also add a description in the Description box to help identify this access grant, but the description will not appear in the list.

  5. In Web Application URL, type the URL of the SharePoint Web application for which you want to grant access.

    This name should match the name of the Web application in SharePoint Products. If the SharePoint Web application is configured to use a port number that is not the standard default (80), you must also type the port number.

  6. In Central Administration URL, type the URL and the port number for SharePoint Central Administration.

    Note

    If you have administrative permissions on the server that is running SharePoint Products, you can view this URL and port number by opening SharePoint Central Administration. If not, you must obtain this information from an administrator for that server.

  7. In Default location for team project collection sites, type the relative path for the site collection that you want to use as the root for team project collections that use this SharePoint Web application.

    Note

    By default, the location name is /sites, but you can use any named path for site collections as configured in SharePoint Central Administration. If you are deploying Team Foundation Server in an environment where another administrator manages SharePoint Products, consider contacting that administrator for guidance on which path to use.

  8. (optional) If you want to make sure that the relative path that you provided is valid, click Verify Path.

  9. Click OK.

    If all the values are correct, the SharePoint Web application appears in the list of Web applications that are available for use with Team Foundation Server. This process might take several moments.

    Note

    Team Foundation Server will not only grant access but also attempt to add the service accounts for the SharePoint Web application to the appropriate group in Team Foundation. If any one of these attempts fails, the configuration information for the Web application is saved, but an error message appears. You must then manually configure the settings that the message indicates.

Add the Service Account for the SharePoint Web Application

When you grant access between a SharePoint Web application and Team Foundation Server, you must add the service account for the Web application to the SharePoint Web Application Services group in Team Foundation Server.

Note

You do not have to perform the procedure to grant access between a SharePoint Web application and Team Foundation Server if your account is a member of the Farm Administrators group. If your account is a member of that group, these settings are configured for you automatically when you perform the procedure to grant access between Team Foundation Server and the SharePoint Web application. 

To add a service account for a SharePoint Web application to SharePoint Web Application Services

  1. On the server where you have installed the application tier for Team Foundation Server, open the administration console for Team Foundation.

    For more information, see Open the Team Foundation Administration Console.

  2. Expand the tree, and click SharePoint Web Applications.

  3. In the SharePoint Web Applications pane, in the Service Accounts for SharePoint Web Applications section, click Add Members.

    The Select Users, Computers, or Groups dialog box opens.

  4. In Enter the object names to select, type the account that you want to add, and then click OK.

See Also

Tasks

Add Integration with SharePoint Products to a Deployment of Team Foundation Server

Integrate Team Foundation Server with SharePoint Products Without Administrative Permissions

Modify or Remove Access Between a SharePoint Web Application and Team Foundation Server

Concepts

Interactions Between SharePoint Products and Team Foundation Server

Configure Settings for Dashboard Compatibility

Team Foundation Server Permissions

The Team Foundation Administration Console

Organizing Your Server with Team Project Collections

Other Resources

Configuring Resources to Support Team Projects

Change History

Date

History

Reason

March 2011

Clarified the limitation for basic installations of Team Foundation Server.

Customer feedback.