I am sure you will have seen my posts on upgrading our internal Team Foundation Server from TFS2008
to TFS2010 Beta 2, RC and RTM, but what about a fresh
upgrade of TFS2008
to TFS2010 using the RTM version of TFS. One of our clients is taking the plunge with TFS2010, so I have the job of doing the
upgrade. It is sometimes very useful
to have a team member that starts work when most of the Sydney workers are heading home as I can do the
upgrade without impacting them. The down side is that if you have any blockers then you can be pretty sure that everyone that can deal with your problem is asleep I am starting with an existing blank installation of TFS 2010, but Adam Cogan let slip that he was the one that did the install so I thought it prudent
to make sure that it was OK. Verifying Team Foundation Server 2010 We need
to check that TFS 2010 has been installed correctly. First, check the Admin console and have a root about for any errors. Figure: Even the SQL Setup looks good. I don’t know how Adam did it! Backing up the Team Foundation Server 2008 Databases As we are moving from one server
to another (recommended method) we will be taking a backup of our TFS2008 databases and resorting them
to the SQL Server for the new TFS2010 Server. Do not just detach and reattach. This will cause problems with the version of the database. If you are running a test migration you just need
to create a backup of the TFS 2008 databases, but if you are doing the live migration then you should stop IIS on the TFS 2008 server before you backup the databases. This will stop any inadvertent check-ins or changes
to TFS 2008. Figure: Stop IIS before you take a backup
to prevent any TFS 2008 changes being written
to the database. It is good
to leave a little time between taking the TFS 2008 server offline and commencing the
upgrade as there is always one developer who has not finished and starts screaming. This time it was John Liu that needed 10 more minutes
to make his changes and check-in, so I always give it 30 minutes and see if anyone screams. John Liu [SSW] said: are you doing something
to TFS :-O MrHinsh [SSW UK][VS ALM MVP] said: I have stopped TFS 2008 as per my emails John Liu [SSW] said: haven't finish check in @_@ can we have it for 10mins? :) MrHinsh [SSW UK][VS ALM MVP] said: TFS 2008 has been started John Liu [SSW] said: I love you! -IM conversation at TFS
Upgrade +25 minutes After John confirmed that he had everything done I turned IIS off again and made a cup of tea. There were no more screams so the
upgrade can continue. Figure: Backup all of the databases for TFS and include the Reporting Services, just in case. Figure: Check that all the backups have been taken Once you have your backups, you need
to copy them
to your new TFS2010 server and restore them. This is a good way
to proceed as if we have any problems, or just plain run out of time, then you just turn the TFS 2008 server back on and all you have lost is one
upgrade day, and not 10 developer days. As per the rules, you should record the number of files and the total number of areas and iterations before the
upgrade so you have something
to compare to: TFS2008 File count: Type Count 1 1845 2 15770 Areas & Iterations: 139 You can use this
to verify that the
upgrade was successful. it should however be noted that the numbers in TFS 2010 will be bigger. This is due
to some of the sorting out that TFS does during the
upgrade process. Restore Team Foundation Server 2008 Databases Restoring the databases is much more time consuming than just attaching them as you need
to do them one at a time. But you may be taking a backup of an operational database and need
to restore all your databases
to a particular point in time instead of
to the latest. I am doing latest unless I encounter any problems. Figure: Restore each of the databases
to either a latest or specific point in time. Figure: Restore all of the required databases Now that all of your databases are restored you now need
to upgrade them
to Team Foundation Server 2010.
Upgrade Team Foundation Server 2008 Databases This is probably the easiest part of the process. You need
to call a fire and forget command that will go off
to the database specified, find the TFS 2008 databases and
upgrade them
to 2010. During this process all of the 6 main TFS 2008 databases are merged into the TfsVersionControl database, upgraded and then the database is renamed
to TFS_[CollectionName]. The rename is only the database and not the physical files, so it is worth going back and renaming the physical file as well. This keeps everything neat and tidy. If you plan
to keep the old TFS 2008 server around, for example if you are doing a test migration first, then you will need
to change the TFS GUID. This GUID is unique
to each TFS instance and is preserved when you
upgrade. This GUID is used by the clients and they can get a little confused if there are two servers with the same one.
To kick of the
upgrade you need
to open a command prompt and change the path
to “C:\Program Files\Microsoft Team Foundation Server 2010\Tools” and run the “import” command in “tfsconfig”. TfsConfig import /sqlinstance:<Previous TFS Data Tier> /collectionName:<Collection Name> /confirmed Imports a TFS 2005 or 2008 data tier as a new project collection. Important: This command should only be executed after adequate backups have been performed. After you import, you will need
to configure portal and reporting settings via the administration console. EXAMPLES -------- TfsConfig import /sqlinstance:tfs2008sql /collectionName:imported /confirmed TfsConfig import /sqlinstance:tfs2008sql\Instance /collectionName:imported /confirmed OPTIONS: -------- sqlinstance The sql instance of the TFS 2005 or 2008 data tier. The TFS databases at that location will be modified directly and will no longer be usable as previous version databases. Ensure you have back-ups. collectionName The name of the new Team Project Collection. confirmed Confirm that you have backed-up databases before importing. This command will automatically look for the TfsIntegration database and verify that all the other required databases exist. In this case it took around 5 minutes
to complete the
upgrade as the total database size was under 700MB. This was unlike the
upgrade of SSW’s production database with over 17GB of data which took a few hours. At the end of the process you should get no errors and no warnings. The
Upgrade operation on the ApplicationTier feature has completed. There were 0 errors and 0 warnings. As this is a new server and not a pure
upgrade there should not be a problem with the GUID. If you think at any point you will be doing this more than once, for example doing a test migration, or merging many TFS 2008 instances into a single one, then you should go back and rename the physical TfsVersionControl.mdf file
to the same as the new collection. This will avoid confusion later down the line.
To do this, detach the new collection from the server and rename the physical files. Then reattach and change the physical file locations
to match the new name. You can follow http://www.mssqltips.com/tip.asp?tip=1122 for a more detailed explanation of how
to do this. Figure: Stop the collection so TFS does not take a wobbly when we detach the database. When you try
to start the new collection again you will get a conflict with project names and will require
to remove the Test
Upgrade collection. This is fine and it just needs detached. Figure: Detaching the test
upgrade from the new Team Foundation Server 2010 so we can start the new Collection again. You will now be able
to start the new upgraded collection and you are ready for testing. Do you remember the stats we took off the TFS 2008 server? TFS2008 File count: Type Count 1 1845 2 15770 Areas & Iterations: 139 Well, now we need
to compare them
to the TFS 2010 stats, remembering that there will probably be more files under source control. TFS2010 File count: Type Count 1 19288 Areas & Iterations: 139 Lovely, the number of iterations are the same, and the number of files is bigger. Just what we were looking for. Testing the upgraded Team Foundation Server 2010 Project Collection Can we connect
to the new collection and project? Figure: We can connect
to the new collection and project. Figure: make sure you can connect
to The upgraded projects and that you can see all of the files. Figure: Team Web Access is there and working. Note that for Team Web Access you now use the same port and URL as for TFS 2010. So in this case as I am running on the local box you need
to use http://localhost:8080/tfs which will redirect you
to http://localhost:8080/tfs/web for the web access. If you need
to connect with a Visual Studio 2008 client you will need
to use the full path of the new collection, http://[servername]/tfs/[collectionname] and this will work with all of your collections. With Visual Studio 2005 you will only be able
to connect
to the Default collection and in both VS2008 and VS2005 you will need
to install the forward compatibility updates. Visual Studio Team System 2005 Service Pack 1 Forward Compatibility Update for Team Foundation Server 2010 Visual Studio Team System 2008 Service Pack 1 Forward Compatibility Update for Team Foundation Server 2010
To make sure that you have everything up
to date, make sure that you run SSW Diagnostics and get all green ticks.
Upgrade Done! At this point you can send out a notice
to everyone that the
upgrade is complete and and give them the connection details. You need
to remember that at this stage we have 2008 project upgraded
to run under TFS 2010 but it is still running under that same process template that it was running before. You can only “enable” 2010 features in a process template you can’t
upgrade. So what
to do? Well, you need
to create a new project and migrate things you want
to keep across. Souse code is easy, you can move or Branch, but Work Items are more difficult as you can’t move them between projects. This instance is complicated more as the old project uses the Conchango/EMC Scrum for Team System template and I will need
to write a script/application
to get the work items across with their attachments in tact. That is my next task! Technorati Tags: TFS 2010,TFS 2008,VS ALM
