Bamboo 4.2 Upgrade Guide
The instructions on this page describe how to upgrade to Bamboo 4.2 from a previous version of Bamboo. For details on the Bamboo 4.2 release, see the Bamboo 4.2 Release Notes.
Please follow the Bamboo 4.2-specific instructions on this page, in addition to the upgrade instructions in the Bamboo upgrade guide.
Please read the Supported platforms page for the full list of supported platforms for Bamboo.
Atlassian intends to retire all support for built-in Git within the next few releases in favor of the native Git support and we will not be improving built-in Git in subsequent releases. This does NOT mean that we are removing Git from Bamboo, just changing how we use Git.
For this release, Bamboo on upgrade will add a Git capability to your server if it detects a Git executable on the path or in Program Files on Windows machines. If you do not have Git installed on your servers, you should do so before running the upgrade so it is automatically configured for you.
If the upgrade fails to detect the Git executable or you do not configure a native Git capability, the built-in Git will continue to function for this release just as before.
How Bamboo uses Git and why it's changing
Bamboo ships with two Git implementations:
- Built-in Git – This is a Java implementation of the Git command line tool that can be embedded into applications (such as Bamboo) to provide Git operations when no Git executable is available.
- Native Git – This uses the Git executable on your server to perform clones, checkouts and merges. Bamboo uses a Git capability to store where Bamboo should look for this executable on the server or on an agent.
As we have been working with the built-in Git, we have discovered that under a particular combination of circumstances and operations it may not behave as expected. Furthermore, new features added to native Git only make it into the built-in Git after a period of months or years, which makes it difficult to build new features.
Built-in Git is also not capable of being used by Bamboo's automatic merging features.
The default DB connection pool size has been increased for new installations from 25 to 100. This will not happen automatically for existing installations. If you are experiencing performance issues, we recommend that you manually change your database pool to 100 connections.
See Hardware sizing considerations for more information.
The Repository URL option for Bitbucket repository configurations has been removed and existing configurations using this option have been automatically migrated to the regular Mercurial repository type.
Subversion 1.7 support
Bamboo 4.2 supports Subversion 1.7, but uses the Subversion 1.6 Workspace Format by default to keep backwards compatibility with older Subversion working copies. You can set the
bamboo.svn.wc.format system property if your Bamboo plans need to use Subversion 1.7 commands as part of your build scripts. See How to configure Bamboo to support Subversion 1.7 Working copy format for details.
Since version 4.2.1, Bamboo uses the Subversion 1.7 Working Copy Format by default. For backwards compatibility with older Subversion working copies you need to configure Repository Settings -> Subversion in the Bamboo Administration panel. The
bamboo.svn.wc.format system property is deprecated.
Upgrading from Bamboo 4.1 to 4.2
To upgrade to Bamboo 4.2, following the appropriate instructions below:
- Follow the instructions in the Bamboo upgrade guide.
We strongly recommend that you back up your Bamboo instance and database before upgrading, as described in the Bamboo upgrade guide.
Upgrading from Bamboo prior to 4.1
In addition to the notes below, please read the Upgrade Guide for every version you are skipping during the upgrade.
Notes for upgrading from Bamboo 4.0
- Bamboo's deprecated Remote API has been removed. If you are using this API, migrate to the Bamboo REST API.
- There are no major schema upgrade tasks that may cause the Bamboo upgrade from 3.4 to 4.0 to take an extended amount of time.
- If you are using Elastic Bamboo, we've upgraded JDK6, Grails 1.2, Grails 1.3 and Maven 3 to the latest minor releases on the stock images. Additionally, we've added Grails 2.0 to the image. See here for a complete list of elastic image contents.
Notes for upgrading from Bamboo 3.2
- If you are using Bamboo with Crowd, follow the instructions in Upgrading Bamboo with Crowd to Bamboo 3.2.
- If you've been using Amazon EC2 images with you custom EBS, see Updating EBSes created for Fedora to support Amazon Linux
- If you've customized Amazon EC2 images to work with Bamboo, see Creating a custom elastic image.
Notes for upgrading from a version of Bamboo prior to 2.7.4
- You will need to upgrade to Bamboo 2.7.4 before upgrading to Bamboo 4.2. If you are using a version of Bamboo earlier than 2.6.3, we recommend that you upgrade to 2.6.3 before upgrading to Bamboo 2.7.4. Bamboo 2.6.3 can be downloaded from the Bamboo Archived Downloads page. Bamboo 2.7.x introduces a number of significant and irreversible changes, so a phased upgrade is recommended. Please see the Bamboo 2.7.x Upgrade Guide for more details.
- You will need to set aside time, as described in the Bamboo 2.7.x Upgrade Guide, for Bamboo to migrate existing Plans to the new Plan structure in Bamboo 2.7.4.
- If you are upgrading from Bamboo 2.5 or earlier, you will need to set aside time, as described in the Bamboo 2.6 Upgrade Guide for Bamboo to migrate its test result data (stored in XML files on the filesystem) into the database.
- If you are upgrading from a version of Bamboo prior to 2.0, you must upgrade to Bamboo 2.0.6 first before upgrading to Bamboo 2.6.3 ( and then 2.7.4). Please read the Bamboo 2.0 Upgrade Guide for important upgrade instructions for upgrading from earlier versions of Bamboo.
Developing for Bamboo 4.2
If you are a Bamboo plugin developer, please refer to our Changes for Bamboo 4.2 guide, which outlines changes in Bamboo 4.2 that may affect Bamboo plugins compiled for earlier versions of Bamboo.
Checking for known issues and troubleshooting the Bamboo upgrade
If something is not working correctly after you have completed the steps above to upgrade your Bamboo installation, please check for known Bamboo issues and try troubleshooting your upgrade as described below:
- Check for known issues. Sometimes we find out about a problem with the latest version of Bamboo after we have released the software. In such cases we publish information about the known issues in the Bamboo Knowledge Base. Please check the Bamboo Known Issues in the Bamboo Knowledge Base and follow the instructions to apply any necessary patches if necessary.
- Did you encounter a problem during the Bamboo upgrade? Please refer to the guide to troubleshooting upgrades in the Bamboo Knowledge Base.
- If you encounter a problem during the upgrade and cannot solve it, please create a support ticket and one of our support engineers will help you.