Moving to a different machine and upgrade on Windows

Still need help?

The Atlassian Community is here for you.

Ask the community

Purpose

This article provides an outline of the process of moving Bamboo to a different machine and also how to proceed the upgrading.

Environment used in this document

Current VersionTarget version
  • Bamboo Server 6.6.0
  • Bamboo Server 6.9.0

For this example, we'll be upgrading to Bamboo 6.9.0. At the time of writing this document, the same procedure can be applied to all recent versions of Bamboo.

Prerequisites

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

Checklist:

Java
  • JDK 1.8
Database
  • MySQL 5.6.3 - 5.7
  • PostgreSQL 9.4 - 10
  • SQL Server 2012 - 2016
  • Oracle 12c
CVS
  • Git 1.8.1.5 and later
  • Mercurial 1.8 and later
  • Subversion 1.5 - 1.8

Pre-migration and upgrading 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:

Backups

Create backups for the following data:

  • Bamboo Database
  • bamboo-home directory
  • Bamboo installation directory
JAVA_HOME

Run the below commands in terminal:

  • echo %JAVA_HOME%

The output should be something similar to this:

C:\> echo %JAVA_HOME%
C:\Program Files\Java\jdk1.8.0_211
  • java -version

The output should be something similar to this:

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)

Before starting the migration, please make sure to complete the previous steps (Prerequisites and Pre-migration and upgrading tasks).

Step 1 - Export data from Bamboo

Before you begin

  • Bamboo will be unavailable while the backup process completes. The export itself may take a long time to complete, depending on the number of builds and tests. We recommend running your backups at a time of day or night when usage is low.
  • Backups may require large amounts of disk space, depending on the number of builds and tests. Please make sure you have enough disk space in your desired backup location before proceeding.
  • Bamboo will not export if plans are currently being built.
  • User management settings for Bamboo will be saved as part of the export.
  1. Click on the button  in Bamboo UI.
  2. Click Export in the left navigation column (under 'System').
  3. Complete the following settings:

    Export Directory Path
    This can be configured – see the note above.

    File Name
    Edit the default name of the file to which Bamboo will export, if necessary.

    Export Results
    Clear this to export only the plan configurations.

    Export Artifacts
    Select to have Bamboo export build artifacts.

    Export Build Logs
    Select to have Bamboo export build logs.

  4. Click on the Export button. Bamboo creates the export file in the location shown for Export Directory Path.

Step 2 - Get the license key

Login to the My Atlassian portal and retrieve your license key for Bamboo in order to proceed with the new installation of Bamboo in another machine.

You may also get the license key by copying the license from the property in the file bamboo.cfg.xml located at <bamboo-home-folder>.

Example:

<property name="license.string">YOUR_LICENSE</property>

Step 3 - Download a fresh distribution of Bamboo

Download a fresh distribution of your currently Bamboo version in Bamboo Downloads. You can use wget to download Bamboo binaries:

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

You also can use wget to download Bamboo executable:

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

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

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

Step 4 - Extract Bamboo files

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

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.6.0.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 5 - Start your new Bamboo 6.6.0

(warning) 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.6.0 by executing the /Bamboo/bin/start-bamboo.bat file.

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

Bamboo Server Edition
   Version : 6.6.0

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"

Wait a little bit for the process finish, access Bamboo and check if everything is working as expected. If Bamboo did not start, please review the prerequisites and make sure you followed all the steps correctly.

If the problem persists, you can also create a support ticket. To help us address the issue, attach the content of the <<Installation folder>>/logs/ folder to the ticket.

Step 6 - Configure the new Bamboo instance

Go through every step in Bamboo UI and put the license that you retrieved from the first step. Then, select the option Import existing data and link with the export file from the previous step.

Wait a little bit for the import process finish, access Bamboo and check if everything is working as expected. If Bamboo did not start, please review the prerequisites and make sure you followed all the steps correctly.

If the problem persists, you can also create a support ticket. To help us address the issue, attach the content of the <<Installation folder>>/logs/ folder to the ticket.

Step 7 - Upgrade Bamboo

In order to run the upgrade for Bamboo, choose your platform and the target version below:

Last modified on Dec 3, 2019

Was this helpful?

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