Disaster Recovery

JetBackup Config Backup Job

JetBackup 5 will backup it's internal databases only when JB Config is enabled on your configured backup destinations. In order to do so, click on "Export JB Config" on your preferred Destination. Keep your DR destination details and Master Encryption Key to be able to restore from DR.

Job Configuration

The JetBackup Config Backup Job is configured to be executed every night at 01:00 AM Server Time with a total schedule retention of 3. The JetBackup Config Backup Job is an Encrypted Compressed Backup that will dump the entire JetBackup MongoDB and Jetindexd Database in order to allow for Disaster Recovery.

  • Backup Structure: Compressed
  • Encrypted: True
  • Schedule: Daily - 01:00 AM Server Time
  • Retention: 3 Total Backups

Since the JetBackup Config Backup Job is encrypted, please make sure to keep a copy of your Master Encryption Key in a secure remote location. If the original server is lost, there is no other way to retrieve the Master Encryption Key. However, you may still install a Fresh JetBackup 5 instance and restore accounts using a Read-Only Destination. For more details see How to perform Disaster Recovery without Master Encryption Key?

Recover from Disaster

Getting Started

JetBackup has the ability to restore from a disaster by storing our JetBackup internal database on your preferred destination. Performing a Disaster Recovery will restore the JetBackup Configuration that was backed up as well as give the option to restore all the accounts that have backups located on the configured destinations.
If for any reason you cannot perform a full Disaster Recovery, you can still restore your accounts manually from the destinations by following these instructions: How to perform Disaster Recovery without Master Encryption Key?

Important information before starting Disaster Recovery!

  • JetBackup will backup it's internal DB only when "Export JB Config" is enabled on your backup destination. In order to do so, click on "Export JB Config" on your preferred Destination. Keep your DR destination details to be able to restore from DR. The JB config backup will be executed every night and will keep a max of 3 snapshots.
  • Please make sure to keep your Master Encryption Key in a secure remote location.
  • There must be at least 1 User Package and/or Reseller Package (if applicable to your Panel) on the new server for JetBackup to assign the accounts to during a DR restore. Please ensure that you specify a "Default Package" in JetBackup's Panel Settings to use when the accounts backed up package is not found on the server.
  • The Disaster Recovery process is not intended for cross-panel migrations. Please take a look at the "Clone Jobs" feature, if you'd like to restore accounts across different control panels.
  • Restoring your JetBackup Configurations may take some time depending the number of backups indexed by JetBackup at the time the JB Config Export was generated. Please allow enough time for the JB Configurations Restore to complete to begin the Disaster Recovery process.

Initial Installation and Setup

With an entire data loss, your first step will be to install JetBackup on a supported platform that meets our system requirements. (See Installation).
After Installation, you will be prompted to choose whether you want to Recover from Disaster, continue with existing data or start with a fresh install in the Disaster Recovery Wizard.

Choose "Recover from Disaster" to continue with disaster recovery.

Disaster Recovery Recover

Now, we need to restore JetBackup's internal database, so JetBackup will have all the information necessary to restore your accounts.

Please have the following information available for the next steps!

  1. Destination Details and Backups Path for the destination where Export JB Config was enabled on your previous configuration. This is used to pull your JetBackup Config information from that destination.
  2. Master Encryption Key This encryption key is used to decrypt your JetBackup Config Backup and is REQUIRED to restore your previous JB configuration.

Restoring JB Configurations

The next step requires you to select your Destination Type.

The "Local" destination is selected in the "Destination Type" dropdown by default. When restoring from a remote destination, the related destination plugin will need to be installed from the JetApps Repository first, and JetBackup will guide you through this process.

To restore JB Config, please select your destination from the "Destination Type" dropdown.

Disaster Recovery Destination Select

You will see the "Install Now" prompt when selecting a remote destination type.

Select "Install Now" to install the destination plugin.

Disaster Recovery Plugin Install

Then enter the Destination details that you gathered earlier:

Disaster Recovery Destination

Choose the database backup (JetBackup settings) that you want to restore from (usually you will want the most recent backup that was created).

Disaster Recovery JB Config

As our database is encrypted, you will need to specify the Master Encryption Key from your previous installation/server.

Enter the Master Encryption Key in the Encryption Key field:

Disaster Recovery JB Config Key

If the key is valid, you will see the "Creating destination and reindexing JB configurations backups" after clicking "OK".

This may take some time to complete, depending on the size of your JetBackup database when the JB Config backup was generated and the number of snapshots.

Please do not exit or refresh the page while the JB Configurations restore is in progress.

Once completed, you will be able to restore your accounts from the destination.

(Optional) You can set "Delete orphan backups older than" option to "Disabled" in your JetBackup Settings to prevent orphan backups from being untentionally removed.

Restoring Accounts

Now we are ready to start restoring your accounts! Simply choose the accounts to restore through the Account Restore Filters and hit the "Finish & login to panel" to continue to your JetBackup Admin Panel while accounts are being restored in the background.

NOTE: JetBackup prioritizes restores by the account type out of the box. Along with the Queue Priority Groups setting, this ensures that parent accounts gets restored before their corresponding child accounts. For more Information regarding JetBackup 5's priority systems, please CLICK HERE.

Disaster Recovery Restore

Your accounts are now in the accounts restoration queue and may take some time to complete while the selected accounts are being restored. You can click "Finish and login to Panel", then visit the queue to check the status.

NOTE: The Disaster Recovery Wizard only lists backups from accounts that do not exist on the current server and were previously active on the source server when JetBackup generated the JB Config Backup.

Post Disaster Recovery Checks

Re-Enable Export JB Config - Don't forget to re-enable "Export JB Config" on your preferred destinations! By default, all destinations will have the Export JB Config setting disabled post Disaster Recovery. You will need to re-enable them under Destination Settings.

Re-Enable Backup Jobs - Don't forget to re-enable your backup jobs! By default, backup jobs that are imported from your JB Config will be disabled. You will need to re-enable them under Backup Jobs.