<?xml version="1.0" encoding="UTF-8"?><api:function-page xml:base="/apidoc/8.0/xdmp.databaseIncrementalBackup.xml" generated="2015-10-07T16:36:00.016766-07:00" mode="javascript" xmlns:api="http://marklogic.com/rundmc/api"><api:function-name>xdmp.databaseIncrementalBackup</api:function-name><api:suggest>xdmp.databaseincrementalbackup</api:suggest><api:suggest>xdmp</api:suggest><api:suggest>databaseincrementalbackup</api:suggest><api:function-link mode="xquery" fullname="xdmp:database-incremental-backup">/apidoc/8.0/xdmp:database-incremental-backup.xml</api:function-link><api:function mode="javascript" name="databaseIncrementalBackup" type="builtin" lib="xdmp" category="AdminBuiltins" hidden="false" bucket="MarkLogic Built-In Functions" prefix="xdmp" namespace="http://marklogic.com/xdmp" fullname="xdmp.databaseIncrementalBackup"><api:summary>
  Starts an asynchronous incremental backup of the specified list of forests to the
  backup data directory.  Optionally starts journal archiving of the specified
  list of forests to the specified journal archive directory.  Returns a job
  ID that uniquely identifies the backup task.
</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.  The directory must exist and be
    writable by the operating system user under which MarkLogic Server
    is running.  The directory cannot be the MarkLogic Server install
    directory or the MarkLogic Server data directory.
  </api:param-description><api:param-name>pathname</api:param-name><api:param-type>String</api:param-type></api:param><api:param name="incremental-dir" type="xs:string?" optional="true"><api:param-description>
    An incremental backup directory.
  </api:param-description><api:param-name>incremental-dir</api:param-name><api:param-type>String?</api:param-type></api:param><api:param name="journal-archiving" type="xs:boolean?" optional="true"><api:param-description>
    Whether or not to enable journal archiving. Defaults to <code xmlns="http://www.w3.org/1999/xhtml">false</code>.
  </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="lag-limit" type="xs:unsignedLong?" optional="true"><api:param-description>
    Maximum difference in seconds that the archived journal can lag behind its
    forest's active journal. Defaults to 15.
  </api:param-description><api:param-name>lag-limit</api:param-name><api:param-type>String?</api:param-type></api:param></api:params><api:return>String</api:return><api:privilege>
  <p xmlns="http://www.w3.org/1999/xhtml"><code>http://marklogic.com/xdmp/privileges/xdmp-database-incremental-backup</code></p>
</api:privilege><api:usage>
  <p xmlns="http://www.w3.org/1999/xhtml">You cannot restore to a read-only forest.</p>
  <p xmlns="http://www.w3.org/1999/xhtml">Reindexing will stop while a backup or restore is in progress.</p>
  <p xmlns="http://www.w3.org/1999/xhtml">The backup directory must exist on each host that has a forest
  specified in the database backup call (that is, the d-nodes in which the
  forests being backed up are hosted). </p>
  <p xmlns="http://www.w3.org/1999/xhtml">If enabling journal archiving, all forests must belong to the same database.</p>
</api:usage><api:example class="javascript"><pre xml:space="preserve" xmlns="http://www.w3.org/1999/xhtml">
xdmp.databaseIncrementalBackup(
    xdmp.databaseForests(xdmp.database("My-Database")),
    "/backups/Data");
=&gt; 33030877979801813489
</pre>
</api:example></api:function></api:function-page>