Upgrade Stash 3.1 to BitBucket 5.3

[junfang li]

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.

[Thomas Buchhorn · Accepted solution]

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

[junfang li]

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.

[Thomas Buchhorn]

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.