MarkLogic 10 Product Documentation
admin.forestCopy

admin.forestCopy(
   config as element(configuration),
   forest-id as (Number|String),
   forest-name as String,
   data-directory as String?,
   [large-data-directory as String?],
   [fast-data-directory as String?]
) as element(configuration)

Summary

This function creates a new forest specification with the same settings as the forest with the specified ID. The new forest configuration will have the specified name. It copies the forest configuration, but does not copy the forest data.

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".
forest-name	The name for the new forest.
data-directory	The optional data directory of the forest. If no directory is specified, then it will be a private forest.
large-data-directory	The optional directory where large objects are stored. If no directory is specified, then large objects will be stored in DATA_DIR/Forests/FOREST_NAME/Large.
fast-data-directory	An optional directory located on a fast storage device, such as an SSD.

Required Privileges

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

Example

  
  const admin = require('/MarkLogic/admin.xqy');
  admin.forestCopy(admin.getConfiguration(), xdmp.forest("myForest"),
         "myNewForest",())
   => returns the new configuration element -- 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.forestCopy

Summary

Required Privileges

Example

MarkLogic 10 Product Documentation
admin.forestCopy