Bamboo 9.6 upgrade notes
We’ve collected some important notes on upgrading to Bamboo 9.6. For details on all the new features and improvements we’ve introduced in this release, see the Bamboo 9.6 release notes.
Skip to
Upgrade notes
Bamboo 9.6 is a long-term support (LTS) release. Normally, we don’t introduce new features in LTS releases but rather consolidate the ones' we’ve introduced since the last LTS release (Bamboo 9.2).
This summary has been divided into sections that group the changes by severity and type:
Breaking changes
Learn about what you need to keep an eye on to avoid outages or disruptions. The entries in this section are organized chronologically from newest to oldest:
NEW IN THIS RELEASE Bamboo 9.6: Removal of local agents
Bamboo 9.6 removes support for local agents. Migrate your local agents to remote, elastic, or ephemeral agents before upgrading to Bamboo 9.6.
Learn more about how to migrate to other types of agents:
- Bamboo remote agent installation guide
- Getting started with Elastic Bamboo
- Enabling ephemeral agent support
NEW IN THIS RELEASE Bamboo 9.6: Removal of the out-of-the-box Clover integration
With the removal of the out-of-the-box Atlassian Clover and OpenClover integration for Bamboo 9.6, we recommend either migrating to a manual configuration or disabling the automatic integration entirely. Otherwise, the affected plans with enabled automatic Clover code coverage will start failing.
Learn more about how to enable manual Clover integration
NEW IN THIS RELEASE Bamboo 9.6: Migration of Tomcat JAVA_OPTS to CATALINA_OPTS
To address an issue with potential excessive memory usage during Tomcat shutdown, the Java runtime options used by Tomcat have been updated from JAVA_OPTS to CATALINA_OPTS in Bamboo 9.6. You can modify these settings in the setenv.sh file for Linux and the setenv.bat file for Windows, both located in <bamboo-install-dir>/bin.
While older setenv scripts work with Bamboo 9.6, they can't guarantee smooth shutdowns or restarts. Before upgrading, we recommend updating your configurations to the revised setenv script.
Bamboo 9.5: Gain higher availability with warm standby clustered deployments
In this release, we’ve upgraded the Bamboo’s clustering architecture by introducing warm standby. Bamboo will now keep all your secondary Data Center nodes running and up-to-date with the primary node at all times, allowing them to take over operations in a matter of seconds.
If you're already using Bamboo Data Center in a cold standby cluster configuration, you’ll need to migrate to the new warm standby configuration before starting Bamboo 9.6.0 for the first time after the upgrade. Learn how to migrate to a warm standby clustering configuration
Learn more about clustering with Bamboo Data Center
Improvements, fixes, and non-breaking changes
Get a glimpse of all the improvements, fixes, and non-breaking changes added to each release leading up to Bamboo 9.6. The table is divided into rows by release. Every row contains a link to the relevant upgrade notes where you can learn the details.
Release | Description | Upgrade notes link |
|---|---|---|
9.5 |
| |
9.4 |
| |
9.3 |
| |
9.2 | There were no changes to the upgrade procedure in this release. |
Changes to supported platforms
See what changes have been made to supported platforms since the last Bamboo LTS release.
For more information about what the latest stable release of Bamboo supports, see Supported platforms.
For the full list of all the software platforms and browsers that have been reached the end of support in Bamboo, see End-of-support-announcements for Bamboo.
Support for the deprecated platforms will be removed entirely in a future version of Bamboo.
New supported platforms
We’ve added support for:
Git 2.35 and later (Bamboo 9.6) NEW IN THIS RELEASE
Java 17 on the Bamboo server and agents (Bamboo 9.4)
PostgreSQL 16 (Bamboo 9.4)
End-of-support announcements
We’ve deprecated support for:
Git versions 2.8–2.34 (Bamboo 9.6) NEW IN THIS RELEASE
Postgres 12 (Bamboo 9.5)
Java 11 for the Bamboo server and agents (Bamboo 9.5)
For more information, go to How to upgrade the Java version used by Bamboo.Automatic Clover integration (Bamboo 9.5)
MySQL 5.7 (Bamboo 9.4)
Oracle 12c (Bamboo 9.4)
PostgreSQL 11 (Bamboo 9.4)
We’ve removed support for:
- Bamboo binary installer package for Windows (Bamboo 9.6) NEW IN THIS RELEASE
Postgres 11 (Bamboo 9.5)
Oracle 12C (Bamboo 9.5)
MySQL 5.7 (Bamboo 9.5)
The 32-bit Windows installer and 32-bit ZIP distribution (Bamboo 9.3)
This means that the 32-bit Windows installer is no longer available, and the 32-bit ZIP distribution is replaced by a 64-bit version.Java 8, including Oracle JDK 8, Open JDK 8, and Adoptium OpenJDK 8 (Bamboo 9.3)
PostgreSQL 10 (Bamboo 9.3)
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.