MarkLogic 12 Product Documentation
admin:forest-add-failover-host

admin:forest-add-failover-host(
   $config as element(configuration),
   $forest-id as xs:unsignedLong,
   $hosts as xs:unsignedLong*
) as element(configuration)

Summary

This function adds a failover host to the list of failover hosts for the specified forest in the specified configuration. If there are already any hosts specified, this host is added to the end of the list of failover hosts.

Parameters
config	A configuration specification, typically as returned from one of the Admin module functions.
forest-id	The ID of the forest. For example, `xdmp:forest("myForest")` specifies the ID for a forest named "myForest".
hosts	The host ID(s) for the host(s) you want to restart. For example, `xdmp:host()` returns the ID for the current host.

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/forest

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

Example


  xquery version "1.0-ml";

  import module namespace admin = "http://marklogic.com/xdmp/admin"
		  at "/MarkLogic/admin.xqy";

  let $config := admin:get-configuration()
  return
  admin:forest-add-failover-host($config,
      admin:forest-get-id($config, "Documents"),
      xdmp:host("myFailoverHost"))

      => add the failover host "myFailoverHost" to the end of the
         list of failover hosts. Use admin:save-configuration to save the changes
         to the configuration or pass the configuration to other Admin API
         functions to make other changes.

MarkLogic 12 Product Documentationadmin:forest-add-failover-host

Summary

Required Privileges

Example

MarkLogic 12 Product Documentation
admin:forest-add-failover-host