Article For
4.0 4.1 4.2 5.0 5.1 5.2

Backups



Backups View

NoSQL Database Studio Backups View

NoSQL Database Studio Backups View

  1. Go to Studio Backups View
    To back up your database or server, click on the Tasks tab then Backups.
  2. Create a Periodic Backup
    To schedule automatic, recurrent backups.
  3. Create a Manual Backup
    For a one-time backup.
  4. Restore a database from a backup
    To restore a database from a previously created backup.
  5. Go to Server Wide Tasks View to back up all of the databases on this server.
  6. Database Group Topology
    You can see all active server-wide and database specific periodic backups.

Periodic Backup Creation

Periodic Backup Tasks View

Periodic Backup View

Periodic Backups View

  1. Create a periodic backup task
    To schedule automatic, recurrent backups.
  2. View Details of periodic backup tasks
    • Backup Now (e.g. before software updates) can be triggered in the 'View Details' interface.
  3. Edit this database backup task. To edit server/node-wide backup tasks, see button #5.
  4. Delete this periodic backup task.
  5. Go to server-wide backups view to back up all databases on the server.
  6. Database Group Topology
    This shows all active server-wide and database specific periodic backups.

Creating Periodic Backups

Defining Periodic Backup

Defining Periodic Backups

  1. Task Name (Optional)

    • Choose a name of your choice
    • If no name is given then RavenDB server will create one for you based on the defined destination
  2. Backup Task Type:

    • Backup
      • Backed Up Data: The database data in a JSON format, including documents, indexes (definitions only) & identities (same as exported database format)
      • Size of backup data: Smaller
      • Backup Speed: Faster
      • Restoring: Slower, Indexes have to be rebuilt from their definitions
    • Snapshot
      • Backed Up Data: The raw database data including the indexes (definitions and data)
      • Size of backup data: Larger
      • Backup Speed: Slower
      • Restoring: Faster, Indexes do not have to be rebuilt
  3. Preferred Node (Optional)

    • Select a preferred mentor node from the Database Group to be the responsible node for this Backup Task
    • If no node is selected, then the cluster will assign a responsible node (see Members Duties)

Scheduling Backups

Select the content to back up. Note: Both incremental and full backups can be scheduled at the same time.

Scheduling Two Backups

Scheduling Two Backups

  1. Full Backup
    Full Backup will back up all the database data every time the task is scheduled to work.
    A Snapshot can only occur when scheduling 'Full'.

  2. Incremental Backup
    Incremental Backup will only back up the delta (changes made) of the data since the last backup that has occurred.

    • If only Incremental Backup is set, then a Full Backup will occur only the first time that the task is triggered,
      followed by Incremental Backups according to the scheduled time.
      The Full Backup that is done the first time will be either a 'Backup' or a 'Snapshot', depending on the type selected.
    • Data that is backed up in Incremental Backup is always of type 'Backup' - even if the Backup Task Type is 'Snapshot'.
      'Backup' types save index definitions, but not the fully built indexes.

Schedule the Backup Tasks to occur at regular intervals (daily, monthly, hourly, every minute) at specific times.

Save on data transfer with frequent "incremental" backups and recover lost data with infrequent "full" backups

To save on data transfer costs you can schedule frequent 'incremental' backups, (which save any changes made since the previous backup).

To ensure that you can recover lost data, schedule infrequent 'full' backups.

Infrequent backups can be useful if a mistake was made and you need access to data from a few days ago.

If downtime while recovering databases is a concern, you can also set up an external replica and manually fail over to it while you recover the data onto the original cluster.


Retention Policy

To save storage space, you can set obsolete scheduled backup files to delete automatically after the time period that you define.
Old backups are deleted after the defined time period during the next scheduled backup.

Backup Retention Policy

Backup Retention Policy

  1. Enable / disable the retention policy. If disabled, the backups are stored indefinitely, which may use a lot of storage.
    We recommend enabling so that deletion of obsolete backups can be scheduled.
  2. Select the retention period.

Some organizations require backups to be stored for as long as 7 years. If this is the case, consider the issue when scheduling and setting the retention policy.


Backup Encryption

Backups can be encrypted. Make sure that you save the encryption key well.

Backup Encryption Options

Backup Encryption Options

  1. Toggle Encrypt to encrypt the backup files.
  2. Choose the current encryption key or create a new one for this backup task.
    • Use the current encryption key. You don't need to set and save a new key with this option.
    • Create a new encryption key for backups. You can only do this on 'Backup' type backups.
Create New Encryption Key for Backup

Create New Encryption Key for Backup

  1. The new encryption key. Click the 'refresh' arrow to randomly create a different key.
  2. Options to save the key.
  3. Check the box to acknowledge that you've saved the key.

Destination

Select backup destinations and enter your credentials for each.
Make sure to save the destinations and credentials information so that your team will be able to restore the database if needed.

Backup Destinations

Backup Destinations

  1. Local machine storage
    • Set a folder of your choice (any directory that can be accessed from your machine)
  2. Cloud storage options

More than one destination can be selected at the same time. The backup process will first write the backup to the local path (or to a temporary path if the local path is not specified).

Once that's done, the backup owner will start uploading the backup to all remote destinations in parallel.

If any of the remote destinations fail, the entire backup will be considered to have failed.

For a resilient data protection strategy

that protects your databases from natural disasters and theft, we recommend scheduling concurrent backups on a local machine and on the cloud. This strategy is known as the 3-2-1 Backup Rule.


Periodic Backup Details

Periodic Backup Details

Periodic Backup Details

  1. Backup Task Details:

    • Task Status
      Active / Not Active / Not on Node
    • Destinations
      List of all backup destinations defined
    • Last Full Backup
      The last time a Full Backup was done (Snapshot / Backup type - depending on task definition)
    • Last Incremental Backup
      The last time an Incremental Backup was done
    • Next Estimated Backup
      Time for next backup
      (Full Backup / Incremental Backup / Snapshot - depending on task definition)
    • Retention Policy
      Backups older than this period will be deleted during next backup.
  2. Backup Now:
    In addition to the scheduled time defined, you can backup your data now.
    This is useful before software updates or any other action where data may be lost.
    The scheduled backup will still be triggered as defined.

  3. Refresh:
    Click to refresh this panel viewed details


Manually Creating One-Time Backups

Manual Backup Tasks View

Manual Backup View

Manual Backups View

  1. Create a one-time manual backup.
    This can be vital before upgrading or whenever you want an unscheduled backup.
  2. Unscheduled backups (e.g. before upgrades) can also be done in the periodic backup details view.

If you've selected 'manual backup', the following screen will open.

Manual Backup Creation

Manual Backup Creation

  1. Backup Type.
    • Snapshot saves the entire database and its indexes.
    • Backup saves the data, but only index definitions.
  2. Encryption - See Backup Encryption.
  3. Destination for backup to be stored.

Click Backup Now to finish the process.

Manual backups have only some of the properties of periodic backups:

  • The backup can be full or snapshot.
  • The backup can be encrypted or not.
  • The backup must have a destination.

There are also some important differences:

  • Manual backups do not have retention policies.
    In other words, they are not set to be automatically deleted.
  • Manual backups do not have names, they are identified by the time they were created.
  • Manual backups are not scheduled, they occur exactly once: when the Backup Now button is pressed.
  • The backup cannot be modified afterward from the Studio, but you can create a new one-time backup whenever you need to.


When the Cluster or Node is Down

  • When the cluster is down (and there is no leader):

    • Creating a new Ongoing Task is a Cluster-Wide operation,
      thus, a new Ongoing Backup Task cannot be scheduled.

    • If a Backup Task was already defined and active when the cluster went down,
      then the Backup Task will still continue to execute on its defined schedule (on its responsible node).
      But, it will fail to be reported to the cluster and may be run again after the cluster has recovered.

  • When the responsible node is down

    • If the responsible node for the Backup Task is down during the scheduled time,
      then another node from the Database Group will take ownership of the task so that there are no gaps in your backups.


Backup Task -vs- Replication Task

  • RavenDB's External Replication provides you with an off-site live replica/copy of the data ('live' meaning that any changes in the database will be duplicated into the replica immediately).
    If one database is down, replicas (other nodes in the cluster) can continue its work, thus greatly improving availability.
    Replication is also quite useful if you need to:

    • Shift operations to a secondary data center
    • Share the workload across more than one server.
  • But a replica isn't a backup. It doesn't present good solutions for many backup scenarios. For example, backups can:

    • Protect you from an accidental collection delete
    • Tell you the state of the system at, say, 9:03 AM last Friday
    • Protect you from various cyber attacks
  • A backup keeps an exact state of the database at a specific point in time and can be restored.