Bamboo Upgrade Guide

Before you begin
Please read the Release Notes and Upgrade Guides for the version you are upgrading to.

Step 1. Identify your Bamboo directories

Go to the 'System Info' page in the 'Administration' menu of your Bamboo instance and note the location of the Bamboo Home, Build Data Path and Configuration Path directories:

Step 2. Shut down Bamboo

You need to shut down Bamboo before backing up or performing the upgrade.

Step 3. Back up Bamboo

Back up the three directories you identified in Step 1 — your Bamboo Home, Build Data Path and Configuration Path directories (for more information about these directories please see Important Directories and Files).

Step 4. Re-install Bamboo

Please note:

When specifying the {BAMBOO_HOME} directory, use the same Bamboo Home directory as in your old installation. That is, specify the same directory and path as the Bamboo Home directory shown in 'Step 1' (above).
Make sure that your {BAMBOO_INSTALL} directory is either a new directory, or else delete your old {BAMBOO_INSTALL} directory before you begin, as legacy files may cause problems.
The {BAMBOO_HOME} directory must be different from the {BAMBOO_INSTALL} directory. This will ensure that your data is not lost when upgrading or re-installing Bamboo.

Follow steps 1 and 2 of the installation instructions for your operating system:

Step 5. Start Bamboo

Once you have installed Bamboo and set the 'bamboo.home' property, start Bamboo. The upgrade process will be performed when Bamboo starts up. Monitor the atlassian-bamboo.log to ensure that the upgrade process has completed successfully.

Step 6. Re-Index Bamboo (if indicated in release notes)

Bamboo maintains an index of its results. This allow Bamboo to display aggregate build results information across builds. You may need to perform a re-index of Bamboo if the upgrade process requires it. This step may or may not be required (depending on the upgrade versions). Also note that you only need to do this if you have existing data in Bamboo.

To re-index, go to 'Administration', then 'Indexing', and click the 'Reindex' button.

Depending on the number of builds and tests you may have, the indexing process may take a significant amount of time. During this period, Bamboo will not be available. Also, it is advisable to ensure that all build queues are disabled and no builds are in progress when you start the re-indexing process. If you have a large instance, it is recommended that you reindex overnight.

Troubleshooting

If you have any problems during upgrade, please raise a support request at https://support.atlassian.com/ and attach your atlassian-bamboo.log so we can help you find out what's gone wrong.