Reconnect Services and Users
This topic, the fourth part of the Restore a Single-Server tutorial, teaches you how to start team project collections and verify user groups on the new server. You will also learn how to clear the data caches on the new server, and how to help ensure that your users do not experience data caching problems when they connect to the new server.
The examples in this tutorial topic follow Jill, an IT Administrator at the fictitious company, Fabrikam, Inc., as she recovers from a hardware failure of the original deployment described in Get Up and Running With a Single-Server Installation [Tutorial]. The examples will be easier to follow if you're familiar with that tutorial.
In this topic
To invoke the StampWorkitemCache web method, you must be a member of the Administrators security group on the server.
To use the tf workspaces command on the client computer, your Read permission must be set to Allow.
After you have completed restoring the data and software on the new server, start the team project collections, and then make sure that all users, groups, and service accounts for your deployment are configured with the permissions that they require to perform tasks and function correctly.
You cannot automatically migrate all permissions. For example, administrators for Team Foundation must be members of the local Administrators group on the server so that they can open the administration console, and you must manually add them to that group. If you followed the tutorial on Get Up and Running With a Single-Server Installation [Tutorial], you can use the user groups you created in Prepare for Installation to make this task easier.
To start a team project collection
Open the administration console, and in Team Project Collections, start the default collection.
Repeat this action for any other team project collections in the deployment.
To verify permissions
Log on to the server and make sure that users, groups, and service accounts are configured with the permissions that they need to operate.
For example, in the example deployment, Jill adds the group "TFS_ProjectContributors"—which resolves to the friendly name Fabrikam Developers and Testers—at the appropriate permissions level for users who will contribute fully to the project in Team Foundation Server, SQL Server Reporting Services, and SharePoint Foundation 2010. For examples of how she does this, see Configure Team Foundation Server to Support Your Development Teams.
For more information, see Add Users to Team Projects, Set Administrator Permissions for Team Project Collections, Set Administrator Permissions for Team Foundation Server, and Service Accounts and Dependencies in Team Foundation Server.
This procedure is optional. You should perform it only if you receive errors 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.
To refresh the cache for tracking work items on client computers
On the new server, open Internet Explorer.
In the Address bar, enter the following address to connect to the ClientService web service:
Even if you are logged on with administrative credentials, you might need to start Internet Explorer as an administrator, and you might be prompted for your credentials.
Choose StampWorkitemCache, and then choose Invoke.
The StampWorkitemCache method returns no data.
To prevent workspace errors from occurring during version control or build operations in Team Foundation, you have to update the data cache on client computers.
To refresh the version control cache, each user must run the tf workspaces command on any computer that uses version control and that connects to the restored server.
To refresh the version control cache on client computers
On the client computer, open a Command Prompt window with administrative permissions, and change directories to Drive:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE.
At the command prompt, enter the following command, including the URL of the collection, which includes the server name and the port number of the new server:
tf workspaces /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName
In the example deployment, one of Jill's developers needs to refresh the version control cache for a project that is a member of the DefaultCollection collection, which is hosted in the FabrikamPrime deployment of Team Foundation Server. He types the following string:
tf workspaces /collection:http://FabrikamPrime:8080/tfs/DefaultCollection
For more information, see Workspaces Command.