Backing Up and Restoring a Database Following Local Disk Failover
- Last Updated: April 15, 2026
- 3 minute read
- MarkLogic Server
- Version 12.0
- Documentation
Following a failure of a host that contains a master forest configured for local disk failover, the database attached to the master forest fails over to the replica forest. This section describes how to back up the surviving replica forest data and restore the data after the host containing the master forest has been restored. In the example procedure described in this section, the Documents database is attached to the Documents-master forest on one host and is configured for local-disk failover to the Documents-rep forest on another host.
For details on how to configure local disk failover, see the Configuring Local-Disk Failover for a Forest section in Scalability, Availability, and Failover.
The procedure in this section is based on this scenario:
-
Before the failure, the
Documents-masterforest is in theopenstate and theDocuments-repforest is in thesync replicatingstate:
-
A failure occurs on the host containing the
Documents-masterforest and theDocumentsdatabase automatically fails over to theDocuments-repforest. TheDocuments-repforest is now in theopenstate and servicing updates on behalf of theDocumentsdatabase.Note:
The configuration of theDocumentsdatabase remains unchanged from before the failover:
To back up the Documents-rep forest, follow these steps:
Note:
Both the backup and restore procedures must be done on the host that contains the Documents-rep forest.
-
On the host machine that contains the
Documents-repforest, back up theDocumentsdatabase. Leave Include replica forests set to true.
-
Select only the
Documents-repforest for backup. -
Once the host containing the
Documents-masterforest is restored, theDocuments-masterforest becomes the replica forest and receives replicated updates from theDocuments-repforest.
Before you can restore data from the Documents-rep forest that you backed up after the failover, you must reconfigure local disk failover from the Documents-rep forest to the Documents-master forest, so that the Documents-master forest is the new replica forest:
-
In the configuration page of the
Documents-masterforest, disable replication to theDocuments-repforest.
-
Navigate to the Forests configuration page for the
Documentsdatabase. Detach theDocuments-masterforest and attach theDocuments-repforest.
-
Navigate to the configuration page for the
Documents-repforest and select theDocuments-masterforest for local-disk failover. -
On the host containing the
Documents-repforest, confirm that the forest is in theopenstate, and restore theDocumentsdatabase from the backup taken after the failover. -
Make sure that only the
Documents-repforest is selected for restoration. -
Once the
Documents-repforest is restored, the updates are replicated to theDocuments-masterforest.