How to: Refresh the Data Caches on Client Computers
To prevent workspace errors from occurring during version control or build operations in Team Foundation, the data cache on client computers must be updated after certain maintenance operations. After you move, restore, rename, or fail over a data-tier or application-tier server, you must refresh the cache for tracking work items and users must refresh the version control cache on client computers.
Required Permissions
To invoke the StampWorkitemCache Web method, you must be a member of the Administrators security group on the application-tier server for Team Foundation. For more information, see Team Foundation Server Permissions.
To exercise the tf workspaces command on the client computer, you must have the Read permission set to Allow.
Refresh the Work Item Cache
Note
This procedure is optional. You should perform it only if errors occur with work item tracking.
To update the cache for tracking work items, you invoke the StampWorkitemCache Web method. This method forces client computers to update the cache the next time that they connect to the application-tier server. This method also synchronizes the workspaces that are defined on the client computers.
Note
When you invoke the StampWorkitemCache Web method, the performance of Visual Studio Team System Team Foundation Server might temporarily degrade. The performance impact depends on how many Team Foundation users are connected when you invoke the method.
To refresh the cache for tracking work items on client computers
On the application-tier server, open Internet Explorer.
In the Address bar, type the following address to connect to the ClientService Web service:
http://ApplicationTierServerName:8080/WorkItemTracking/v1.0/ClientService.asmx
Note
Even if you are logged on with administrative credentials, you might need to start Internet Explorer as an administrator on a server that is running Windows Server 2008 by clicking Start, clicking All Programs, right-clicking Internet Explorer, and then clicking Run as administrator. For more information, see the Microsoft Web site.
Click StampWorkitemCache, and then click Invoke.
Note
The StampWorkitemCache method returns no data.
Refresh the Version Control Cache
To update the version control cache, each user runs the tf workspaces command on any computer that must be updated. They must update any computer that uses version control and that connects to an application-tier server whose databases were relocated.
To refresh the version control cache on client computers
Log on to a computer that is running a client for Team Foundation and that uses version control.
Click Start, point to All Programs, point to Microsoft Visual Studio 2008, point to Visual Studio Tools, and then click Visual Studio 2008 Command Prompt.
Note
Even if you are logged on with administrative credentials, you might need to open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008 or Windows Vista. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.
At the command prompt, type the following command, providing the name and port number of the application-tier server:
**tf workspaces /s http://**ApplicationTierServerName:Port
For more information, see the Workspaces Command.
See Also
Tasks
How to: Restore Data for Team Foundation
How to: Fail Over to a Mirrored Data-Tier Server
How to: Move from a Single-Server to a Dual-Server Deployment