XQuery admin:forest-set-foreign-replicas

MarkLogic 10 Product Documentation
admin.forestSetForeignReplicas

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

Summary

This function writes the specified replica forest configuration into the database replication configuration. Any forest-level configuration will override the database level-configuration. This function must be executed on the master cluster.

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 fforest =
    admin.forestForeignReplica(fcl, fdb , 2331251018938912591)
     admin.forestSetForeignReplicas(cfg, xdmp.forest("Documents2"), fforest)

   //Returns a configuration element that includes the specified foreign replica
   //forests.//Use admin.saveConfiguration to save the changes to the configuration
   //or pass the configuration to other Admin API functions to make other changes.

MarkLogic 10 Product Documentationadmin.forestSetForeignReplicas

Summary

Required Privileges

Example

MarkLogic 10 Product Documentation
admin.forestSetForeignReplicas