Moving to a different machine and upgrade on Linux
目的
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 Version | ターゲット バージョン |
|---|---|
|
|
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 |
|
|---|---|
| データベース |
|
| CVS |
|
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:
| バックアップ | Create backups for the following data:
|
|---|---|
| JAVA_HOME | Run the below commands in terminal:
The output should be something similar to this:
The output should be something similar to this: |
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
はじめる前に
- 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.
- Click on the button
in Bamboo UI. - Click Export in the left navigation column (under 'System').
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.- 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>.
例:
<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:
wget https://www.atlassian.com/software/bamboo/downloads/binary/atlassian-bamboo-6.6.0.tar.gzAfter the download finishes, you should see something similar to this:
ls
atlassian-bamboo-6.6.0.tar.gzStep 4 - 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.
Create a new Bamboo folder and extract the content of the .zip inside it:
mkdir Bamboo
tar -xf atlassian-bamboo-6.6.0.tar.gz --strip 1 -C ~/Bamboo
Expected results:
cd Bamboo
ls
atlassian-bamboo bin lib logs README.html scripts tomcat-docs work bamboo.sh conf licenses NOTICE README.txt temp webappsStep 5 - Start your new Bamboo 6.6.0
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.
./Bamboo/bin/start-bamboo.sh
To run Bamboo in the foreground, start the server with start-bamboo.sh -fg
Server startup logs are located in /home/bamboo/install/logs/catalina.out
Bamboo Server Edition
Version : 6.6.0
If you encounter issues starting or stopping Bamboo Server, please see the Troubleshooting guide at https://confluence.atlassian.com/display/BAMBOO/Installing+and+upgrading+Bamboo
Using CATALINA_BASE: /home/bamboo/install
Using CATALINA_HOME: /home/bamboo/install
Using CATALINA_TMPDIR: /home/bamboo/install/temp
Using JRE_HOME: /usr
Using CLASSPATH: /home/bamboo/install/bin/bootstrap.jar:/home/bamboo/install/bin/tomcat-juli.jar
Tomcat started.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: