Resolving Problems Accessing Web Services
Web services for Team Foundation depend on the appropriate running and configuration of various services, application pools, service accounts, directories, and Web configuration files. A configuration problem in one or more of these areas can cause problems when a client attempts to access a Web site or Web service for Team Foundation.
The following table summarizes the application pools, Web sites, and service accounts on which Team Foundation relies. For more information about Team Foundation services, see Managing and Resetting Service Accounts and Passwords.
Application pool |
Web site |
Service account |
|---|---|---|
DefaultAppPool |
Team Portal |
Network Service |
ReportServer |
Reports |
Network Service |
|
ReportServer |
Network Service |
SharePoint Central Administration v3 |
SharePoint Services Central Administration Site |
The account specified when SharePoint Products and Technologies was installed. |
Microsoft Team Foundation Server Application Pool |
Team Build Service (if Team Foundation Build is installed) |
The account specified when Team Foundation Build was installed. |
|
Team Foundation Server |
TFSService |
|
Team Foundation Server Warehouse |
TFSService |
|
Team Foundation Server Integration |
TFSService |
|
Team Foundation Server VersionControl |
TFSService |
|
Team Foundation Server WorkItemTracking |
TFSService |
Note
You manage the ReportServer application pool for SQL Server 2005 but not for SQL Server 2008.
The following table summarizes configuration issues that can cause problems when users try to access a Web service for Team Foundation. In the table, problems that are more likely to occur appear first. Therefore, you should try the resolutions in the order in which they appear so that you can increase the chance that you can solve the problem quickly.
Problem |
Resolution |
|---|---|
User or group permissions are not set correctly. |
Verify user and group permissions. For more information, see Troubleshooting Team Foundation Server Permissions and Security and Managing Users and Groups. |
A service is not running. |
Verify that all Team Foundation services are running. For more information, see How to: Restart a Service and Set it to Start Automatically. |
An application pool is not running or is not correctly configured. |
Restart any application pools that have stopped, and verify the identity that is assigned to each application pool. For more information, see How to: Verify or Correct the IIS Configuration for an Application Pool. Also, verify that the service accounts are correctly configured and that no passwords have expired. |
A service account is not correctly configured, or its password has expired. |
Review Managing and Resetting Service Accounts and Passwords. Use the TFSAdminUtil ChangeAccount or ChangePassword commands to update service accounts and passwords across the system. See also How to: Change the Service Account or Password for SQL Server Reporting Servicesand How to: Change the Service Account or Password for Team Foundation Server. |
Directory or folder permissions are not set correctly. |
Verify that the built-in Users group has Read, List, and Read & Execute permissions for each Team Foundation Web site directory and virtual directory on which Team Foundation relies. For more information, see How to: Change the Access Control List Permissions for a Directory. Also, verify that the service account for Team Foundation has full access to the MachineKeys directory. For more information, see How to: Change the Security Permissions for the MachineKeys Directory. |
A Web site or virtual directory is not correctly configured. |
Verify that the Internet Information Services (IIS) properties are correctly configured for each Web site directory and virtual directory on which Team Foundation relies. Correct any properties as needed. For more information, see How to: Verify or Correct the IIS Configuration for a Web Site or Virtual Directory. |
Namespace information has been added, or impersonation has been enabled for a Web site. |
Open the Web.config file for each Team Foundation Web service, and remove any information about namespaces or impersonation that you find. For more information, see How to: Verify or Correct the Services Web.config File Properties. |
A Web.config file has been renamed or is missing. |
Restore the Web.config file for your deployment configuration. For more information, see How to: Restore a Missing Web.config File. |
A Web Service Extension is set to Prohibited. |
Verify the state of the Web Service Extensions, and correct them as needed. For more information, see How to: Verify or Correct the Status of Web Service Extensions. |
SharePoint Products and Technologies is not correctly configured. |
To resolve this issue, see Resolving Configuration Issues in SharePoint Products. |
See Also
Tasks
Resolving Problems Connecting to the Application-Tier Server
Resolving Problems Connecting to the Data-tier Server