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.

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 choose Extensions for SharePoint Products.

  3. In the Extensions pane, choose Grant access.

    The Access for Team Foundation Server window opens.

  4. In URL for Team Foundation Server, 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, choose the URL for the SharePoint web application that you want to use from the drop-down list.

    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 Configure Team Foundation Server Extensions for SharePoint Products.

  6. (optional) In Restrict site creation to the following path, specify 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, specify 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  or SharePoint Server 2010 and you want reports and dashboards to operate correctly. If you are configuring a web application that is hosted on SharePoint Foundation 2010, leave this field blank.

  8. When you have provided the required information, choose 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 Team Foundation Server 2008 or 2005

  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 choose Extensions for SharePoint Products.

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

    The Redirection for Report Server window opens.

  4. In SharePoint Web Application, choose the URL for the web application that you want to use from the drop-down list.

  5. (optional) In Relative path, specify 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, specify the URL (including the instance name, if applicable) for Report Manager.

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

  8. When you have provided the required information, choose 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 choose SharePoint Web Applications.

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

    The SharePoint Web Application Settings window opens.

  4. On the General tab, in Friendly Name, specify 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, specify the URL of the SharePoint eb 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 specify r the port number.

  6. In Central Administration URL, specify 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, specify 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, choose Verify Path.

  9. Choose 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 choose SharePoint Web Applications.

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

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

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

See Also

Tasks

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

Concepts

Team Foundation Server Permissions

The Team Foundation Administration Console

Organizing Your Server with Team Project Collections

Other Resources

Configuring Resources to Support Team Projects