Cronjobs

This document describes cronjobs an related configurations, which should be set for your BlueSpice (depending on the used version).

Tip for this Document

• Please, read this manual completely and work through the single installtion steps one after another. 
• For editing the configuration files with a text editor, the files must be saved in UTF-8 coding without BOM (Byte Order Mark).
• The placeholder <installpath-bluespice> stands for the path to your BlueSpice installation, e.g C:\inetpub\wwwroot\bluespice (Windows) or /var/www/bluespice (Linux).

runJobs.php

Time-consuming processes will be moved to a processing queue in the background of BlueSpice. With every page impression, a part of these will be processed. For the case that there are lots of processes in the queue and there are relatively litte page impressions, the tasks will not be processed promptly. 

 Zeitaufwändige zu erledigende Prozesse werden von BlueSpice im Hintergrund in eine Warteschlange zum Abarbeiten gelegt. Bei jedem Seitenaufruf wird ein Teil dieser Prozesse abgearbeitet. Hängen zu viele Prozesse in der Warteschlange und es gibt verhältnismäßig wenige Seitenaufrufe so werden diese Prozesse nicht zeitnah abgearbeitet.

For this reason, the queue should be processed regularly by cronjob. At the same time, the calling of the queue by page impressions can be deactivated, which increases the performance of BlueSpice. For this, create the file <installpath-bluespice>/settings.d/001-JobQueue.php with the following content: 

<?php

$wgJobRunRate = 0;

Save and close the file.

Now create a cronjob (Windows: "Scheduled task") depending on your operating system. The command to execute is:

php <installpath-bluespice>/maintenance/runJobs.php (Linux)
<installpath-bluespice>\maintenance\runJobs.php (Windows)

It is recommended to specify the complete path to php.exe under Windows. For more information, see the environment variables document.

Execute the cronjob every 15 minutes. 

runNotifications.php (only BlueSpice pro)

The BlueSpiceReminder notifies the users by email about upcoming tasks in BlueSpice. For this, a cronjob needs to be executed once a day. This is the command:  

php <installpath-bluespice>/extensions/BlueSpiceReminder/Reminder/maintenance/runNotifications.php (Linux)
php <installpath-bluespice>\extensions\BlueSpiceReminder\Reminder\maintenance\runNotifications.php (Windows)

It is recommended to specify the complete path to php.exe under Windows. For more information, see the environment variables document.