MarkLogic 9 Product Documentation

Administrator's Guide — Chapter 31

Understanding Scheduled Tasks

MarkLogic Server allows you to schedule the execution of XQuery main modules. The ability to schedule module execution is useful for:

• Loading content. For example, periodically checking for new content from an external data source, such as a web site, web service, etc.
• Synchronizing content. For example, when MarkLogic is used as a metadata repository, you might want to periodically check for changed data.
• Delivering batches of content: For example, initiate an RSS feed, hourly or daily.
• Delivering aggregated alerts, either hourly or daily.
• Delivering reports, either daily, weekly, or monthly.
• Polling for the completion of an asynchronous process, such as the creation of a PDF file

Tasks can be scheduled to run at a particular time on a particular date, or at a specified interval. MarkLogic Server attempts to place the task on the task server's queue at the specified time, but the actual execution of the task might not start at this time. If the queue is full, the task fails and will not be re-tried until the next scheduled interval.

Scheduling a Module for Invocation

To schedule a module for invocation at a particular date/time or interval, do the following:

1. Click the Groups icon in the left tree menu.
2. Click on the group in which you want to schedule a task (for example, Default).
3. Click the Scheduled Tasks icon on the left tree menu.
4. Click on the Create tab to bring up the Schedule a Task page
5. Specify the URI for the module to invoke in the Task Path field. The task path must begin with a forward slash (/) and cannot contain a question mark '?', colon ':' or pound '#' character.
6. In the Task Root field, specify the root directory (files system) or URI root (database) that contains the module. For example, if the module is located in the file system under MarkLogic/Docs, specify Docs.
7. In the Task Type field, select one of the task types described in Selecting a Task Type.
8. In the Database field, select the database on which to invoke the module.
9. In the Task Modules field, select either the file system or database that contains the module specified in the Task Path field.

   If Task Modules is set to (file system), then place the module in the directory specified by Task Root. For example, in the configuration shown in Step 10, you would place the Scheduler_test.xqy file in the MarkLogic/Docs directory.

   If Task Modules is set to a database, then load the module into that database under the URI root specified by Task Root. For example, if the configuration shown in Step 10 specified the Documents database in the Task Modules field, you could use the xdmp:document-load function to load the module with the following URI option:

   <uri>Docs/Scheduler_test.xqy</uri>

10. In the Task User and Task Host fields, specify the user with permission to invoke the task and the host computer on which the task is to be invoked. If no host is specified, then the task runs on all hosts.

    The user specified in the Task User field must have the privileges required to execute the functions used in the module. See Appendix B: Pre-defined Execute Privileges for the full list of execute privileges.

    Example of a Scheduled Task configuration:

Selecting a Task Type

You can select one of the date/time or interval scheduling options described in this section as your task type.

The interval scheduling options that operate on elapsed time are:

• Scheduling Per Minute
• Scheduling Per Hour

The date/time scheduling options that operate on calendar time are:

• Scheduling Per Day and Time
• Scheduling Per Week, Day, and Time
• Scheduling Per Month, Day, and Time
• Scheduling One Invocation on a Calendar Date and Time

  The date/time options are scheduled in terms of the local time designated by the server's clock. This means that, in regions that recognize daylight savings time, a scheduling interval of 24 hours is not the same as a once-per-day at a particular time scheduling interval.