Blogs

Upgrading TFS 2013.2 to TFS 2013.3 (Update 3)

Team Foundation Server 2013 Update 3 (aka TFS 2013.3) was released on August 4th, 2014. In 4ward we upgraded TFS on all the major and minor versions from 2010 to 2013, and this week we updated our TFS 2013.2 architecture to TFS 2013.3.

So in this post I’ll show you how to do an in-place upgrade of Team Foundation Server 2013 Update 3.

4ward TFS 2013 architecture For a Single-Server TFS 2013 topology like mine it was an easy and fast enough process. The Upgrade wizard restore the previous configuration settings, so the only things you have to insert are the passwords for the service accounts. If you want to see the previous posts on TFS upgrade, you can go here:

System Requirements

Before upgrading, you have to check the System Requirements for Team Foundation Server.

Preparing for Installation

If you have a MSDN Subscription, you can download, under the “Visual Studio” category, the Team Foundation Server 2013 Update 3 ISO image (en_visual_studio_team_foundation_server_2013_with_update_3_x86_x64_dvd_4900391.iso) or the Web Installer (en_visual_studio_team_foundation_server_2013_with_update_3_x86_x64_web_installer_4900363.exe). Before to go on, my recommendation is to perform the following tasks:

  • Run a Complete Health Check with the Best Practice Analyzer Tool for Team Foundation Server in order to prevent or troubleshoot problems in the actual TFS deployment;
  • Write down the actual TFS configuration (you can take some screenshots on TFS Administration Console) and make sure to have all the service accounts credentials for TFS;
  • Send an email to warning about the upgrading process because the system will be offline while the Upgrade is applied!
  • Download all the Windows Updates and Microsoft Updates and reboot the system if necessary;
  • Stop all the services and application pools:
    • Stop the TFS services like TfsJobAgent, TFSBuildServiceHost, etc. by using the “TFSServiceControl quiesce” command (you can find it under “C:\Program Files\Microsoft Team Foundation Server 12.0\Tools”);
    • Double-check that TFS isn’t reachable from Visual Studio and Web Access.
  • Perform a full backup for each database used by TFS. There are two way to do this operation:
    • By using the Database BackUp Tool when the Upgrade wizard asks to do it (recommended);
    • By using SQL Server Management Studio (you must also synchronize the backups to the same point in time, see how to manually back up Team Foundation Server).
  • Are you using a virtual machine? If so, take a snapshot so you can always rollback the system if something goes wrong.

Install TFS 2013 Update 3

Run the Visual Studio Team Foundation Server 2013 Update 3 installation (tfs_server.exe): Team Foundation Server Setup - TFS 2013 Update 3 Accept the licence terms and click on Install Now: it would take about 15 minutes to complete the installation (depending the system performance). Team Foundation Server Setup - TFS 2013 Update 3: Installing... It could be necessary to restart the machine to continue with the installation: Team Foundation Server Setup - TFS 2013 Update 3: Restart Required If you are doing an in-place upgrade, the Upgrade Wizard opens automatically at the end of the installation process: Team Foundation Server Upgrade Wizard Make sure the SQL Server Instance is ok. Team Foundation Server Upgrade Wizard: Configuration Database ATTENTION: The schema of your database will be updated to the new format and the operation is not reversible without a backup! So you can take a full backup now by clicking the link to the Database Backup Tool: TFS Database Backup Tool Select the databases to backup and the destination folder and click on Backup Now. TFS Database Backup Tool The process was very quick for me (3 minutes to backup about 25 Gb). TFS Database Backup Tool Now you have a current full backup of TFS databases: you can close the tool and go straight :-) Team Foundation Server Upgrade Wizard: Configuration Database Insert the password for the TFS service account and click on Test link to validate the credentials: Team Foundation Server Upgrade Wizard: Application Tier Settings Because the Application Tier caches a lot of resources on a local folder (usually under C:\Program Files\Microsoft Team Foundation Server 12.0\Application Tier\Web Services\_tfs_data), you can configure a different path for this directory and make sure you have enough disk space. Team Foundation Server Upgrade Wizard: Application Tier Settings - File Cache Folder Keep the flag to configure Reporting for TFS: Team Foundation Server Upgrade Wizard: Reporting Most of these screenshot are just “click next, next, next” because I am doing an in-place upgrade. So check if everything is ok, like the Reporting Services Instance, the Report Server URL and the Report Manager URL. Team Foundation Server Upgrade Wizard: Reporting - Reporting Wizard Team Foundation Server Upgrade Wizard: Reporting - Database Team Foundation Server Upgrade Wizard: Reporting - Analysis Services Insert the Password for the report reader account: Team Foundation Server Upgrade Wizard: Reporting - Report Reader Account Team Foundation Server Upgrade Wizard: SharePoint Products My deployment use a separate server for SharePoint, and I don’t want to modify the current settings, so go on… Team Foundation Server Upgrade Wizard: SharePoint Products - Settings Take a look at the Review page to check if everything is ok: Team Foundation Server Upgrade Wizard: Review The Readiness Check validates that everything is available: Team Foundation Server Upgrade Wizard: Readiness Checks I have a yellow warning on the disk space on file cache location: the disk would have at least 50GB of available free space. Anyway you can skip it: if needed, you can always open the TFS Administration Console and change the File Cache Folder under Application Tier settings. Team Foundation Server Upgrade Wizard: Configure Team Foundation Server Upgrade Wizard: Configure - Configuration Progress After Configuration, you have to start the Project Collection upgrade: Team Foundation Server Upgrade Wizard: Configure - Upgrade Progress The process takes only about 2 minutes to upgrade our Project Collections: Team Foundation Server Upgrade Wizard: Configure - Upgrade Progress (Success) At the end you can close the Upgrade Wizard and the Configuration Center: Team Foundation Server Upgrade Wizard: Complete Team Foundation Server Configuration Center From the TFS Administration Console you can see that the version number is updated (12.0.30723.0): Team Foundation Server Administration Console (TFS 2013 Update 3) Take a few minutes to check that everything works correctly:

  1. Open Visual Studio and connect to TFS by using the Team Explorer window;
  2. Perform a Get Latest;
  3. Modify a test file and check in;
  4. Queue a new build and verify if it has successfully run;
  5. Check the Reporting Services;
  6. Open the TFS Web Access: Team Foundation Server 2013 Update 3 Web Access

Final tasks: don’t miss to update the Build Server, the SharePoint Extensions on the remote machine and the Agents for Visual Studio (Test Controllers and Test Agents). Now you’re ready to go! Do you need a support to adopt Visual Studio ALM? We can help you! Contact us: info@4ward.it

0


Add a Comment