Bamboo 8.0 upgrade notes

Bamboo release notes

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

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.

Last modified on Jan 26, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.