MarkLogic 9 Product Documentationadmin.databaseEmployForest
admin.databaseEmployForest( config as element(configuration), database-id as (Number|String), forest-id as (Number|String) ) as element(configuration)
Summary
This function "employs" the specified forest in the configuration. This function can be used to "unretire" a forest that was previously retired by the admin:database-retire-forest function.
| Parameters | |
|---|---|
| config | A configuration specification, typically as returned from one of the Admin module functions. |
| database-id | The ID of the database. |
| forest-id | The ID of the forest. |
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/forests
http://marklogic.com/xdmp/privileges/admin/database/forests/{id}
Example
const admin = require('/MarkLogic/admin.xqy');
var config = admin.getConfiguration()
var dbid = admin.databaseGetId(config, "myDatabase")
var forestid = admin.forestGetId(config, "myForest")
admin.databaseEmployForest(config, dbid, forestid)
//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.