Skip to content

Diagnostics Tab

Dickson Law edited this page Jan 26, 2018 · 1 revision

Diagnostics Tab

This menu allows you to verify the functionality of your job dispatch queue. There are 2 main types of background jobs in Omeka:

Job Tests Menu

  • Short-running jobs: This type is most often used for shorter, local batched tasks, such as batch edits and deletes.
  • Long-running jobs: This type is most often used for longer import tasks, such as jobs started by CSV Importer.

Click "Test" to dispatch a test job. It will have up to 60 seconds run and respond, at which point you will be redirected back to this menu. A healthy job queue should respond in less than 10 seconds.

You can also view older test results with the "History" button. To remove history entries, click "Clear" and confirm.

Known Error Messages

Below is a list of error messages that may occur when a job attempts to start. If you get an error not listed below, please ask for assistance on the Omeka forums.

  • "The configured PHP path () does not point to a PHP-CLI binary.": Your long-running job dispatcher is not correctly configured. Edit the background.php.path entry in your Omeka instance's application/config/config.ini file to a valid PHP-CLI path. Common paths on self-administrated setups include /usr/bin/php and usr/bin/php-cli. If you use a web hosting service, please consult your administrator for the correct value.
Clone this wiki locally