TFS 2012 with Update 1 - Done

Not long ago, we upgraded our TFS 2010 instance to TFS 2012 RC, and then followed it up with an update to the RTM when that became available.  It has been running great since the upgrade.

Today, I'm happy to announce we updated our TFS 2012 server with Update 1 last week.  This update adds a lot to TFS, but many of the changes are behind the scenes.

Once again, SSW is the first company I know of to make the move to TFS 2012 Update 1!

Summary

It took a few more steps than I thought would be needed.   I’ll be going through the steps we took to upgrade our TFS in this blog post - if you follow this guide, it will be a snap.

Warning: Even though this is called an "update", it represents a complete new version and therefore you'll need to configure everything again!

The steps I took were:

  1. Screenshot our existing configuration
  2. Back up the databases and snapshot the servers
  3. Stop the TFS services
  4. Install TFS 2012 Update 1
  5. Configure TFS 2012 Update 1
  6. Test, test, test!

Before you start

Just as we did last time, the first step was to send an email letting everyone know there would be a TFS outage.  See our Rules to Better Networking for an example of how to do it.

If you’re doing the upgrade, you’ll also need administrator access to the servers. Just as last time, I got promoted temporarily so I could do my work.

Preparation Steps – save your existing configuration

Once again, this is an incremental release so we can expect the configuration to be more or less identical.  To make life easier for me, I opened the TFS Administration Console and took a screenshot of each setting.  This ensures I don’t forget any of the settings.  I referred back to these settings in step 5.

Once I’ve saved everything I need, we can get going on the install.

Preparation Steps – stopping the servers and backing up

  1. Review the Rules to Better TFS 2012 Migration to make sure what you need to do.  In line with rule 4, I took the TFS server offline. This is important because we don’t want any checkins or work item changes to come through while we’re halfway through the process.  They may miss the upgrade!
    1. Use TFSServiceControl quiesce to stop all the agents. Note: Once again  I got a number of exceptions, but it seems after a retry it worked fine.  The important parts are highlighted in yellow. TFS Quiesce
    2. Stop the relevant network services TFS Net Stop WAS
    3. Verify that you can’t connect to the TFS server by trying to connect in Visual Studio TFS unavailable in VS And that you can’t visit the TFS Web Access TFS Web - 404


  2. As per rule 5,  it’s a good idea to run the DogFood Stats queries from Grant Holliday.  Document the numbers so you can compare them after the upgrade to make sure you haven’t lost anything.  If you have more than one Project Collection, make sure you do this over every Project Collection you care about.
  3. Back up the TFS and Reporting Server databases as per rule number 6. We have a few relevant databases because we have a number of Project Collections.
    TFS Backup Collections

Installing TFS 2012 Update 1

  1. Because we’re installing from an ISO rather than a physical CD, we mount the ISO using SlySoft’s Virtual CloneDrive (or your favourite alternative).
  2. Run tfs_server.exe from the installation disk or ISO.
  3. Accept the license terms and click Install Now. Update 1 Installation
  4. Watch the progress with excitement and trepidation (and coffee) Update 1 Install Progress

Configuring TFS 2012 Update 1

  1. Choose Upgrade from the left-hand menu and click Start Wizard. TFS upgrade
  2. Click Next on the first screen presented.
  3. We’re now asked to upgrade an existing database.  Type in your SQL Server instance name and then click List Available Databases.  The tool should find your TFS Configuration database. TFS database upgrade
  4. Confirm you have a current backup, then click Next.
  5. Next, we’re asked for the service account for our Application Tier.  To make sure this is consistent, check the screenshots you created right at the start in your Preparation Steps. Click Next. TFS Application Tier settings
  6. Next up, we’re asked if we want to configure reporting services.  Make sure the checkbox is checked, then click Next.
  7. Again checking your screenshots, make sure the instance and URLs for your Reporting Services instance are correct, and click Next. TFS Reporting Services config
  8. Next up is the TFS Warehouse database.
  9. Enter the correct SQL Server instance (if it’s not already correct), then test the connection by clicking on Test, then click List All Available Databases. The wizard will find the Tfs_Warehouse database automatically.  If everything is correct, click Next. TFS warehouse config
  10. Next, you’re asked for your Analysis Services instance.  Again, check your screenshots and enter the correct information before clicking Next.
  11. Next, we’re asked to provide an account that the Reports will run as.  Check your screenshots and click Next.
  12. Next we’re asked if we want to configure SharePoint for TFS, we do, so we’ll make sure the checkbox is checked and click Next.
  13. Important: Even if you have a different SharePoint setup, it’s advisable to simply use the current SharePoint settings at this point.  If you enter new details, the final step will have trouble verifying the installation as it will think you have two SharePoint instances.  Don’t worry, you can change it later. TFS SharePoint config
  14. On the next screen, we’ll get a summary of all the options we’ve chosen.
  15. Go through them carefully to make sure everything is correct, and click Verify to check. TFS config confirmation Note that we had some issues at this point with Analysis Services.  It appeared Analysis Services was corrupt and was preventing us from continuing.  Thanks to this blog post by Oshry Horn, we were able to fix the issue and continue with our configuration. Matt has also mentioned in the comments that the WWW Publishing service needs to be started at this point.  You can do this by typing "net start was" in a command line console (as Administrator). 
  16. Once the readiness checks pass, click Configure Readiness Checks
  17. Wait patiently (again with coffee) while the upgrade goes through its steps.  When finished, click Next. Upgrade Done
  18. Once the TFS upgrade has finished, the Upgrade Wizard will upgrade each of the Project Collections. Be patient while it does this. Project Collection Upgrades
  19. At this point I ran the Dog Food Stats again (as per step 9) and checked that nothing had changed too much.

Additional steps

  1. I also upgraded Team Foundation Server on our Build Servers by installing the upgrade and checking the settings were the same.
  2. I also uninstalled the TFS Extensions on the SharePoint server and installed the new ones. To get this working again, I had to repair the connection in the Configuration Manager on the TFS server to get them talking to each other again. Repair Sharepoint Connections
  3. We also had to reconfigure our Build Controller to get it working again.

Testing

After the final steps were completed, we went through the following tests to make sure everything was up and running again.

  1. Open Visual Studio and connect to TFS
  2. Do a Get Latest
  3. Make a change and check in
  4. Trigger a build and wait for it to succeed
  5. Check TFS Web Access is working by navigating to the TFS URL
  6. Check the Reporting Services are still working by navigating to the reporting URL

I’m happy to say all these tests passed without a problem.

We’re up and live on TFS 2012 Update 1!

Damian Brady

I'm an Australian developer, speaker, and author specialising in DevOps, developer process, and software architecture. I love Octopus Deploy, Visual Studio Team Services, and reducing process waste.

Subscribe to Damian Brady

Get the latest posts delivered right to your inbox.

or subscribe via RSS with Feedly!