Powered by Zoomin Software. For more details please contactZoomin

Administrate MarkLogic Server

Restoring a Reconfigured Database

  • Last Updated: April 15, 2026
  • 3 minute read
    • MarkLogic Server
    • Version 11.0
    • Documentation

You can restore a database from a backup, even if forests have been added to or subtracted from the database after the backup. When the number of database forests are asymmetrical to the backup forests, these mapping rules apply:

  • Restore a single database forest from a single backup forest.

  • Restore a single database forest from multiple backup forests.

When restoring a database that has added or subtracted forests since the backup, click on the Backup/Restore tab, go to the Restore section of the page, set the Forest topology changed field to true, and click OK.

To restore a database that has added or subtracted forests since the backup, follow these steps:

  1. Click the Backup/Restore tab.

  2. Scroll to the Restore section.

  3. Set Forest topology changed to true.

  4. Click OK. The confirmation page appears showing the existing forests for the database and the backed up forests.

For example, you want to restore from a backup that was done when the Documents database had only one forest (Documents) and the restore operation is done after adding two more forests (Documents2 and Documents3) to the Documents database. You can restore a backup forest to only a single existing forest. In this example, we are populating the Documents forest from the backup of the Documents forest.

Graphic showing restoring the Documents forest from the backup of the Documents forest.

The Confirm restore page shows the restore operation. This operation is restoring the Documents forest from the Documents backup forest. To ensure that the Documents database is restored with the data from the backup, set the Documents2 and Documents3 forests to clear to remove any data added since the backup.

Screenshot of the Confirm restore page showing the restore operation.

These are the restore options for each existing forest:

Setting

Description

restore

Restore forest from backup forest.

clear

Do not restore forest and clear any data from the existing forest.

no change

Do not restore forest and leave the contents of the existing forest unchanged.

To restore from a backup that contains more than one forest, click the More Forests button and chose the additional backup forests from the pull down menus.

For example, you want to restore from a backup that was done when the Documents database had three forests, Documents, Documents2, and Documents3 and the restore operation is done after deleting the Documents2 and Documents3 forests. In this example, we are populating the singular Documents forest from the Documents, Documents2, and Documents3 backup forests.

Graphic showing populating the singular Documents forest from the Documents, Documents2, and Documents3 backup forests.

To restore a database that has added or subtracted forests since the backup, along with the auxiliary databases (Security, Schemas, and Triggers); click on the Backup/Restore tab; go to the Restore section of the page; enable the Forest topology changed and Include auxiliary databases options, and click Ok.

Note:

The Include auxiliary databases option is only relevant when Forest topology changed is enabled.

TitleResults for “How to create a CRG?”Also Available inAlert