Regular tasks (cron)
To enable the regular tasks feature in ORSEE, we need to install a so-called 'cronjob' which regularly runs a script that checks whether a task is due and starts it when required.
Cronjobs on Unix/Linux systems are managed by the cron daemon
and configured in a crontab
file. To list your currently installed crontab, type
crontab -l
If you have no cronjobs installed yet, you may just install the crontab file which comes with ORSEE in the install/
directory named crontab-for-orsee
by typing
crontab crontab-for-orsee
If there are cronjobs installed already, and you don't want to overwrite them, just copy the lines from the file crontab-for-orsee
, call the editor vi
on your crontab by typing
crontab -e
and paste in the lines at the end. Some useful vi
commands: i
- insert from here, ESC
- leave insert mode, x
- delete char, dd
- delete line, :x
- save and exit.
The cronjob configured for ORSEE reads as this: Every 5 minutes, test whether the file admin/cron.php
in ORSEE's system path is readable, and if this is true, change to the admin/
directory and run the cron.php
script via PHP, but without any output.
If you are familiar with cron, you may change the job configuration to fit your needs. Note that the cron job is running under the user name of the user who has installed it. Thus, all files in your ORSEE system directory should be readable for that user (and the usage/ directory should be writable for the cron user because the webalizer output will be written there).
Note: If you are putting your crontab under “cron.d”, then the cron command in the tab will also need to specify the user under which the cronjob is supposed to be run, as the 6th column (after the 5 frequency columns with the minutes and the stars*). For details see here: https://unix.stackexchange.com/questions/296347/crontab-never-running-while-in-etc-cron-d