Bitbucket Data Center upgrade from version 8.13.2 to version 8.19.3 got stuck with no error
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Bitbucket Data Center upgrade from version 8.13.2 to version 8.19.3 got stuck without any error message. While trying to access Bitbucket, Bitbucket UI is showing a 503 error due to the upgrade not moving further.
Environment
Tested on Bitbucket Data Center 8.13.2 Applies to Bitbucket Data Center version < 8.18.x.
Diagnosis
Need to validate the bitbucket.properties file for the following mesh sidecar properties if it is set to false. These properties with false status help to disable the mesh sidecar process in Bitbucket.
1
2
mesh.enabled=false
plugin.bitbucket-git.mesh.sidecar.enabled=falseCause
Starting from Bitbucket Data Center 8.18 version, to run Bitbucket Data Center, you need the enabled Bitbucket Mesh sidecar.
If you previously disabled the sidecar withmesh.enabled=falseorplugin.bitbucket-git.mesh.sidecar.enabled=falsein thebitbucket.propertiesfile, you need to remove these settings before upgrading to Bitbucket 8.18 or later. Similar details can be found in the Release Note guide of the Bitbucket 8.18 version.
Solution
First enable the mesh-sidecar process on Bitbucket 8.13.x or a lower version than Bitbucket 8.18.x version and then approach for an upgrade to a higher version (like 8.18.x or 8.19.x) should resolve the upgrade hang or stuck issue.
Was this helpful?