Upgrade your deployment to the latest version of Azure DevOps Server or Team Foundation Server
Azure DevOps Server 2019 RC | TFS 2018 | TFS 2017 | TFS 2015
The general process for upgrading an existing deployment of Azure DevOps Server is to:
Prepare your environment
New system requirements may require an upgrade to hardware or software. Either way, an upgrade is a good time to consider whether the current environment is meeting your needs, or if it makes sense to make changes.
Expect the best, prepare for the worst
Even though Azure DevOps Server upgrades are reliable, it always makes sense to prepare for a worst case scenario. The most important step is to make sure you have a complete and consistent set of database backups is available.
If you're upgrading in place and not moving to new hardware, consider a dry run of your upgrade in a pre-production environment.
Do the upgrade!
Once the preparation is done, you'll need to install the new version of Azure DevOps Server. Get the binaries and run through the installation process to upgrade your servers.
Configure new features
You might need to configure each project to gain access to new features made available. You don't have to make all configurations immediately, but some features aren't available until they're configured. Depending on the project, make changes using the Azure DevOps Server setup wizard or manually in the Management Console.
For previous versions of Team Foundation Server, the following Upgrade Matrix shows the proper steps to upgrade, based on what version you're upgrading from:
Before you upgrade to TFS 2018
Since TFS 2017.2, the old work item form
[VS403364]: This release introduces major updates to the work item form layout and functionality and deprecates legacy custom controls. Consequently, the upgrade process will update all work item type definitions to use the new work item form WebLayout element and remove all custom controls. For more information and recommended upgrade steps, see the Deployment Guide.
We recommend that you review Handling a TFS 2018 upgrade from old form to new form for further guidance.
Before you upgrade to TFS 2017
If you use TFS with Project Server integration to synchronize your data, you should review the following articles:
- Synchronize TFS with Project Server on how native integration with Project Server is no longer supported. Instead a solution is provided by our partner, Tivitie.
- Remove integration of TFS with Project Server for steps on how to remove the integration. This step is to be completed after synchronization.
We also recommend that you review the options when upgrading from TFS 2008 or TFS 2010. With on the amount of customization you've made to your work tracking process, you'll want to choose between the options described.
Upgrading a TFS deployment can differ depending on the specifics of your existing deployment. Factors that influence the complexity and duration of your upgrade include:
- Number of servers involved in the deployment
- A deployment configuration using SharePoint integration or reporting
- Size of the databases
- Version of the upgrade
In all cases, the general process is logically the same. Make sure your environment is ready, prepare, and do the upgrade.
Your TFS deployment will be offline for the duration of the upgrade and upgrade times can differ depending on the size of the deployment. You can keep your upgrades comparably fast by cleaning up unnecessary data. It also helps if you're keeping up with the latest versions of Azure DevOps Server.
If you're upgrading a database to TFS 2015, consider using TfsPreUpgrade. It performs the most expensive parts of the upgrade from TFS 2013 QU4/QU5 in the background, allowing you to continue using TFS, which can cut offline time significantly for large databases.