Upgrade: TFS 2008 to TFS 2010

The TFS install guide has instructions to both (in place and migration) types of upgrades possible in TFS 2010. While most of you would like to go for a Migration upgrade, simply for the reason that you can have both the TFS 2008 and upgraded TFS 2010 environments available while stage the upgraded TFS 2010 server in the test environment before adopting.

This document has screen shots of the upgrade process (Migration upgrade) along with some pointers that might help during the upgrade procedure.

Before beginning with the actual upgrade we have to set up the environment for TFS2010 and depending on the requirement (to use or not) Reports and SharePoint should also be installed and configured (see point 11 to know more on reporting services configuration).

1) Install default /named instance of SQL

2) SQL server analysis services are needed only if Reports are going to be used.

3) SharePoint 3.0 (SP1 if hosted on Win 2008) has to be installed and a web application with the old content database should be provisioned before starting the upgrade.

4) If the old instance of TFS 2008 uses WSS 2.0, then it should be upgraded to WSS 3.0 or MOSS 2007 before proceeding with TFS 2010 upgrade. WSS 2.0 is not supported on TFS 2010.

Getting ready for the upgrade:

1) Take a full back up of all the 7 TFS 2008 databases and the SharePoint project portal content database from the source server. The reports databases are not required for the upgrade. TFS 2010 upgrade process will create the reports in the new format/hierarchy.

2) Restore the 7 TFS 2008 databases and the SharePoint content database to the SQL instance that will be used with TFS 2010.

3) Install the TFS 2010 bits on the server and launch the “Team Foundation Server administration console” to start the upgrade

4) As you launch the “Team Foundation Server administration console”, the application tier node on the left pane gives you the option to launch the “Configuration Center”

image

5) Launch the “Configuration Center” by clicking ‘Configure installed features’

image

6) Select “Upgrade” to start the ‘Upgrade wizard’

image

7) In the Upgrade Wizard, enter the SQL instance that has the restored TFS 2008 databases (as point 2) and select the option ‘List available databases’. The TFSIntegration database will be detected and the production version would be mentioned. Note: The checkbox at the bottom need to be checked for the upgrade to complete successfully, if unchecked the upgrade would fail during the verification phase. Click Next.

image

8) Enter the service account and the Authentication type. If Negotiate has to be selected, then SPNs have to be created for the accounts.

image

9) In the Website section, accept the defaults or enter the site name and port number that you wish to have TFS web service run.

image

10) Reports configuration: If reports are required, then proceed with the configuration by selecting the check box

image

11) SSRS should be pre installed and configured for the TFS reports configuration to succeed. Enter the SSRS instance name that will host the reports for the TFS 2010 instance. You need not restore the old Reports and Reportservertempdb databases. After entering the SSRS instance name, click the “populate URLs” link, the Report server and Report manager links would be verified and populated.

image

12) Enter the SSAS instance name and click Next.

image

13) Select the checkbox if a different account other than the TFSservice account is going to be used.

image

14) Select the checkbox for SharePoint configuration, if SharePoint project portals are going to be used.

image

15) The SharePoint web application should be created and provisioned with the old Content database. If not, you would see this error:

 image

16) Once SharePoint is installed and configured, the urls would resolve properly

image

17) Enter the Project collection name

image

18) Confirm the settings and click “verify”

image

image

19) The readiness check is run and if the check was successful (without any errors) proceed with configure.

image

20) The Configuration wizard starts

image

21) As the Configuration process completes, you could see the new databases are created (TFS_Configuration , TFS_Warehouse and TFS_<TPC name>) but all the old TFS databases are still not deleted.

image

22) Once the configuration part completes, the Upgrade process starts

image

Note: While this process happens, the reports are created for the existing projects. You could see the screen shots below taken while the upgrade process is happening and after it is completed. Note that a folder by the name of the project collection is created at the root and inside the project collection folder, the individual project folders are created with the reports for that particular project inside them.

clip_image042

clip_image044

23) Once the Upgrade Process is completed, the upgrade Wizard shows the completing screen.

 clip_image046

Content By: Arun Rama

Reviewed by: Lucky