diff --git a/components/ILIAS/Cron/README.md b/components/ILIAS/Cron/README.md index 48455e007f83..103c4fb9005e 100755 --- a/components/ILIAS/Cron/README.md +++ b/components/ILIAS/Cron/README.md @@ -22,8 +22,7 @@ described in [RFC 2119](https://www.ietf.org/rfc/rfc2119.txt). To give more control of if and when cron-jobs are executed to administrators a 2nd implementation of cron-jobs has been added to ILIAS 4.4+. All existing cron-jobs have been migrated and thus moved to their respective modules -and services. The top-level directory "cron/" will probably be kept because of cron.php but should otherwise be empty -at some point. +and services. The CLI entry point for executing cron-jobs is `cli/cron.php`. ### Providing a Cron-Job @@ -176,12 +175,15 @@ So as mentioned above the cron-tab can safely be set to every few minutes. In order to execute the cron job manager, the following command MUST be used: ```shell -/usr/bin/php [PATH_TO_ILIAS]/cron/cron.php run-jobs run-jobs +/usr/bin/php [PATH_TO_ILIAS]/cli/cron.php run-jobs ``` The `` MUST be a valid (but arbitrary) user account of the ILIAS installation. The `` MUST be the client id of the ILIAS installation. +The system crontab SHOULD invoke this command every few minutes. Individual cron-jobs +are then executed according to their configured schedule. + ## Permission Context Implementations of `\ILIAS\Cron\CronJob` MUST NOT rely on specific permissions (e.g. RBAC). diff --git a/docs/configuration/install.md b/docs/configuration/install.md index b67295071404..a49782a7f5b5 100755 --- a/docs/configuration/install.md +++ b/docs/configuration/install.md @@ -690,7 +690,8 @@ We strongly recommend using MariaDB instead of MySQL due to performance, licensi ## Configure Cron Jobs This step configures the execution of the ILIAS Cron Jobs, which can be set to perform tasks, such as sending notifications. -You can manage these jobs in the ILIAS Administration under "Administration > General Settings > Cron Jobs". +You can manage these jobs in the ILIAS Administration under +"Administration > System Settings and Maintenance > Cron Jobs". To test the execution of the Cron Jobs Executable `./cli/cron.php`, the following command can be used: @@ -702,16 +703,16 @@ The `` is a valid, arbitrary user account within the ILIAS installation. The `` corresponds to the client ID of the ILIAS installation. To configure automated Cron Jobs in your system, you need to create a user in ILIAS, for example named `cron`. -Then create a new file in the Linux Cron configuration for ILIAS at `/etc/cron.d/ilias`, -including a line to execute `./cli/cron.php` every 5 minutes. +Then create a new file in the Linux Cron configuration for ILIAS at `/etc/cron.d/ilias`, +including a line to execute `./cli/cron.php` every 5 minutes. Other methods for executing Linux cron tasks, such as using the user crontab, can also be utilized. ```cron */5 * * * * www-data /usr/bin/php /var/www/ilias/cli/cron.php run-jobs cron myilias > /dev/null 2>&1 ``` -You can verify the proper automatic execution in the ILIAS Administration section by checking the timestamp -displayed at `Last Start of the Cron Job` after some time. +You can verify the proper automatic execution in the ILIAS Administration section by checking the timestamp +displayed at `Last Automatic Execution of Cron Job Script` after some time.