|
|
# Cron Package - Administrations Doku
|
|
|
# Cron Package - Administrator Documentation
|
|
|
|
|
|
Im Menü-Eintrag **Einstellungen -> Crons** befinden sich der Cron-Manager und den Cron History Manager.
|
|
|
Über den Cron-Manager können Sie alle Crons verwalten. Sie können Crons hinzufügen, editieren und oder löschen.
|
|
|
|
|
|
Der Cron History Manager gibt Ihnen einen Überblick über die Cron Timeline. Hier finden Sie ein Listing wann ein Cron ausgeführt wurde und von wem ein Cron ausgeführt.
|
|
|
|
|
|
## Cron in bestimmten Intervallen ausführen.
|
|
|
|
|
|
Damit das Cron System in bestimmtem Intervallen seine Cron-Einträge ausführen kann sollte der Cron Manager in Intervallen ausgeführt werden.
|
|
|
Der Cron Manager führt dann alle anstehenden Crons aus.
|
|
|
|
|
|
1. Als erstes sollten Sie in der QUIQQER Administration einen Cron Benutzer anlegen welcher die nötigenden Rechte besitz Crons auszuführen.
|
|
|
2. Danach müssen Sie den Cron-Manager in Intervallen ausführen. je nach gewünschter Nutzung alle 10 Minuten oder jede Stunde. Sie haben mehrere Möglichkeiten den Cron-Manager ausführen zu lassen.
|
|
|
|
|
|
**Über die Konsole / Bash**
|
|
|
|
|
|
```bash
|
|
|
php quiqqer.php cron
|
|
|
```
|
|
|
The menu entry **Settings -> Crons** contains the Cron Manager and the Cron History Manager. You can manage all crons via the Cron Manager. You can add, edit and delete crons.
|
|
|
|
|
|
The Cron History Manager gives you an overview of the Cron Timeline. Here you can find a listing when a cron was executed and by whom a cron was executed.
|
|
|
|
|
|
## Cron Manager auf der Konsole / Bash
|
|
|
|
|
|
Der Cron Manager bringt ein Konsolen-Tool mit.
|
|
|
D.h. der Cron-Manager kann über die Konsole verwaltet werden.
|
|
|
The Cron Manager comes with a console tool and can be managed via the console:
|
|
|
|
|
|
```bash
|
|
|
php quiqqer.php --username="*" --password="*" --tool="package:cron"
|
|
|
```
|
|
|
|
|
|
## Cron im Linux System anlegen
|
|
|
Z.B. um alle 5 Minuten die QUIQQER Crons ausführen
|
|
|
## Run crons regularly
|
|
|
|
|
|
The Cron-script has to be called in one minute intervals.
|
|
|
|
|
|
If QUIQQER is installed on a dedicated on a dedicated server the Cron-script can be called via a system-cron. For this approach see the section `Use System-Cron`.
|
|
|
|
|
|
If QUIQQER is installed on a shared host or just a webspace and you can not add System-Crons, you can use the Cron-Service. See the section `Use Cronservice` for this approach.
|
|
|
|
|
|
### Use System-Cron
|
|
|
|
|
|
To call the Cron-script via Linux System-Crons you have to edit the crontab files for the user that executes your webserver (e.g. `www-data` for apache2 webservers).
|
|
|
You can do this by calling:
|
|
|
```bash
|
|
|
crontab -eu www-data
|
|
|
```
|
|
|
|
|
|
und folgendes Einfügen
|
|
|
|
|
|
In the now opening editor window you add the following new line to the end of the file:
|
|
|
```bash
|
|
|
*/5 * * * * php /var/www/html/quiqqer/quiqqer.php cron > /dev/null 2>&1
|
|
|
* * * * * php <path-of-quiqqer-system>/quiqqer.php cron > /dev/null 2>&1
|
|
|
```
|
|
|
**Note:** You have to replace `<path-of-quiqqer-system>` with the path of your QUIQQER systems' root folder (e.g. `/var/www/html/vhosts/quiqqer/quiqqer.php`).
|
|
|
|
|
|
After doing that you can save the file and close the editor. When using the nano editor files are saved by pressing `Crtl + O`. The editor can be closed via `Crtl + X`.
|
|
|
|
|
|
Now your Linux-system should call the QUIQQER-Cron-Script every minute.
|
|
|
|
|
|
### Use Cronservice
|
|
|
|
|
|
The QUIQQER cronservice enables systems without native cron functionality to execute the QUIQQER crons anyway. This is realized with an external server on which QUIQQER systems can register themselves. This server will start the scheduled crons of all registered QUIQQER systems regularly.
|
|
|
|
|
|
To use the Cron-Service open the QUIQQER administration and navigate to `Adminstration` > `Crons` > `Cronservice`.
|
|
|
![image](uploads/3d359c252ec738a8f790e9c9007d448f/image.png)
|
|
|
|
|
|
By following the instructions in the dialog you can register your system for the Cronservice.
|
|
|
|
|
|
When you followed all instructions and open the dialog again, you should see that the status now shows `Active` and some further information.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
... | ... | |