Offline Job Queues

The purpose of the Offline Jobs function is to delegate slow processes, such as creating a preview for a video file, to another script/process to be run asynchronously. The upload process therefore focuses on getting files into the filestore, later working from a queue for further processing.

Originally developed to work alongside the Video Tracks plugin, job queue functionality has been expanded to allow the following to be handled offline:

  • Creating an alternative file from the specified command
  • Running a command that will create an output file, optionally specifying a download URL that can be sent to the user
  • Creating previews for resources or alternative files
  • Downloading collections of resources*
  • Deleting files
  • Extracting text from the resource and saving to a configured metadata field

* Please note that the offline jobs functionality for collection downloads is not available when ResourceSpace is accessed anonymously or via an externally shared collection

Offline jobs cannot be run individually by a user, they are run in the command line, usually using a regular cron job.

To enable this perform the following steps:-

  1. Enable a scheduled task (Windows) or cron job (Linux) that runs /pages/tools/offline_jobs.php as frequently as desired e.g.
    */5 * * * * cd /var/www/pages/tools; php offline_jobs.php
    
  2. Set the following option in the ResourceSpace configuration file (config.php)
    $offline_job_queue=true;