Migrating Configuration Database

In this article

    Migration of the configuration database is helpful if you need to move the backup server and configuration database to another location, for example, offsite. In this case, you can configure a backup server, deploy a Microsoft SQL Server in the target location and then restore data from the configuration backup to a database on this server. As a result, you will get a "replica" of the backup server without additional adjustments and fine-tuning.


    It is recommended that you use Veeam Backup & Replication tools to create configuration backups and migrate the configuration database. If you use native Microsoft SQL Server tools or others, after migration, some information, such as secure configuration data, may not be accessible.

    Before You Begin

    Before you start the migration process, perform the following tasks:

    • Prepare the target backup server.

    Install Veeam Backup & Replication on the machine on which you plan to move your source backup server.

    • Stop all running jobs and disable all scheduled jobs on the source backup server before you create the configuration backup.

    Do not start or enable any jobs. If you start a job before migration is completed, Veeam Backup & Replication will produce a new restore point in the chain and update the chain metadata. The created configuration backup will not contain information about this new restore point. When you migrate data from the configuration backup to the database and start the job again, Veeam Backup & Replication will fail to synchronize the chain metadata with data in the database. As a result, the job will fail.

    • Save registry keys that you changed or created on the backup server. After the migration, you will need to recreate or change the keys manually because the configuration database does not store them.

    Before migrating the configuration backup, Veeam Backup & Replication performs an additional check. If the configuration backup does not meet the requirements, Veeam Backup & Replication will offer you to switch to the Restore mode.

    In the Restore mode, Veeam Backup & Replication will rescan VM replicas, backup repositories and tape libraries connected to the backup server. The database will be updated to include information about new restore points, and subsequent job sessions will work in a proper way.

    Performing Migration

    1. On the target backup server, from the main menu, select Configuration Backup.
    2. In the Restore section, click Restore to launch the Configuration Database Restore wizard.

    Migrating Configuration Database 

    1. At the Restore Mode step of the wizard, select Migrate.

    Migrating Configuration Database 

    1. Complete the wizard as described in the Restoring Configuration Database section.
    2. If you created custom registry keys or changed the existing ones on the previous backup server, you must recreate or change the registry keys again manually on the target backup server.


    If you have local repositories, after migration to another VM they may be displayed as empty. In this case, add them again and remap the jobs.

    Related Topics

    Creating Configuration Backups

    I want to report a typo

    There is a misspelling right here:


    I want to let the Veeam Documentation Team know about that.