Bamboo Generic Upgrade Guide

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).

Note that it is not necessary to back up your Working Directory (located inside your Bamboo Home directory).
 

Step 4. Re-install Bamboo

注意:

• 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.

  If you are using external database

  Bamboo doesn't ship with JDBC drivers for external database. If you are using an external database, remember to copy the JDBC driver from your previous Bamboo installation to your new Bamboo install.

  Follow steps 1 and 2 of the installation instructions for your operating system:
• Bamboo Standalone Installation Guide — Windows
• Bamboo Standalone Installation Guide — Linux
• Bamboo Standalone Installation Guide — Mac
• Bamboo EAR-WAR Installation Guide

Step 5. Update plugins

If you are using any plugins other than the ones that ship with Bamboo, check that each one is compatible with the new version of Bamboo. Upgrade any plugins that are out-of-date, and disable any plugins that are incompatible with your new version of Bamboo.

Step 6. Re-configure external user repositories (if applicable)

• LDAP integration — If you had previously integrated Bamboo with LDAP/AD, copy your old ../<Bamboo-install>/webapps/WEB-INF/classes/atlassian-user.xml file to the new Bamboo installation.
• Crowd integration — If you had previously integrated Bamboo with Crowd, you will need to re-enable Crowd integration. For details please see integrating Crowd with Bamboo.

Step 7. Start Bamboo

Once you have installed Bamboo and set the 'bamboo.home' property (as described in the Installation Guides), start Bamboo. The upgrade process will be performed when Bamboo starts up. You will not see the Setup Wizard.

Monitor the atlassian-bamboo.log to ensure that the upgrade process has completed successfully.

Step 8. Re-index Bamboo (if indicated in release notes)

Bamboo maintains an index of its build 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. 

トラブルシューティング

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