JavaScript admin.groupSetBackgroundIoLimit

MarkLogic 9 Product Documentation
admin:group-set-background-io-limit

admin:group-set-background-io-limit(
   $config as element(configuration),
   $group-id as xs:unsignedLong,
   $max-megabytes-per-second as xs:unsignedInt
) as element(configuration)

Summary

This function sets a limit on the amount of I/O that background tasks (for example, merges) will consume. If the limit is reached, then merges are throttled back to limit their maximum I/O. This can help in situations when the I/O system on the computer is maxed out. In normal operations, you should not need to set this parameter.

Parameters
config	A configuration specification, typically as returned from one of the Admin module functions.
group-id	The ID of the group to which the App Server belongs. Typically, this is the result of an `admin:group-get-id` call.
max-megabytes-per-second	A number representing the maximum amount of I/O, in megabytes-per-second, to allow for each host in the group.

Required Privileges

This operation requires at least one of the following privileges:

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

http://marklogic.com/xdmp/privileges/admin/group/{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()
  let $groupid := admin:group-get-id($config, "Default")
  return
  admin:group-set-background-io-limit($config, $groupid, 100)

  (: returns the new configuration element -- 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 9 Product Documentationadmin:group-set-background-io-limit

Summary

Required Privileges

Example

MarkLogic 9 Product Documentation
admin:group-set-background-io-limit