TF31001: Team Foundation cannot retrieve the list of team projects from Team Foundation Server {0}. The Team Foundation Server returned the following error: {1}.

This error occurs when Team Explorer cannot display the list of team projects in Visual Studio Team System Team Foundation Server. The specific error message that Team Foundation Server returns should help you determine the cause of the problem.

As a first step, determine whether this problem occurs on one or multiple computers. If the problem occurs on only one computer, you should perform a basic connectivity check of services for Team Foundation Server, as To verify basic connectivity to services describes later in this topic. If the problem occurs on more than one computer, you should contact the administrator for Team Foundation Server to confirm whether the server is operational and available on the network.

When the problem occurs on only one computer

You may be able to resolve the problem if you review and address the following likely causes:

Symptom

Problem/Resolution

When configuration information changes for a deployment of Team Foundation Server, the cache on client computers must be cleared.

Follow the steps in To clear the cache on client computers for Team Foundation later in this topic.

An error appears that resembles the following text:

TF31001: Team Foundation cannot retrieve the list of team projects from Team Foundation Server ServerName. Team Foundation Server returned the following error: Access to the temp directory is denied.

Antivirus or firewall software on your client computer may be blocking services for Team Foundation Server. Disable the antivirus software or firewall to determine whether that change corrects the problem.

When the problem occurs on multiple computers

As an administrator, you should check the event logs for the application-tier server to try to pinpoint the problem. Also, you can use the following table to determine whether the server is misconfigured.

Important noteImportant Note:

If a TF31002 error appears in addition to one or more TF31001 errors, you should also review the information in TF31002: Unable to connect to this Team Foundation Server {0}. Team Foundation Server URL: {1}.

Problem

Resolution

An error appears that resembles the following text:

TF31001: Team Foundation cannot retrieve the list of team projects from Team Foundation Server ServerName. Team Foundation Server returned the following error: The request failed with HTTP status 403: Forbidden.

This error may occur when IP restrictions are enabled on the website for Team Foundation Server. You should remove these restrictions. For more information, see How to: Verify or Correct IP Address and Domain Name Restrictions.

NoteNote:
By default, Team Foundation Server is configured to grant all computers access to all Web sites for Team Foundation. Before you revert any settings to the default value, you should investigate why the settings were changed. Many organizations deny access to match their infrastructure requirements or security policies.

An error appears that resembles the following text:

TF31001: Team Foundation cannot retrieve the list of team projects from Team Foundation Server ServerName. Team Foundation Server returned the following error: The request failed with HTTP status 503: service unavailable.

Required application pools and services might not be running. For more information, see How to: Verify or Correct the IIS Configuration for an Application Pool and How to: Restart a Service and Set it to Start Automatically.

An error appears that resembles the following text:

TF31001: Team Foundation cannot retrieve the list of team projects from Team Foundation Server ServerName. Team Foundation Server returned the following error: The request failed with HTTP status 503: TF30059: Fatal error when initializing web service.

The WWW service might be running in Internet Information Services (IIS) 5.0 isolation mode. For information about how to resolve this error, see Error 29112 in Troubleshooting Installation of Team Foundation.

The TCP/IP protocol for SQL Server might be disabled. For information about how to enable this protocol, see How to: Enable the TCP/IP Protocol for a Database Instance.

An error appears that resembles the following text:

TF31001: Team Foundation cannot retrieve the list of team projects from Team Foundation Server ServerName. On the client computer, the application event log shows the error "Invalid length parameter passed to the SUBSTRING function."

Statistics in the TfsIntegration database might be outdated. For more information, see the following page on the Microsoft website: TFS: Error message "Invalid length parameter passed to the SUBSTRING function." when trying to connect.

If the previous resolutions do not solve the problem, check the forum for administering Team Foundation Server. For more information, see the following page on the Microsoft website: MSDN Forums - Visual Studio Team System – Team Foundation Server - Administration.

To check for basic connectivity to services

  • Open a browser, and type the following address:

    https://<server>:8080/services/v1.0/serverstatus.asmx

    If a description of the web service for Team Foundation Server Status does not appear, contact your administrator for Team Foundation Server.

To clear the cache on client computers for Team Foundation

  1. Log on to your client computer for Team Foundation by using the credentials of the user whose cache you want to clear.

  2. Close any open instances of Visual Studio.

  3. Open a browser, and browse to one of the following folders, depending on the operating system that is running:

    • Windows XP or Windows Server 2003

      Drive**:\Documents and Settings\UserName\Local Settings\Application Data\Microsoft\Team Foundation\2.0\Cache**

    • Windows Vista or Windows 7

      Drive**:\Users\UserName\AppData\Local\Microsoft\Team Foundation\2.0\Cache**

  4. Delete the contents of the Cache directory, including all subfolders.

See Also

Tasks

Troubleshooting Team Explorer

Change History

Date

History

Reason

August 2010

Added information and links to topics about troubleshooting.

Customer feedback.