Creating a New XDBC Server
To create a new server, follow these steps:
Log into the Admin Interface.
Click the Groups icon in the left tree menu.
Click the group in which you want to define the XDBC server (for example, Default).
Click the App Servers icon on the left tree menu.
Click the Create XDBC tab. The Create XDBC Server page appears.
In the XDBC Server Name field, enter a shorthand name for this XDBC server. MarkLogic Server will use this name to refer to this server on display screens in the Admin Interface.
In the Root field, enter the name of the directory in which you will store your XQuery programs. If the modules field is set to a database, then the root must be a directory URI in the specified modules database.
If the Modules field is set to (file system), then the root directory is either a fully-qualified pathname or is relative to the directory in which MarkLogic Server is installed. The following table shows the default installation directory for each platform:
Platform
Program Directory
Microsoft Windows
C:\Program Files\MarkLogicRed Hat Linux
/opt/MarkLogicMac OS X
~/Library/MarkLogicNote
Unless you specify a shared drive, all hosts in the group will need to have a copy of the XQuery programs in the directory specified above.
Warning
Do not create XDBC server root directories named Docs, Data, or Admin. These directories are reserved by MarkLogic Server for other purposes. Creating XDBC server root directories with these names can result in unpredictable behavior of the server and may also complicate the software upgrade process.
In the Port field, enter the port number through which you want to make this XDBC server available.
The port number must not be assigned to any other XDBC, HTTP, or WebDAV server.
In the Modules field, select the database to use as the modules database for your XQuery documents, or leave it at the default of storing your XQuery modules on the file system. For information on what a modules database is, see Modules Database.
In the Database field, select the database to be accessed by this XDBC server. Multiple HTTP, XDBC, and WebDAV servers can access the same database.
Scroll to the Authentication field and select an authentication scheme, as described in Types of Authentication in Securing MarkLogic Server. The default is digest, which uses encrypted passwords.
Scroll to the Privilege field near the bottom of the screen. This field represents the privilege needed to access (login to) the server. You may leave this field blank.
A user accessing the XDBC server must have the execute privilege selected in order to access the XDBC server (or be a member of the
adminrole).Set any other properties for this app server, as appropriate to your needs:
Last Login and Display Last Login are described in Storing and Monitoring the Last User Login Attempt.
Backlog specifies the maximum number of pending connections allowed on the HTTP server socket.
Threads specifies the maximum number of app server threads.
Request Timeout specifies the maximum number of seconds before a socket receives a timeout for the first request.
Keep Alive Timeout specifies the maximum number of seconds before a socket receives a timeout for subsequent requests over the same connection.
Session Timeout specifies the maximum number of seconds before an inactive session times out.
Max Time Limit specifies the upper bound for any request's time limit. No request may set its time limit (for example with
xdmp:set-request-time-limit()) higher than this number. The time limit, in turn, is the maximum number of seconds allowed for servicing a query request. The app server gives up on queries which take longer, and returns an error.Default Time Limit specifies the default value for any request's time limit, when otherwise unspecified. A request can change its time limit using
xdmp:set-request-time-limit(). The time limit, in turn, is the maximum number of seconds allowed for servicing a query request. The app server gives up on queries which take longer, and returns an error.Pre-commit Trigger Limit specifies the maximum number of pre-commit triggers a single statement against this app server can invoke. For more information on triggers, see Using Triggers to Spawn Actions in the Application Developer’s Guide.
Pre-commit Trigger Depth specifies the maximum depth (how many triggers can cause other triggers to fire, which in turn cause others to fire, and so on) for pre-commit triggers that are executed against this app server. For more information on triggers, see Using Triggers to Spawn Actions in the Application Developer’s Guide.
Collation specifies the default collation for queries run in this app server. This will be the collation used for string comparison and sorting if none is specified in the query. For details, see Encodings and Collations in the Search Developer’s Guide.
Log Errors specifies whether to log uncaught errors for this app server to the ErrorLog.txt file. This is useful to log exceptions that might occur on an app server for later debugging.
Debug Allow specifies whether to allow requests against this app server to be stopped for debugging, using the MarkLogic Server debugging APIs.
Profile Allow specifies whether to allow requests against this app server to be profiled, using the MarkLogic Server profiling APIs. For details, see Profiling Requests to Evaluate Performance in the Query Performance and Tuning Guide.
Default XQuery Version specifies the default XQuery language for this app server if an XQuery module does explicitly declare its language version.
The properties associated with SSL support are described in Configuring SSL on App Servers in Securing MarkLogic Server.
The new XDBC server is created. Creating an XDBC server is a “hot” admin task; the changes take effect immediately. For information and setup instructions for managing user sessions and/or keeping track of login attempts, see Managing User Requests and Monitoring Login Attempts.