Cronjobs

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

Tips for this Document

• Please, read this manual completely and work through the single installation 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 regarding the documentation "Folder structure under Windows") or /var/www/bluespice (Linux).
• The placeholder <tomcat-webapps stands for the path to the webapps directory of your Tomcat server, e.g C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps (Windows) or /var/lib/tomcat8/webapps (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. 

For this reason, the queue should be processed regularly by cronjob. 

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

php <installpath-bluespice>/maintenance/runJobs.php (Linux)
php.exe <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. 

processBsEmailBatch.php

For reports via email sent from MediaWiki, please create a cronjob and run it daily. The command for this is:

php <installpath-bluespice>/extensions/BlueSpiceEchoConnector/maintenance/processBsEmailBatch.php (Linux)
php.exe <installpath-bluespice>\extensions\BlueSpiceEchoConnector\maintenance\processBsEmailBatch.php (Windows)

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

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.