Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Manage Backups

      +
      Backups contain bucket data. You can take a backup on-demand or use a configurable automatic schedule.

      Use the procedures on this page to create on-demand backups, schedule automatic backups, and manage backups. To learn more about how backups work in Couchbase Capella, see Backup and Restore Data.

      View and Manage Backups

      Permissions Required

      To view and manage backups in the Capella UI:
      Backup options are unavailable to free trial clusters.

      Accessing Database Backups in the Capella UI

      You can access a database’s backups from the Backup page.

      1. Open the Backup page for your database:

        1. With the Projects tab in your organization open, click the project with the database you want to work with.

        2. With the Databases tab open, select your database.

        3. Click the Backup tab.

      The database’s 'Backups' tab.

      Backup Summary

      A database’s Backups page shows a summary of the latest backups per bucket that exist for the database. You can sort the backup information by bucket name.

      Each bucket includes the following information about its most recent backup:

      Field Description

      Bucket Name

      The name of the bucket.

      Latest Backup

      The last time there was a backup of the bucket, the backup type, the backup size, and how long it took.

      Items

      The number of items in the backup.

      Tombstones

      The number of tombstones, or records for removed items, in the backup. This number includes tombstones for deleted documents and any dropped collections.

      GSI

      The number of Global Secondary Indexes (GSI) in the backup.

      FTS

      The number of Full Test Search (FTS) indexes in the backup.

      CBAS

      The number of indexes for the Couchbase Analytics Service (CBAS) in the backup.

      Event

      The number of eventing functions in the backup.

      Expires On

      The date the backup expires and is deleted.

      Configure Scheduled Backups

      You can configure scheduled backups for buckets at any time. When you set a backup schedule, the bucket automatically backs up the bucket based on the chosen schedule.

      Couchbase recommends that you change each bucket’s Backup Schedule according to your Recovery Time Objective (RTO) and Recovery Point Objective (RPO). For example, buckets in production databases might require a much smaller backup window and a much longer backup retention time period than buckets in development databases.

      You can edit a bucket’s backup schedule when modifying a bucket or from the Backup page for your database.

      To change a bucket’s backup schedule from the Backup page:

      1. Open the Backup page for your database:

        1. With the Projects tab in your organization open, click the project with the database you want to work with.

        2. With the Databases tab open, select your database.

        3. Click the Backup tab.

      2. Select the bucket you want to change.

      3. Click Edit Schedule.

      4. If it’s not already selected, use the Bucket list to choose the bucket you want to change.

        Using the Bucket list, you can select multiple buckets to bulk edit backup schedules.

      5. Choose a backup schedule for the bucket according to the relative importance of the workload and data.

        1. Select Do Not Backup to not schedule any backups.

          Do Not Backup is not recommended for production databases. It’s intended for development databases or similar.

          To set a weekly incremental schedule, see the steps which follow.

        2. Choose Set Weekly Schedule.

        3. Choose the Day of the week when you want Capella to take the full backup. The default value is Sunday.

        4. Set the Start at time of day for the full backup.

          Select a Start at time when your application isn’t using Capella heavily unless you’ve chosen a database configuration with more capacity than you need.

        5. Use the Incremental Every list to set the frequency of incremental backups.

          If you change the Start at time, the next incremental backup might happen at a different time than you expect. Capella calculates the Incremental Value backward from the configured Start at time.

          For example, Incremental Every is 8 hours, and the Start at time is 4 AM. If the current time is 9 PM, Capella takes an incremental backup at 8 PM, an eight-hour interval backward from 4 AM. If you change the Start at to 6 AM, you would see another incremental backup at 10 PM, two hours after the last backup. The backup occurs at this time because Capella recalculates the eight-hour backup interval back from the new 6 AM Start at time.

        6. Select Cost Optimized Retention. When selected, the cost optimized retention policy applies to your bucket backup. For more information, see Cost Optimized Retention Policy.

        7. Set a Retention Time in line with your data retention policy.

          If you selected Cost Optimized Retention, the Retention Time applies only to the monthly restore point.

          Capella preserves each backup from 30 Days to 5 Years. After the retention time lapses, Capella schedules the backup for deletion.

          The Retention Time setting applies to all future backups for a bucket. Changes to this setting do not affect previous backups.

      6. Click Apply.

        The first automatic backup occurs at the next increment of the Incremental Every value, calculated backward from the configured Start at time.

      Create an On-Demand Backup

      Capella keeps on-demand backups for 30 days.

      An on-demand backup of a bucket is always a Full backup. Capella schedules on-demand backup to start immediately.

      1. Open the Backup page for your database:

        1. With the Projects tab in your organization open, click the project with the database you want to work with.

        2. With the Databases tab open, select your database.

        3. Click the Backup tab.

      2. Select the bucket you’re creating an on-demand backup for.

      3. Click Backup Now.

      4. Use the Bucket list to choose the buckets you want to back up.

      5. Click Backup Now.

        There can be a slight delay while Capella schedules the backup.

        The Activity Log lists on-demand backup events. This includes when a backup was triggered, when it started, and when it finished.

      The Backup page shows the details of a bucket’s backup when it’s done.

      View Backup Details

      You can view the details of a database backup by inspecting it in the Capella UI.

      1. Open the Backup page for your database:

        1. With the Projects tab in your organization open, click the project with the database you want to work with.

        2. With the Databases tab open, select your database.

        3. Click the Backup tab.

        The Backup page shows the details of the most recent backup for each bucket in the database.

      2. Select the bucket with the backups you want to view.

        The bucket page lists recent backups grouped by the on-demand and scheduled backup types:

        The

        Each backup has the date and time it was created, the backup type, and the expiry time. A Scheduled backup also includes a number for the backup’s position in the backup series.

      View Backups by Date

      A bucket’s page shows backups for the current backup cycle. To view backups that belong to previous cycles:

      • Use the From Date date picker to select the start date for the backup cycle you want to view.

        Choosing a new From Date automatically refreshes the page to show scheduled and on-demand backups based on this new date.

      Delete a Backup

      Deleting a backup is a permanent action.

      When you delete a database, you also delete its bucket backups. When you delete a bucket, Capella keeps its backups until their configured retention time.

      In Couchbase Capella, backups are deleted as follows:

      Manual deletion

      You can manually delete a set of scheduled backups or individual manual backups. You can’t undo a backup deletion.

      1. Open the Backup page for your database:

        1. With the Projects tab in your organization open, click the project with the database you want to work with.

        2. With the Databases tab open, select your database.

        3. Click the Backup tab.

      2. Select the bucket with the backups you are deleting.

      3. Click Delete for the backup you want to delete.

        If you’re deleting a scheduled series of backups, delete the most recent backup.

      4. Confirm the backup deletion request.

        1. Type delete into the provided field.

        2. Click Delete Backup.

      Exceeding the retention time

      If a backup’s age is greater than the retention time set in the Backup Schedule, Capella automatically deletes the backup.

      Deleting a database

      If you delete a database with bucket backups, all the backups stored in the database are also deleted.

      Download a Backup in the Capella UI

      You can download backups from the Capella UI or using wget.

      Prerequisites

      Procedure

      To download a backup in the Capella UI:

      1. From the Backup tab for your database, select a bucket.

      2. Navigate to one of the following pages:

        1. Bucket Backup

          Contains the latest and partially completed backups for a selected bucket. You cannot download a backup series (backup cycle) where all incremental backups are not complete.

        2. Completed Backups

          Contains all completed backups for a selected bucket.

      3. [Optional] Filter by backups, a date range, or a type. For example, Scheduled or On-Demand backup types.

      4. [Optional] Expand a backup card to view its details.

      5. Click Download on a backup.

        A dialog box is displayed.

      6. Click Proceed to start the download file creation.

      7. An email is sent to you when the downloadable backup file is ready.

      8. After receiving an email, from the Backup tab for your database, select a bucket, and click Downloadable Backups.

        A list of ready-to-download backups is displayed.

      9. Click Copy URL on the appropriate downloadable backup.

        You have up to 12 hours after the download file has been created to copy the Download URL. Each copy generates a unique URL. After you copy the download URL, it expires in 1 hour. You must start the download before the URL expires. After starting the download, you have at least 12 hours before the download file is removed.

      10. To download the file using a browser, paste the download URL into a browser window and Enter.

        The .zip file containing the backup is downloaded. The downloaded file is a zip of a cbbackupmgr archive.

      11. Unzip the downloaded backup zip archive file in an appropriate location.

      12. Use the Couchbase cbbackupmgr cbbackupmgr utility to view, examine, or restore the backup.

      Download Using wget with the Download URL

      You can download the backup zip archive file using an utility like wget or curl.

      To download using wget:

      Description Action

      To use the filename set in the response-content-disposition/content-disposition option of the download URL.

      wget --content-disposition "<download_url>"

      To rename the file when downloading using the download URL.

      wget -O capella_cluster_testbucket1_backup_0219.zip "<download_url>"