Migrating TFS 2017 to DevOps 2019

So I have an existing Team Foundation Server (2017) running in my network (which I use quite a bit more than github..) that I will be migrating to a new machine.

At the same time, it would probably be beneficial to migrate to the latest version, which was renamed to Azure DevOps Server. So we will do that as well.

Microsoft has documentation of how to upgrade which we will be referencing.

Prerequisites
—————–

Existing TFS (2017) setup,

Backups (you have backups right?)

Getting Started
——————–

Start by downloading, and then installing Devops Server (I am using version 2019, which is the currently the latest version).

After install (and rebooting the server), the configuration wizard will open. If it didn’t launch automatically, check your start menu.

Here we will click start wizard and start going through the prompts.

First page will give basic information, and ask if you want to participate in the improvement program.

The next page is where our configuration starts. We need to select that we have an existing database we will be using.

From here we will need to point to our old TFS server, and then select List Available Databases.

Now we after our old database is listed, we can continue. Make sure you have backups! This page now has a link to create a backup of the database in case something goes wrong.

After our backup is finished, click to go to then next page.

Choose the deployment type, either Production or pre-production upgrade testing.

Next, choose the account that the DevOps server will use.

On the next page, choose if you want to enable search or not

And finally, configure if you want to enable reporting.

Now that we have finished choosing all of our configuration options, we move on to the review page. Go through all the config options, and make sure they match what your environment needs.

Once you have verified the configuration is correct, click on Verify to have the DevOps server verify it’s configuration.

If there are any issues, go back and fix them, until there are no issues remaining.

Click Configure. After a bit of time, the configuration will finish.

On the last page, you will see an over information page about the upgrade, including the new DevOps server address you will point to. Depending on how you have your dns set, you could update the CNAME that pointed to the old server, to instead point to the new server.

Note, the old and new server still must co-exist because the SQL server is still stored on the old server.

You can find the next post detailing how to migrate that SQL database to a new server here