Purpose

This article provides an outline of the upgrade process for Bamboo Server 5.14.+ to a recent version. For generic upgrade documentation, see Bamboo upgrade guide

Environment used in this document

Prerequisites

• Double check if your environment meets the supported platform's requirements for Bamboo 6.8:

Checklist:

Pre-upgrade tasks

• Make sure Bamboo is not running
• Backup of the current environment
• Make sure the JAVA_HOME variable is pointing to valid JDK 1.8 installation
  

Checklist:

C:\> echo %JAVA_HOME%
C:\Program Files\Java\jdk1.8.0_211

C:\> java -version
java version "1.8.0_211"
Java(TM) SE Runtime Environment (build 1.8.0_211-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.211-b12, mixed mode)

Run the upgrade

Step 1 - Stop Bamboo

• Bamboo running as a Windows Service:

Run the following command on CMD/Powershell

C:\> net stop Bamboo

Expected output:

C:\> net stop Bamboo
The Bamboo service is stopping..
The Bamboo service was stopped successfully.

Delete the old Service of Bamboo:

1. Navigate to folder <Bamboo-installation-folder>/bin

2. Remove the old service by executing the UninstallService.bat

   C:\Program Files\Bamboo\ UninstallService.bat

3. If there are any issues removing the service, open a command prompt and run the following command to remove it:

   sc delete <ServiceName here>

4. Install the new service using the instructions from this document: Running Bamboo as a Windows service as the local user

If Bamboo is running as a Windows Service, please run C:\Program Files\Bamboo\UninstallService.bat to remove Bamboo 5.14+ Service.

• Bamboo running in console:

Run the C:\Program Files\Bamboo\bin\stop-bamboo.bat script:

C:\Program Files\Bamboo\bin> .\stop-bamboo.bat

Expected output:

C:\Program Files\Bamboo\bin> .\stop-bamboo.bat

Bamboo Server Edition
   Version : 5.14.0.1

JAVA_HOME "C:\Program Files\Java\jdk1.8.0_211" contains spaces. Please change to a location without spaces if this causes problems.

If you encounter issues starting or stopping Bamboo Server, please see the Troubleshooting guide at https://confluence.atlassian.com/display/BAMBOO/Installing+Bamboo+on+Windows

Using CATALINA_BASE:   "C:\Program Files\Bamboo"
Using CATALINA_HOME:   "C:\Program Files\Bamboo"
Using CATALINA_TMPDIR: "C:\Program Files\Bamboo\temp"
Using JRE_HOME:        "C:\Program Files\Java\jdk1.8.0_211"
Using CLASSPATH:       "C:\Program Files\Bamboo\bin\bootstrap.jar;C:\Program Files\Bamboo\bin\tomcat-juli.jar"

You can also use the Windows Service management tool to stop Bamboo service

Step 2 - Download Bamboo 6.8.1

You can use wget to download Bamboo binaries:

C:\> wget https://product-downloads.atlassian.com/software/bamboo/downloads/atlassian-bamboo-6.8.1.zip

You also can use wget to download Bamboo executable:

C:\> wget https://www.atlassian.com/software/bamboo/downloads/binary/atlassian-bamboo-6.8.1-windows-x64.exe

After the download finishes, you should see something similar to this:

C:\> dir
atlassian-bamboo-6.8.1.zip
atlassian-bamboo-6.8.1-windows-x64.exe

Step 3 - Extract Bamboo files

Go through this step just if you are using the Bamboo binaries. If you are using the executable, please ignore this step.

Rename Bamboo 5.14.0.1 installation folder:

C:\Program Files> rename Bamboo Bamboo.5.14.0.1
C:\Program Files> dir
Bamboo.5.14.0.1

Create a new Bamboo folder and extract the content of the .zip inside it:

C:\Program Files> mkdir Bamboo
C:\Program Files> tar -xf atlassian-bamboo-6.8.1.zip --strip 1 -C Bamboo

Expected results:

C:\Program Files> cd Bamboo
C:\Program Files> dir
BUILDING.txt  CONTRIBUTING.md  NOTICE  README.html  README.md  README.txt  atlassian-bamboo  bamboo.sh  bin  conf  lib  licenses  logs  scripts  temp  tomcat-docs  tools  webapps  work

Step 4 - Copy the configurations from Bamboo 5.14.0.1

All customisations made to the following files must be copied to the new installation folder:

/Bamboo.5.14.0.1/bin/setenv.bat

#
#  Occasionally Atlassian Support may recommend that you set some specific JVM arguments.  You can use this variable below to do that.
#
JVM_SUPPORT_RECOMMENDED_ARGS:="-Dbamboo.ec2.agent.endpoint=http://localhost:8085-XX:UseG1GC"

#

#
# The following 2 settings control the minimum and maximum given to the Bamboo Java virtual machine.  In larger Bamboo instances, the maximum amount will need to be increased.
#
JVM_MINIMUM_MEMORY="2048m"
JVM_MAXIMUM_MEMORY="2048m"

#

/Bamboo.5.14.0.1/bin/server.xml

/Bamboo.5.14.0.1/bin/atlassian-bamboo/WEB-INF/classes/bamboo-init.properties 

C:\Program Files>/Bamboo.5.14.0.1/atlassian-bamboo/WEB-INF/classes$ cat bamboo-init.properties 
## You can specify your bamboo.home property here or in your system environment variables.

bamboo.home=C:/Users/User/bamboo-home

C:\Program Files> dir
atlassian-bamboo-5.14.0.1.zip  bamboo-home  Bamboo  Bamboo.5.14.0.1
C:\Program Files> cp Bamboo.5.14.0.1/atlassian-bamboo/WEB-INF/classes/bamboo-init.properties Bamboo/atlassian-bamboo/WEB-INF/classes/

Step 5 - Start Bamboo 6.8.1

Go through this step just if you are using the Bamboo binaries. If you are using the executable, please ignore this step.

Start Bamboo 6.8.1 by executing the /Bamboo/bin/start-bamboo.bat file.

C:\Program Files\Bamboo> \bin\start-bamboo.bat

Bamboo Server Edition
   Version : 6.8.1

JAVA_HOME "C:\Program Files\Java\jdk1.8.0_211" contains spaces. Please change to a location without spaces if this causes problems.

If you encounter issues starting or stopping Bamboo Server, please see the Troubleshooting guide at https://confluence.atlassian.com/display/BAMBOO/Installing+Bamboo+on+Windows

Using CATALINA_BASE:   "C:\Program Files\Bamboo"
Using CATALINA_HOME:   "C:\Program Files\Bamboo"
Using CATALINA_TMPDIR: "C:\Program Files\Bamboo\temp"
Using JRE_HOME:        "C:\Program Files\Java\jdk1.8.0_211"
Using CLASSPATH:       "C:\Program Files\Bamboo\bin\bootstrap.jar;C:\Program Files\Bamboo\bin\tomcat-juli.jar"

Step 6 - Upgrading Bamboo using the executable

Go through this step just if you are using the Bamboo executable. If you are using the binaries, please ignore this step.

Open the atlassian-bamboo-6.8.1-windows-x64.exe file and follow the instructions below:

Post-upgrade tasks

Recovery Plan: