How to speed up home folder migration during upgrade to Bamboo 8.0 or higher
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
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
During the upgrade of Bamboo to version 8.0 or higher the home directory gets restructured as indicated in https://confluence.atlassian.com/bamboo/bamboo-home-migration-1063170553.html. This operation my take a long time to finish depending on your configuration and amount of files inside the <bamboo-home>/artifacts folder.
If your entire home folder is on the same disk and you're not using a custom location for the shared folder, the shared folder will be created inside your current <bamboo-home> folder. Your artifacts and other files will be moved there. This operation is quite quick and the additional steps in this KB are not required.
If you have a large artifacts folder that's mounted on a different storage other than the <bamboo-home>/artifact folder, moving artifacts to the new shared folder that gets created during the upgrade can be a time consuming task. The move command (Linux mv) used by Bamboo to move the files is quick when both origin and destination locations are on the same disk. However, if that is not the case the time will depend on the number and size of the files.
Environment
- Upgrade of Bamboo to version 8.0 or higher.
- Artifact folder mounted on a shared storage or different disk than the <bamboo-home> folder.
Solution
The steps below need to be integrated to your upgrade run book.
You can skip the migration of the artifact folder using the following steps:
- Shutdown Bamboo.
- Take a backup of the <bamboo-home> folder and database.
Create folder named shared inside your <bamboo-home> folder:
cd $BambooHomeDir mkdir shared- Reconfigure the mount of the artifact directory from <bamboo-home>/artifacts to <bamboo-home>/shared/artifacts (this will depend on how you configured the mount on your Linux environment).
Update the <bamboo-home>/bamboo.cfg.xml file with this exact configuration:
<property name=“bamboo.artifacts.directory”>${bambooSharedHome}/artifacts</property>It is NOT necessary to replace ${bambooSharedHome} with the complete path to your <bamboo-home> folder.
- Start Bamboo 8.0 or higher to start the upgrade (during the upgrade task only the artifacts folder copy will be skipped).
During the upgrade, it's expected to see messages like:
2021-11-10 19:47:36,024 INFO [localhost-startStop-1] [UpgradeTask70302ReorganiseHomeDirectory] Moving /home/charlie/bamboo-home-folder/artifacts to /home/charlie/bamboo-home-folder/shared/artifacts...
2021-11-10 19:47:36,024 WARN [localhost-startStop-1] [UpgradeTask70302ReorganiseHomeDirectory] Did not found the path /home/charlie/bamboo-home-folder/artifacts. You might need to migrate it manually.
2021-11-10 19:47:36,024 INFO [localhost-startStop-1] [UpgradeTask70302ReorganiseHomeDirectory] Property [bamboo.artifacts.directory] is set to [/home/charlie/bamboo-home-folder/shared/artifacts]. Not changing it.