Upgrade Stash 3.1 to BitBucket 5.3

I have Stash 3.1 installed on a server, now I want to upgrade it to BitBucket 5.3 to a new Server.

I have copied the stash-home directory to the new server, but i have a question regarding the server.xml file upgrade.

One instruction says "To migrate customizations made in the server.xml file to the bitbucket.properties file", but my problem is the old stash home dir doesnt have bitbucket.properties. (https://confluence.atlassian.com/bitbucketserver/migrate-server-xml-customizations-to-bitbucket-properties-897811761.html)

Another intruction says "If you are upgrading from Stash 3.7 or earlier and you made any changes to <Bitbucket Server installation directory>/conf/server.xml (for instance to secure your server with SSL):

  1. In the <BITBUCKET_HOME> directory, make a new directory called shared.
  2. Then, copy your modified server.xml file into <BITBUCKET_HOME>/shared/
    " (https://confluence.atlassian.com/bitbucketserver/install-bitbucket-server-from-an-archive-file-776640148.html)

Plesase tell me which one to follow?

Thanks.

1 answer

1 accepted

If you upgrade from Stash to a Bitbucket 4.x version, the  <BITBUCKET_HOME>/shared/ instructions works.

But if you are going to upgrade to a 5.x version, then bitbucket.properties instructions are valid.

If the file does not exist, then create the file.

This is how a properties file on a linux system with a postgres DB could look like:

#>***************
#>* DB Settings *
#>***************
jdbc.driver=org.postgresql.Driver
jdbc.url=jdbc:postgresql://bitbucket-db:port/bitbucket_app
jdbc.user=bitbucket_app
jdbc.password=verysecret

#>**********************************
#> Set http port and proxy setting *
#>**********************************
server.port=7990
server.secure=true
server.scheme=https
server.proxy-port=443
server.redirect-port=8443
server.proxy-name=bitbucket.mycompany.com

#>******************************
#> Specify path to git version *
#>******************************
plugin.bitbucket-git.path.executable=/opt/rh/rh-git29/root/usr/bin/git

Thanks

Do I still need to keep stash-config.properties in the stash-home directory? I think DB settings are already specified in the new bitbucket.properties file.

No, I do not think you need to keep the file. New bitbucket installations run without stash-config.properties file.

Just make a backup and as always try to upgrade on a staging system first.

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jun 06, 2018 in Bitbucket

Do you use Bitbucket Cloud and Jira Cloud? If so, let us know!

Hi Community, I'm Julia and I'm on the Jira Software Cloud marketing team!  We're looking for companies or teams using Bitbucket Cloud and Jira Software Cloud. If your team fits the t...

96 views 4 3
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you