The instructions on this page describe how to import data from a Bamboo backup. |
On this page: |
Importing Data from Backup
Before you begin:
- The import process will delete your Bamboo installation and restore data from a previous export of Bamboo. This includes login data, hence you will need to know an administration login in the Bamboo data to be imported.
- Bamboo will be unavailable until the import process is complete, which may take some time.
- 'File Path' setting — Bamboo restricts the editing of certain file path settings for security reasons (see Bamboo Security Advisory 2010-05-04). If so, you must configure Bamboo to permit modification to its file path settings, by starting Bamboo with the system property
bamboo.paths.set.allowed=true
. The procedure for configuring a Bamboo system property is described on Configuring System Properties.
Once you have configured your file path setting, we recommend removing or disabling thebamboo.paths.set.allowed
system property and restarting Bamboo. If your Bamboo instance is accessible to anyone outside your organisation, then this will minimise the risk of Bamboo being compromised by security-related attacks. - If you created your backup file using Bamboo 3.2 or later, importing the file will restore your user management settings. If you created your backup file using Bamboo 3.1 or earlier, importing the file will default your user management settings to 'Local users and groups' (i.e. user/group management in Bamboo). You may need to change your settings after the import.
- If you manage users externally (LDAP or Crowd) and the Bamboo internal user repository (in the backup file) contains user names that duplicate user names in the external repository, you will not be able to import from the backup file.
To import data from backup:
- Click the 'Administration' link in the top navigation bar.
- Click the 'Import' link in the left navigation column.
- Type the absolute 'File Path' from which Bamboo is to import data. For example, "/opt/bamboo/bamboo-home/export.zip" on UNIX-based operating systems.
- Select the 'Backup data' check-box. (This is HIGHLY RECOMMENDED.)
- Specify the absolute 'Backup Directory Path' to which Bamboo will backup its data. This must be different from the 'File Path' specified above. For example, 'C:\Documents and Settings\<me>\bamboo-home\my-backups' for a Windows-based operating system. You would typically use forward-slashes (without drive letter specification) on UNIX-based operating systems.
- Type the 'File Name' of the file to which Bamboo will export its data. For example, '
backup.zip
'. - Click the 'Import' button.
- After the import is complete,
- check the paths of your builders and JDK.
- index your data.
Screenshot above: Importing data from a backup
Notes
Related Topics
Managing Data and Backups
Specifying a Backup Schedule
Exporting Data for Backup
Attachments:


