Loading TOC...

MarkLogic Server 11.0 Product Documentation
admin:database-add-foreign-replicas

admin:database-add-foreign-replicas(
   $config as element(configuration),
   $database-id as xs:unsignedLong,
   $replicas as element(db:foreign-replica)*
) as element(configuration)

Summary

This function adds one or more replica databases to the database replication 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.
database-id The ID of the replica database to be added.
replicas One or more replica database configuration elements. More than one replica database 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


  xquery version "1.0-ml";

  import module namespace admin = "http://marklogic.com/xdmp/admin"
      at "/MarkLogic/admin.xqy";

  let $fdb := 7746794057802787479
  let $cfg := admin:get-configuration()
  let $fcl := admin:cluster-get-foreign-cluster-id($cfg, "ClusterA")
  let $freplica := admin:database-foreign-replica($fcl, $fdb, fn:true(), 300)

  return admin:database-add-foreign-replicas($cfg, xdmp:database("NewDB"), $freplica)

  (: Adds the 'NewDB' database to the replica databases configuration. Use
     admin:save-configuration to save the changes to the configuration or
     pass the configuration to other Admin API functions to make other changes. :)
    

Stack Overflow iconStack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.