From f4466b86e34e0c12b09b8d0641ff7f7b1cdb912b Mon Sep 17 00:00:00 2001 From: Tobias Diekershoff Date: Thu, 13 Apr 2017 07:52:38 +0200 Subject: [PATCH 1/5] some EN doc about the worker --- doc/Settings.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/doc/Settings.md b/doc/Settings.md index 365256272..820cef698 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -133,6 +133,9 @@ By default, any (valid) email address is allowed in registrations. If you enable the `Allow Users to set remote_self` users can select Atom feeds from their contact list being their *remote self* in die advanced contact settings. Which means that postings by the remote self are automatically reposted by Friendica in their names. +This feature can be used for let the user mirror e.g. blog postings into her Friendica postings. +It is disabled by default, as it casus additional load on the server and may be mis-used to distribute SPAM. + As admin of the node you can also set this flag directly in the database. Before doing so, you should be sure you know what you do and have a backup of the database. @@ -167,6 +170,19 @@ This will mean you cannot connect (at all) to self-signed SSL sites. ### Worker +This section allows you to configure the background process that is triggered by the `cron` job that was created during the installation. +The process does check the available system resources before creating a new worker for a task. +Because of this, it may happen that the maximom number of worker processes you allow will not be reached. + +If your servers setup does not allow you to use the `proc_open` function of PHP, please disable it in this section. + +The tasks for the background process have priorities. +To guarantee that important tasks are executet even though the system has a lot of work to do, it is useful to enable the *fastlane*. + +Should you not be able to run a cron job on your server, you can also activate the *frontend* worker. +If you have done so, you can call `example.com/worker` (replace example.com with your actual domain name) on a regular basis from an external servie. +This will then trigger the execution of the background process. + ### Relocate ## Users From 09da31442e69033331b8f3bb2897b3112f38512d Mon Sep 17 00:00:00 2001 From: Tobias Diekershoff Date: Sun, 16 Apr 2017 13:47:57 +0200 Subject: [PATCH 2/5] Worker auf Deutsch --- doc/de/Settings.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/de/Settings.md b/doc/de/Settings.md index 68e17adc7..f70b44f24 100644 --- a/doc/de/Settings.md +++ b/doc/de/Settings.md @@ -162,6 +162,19 @@ Das führt dazu, dass du keinerlei Verbindung zu einer selbst unterzeichneten SS ### Worker +In diesem Abschnitt kann der Hintergrund-Prozess konfiguriert werden. +Bevor ein neuer *Worker* Prozess gestartet wird, überprüft das System, dass die vorhandenen Resourchen ausrechend sind, +Aus diesem Grund kann es sein, dass die maximale Zahl der Hintergrungprozesse nicht erreicht wird. + +Sollte die PHP Funktion `proc_open` auf dem Server nicht verfügbar sein, kann die Verwendung durch Friendica hier unterbunden werden. + +Die Aufgaben die im Hintergrund erledigt werden, haben Prioritäten zugeteilt. +Um garantieren zu können, das wichtige Prozesse schnellst möglich abgearbeitet werden können, selbst wenn das System gerade stark belastet ist, sollte die *fastlane* aktiviert sein. + +Wenn es auf deinem Server nicht möglich ist, einen cron Job zu starten, kannst du den *frontend* Worker einschalten. +Nachdem dies geschehen ist, kannst du `example.com/worker` (tausche example.com mit dem echten Domainnamen aus) aufrufen werden. +Dadurch werden dann die Aufgaben aktiviert, die der cron Job sonst aktivieren würde. + ### Umsiedeln ## Nutzer From 5a0af71aded3a33288b7813d21706a48b7190c89 Mon Sep 17 00:00:00 2001 From: Tobias Diekershoff Date: Sun, 16 Apr 2017 13:54:12 +0200 Subject: [PATCH 3/5] remote_self paragraph was missing in DE --- doc/de/Settings.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/de/Settings.md b/doc/de/Settings.md index f70b44f24..29e99c8af 100644 --- a/doc/de/Settings.md +++ b/doc/de/Settings.md @@ -126,6 +126,10 @@ Wildcards werden akzeptiert (Wildcard-Unterstützung unter Windows benötigt PHP Webb du die Option `Nutzern erlauben das remote_self Flag zu setzen` aktivierst, können alle Nutzer Atom Feeds in den erweiterten Einstellungen des Kontakts als "Entferntes Konto" markieren. Dadurch werden automatisch alle Beiträge dieser Feeds für diesen Nutzer gespiegelt und an die Kontakte bei Friendica verteilt. +Dieses Feature kann z.B. dafür genutzt werden Blogbeiträge zu spiegeln. +In der Grundeinstellung ist es nicht aktiviert, da es zusätzliche Last auf dem Server verursachen kann. +Außerdem könnte es durch Nutzer als SPAM Verteiler missbraucht werden. + Als Administrator der Friendica Instanz kannst du diese Einstellungen ansonsten nur direkt in der Datenbank vornehmen. Bevor du das tust solltest du sicherstellen, dass du ein Backup der Datenbank hast und genau weißt was die Änderungen an der Datenbank bewirken, die du vornehmen willst. From f3393106ae7ba3c906734563447d3836909ad9f8 Mon Sep 17 00:00:00 2001 From: Tobias Diekershoff Date: Sun, 16 Apr 2017 13:59:52 +0200 Subject: [PATCH 4/5] typos --- doc/Settings.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/Settings.md b/doc/Settings.md index 820cef698..13424a5a4 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -133,8 +133,8 @@ By default, any (valid) email address is allowed in registrations. If you enable the `Allow Users to set remote_self` users can select Atom feeds from their contact list being their *remote self* in die advanced contact settings. Which means that postings by the remote self are automatically reposted by Friendica in their names. -This feature can be used for let the user mirror e.g. blog postings into her Friendica postings. -It is disabled by default, as it casus additional load on the server and may be mis-used to distribute SPAM. +This feature can be used to let the user mirror e.g. blog postings into their Friendica postings. +It is disabled by default, as it causes additional load on the server and may be misused to distribute SPAM. As admin of the node you can also set this flag directly in the database. Before doing so, you should be sure you know what you do and have a backup of the database. @@ -172,12 +172,12 @@ This will mean you cannot connect (at all) to self-signed SSL sites. This section allows you to configure the background process that is triggered by the `cron` job that was created during the installation. The process does check the available system resources before creating a new worker for a task. -Because of this, it may happen that the maximom number of worker processes you allow will not be reached. +Because of this, it may happen that the maximum number of worker processes you allow will not be reached. -If your servers setup does not allow you to use the `proc_open` function of PHP, please disable it in this section. +If your server setup does not allow you to use the `proc_open` function of PHP, please disable it in this section. The tasks for the background process have priorities. -To guarantee that important tasks are executet even though the system has a lot of work to do, it is useful to enable the *fastlane*. +To guarantee that important tasks are executed even though the system has a lot of work to do, it is useful to enable the *fastlane*. Should you not be able to run a cron job on your server, you can also activate the *frontend* worker. If you have done so, you can call `example.com/worker` (replace example.com with your actual domain name) on a regular basis from an external servie. From d5c2b9d4cd9881614a8c791dc54d9ed2c4c0e4b8 Mon Sep 17 00:00:00 2001 From: Tobias Diekershoff Date: Mon, 17 Apr 2017 07:33:12 +0200 Subject: [PATCH 5/5] Ham --- doc/de/Settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/de/Settings.md b/doc/de/Settings.md index 29e99c8af..a63905055 100644 --- a/doc/de/Settings.md +++ b/doc/de/Settings.md @@ -128,7 +128,7 @@ Dadurch werden automatisch alle Beiträge dieser Feeds für diesen Nutzer gespie Dieses Feature kann z.B. dafür genutzt werden Blogbeiträge zu spiegeln. In der Grundeinstellung ist es nicht aktiviert, da es zusätzliche Last auf dem Server verursachen kann. -Außerdem könnte es durch Nutzer als SPAM Verteiler missbraucht werden. +Außerdem könnte es durch Nutzer als Spam Verteiler missbraucht werden. Als Administrator der Friendica Instanz kannst du diese Einstellungen ansonsten nur direkt in der Datenbank vornehmen. Bevor du das tust solltest du sicherstellen, dass du ein Backup der Datenbank hast und genau weißt was die Änderungen an der Datenbank bewirken, die du vornehmen willst.