Scheduler Application

Last modified by Mathieu Pace on 2024/07/05 18:15

scheduler.pngAllows scheduling Jobs
TypeXAR
Category
Developed by

XWiki Development Team

Rating
2 Votes
LicenseGNU Lesser General Public License 2.1
Bundled With

XWiki Standard

Installable with the Extension Manager

Description

This application requires the Scheduler Plugin. It is bundled in XWiki version 1.2 milestone 2 and later.

Offers a dashboard of defined jobs and the ability to perform actions on these jobs (cancel, reschedule, edit, etc). The application is available on the Scheduler space of your wiki.

Usage

Accessing the Application

Since 8.2M2+ Log in with a user having Admin rights and access the Application Index from the Drawer (top right menu) and select the Scheduler application:

schedulerentry.png

Note for technical users: you can directly access the application by navigating manually to the Scheduler/WebHome page.

With older versions of XWiki (between 5.3M2+ to 8.2M2) you could access it an entry in the Applications Panel (if you had Admin rights):

schedulerentryflamingo.png

Clicking this link will get you to the Scheduler home page:

scheduler-dashboard.png

Creating a new Job

scheduler-job-creation.png

The cron expressions are used to configure how often the jobs will be triggered. Cron expressions are strings that are actually made up of seven sub-expressions, that describe individual details of the schedule (see this tutorial on the quarts scheduler documentation). These sub-expression are separated with white-space, and represent:

  1. Seconds
  2. Minutes
  3. Hours
  4. Day-of-Month
  5. Month
  6. Day-of-Week
  7. Year (optional field)

Below some example of valid cron expression, from the official quartz scheduler documentation:

 Cron expression  Meaning
 0 15 10 * * ?  Fire at 10:15am every day
 0 15 10 ? * MON-FRI  Fire at 10:15am every Monday, Tuesday, Wednesday, Thursday and Friday
 0 0/5 14 * * ?  Fire every 5 minutes starting at 2pm and ending at 2:55pm, every day
 0 15 10 ? * 6L  Fire at 10:15am on the last Friday of every month

Scheduling a job

Click on the "Schedule" action to register the job and display the next time it will be fired.

A job can be triggered manually by using the "Trigger" action. Notice that it needs to be scheduled first to be triggered this way.

Advanced

By default, the user used to execute the Scheduler job is the user who created the job page. However it's possible to change it by editing the job page using the Object Editor and changing the "Job execution context user" as shown on the next image. 

Similarly you can change the language used when executing the job script or the wiki (a.k.a database) for which the script will be executed.

advanced.png

After editing an already scheduled job, it needs to be re-scheduled to use the modifications.

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

Get Connected