admin.xdbcServerCreate

admin.xdbcServerCreate(
   config as element(configuration),
   group-id as (Number|String),
   appserver-name as String,
   root as String,
   port as (Number|String),
   modules-id as Item,
   database-id as (Number|String)
) as element(configuration)

Summary

This function creates a new XDBC App Server with the specified name, root, and port in the configuration.

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.
appserver-name The name of the App Server. The name must be unique among the App Server names for the group.
root The path to the module directory root of this XDBC server.
port The port on which the App Server listens. The port must be available on the host.
modules-id The ID of the modules database (for example, xdmp.database("Modules")). To specify the filesystem, use 0 or "file-system"
database-id The ID of the database (for example, xdmp.database("myDatabase") ).

Required Privileges

This operation requires at least one of the following privileges:

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

http://marklogic.com/xdmp/privileges/admin/group-security/{id}

Usage Notes

Any group or database whose ID you pass into this function must exist when the transaction begins, otherwise an exception is thrown. If you need to create the group and/or database, do so in a separate transaction before using them in in this function.

Example

  
  const admin = require('/MarkLogic/admin.xqy');
  const config = admin.getConfiguration()
  const groupid = admin.groupGetId(config, "myGroup")
  admin.xdbcServerCreate(config, groupid, "myNewAppServer",
        "/space/mycode", 8005, 0, xdmp.database("myDatabase") )

   //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.  
  
Powered by MarkLogic Server | Terms of Use | Privacy Policy