Bamboo 8.0 upgrade notes
We’ve collected some important notes on upgrading to Bamboo 8.0. For details on all the new features and improvements we’ve introduced in this release, see the Bamboo 8.0 release notes.
Upgrade notes
Here’s some important information you should know about before upgrading.
Changes to the home directory structure
As part of the cold stand-by capabilities of Bamboo Data Center, major changes were made to the home folder. As part of the upgrade, the home folder is split into two parts: one containing data that will be exclusive for each instance, and another folder that contains the files that will be shared among every node. Applying this change is required for using multiple nodes with Bamboo Data Center, but other types of Bamboo installations are also affected, including Server and single-node Data Center setups.
Before you upgrade, we recommend that you learn more about the changes to the home directory structure at Bamboo home migration.
Changes to the commons-io API
The Commons IO library was upgraded from 2.6 to 2.8.0. It causes different behavior of the FileUtils.cleanDirectory method on Windows. The previous version was able to remove read-only folders, but commons-io 2.8.0 has a bug, which prevents the removal of a folder if it contains a directory with the read-only flag. App vendors should use com.atlassian.bamboo.utils.BambooPathUtils#cleanDirectory for directory cleanup.
Lucene API removal
The Lucene API was deprecated in Bamboo 7.2 and removed in 8.0. App vendors should use other places for data storage like Bandana or Active Objects.
Removed support for CVS and Mercurial
In Bamboo 8.0, we've removed support for CVS (deprecated in Bamboo 7.1) and Mercurial (deprecated in Bamboo 7.2). See Supported platforms for more details.
Remote agent wrapper support for Java 11
As part of the support for Java 11, you can upgrade Java used by remote agents from version 8 to 11. See the Bamboo Remote Agent installation guide for detailed instructions.
Connecting to MySQL databases
When connecting Bamboo to a MySQL database, make sure to use the correct version of MySQL Connector/J:
- For MySQL 5.7 use version 5.1.49. Using a different version requires additional configuration options:
- versions 5.1.48 and older require configuring TLS (by setting the connection string flag, for instance: enabledTLSProtocols=TLSv1.2,TLSv1.1,TLSv1.0) due to deprecation of TLS 1.0 and 1.1
- version 8.0.26 requires setting the nullCatalogMeansCurrent flag to true in the DB connection string
- For MySQL 8, version 8.0.26 or later is recommended.
Code coverage plan settings are more strict
If plan configuration has Code coverage settings enabled, the build will fail if the file with coverage data is not found on build completion.
Changes to supported platforms
See what changes are in store for the supported platforms in Bamboo. For more information about what the latest stable release of Bamboo supports, see Supported platforms.
End-of-support announcements
This release of Bamboo removes support for the following platforms:
- Lucene
- MySQL 5.6
New supported platforms
This release of Bamboo doesn't adds support for the following platforms:
- Java 11
- MySQL 8
- Postgres 13
How to upgrade Bamboo
See the Bamboo upgrade guide for a complete walk-through of the upgrade process that includes descriptions of all the available upgrade paths, prerequisites, and methods.