How to move the Bamboo Home location to a different place
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
This article explains how to move <bamboo-home> location to another place on your system.
Environment
Bamboo 7, 8
Diagnosis
In certain environments, extending the <bamboo-home> filesystem is not possible due to several factors. If growing it is not an option, you will need to instruct Bamboo to point it to a new location with more space.
It can also be the case that the current <bamboo-home> location does not satisfy certain design requirements or standards and needs to be modified.
Solution
Move your <bamboo-home>
To move your <old-bamboo-home> to another place you will need to take a few steps as follows:
Stop Bamboo completely, including any Agents and the Database
Have a Full Backup of your Bamboo, this is a safeguard in case something goes wrong
Copy (don't move) the
<old-bamboo-home>data to the<new-bamboo-home>locationConfirm that the file permissions and ownership of the new
<new-bamboo-home>location and their files are equivalent to the old oneModify
<bamboo-install>\atlassian-bamboo\WEB-INF\classes\bamboo-init.propertiesand change thebamboo.home=entry to reflect the<new-bamboo-home>Start your Database, Bamboo Server and its Agents as usual
Test, stress and validate if everything is working as required
Cleanup the old area
Bamboo requires a filesystem that supports full file locking. Using Bamboo over remote shares running alternative filesystems such as VxFS, GlusterFS, GFS2, etc is not tested and may create unpredictable results. Please avoid using such filesystems.
For Bamboo Home folders originally created on versions earlier than 8.0, the following locations require strict filesystem permissions to work. Please use the Bamboo user account or an elevated user (root/Administrator) to copy the files from one location to another. Make sure to set the file and folders permissions and ACLs post-migration as Bamboo will refuse to start in case those locations have the wrong permissions.
Bamboo 7:
<bamboo-home>\xml-data\configuration\cipherBamboo 8:
<bamboo-home>\shared\configuration\cipherBamboo 8 clustered:
<bamboo-shared-home>\configuration\cipher
On Windows, If you can't use the Bamboo user account to run the copy due to it being a Service account (e.g. Local Service), you will need to change the cipher folder ownership to a user you have control over before starting the copy. This is necessary as that folder has strict permissions that would forbid any other users from accessing its contents. Once the ownership is changed, copy the file to its final destination and restore the file ownership to its original settings. Bamboo will refuse to start if the file ownership doesn't belong to the user running the application.
If you are migrating a Bamboo Home that was created on version 8 or later, you just need to provide enough ACL permissions on the new location.
Was this helpful?