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
