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');
  const cfg = admin.getConfiguration()
  const fcl = admin.clusterGetForeignClusterId(cfg, "ClusterA")
  const fdb = admin.databaseForeignReplicaGetDatabaseId(
                      admin.databaseGetForeignReplicas(cfg, xdmp.database("Documents")))
  const mforest = xdmp.forest("Documents2")
  const 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. 
    
Powered by MarkLogic Server | Terms of Use | Privacy Policy