<?xml version="1.0" encoding="UTF-8"?><api:function-page xml:base="/apidoc/8.0/xdmp.databaseRestoreValidate.xml" generated="2015-10-07T16:36:00.016766-07:00" mode="javascript" xmlns:api="http://marklogic.com/rundmc/api"><api:function-name>xdmp.databaseRestoreValidate</api:function-name><api:suggest>xdmp.databaserestorevalidate</api:suggest><api:suggest>xdmp</api:suggest><api:suggest>databaserestorevalidate</api:suggest><api:function-link mode="xquery" fullname="xdmp:database-restore-validate">/apidoc/8.0/xdmp:database-restore-validate.xml</api:function-link><api:function mode="javascript" name="databaseRestoreValidate" type="builtin" lib="xdmp" category="AdminBuiltins" hidden="false" bucket="MarkLogic Built-In Functions" prefix="xdmp" namespace="http://marklogic.com/xdmp" fullname="xdmp.databaseRestoreValidate"><api:summary>
  Validates that the specified list of forests can be restored from the
  backup data directory.  Returns a database restore set node.
</api:summary><api:params><api:param name="forestIDs" type="xs:unsignedLong*"><api:param-description>
    A sequence of forest IDs.
  </api:param-description><api:param-name>forestIDs</api:param-name><api:param-type>String[]</api:param-type></api:param><api:param name="pathname" type="xs:string"><api:param-description>
    A backup data directory pathname.
  </api:param-description><api:param-name>pathname</api:param-name><api:param-type>String</api:param-type></api:param><api:param name="restoreToTime" type="xs:dateTime?" optional="true"><api:param-description>
    The date and time to restore the forest data to.
  </api:param-description><api:param-name>restoreToTime</api:param-name><api:param-type>Date?</api:param-type></api:param><api:param name="include-replicas" type="xs:boolean?" optional="true"><api:param-description>
    Whether to include replica forests
  </api:param-description><api:param-name>include-replicas</api:param-name><api:param-type>Boolean?</api:param-type></api:param><api:param name="journal-archiving" type="xs:boolean?" optional="true"><api:param-description>
    Whether to restore from archived journals. Defaults to false.
  </api:param-description><api:param-name>journal-archiving</api:param-name><api:param-type>Boolean?</api:param-type></api:param><api:param name="journal-archive-path" type="xs:string?" optional="true"><api:param-description>
    Path to where archived journals are stored. Defaults to the backup data
    directory.
  </api:param-description><api:param-name>journal-archive-path</api:param-name><api:param-type>String?</api:param-type></api:param><api:param name="incremental-backup" type="xs:boolean?" optional="true"><api:param-description>
    Whether to restore using incremental backups. Defaults to false.
  </api:param-description><api:param-name>incremental-backup</api:param-name><api:param-type>Boolean?</api:param-type></api:param><api:param name="incremental-backup-path" type="xs:string?" optional="true"><api:param-description>
    Path to where incremental backups are stored. Defaults to the backup data
    directory.
  </api:param-description><api:param-name>incremental-backup-path</api:param-name><api:param-type>String?</api:param-type></api:param></api:params><api:return class="javascript">Object</api:return><api:privilege>
  <p xmlns="http://www.w3.org/1999/xhtml"><code>http://marklogic.com/xdmp/privileges/xdmp-database-restore-validate</code></p>
</api:privilege><api:example class="javascript"><pre xml:space="preserve" xmlns="http://www.w3.org/1999/xhtml">
xdmp.databaseRestoreValidate(
  xdmp.databaseForests(
            xdmp.database("MyDB")),
    // previously backed-up dir
    "/tmp/database_backup"
)
=&gt;
{
    "tagInfo": {
        "version": "8.0-20141119",
        "jobid": "1975326905393827288",
        "startdate": "2014-11-19T10:37:37",
        "enddate": "2014-11-19T10:37:38"
    }
    ,
    "forests": [
        {
            "forestName": "forest1",
            "forestId": "12393306467180079458",
            "forestStatus": "okay",
            "directoryPath": "/tmp/database_backup/20141119-1037377997450",
            "directoryStatus": "okay",
            "action": "restore",
            "incrementalBackup": false,
            "journalArchiving": false
        },
        {
            "forestName": "forest2",
            "forestId": "2102578687500930109",
            "forestStatus": "okay",
            "directoryPath": "/tmp/database_backup/20141119-1037377997450",
            "directoryStatus": "okay",
            "action": "restore",
            "incrementalBackup": false,
            "journalArchiving": false
        }
    ],
    "databases": [
        {
            "databaseName": "MyDB",
            "databaseId": "13433268924640794832",
            "assignmentPolicyName": "bucket",
            "databaseForests": [
                {
                    "forestName": "forest1",
                    "forestId": "12393306467180079458"
                },
                {
                    "forestName": "forest2",
                    "forestId": "2102578687500930109"
                }
            ]
        }
    ]
}

</pre>
</api:example></api:function></api:function-page>