XQuery admin:forest-add-foreign-replicas

MarkLogic 9 Product Documentation
admin.forestAddForeignReplicas

admin.forestAddForeignReplicas(
   config as element(configuration),
   forest-id as (Number|String),
   foreign-replicas as element(as.foreignReplica)[]
) as element(configuration)

Summary

This function adds the replica forest that is associated with the specified master forest to the database replication configuration. This function must be executed on the master host.

Parameters
config	A configuration specification, typically as returned from one of the Admin module functions.
forest-id	The ID of the forest on the master host to be replicated.
foreign-replicas	The element returned by the `admin:forest-foreign-replica` function that specifies the configuration for the replica forest. More than one forest replica configuration elements may be specified in a one-to-many replication scheme.

Required Privileges

This operation requires at least one of the following privileges:

http://marklogic.com/xdmp/privileges/admin/database

http://marklogic.com/xdmp/privileges/admin/database/{id}

http://marklogic.com/xdmp/privileges/admin/database/replication

http://marklogic.com/xdmp/privileges/admin/database/replication/{id}

Example

  
  const admin = require('/MarkLogic/admin.xqy');
  var cfg = admin.getConfiguration()
  var fcl = admin.clusterGetForeignClusterId(cfg, "ClusterA")
  var fdb = admin.databaseForeignReplicaGetDatabaseId(
                      admin.databaseGetForeignReplicas(cfg, xdmp.database("Documents")))
  var mforest = xdmp.forest("Documents2")
  var fforest = admin.forestForeignReplica(fcl, fdb , 2863600501631949400)
  admin.forestAddForeignReplicas(cfg, mforest, fforest)

  //Adds the foreign forest, 'Document2', to the forests used by the replica database,
  //'Documents'.//Use admin.saveConfiguration to save the changes to the configuration
  //or pass the configuration to other Admin API functions to make other changes.

MarkLogic 9 Product Documentationadmin.forestAddForeignReplicas

Summary

Required Privileges

Example

MarkLogic 9 Product Documentation
admin.forestAddForeignReplicas