This is the documentation for Bamboo 5.8. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

The instructions on this page describe how to import data from a Bamboo backup.

Before you begin:

  • Bamboo will be unavailable until the import process is complete, which may take some time.
  • The import process will delete your Bamboo installation and restore data from a previous export of Bamboo. This includes login data, so you will need to know an administration login in the Bamboo data to be imported.
  • 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 (using 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.
  • Backup Directory Path: Bamboo restricts the editing of certain file path settings for security reasons (see Bamboo Security Advisory 2010-05-04). If you must configure Bamboo to permit modification to its file path settings, start 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 the bamboo.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.

To import data from backup:

  1. Click the  icon in the Bamboo header and choose Overview.
  2. Click Import in the left navigation column (under 'System').
  3. Complete the following settings:

    File PathThe absolute path to the data file that Bamboo should import. For example, "/opt/bamboo/bamboo-home/" on UNIX-based operating systems.
    Backup dataHighly recommended. Bamboo will not import data unless it is able to successfully export data first.
    Backup Directory PathThis can be configured – see the note above.
    File NameThe file to which Bamboo will export its data.
    Clear artifact directoryDelete all existing build artifacts before the import.
    Apply imported data without server shutdownNot recommended in a production environment.
  4. Click Import.
  5. After the import is complete,

Screenshot: Importing data from a backup