MarkLogic Server 11.0 Product Documentation
admin.httpServerCreate

admin.httpServerCreate(
   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 HTTP 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 root of the App 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.httpServerCreate(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.

MarkLogic Server 11.0 Product Documentationadmin.httpServerCreate

Summary

Required Privileges

Usage Notes

Example

MarkLogic Server 11.0 Product Documentation
admin.httpServerCreate