Upgrade Stash 3.5.1 to BitBucket 5.8

[Markus Schrand]

Hi!

Following scenario:

We have Stash v3.5.1 (with MySQL - DB) on one old server.

Now we want to upgrade it to BitBucket v5.8 (with SQL Server - DB) on a new server.

What would be the recommended procedure here or is there a special step by step guide?

Thanks!

[Caterina Curti]

Hi @Markus Schrand,

You should start by reviewing the Bitbucket Server upgrade guide. The upgrade from Stash 3.5.1 to the lasted Bitbucket (5.8) is a major one. However, there is no specific upgrade path and you can upgrade from any Bitbucket version to any version.

Considering that you are planning to move to SQL Server, I would perform the change in the following way:

- upgrade to Bitbucket 5.8

- migrate to SQL Server (Connecting Bitbucket Server to SQL Server)

To make sure that this will work, we need to confirm which MySQL version is currently installed. According to the Stash 3.5.x Supported platforms and the latest Bitbucket Server Supported platforms pages, both versions support MySQL 5.5.

If this is the version that is currently installed, the procedure above would be the suggested one.

It is very important to take a full backup of Stash before attempting the upgrade.

Thanks, Caterina - Atlassian 

[Edwin Kyalangalilwa]

@Caterina Curti

Currently working on upgrading from 3.5.1 as well. 

To confirm - if the current 3.5.1 DB version is supported in the target latest version, then I can upgrade directly?

[Ana Retamal]

Hi @Edwin Kyalangalilwa! To follow up with your question, you'll need to move server.xml customizations to bitbucket.properties, and then you'll be able to upgrade directly from 3.5.1 to 5.8

Upgrading from any version earlier than Bitbucket Server 4.14 or earlier to Bitbucket Server 5.x or later requires that you manually migrate any changes to the server.xml file to the bitbucket.properties file.

You can find more info at Migrate server.xml customizations to bitbucket.properties.

Hope that helps!

Ana

[Edwin Kyalangalilwa]

Hi @Ana Retamal!

That helps. Thanks for clarifying!

[Ana Retamal]

Just one more thing:

If the file does not exist, then you need to create it.

Let us know if you have any questions!

Ana