content.ini [ContentJobSettings] #

Der Block [ContentJobSettings] von settings/content.ini, mit 12 Einstellung(en).

Bearbeiten Sie settings/content.ini nie selbst: Ein Update ersetzt die Datei. Schreiben Sie die Einstellungen, die Sie ändern, in ein Override, das Vorrang vor der ausgelieferten Datei hat:

• settings/override/content.ini.append.php für jeden Siteaccess,
• settings/siteaccess/<siteaccess>/content.ini.append.php für einen Siteaccess,
• extension/<extension>/settings/content.ini.append.php in einer Erweiterung (gelesen, wenn die Erweiterung aktiv ist).

SynchronousLimit #

Inhaltsaufträge: Das Entfernen großer Teilbäume (content/removeobject, content/removenode) und das Kopieren von Teilbäumen
(content/copysubtree) läuft stapelweise in einem Hintergrund-Worker statt in der Web-Anfrage, sodass es
nie an einer Zeitgrenze der Anfrage, einer Speichergrenze oder einer riesigen Transaktion scheitert. Jeder Stapel ist eine
eigene Transaktion, gefolgt von einem Prüfpunkt: Ein Auftrag macht nach jeder
Unterbrechung (auch kill -9) dort weiter, wo er aufgehört hat. Klassen in kernel/classes/contentjob/; der Befehl
bin/php/expcontentjob.php (./console exp:expcontentjob list|show|run|resume|cancel|remove|copy).
Aufträge liegen in var/<site var dir>/jobs/content/ (ein Cluster braucht dafür ein gemeinsames var-Verzeichnis).

Der Benutzer wählt pro Operation, ob sie jetzt (in der Anfrage) oder als Hintergrundauftrag läuft; dies
legt die zuerst angebotene Wahl fest: unter dieser Zahl von Knoten „jetzt“, ab ihr „Auftrag“. 0 = immer „Auftrag“.

Standard: 50.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
SynchronousLimit=50
*/ ?>

NowLimit #

„Jetzt“ wird über dieser Zahl von Knoten abgelehnt, mit dem Hinweis, es als Auftrag auszuführen. 0 = keine Obergrenze.

Standard: 1000.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
NowLimit=1000
*/ ?>

BatchSize #

Knoten pro Stapel (jeder eine Transaktion). Auf SQLite (ein Schreiber zur Zeit) halbiert der Worker den nächsten Stapel,
solange einer die Schreibsperre über 2 s hält, und vergrößert ihn wieder bis BatchSize, wenn sie wieder schnell sind.

Standard: 50.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
BatchSize=50
*/ ?>

BatchPause #

Pause zwischen den Stapeln in Millisekunden (0 = keine), um anderen Schreibern Raum zu lassen.

Standard: 0.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
BatchPause=0
*/ ?>

QueuedGrace #

Einen wartenden Auftrag, dessen Worker nicht innerhalb so vieler Sekunden gestartet ist, startet der Cronjob-Teil
'contentjobs' (Gruppe frequent); ein laufender Auftrag, dessen Worker gestorben ist, wird sofort gestartet.

Standard: 60.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
QueuedGrace=60
*/ ?>

QueuedTimeout #

Ein wartender Auftrag, den innerhalb so vieler Sekunden kein Worker gestartet hat (keine Cronjob-Läufe, der Start ging verloren), schlägt fehl
und gibt seine Sperren zurück, wenn er noch nichts getan hat, sodass er nie einen Teilbaum blockiert; setzen Sie ihn fort, um es erneut zu versuchen.
Ein Worker, der gar nicht gestartet werden kann, lässt den Auftrag sofort fehlschlagen, mit dem Grund. 0 = läuft nie ab.

Standard: 600.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
QueuedTimeout=600
*/ ?>

MaxAttempts #

Ein Auftrag, dessen Worker so oft gestartet wird, ohne einen Stapel abzuschließen, wird als fehlgeschlagen markiert (mit dem
letzten Fehler), statt endlos wiederholt zu werden. Setzen Sie ihn fort, sobald die Ursache behoben ist.
Es ist auch, wie oft der Cronjob-Teil einen Auftrag von selbst fortsetzt, der an einem vorübergehenden Datenbankfehler
scheiterte (belegt, gesperrt, ein Deadlock); die Zählung beginnt nach jedem fertigen Stapel neu.

Standard: 5.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
MaxAttempts=5
*/ ?>

BusyRetries #

Ein Stapel, der scheitert, weil die Datenbank belegt oder gesperrt ist (SQLite "database is busy" oder "locked",
MySQL Zeitüberschreitung beim Warten auf eine Sperre 1205 oder Deadlock 1213), wird zurückgerollt und ab dem letzten Checkpoint
bis zu so vielen Malen erneut ausgeführt, nach einer Pause, die sich jedes Mal verdoppelt (1, 2, 4 ... Sekunden). Dann schlägt der Auftrag
mit einem vorübergehenden Fehler fehl, den der Cronjob-Teil von selbst fortsetzt. 0 = beim ersten solchen Fehler fehlschlagen.

Standard: 8.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
BusyRetries=8
*/ ?>

BusyBackoffMax #

Die längste Pause zwischen zwei dieser Versuche, in Sekunden.

Standard: 60.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
BusyBackoffMax=60
*/ ?>

KeepDays #

Abgeschlossene (fertige oder abgebrochene) Aufträge entfernt der Cronjob-Teil nach so vielen Tagen. 0 = nie.

Standard: 30.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
KeepDays=30
*/ ?>

PhpBinary #

Die PHP-Kommandozeilen-Binärdatei für den Worker; leer = das PHP, das die Anfrage ausführt (PHP_BINDIR/php).

Standard: leer.

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
PhpBinary=
*/ ?>

JobTypes #

Die Job-Typen: JobTypes[<name>]=<Klasse, die expContentJobType implementiert>.
Eine Paketinstallation im Hintergrund (Setup > Pakete > Installieren, „Im Hintergrund installieren“), doc/eng-us/bc/6.0/package-json-format.md
Ein Export der Audit-Konsole im Hintergrund (Audit > Export, „Im Hintergrund exportieren“), doc/eng-us/bc/6.0/audit.md
Die Handbücher der Hilfe, im Hintergrund aus der Markdown-Hilfe gebaut (eine neue Installation reiht es ein), doc/eng-us/features/6.0/help-content.md
Ein Hintergrundlauf eines Import- oder Export-Werkzeugs (Export, CIE ...), wenn es keine Job-Warteschlange gibt,
doc/eng-us/features/6.0/transfer-runs.md (transfer.ini)
Eine Massenaktion von Dashboard > Neue Inhalte auf mehr als [ModerationSettings] JobThreshold Objekte, doc/eng-us/features/6.0/moderation.md

Standard: ein Hash mit 14: remove=expContentJobRemoveSubtree, copy=expContentJobCopySubtree, move=expContentJobMoveSubtree, hide=expContentJobHideSubtree, reveal=expContentJobRevealSubtree, section=expContentJobSectionSubtree, state=expContentJobStateSubtree, addlocation=expContentJobAddLocation, removelocation=expContentJobRemoveLocation, packageinstall=expContentJobPackageInstall, auditexport=expContentJobAuditExport, helpmanuals=expContentJobHelpManuals ....

<?php /* #?ini charset="utf-8"?
# settings/override/content.ini.append.php
[ContentJobSettings]
# ein leeres "JobTypes[]" zuerst ersetzt die ausgelieferte Liste; ohne es werden die Einträge hinzugefügt
JobTypes[]
JobTypes[remove]=expContentJobRemoveSubtree
JobTypes[copy]=expContentJobCopySubtree
JobTypes[move]=expContentJobMoveSubtree
JobTypes[hide]=expContentJobHideSubtree
JobTypes[reveal]=expContentJobRevealSubtree
JobTypes[section]=expContentJobSectionSubtree
JobTypes[state]=expContentJobStateSubtree
JobTypes[addlocation]=expContentJobAddLocation
JobTypes[removelocation]=expContentJobRemoveLocation
JobTypes[packageinstall]=expContentJobPackageInstall
JobTypes[auditexport]=expContentJobAuditExport
JobTypes[helpmanuals]=expContentJobHelpManuals
JobTypes[transfer]=expContentJobTransfer
JobTypes[moderation]=expContentJobModeration
*/ ?>

Siehe auch #

• Alle Blöcke von content.ini
• Alle INI-Dateien
• Die Einstellungsseite

Erzeugt von ./console exp:help:examples --language=ger-de aus settings/content.ini. Bearbeiten Sie diese Seite nicht: Ändern Sie die Quelle oder die deutsche Übersetzung und erzeugen Sie sie neu (wie). Freie Dokumentation: GFDL 1.3 oder später.