Upgrade TFS2010 to TFS11 with Detach and Attach

One of the simplest way to upgrade with minimum risk a Project Collection from TFS 2010 to TFS11 Beta is using the detach/attach feature of TFS, introduced with version 2010.  Basically all you need to do is Detach the project collection from the old TFS 2010 server and reattach to a brand new TFS11 server, you can read about the whole procedure in an old post that explain how to Move a Team Project Collection from one server to another one.

This operation works because the attach routine of TFS11 performs an upgrade during the attach phase and this is done transparently to the user. The real good aspect of this operation is that after the attach process you can reattach the Project Collection in the old server and continue to work wit it. The attach procedure in TFS11 is really simple, when you restored the Project Collection Database in the new server, you should open TFS Administration Console and choose to Attach a Project Collection.

List of available Project Collection to Attach

Figure 1: Attach wizard automatically detect any database that contains a detached Project Collection.

You should only give a name to the project collection do verification checks and press Attach, everything is done automatically.

Result of Attach Operation

Figure 2: Result of Attach operation, the Project Collection is now converted to TFS11.

This technique is optimal to evaluate the upgrade process, without requiring any discontinuity in the service, all you need to do is detach/attach the Team Project Collection from the old server to the new one, then perform all the manual upgrade operations needed to use new features and perform some test to verify if the upgrade procedure did not ruin anything. All these operation can be performed while the team still work on the old TFS server because you can immediately reattach the Project Collection in the old server. When everything is ok you can schedule an offline period where you will do another detach/attach/upgrade to move all the team on upgraded collection.

After the collection is imported you still need to do some manual post upgrade operations if you want to use the new features offered by TFS11, because the imported collection still contains old Process Template Definitions, that does not support new features. To accomplish this operation you need to download Visual Studio 11 Beta Update Files, a tool to enable new TFS11 features after a Collection was upgraded from TFS2010. You can find a detailed discussion in this MSDN article named: Updating an Upgraded Team Project to Access New Features.

If you omit this part you got errors when you try to use new features related to Work Items, if you browse the home page of the project with TFS Web Access you will got an error

Errors in Web Access home page because the Process Template was not upgraded

Figure 3: Imported Team Project still uses old Process Template, new Web Access features are not available.

After you unzip the Visual Studio 11 Beta Update Files and issued the upgrade command Es. updateProject "http://vsalm:8080/tfs/ImportedCollection" "Tailspin Toys" Agile you can use all the new cool feature of TFS11.


Figure 4: Now everything works, you can see the burndown and tiles for favorites elements

Now your Project Collection is ready to work with TFS11.

Gian Maria.

Published by

Ricci Gian Maria

.Net programmer, User group and community enthusiast, programmer - aspiring architect - and guitar player :). Visual Studio ALM MVP

6 thoughts on “Upgrade TFS2010 to TFS11 with Detach and Attach”

  1. Great Post. I was trying to do the same thing, however when I was attaching a TFS2010 collection to TFS11, got the error at “Build” stage, and here is what the error says ([Error] TF246076: No Team Foundation identity domain exists with the following security identifier (SID): S-1-9-1551374245-3680074475-653763904-2602007454-3146141172). Could you help with this error? Thanks in advance.

  2. This is a really strange error, but it seems that it try to map a user of the old machine in the new machine. Are you in a domain or you have deployed in workgroup? I strongly suggest you to post this error in the administration forum http://social.msdn.microsoft.com/Forums/en/tfsadmin/threads that is monitored by a lot of MVP and Microsoft staff.

    You can also have a look at the Identities command of TFSConfig.Exe used to manage identities http://msdn.microsoft.com/en-us/library/ms253054.aspx.


  3. Wenjiang, I am experiencing the same error. Can you tell me what you did to resolve your identity issue.

  4. Martin, I found references of that identity in ADObjectMemberShops and ADObjects tables in collection database, and removed them manually. The key is that you need to use wildcard to query these two tables. Remember to Detach and Backup, so if something goes wrong, you can always go back.

Comments are closed.