Exporting Data for Backup

Exporting Data for Backup

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 test. We recommending 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 it detects that plans are currently being built. Please ensure that you do not have plans building (see Viewing Bamboo's Current Activity).
• 'Export Directory 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 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.
• Bamboo uses the third party TrueZip library to create zip archives. TrueZIP currently implements the ZIP32 specification only. This limits the maximum ZIP file length to 4GB. Unfortunately, Bamboo exports will fail if the resulting ZIP file is over 4GB. As a workaround, please export Bamboo without artifacts or use a different backup strategy
• User management settings for Bamboo will be saved as part of the export. For information on user management in Bamboo, see Working with External User Repositories.

To export data for backup:

1. Click the 'Administration' link in the top navigation bar.
2. Click the 'Export link in the left navigation column.
3. Specify the absolute 'Export Directory Path' to which Bamboo will export its data. 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.
4. Type the 'File Name' of the file to which Bamboo will export its data. For example, 'export.zip'.
5. Select the 'Export Artifacts' check box if you want to backup your build artifacts.
6. Click the 'Export' button.

Screenshot above: Exporting data for backup

Notes

Related Topics

Managing Data and Backups
Specifying a Backup Schedule
Importing Data from Backup