This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

You can configure Bamboo to automatically create a backup each night, rather than doing a manual export every time.

On this page:

Specifying a Backup Schedule

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).
  • 'Backup 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.

To specify a backup schedule:

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Scheduled Backups' link in the left navigation column. The 'Scheduled Backup Details' page will be displayed, showing details about the status of scheduled backups or any currently configured backup.
  3. Click the 'Edit' button to edit the current 'Scheduled Backup Details'.
  4. Ensure that the 'Disable scheduled backups' check box is cleared to ensure that your automatic backups will be performed.
  5. Select the 'Backup Artifacts' check box if you want to include build artifacts in your scheduled backups.
  6. In the 'Backup path' field, specify the directory where you want to store your backups. Each backup will be stored as a single file.
  7. In the 'Backup file prefix' field, specify the first part of the filename for all your backup files.
  8. In the 'Backup file date pattern' field, specify the date/time format for identifying your individual backup files. This will be appended to the 'Backup file prefix' to form the complete filename for your backup files, e.g.:
    • if your 'Backup file prefix' is 'bamboo_backup_' and your 'Backup file date pattern' is 'yyyy_MM_dd', then your backup file on 31st July 2007 would be named 'bamboo_backup_2007_07_31'.
  9. In the 'Schedule' field, choose one of the following frequencies at which backups will be executed:
    • 'Daily' — creates a backup every day. If you choose this option, select the time 'Interval' with which Bamboo will execute backups:
      • 'once per day' — If you choose this option, select the time of day at which the backup will be conducted.
      • Any other 'Interval' option — select the segment of time in a day during which the backups will be conducted.
    • 'Days per Week' — creates a backup on specific days of a week. If you choose this option, select the check boxes next to the days of the week on which you want the backups conducted. Also, specify the time 'Interval' with which Bamboo will execute backups on these days. (Refer to the 'Daily' interval options above for details.)
    • 'Days per Month' — creates a backup on a specific day of a calendar month. If you choose this option, select either:
      • The calendar date of the month on which the backup will run.
      • The day of the week in the calendar month on which the backup will run.
    • 'Advanced' — creates a backup whose schedule is dependent on a Cron expression. For more information on creating Cron expressions, please refer to the documentation on creating Cron expressions in Bamboo.
  10. Click the 'Save' button. Your first backup will run when your server's clock matches the specified time.

Disabling a Backup

If you disable schedule backups, your schedule details will be retained but no automatic backups will be performed.

To disable a scheduled backup:

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Scheduled Backups' link in the left navigation column. The 'Scheduled Backup Details' page will be displayed, showing details about the status of scheduled backups or any currently configured backup.
  3. Click the 'Edit' button to edit the current 'Scheduled Backup Details'.
  4. Select the 'Disable scheduled backups' check box.
  5. 保存」ボタンをクリックします。

Screenshot above: Scheduled Backups

注意

関連トピック

Managing Data and Backups
Exporting Data for Backup
Importing Data from Backup