Backup / Restore with Local Disk Failover
06 December 2016 06:46 PM
Backup/Restore settings for Local Disk Failover
When configuring backups for a database, the '
This KB article will go over an example failover scenario, and will show how a scheduled backup/restore works with different
Consider a 3 node cluster with hosts
|Host A||Host B||Host C|
|forest-1p (disabled)||forest-2p (open)||forest-3p (open)|
|forest-3r (disabled)||forest-1r (open)||forest-2r (sync replicating)|
'Include replica Forests' is false and '
Journal Archiving' is true
Forest 1p is disabled, and the corresponding replica forest-1r is now Open because of the failover. In this case a backup task will not succeed during this time because replica forests have not been configured for backups. The following 'Warning' level message will be logged:
Warning: Not backing up database backup-test because first forest master forest-1p is not available, and replica backups aren't enabled
Host-A is brought up again, the forest states will be
forest-1p - sync replicating
forest-1r - open
At this time, backups will succeed and because journal archiving is enabled, journals will be written to the backup data.
However, you will not be able to do a "point in time restore' using journal archiving. When the configured master is not the acting master and backup is not enabled for replicas, the following error occurs when a restore to a point in time is attempted :
Operation failed with error message: xdmp:database-restore((xs:unsignedLong("5138652658926200166"), "/space/20160927-1125008228810", xs:dateTime("2016-09-27T11:06:21-07:00"), fn:true(), ()) -- Unable to restore replica forest forest-1r because the master forest forest-1p is not also restored, or is not acting master. Check server logs.
To get past this, the forests need to be failed back in order to make the 'configured master' same as the 'acting master'
Include replica forests' is true and '
Journal Archiving' is true
In this case, backups will succeed when forests are failed over to their replica forests because replica forests are configured for backups. And, because journal archiving is enabled, journals will be also written to the backup data.
Even in this case, point in time restore will not work similar to the previous case, until the forests are failed back.
MarkLogic Administrator's Guide: Backing up and Restoring a Database Following Local Disk Failover
MarkLogic Administrator's Guide: Restoring Databases with Journal Archiving
MarkLogic Knowledgebase Article: Understanding the role of journals in relation to backup and restore journal archiving
MarkLogic Knowledgebase Article: Database backup / restore and local disk failover