Downgrade Bitbucket when upgrading with Server license to Bitbucket Data Center 8.15 and later
Starting from 8.15.x, new releases of Bitbucket will be available only to Data Center customers. If you have a Server license, learn about your options.
If you've upgraded your Bitbucket Server instance to Bitbucket 8.15 and later, you may come across the following error:
This Bitbucket version no longer supports Server licenses
This is because Bitbucket 8.14 is the last supported Server release.
There are no home directory or database upgrades run when upgrading from Server instances to Bitbucket 8.15 and later. Server customers will be able to safely downgrade from Bitbucket Data Center 8.15+.
To use Bitbucket, you'll need to downgrade your previous Bitbucket version to 8.14 or older:
Stop Bitbucket by running
./stop-bitbucket.shfrom<your new Bitbucket installation directory>/bin.Go to the installation directory of your previous Bitbucket version.
In
/bin, make sure that yourBITBUCKET_HOMEis set to your existing home directory throughset-bitbucket-home.sh. If you use aBITBUCKET_HOMEenvironment variable to specify the home directory location, no change is required.Start Bitbucket with
./start-bitbucket.sh.
If your Bitbucket installation is configured to run the bundled search server, you may encounter the bundled search server failing to start after the downgrade with the following error message in the
BITBUCKET_HOME/log/searchlogs:java.lang.IllegalStateException: cannot downgrade a node from version [1.3.12] to version [1.3.11]In this case, you should do the following to allow Bitbucket to repair the search data:
Stop Bitbucket by running
./stop-bitbucket.shfrom<your new Bitbucket installation directory>/bin.Delete the
BITBUCKET_HOME/shared/search/data/.versionfile.Start Bitbucket with
./start-bitbucket.sh.
If you’d like to use Bitbucket 8.15 and later, you need to update your license to Data Center. To do this:
Go to Administration > Licensing.
Select Edit license and enter your Data Center license key.
Select Save.