mirror_php/humhub
1
0
Fork 0
mirror of https://github.com/humhub/humhub.git synced 2025-01-17 14:18:27 +01:00
Code Issues Projects Releases Wiki Activity

Merge pull request #3261 from acs-ferreira/patch-9

Browse Source 
Clarify things about Cronjobs & Asynchronous Tasks
This commit is contained in:
buddh4 2018-08-21 18:18:30 +02:00 committed by GitHub
commit 351bfa14a6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
protected/humhub/docs/guide/admin/installation-configuration.md
View File

@ -18,19 +18,22 @@ CronJobs and Asynchronous Job Processing (v1.3+)
---------------------------
**CronJobs** are used to execute scheduled tasks as for example sending _summary emails_ or _search index optimization_
and need to be configured in your server environment.
and they need to be configured in your server environment.
The scheduled job runner can be executed manually as follows:
The scheduled job-runner can be executed manually as follows:
```
> /usr/bin/php /path/to/humhub/protected/yii cron/run
```
**Asynchronous Jobs** are used to execute potentially long running tasks in the background and can either be run by
an extra CronJob or by other job-runner alternatives. Please see [Asynchronous Tasks](asynchronous-tasks.md) for more
details about queuing and job processing options.
**Asynchronous Jobs** are used to execute potentially long running tasks in the background and can either be:
The asynchronous job-runner can be executed manually as follows:
- run by an extra CronJob (see below),
- or by a job-runner alternative.
> Please see [Asynchronous Tasks](asynchronous-tasks.md) for more details about queuing and job processing options.
The asynchronous job-runner can also be executed manually as follows:
```
> /usr/bin/php /path/to/humhub/protected/yii queue/run
@ -38,12 +41,20 @@ The asynchronous job-runner can be executed manually as follows:
**Example CronTab configuration:**
These Cronjobs can be run together if you're not using any other job-runner (like Supervisor or Systemd):
```
* * * * * /usr/bin/php /path/to/humhub/protected/yii queue/run >/dev/null 2>&1
* * * * * /usr/bin/php /path/to/humhub/protected/yii cron/run >/dev/null 2>&1
* * * * * /usr/bin/php /path/to/humhub/protected/yii queue/run >/dev/null 2>&1
* * * * * /usr/bin/php /path/to/humhub/protected/yii cron/run >/dev/null 2>&1
```
> Warning: You only require this cron jobs if there is no other job worker configured. See [Asynchronous Tasks](asynchronous-tasks.md) for more details.
> Warning: These two cron jobs are only **both required** if there is no other worker configured. See [Asynchronous Tasks](asynchronous-tasks.md) for more details. Please also note that additional job-workers can be configured **only in dedicated environments, not shared hostings**.
In case you've configured a job-worker (like Supervisor or Systemd), only the main Cronjob should be running paralel to the job-runner, so:
```
* * * * * /usr/bin/php /path/to/humhub/protected/yii cron/run >/dev/null 2>&1
```
> Note: Please see the [Cron Job Section](cron-jobs.md) for more information about the configuration of cron jobs.
@ -54,8 +65,7 @@ URL Rewriting (Optional)
URL rewriting can be used in order to use pretty urls. When enabled your HumHub installation will make use of urls like
`http://localhost/humhub/directory/directory` instead of `http://localhost/humhub/index.php?r=directory%2Fdirectory`.
Rename the `.htaccess.dist` file residing in your HumHub root folder to `.htaccess`
and modify the local configuration `protected/config/common.php`:
Rename the `.htaccess.dist` file residing in your HumHub root folder to `.htaccess` and modify the local configuration located at `protected/config/common.php` as follow:
```php
<?php
@ -74,4 +84,4 @@ Further Configuration Options
------------------------
Please see the [Custom Configuration Section](advanced-configuration.md) for further information about other configuration
possibilities.
possibilities.