Adventures of a wannabe geek!

Ranting within

Upgrading From TeamCity 5.x to 6.0

I have recently upgraded my TeamCity installation 5.1 to 6.0 and found when I was upgrading that the documentation supplied by JetBrains was very sketchy. After seeing some peoples upgrades go a bit wrong, I thought a blog post on how to do this would help.

This post assumes that you have 5.x version of TeamCity installed. The version I specifically have is 5.1.5

1. Download the latest version of TeamCity windows installer

2. Log into your TeamCity dashboard as an administrator. Click on ‘Administration’

image

3. In the administration screen click on ‘Backup Data’ on the right hand column

image

4. We now need to actually backup our data. In order to do this we will, by default, be in the ‘Settings’ Tab. In this tab you will see where TeamCity wants to backup the data by default. You will also be given the options of what to backup. The settings I use are as follows:

image

Once I save the settings I can then go to ‘Backup Process’ and click on ‘Start Backup’. This gives me something that looks like this

image

(Please ignore the numbers as I am running an empty version of TeamCity for this demonstration)

5. Go to the location where point 1 downloaded TeamCity to and run TeamCity.exe

6. Follow the standard installation instructions and make sure you:

  • install to the same directory location as before (C:\Program Files (x86)\JetBrains\TeamCity for me)
  • uninstall the previous version when asked
  • I tend to only uninstall the build agents log files
  • use the same buildserver directory as before (C:\Program Files (x86)\JetBrains\TeamCity\BuildServer for me)

7. Start the TeamCity dashboard after the installer finishes. Gives us this page:

image

Go to your installation directory (C:\Program Files (x86)\JetBrains\TeamCity\Logs\) then find

teamcity-server.log

8. Open this .log file in notepad or a similar text editor and scroll right to the end and find

Administrator login is required from web UI using authentication token: <token here>

9. Take the token and paste it into the web browser and ‘Confirm’

10. You will be presented with an upgrade screen which gives details of the product and installation paths. If you are happy then click ‘Upgrade’

11. The upgrade will kick into action as follows:

image

When the upgrade is done you will be shown the login screen. Login as an administrator and make sure you can see all your projects, some history and some changes for some projects

This is a very short process as JetBrains has thankfully made it easy. Hopefully this guide will help