Work Manager und Drosselung

AEM Forms (und frühere Versionen) verwendeten JMS-Warteschlangen, um Vorgänge asynchron auszuführen. In AEM Forms wurden JMS-Warteschlangen durch Work Manager ersetzt. Dieses Dokument stellt Hintergrundinformationen über Work Manager und Anweisungen zum Konfigurieren von Einschränkungsoptionen für Work Manager bereit.

Informationen zu Vorgängen mit langer Lebensdauer (asynchron)

Die Vorgänge, die von Diensten in AEM Forms ausgeführt werden, können entweder Prozesse mit kurzer Lebensdauer (synchron) oder Prozesse mit langer Lebensdauer (asynchron) sein. Vorgänge mit kurzer Lebensdauer werden synchron mit demselben Thread ausgeführt, von dem sie aufgerufen wurden. Diese Vorgänge warten auf eine Antwort, bevor sie fortgesetzt werden.

Vorgänge mit langer Lebensdauer umfassen möglicherweise Systeme oder gehen über das Unternehmen hinaus, beispielsweise wenn ein Kunde ein Antragsformular für eine Hypothek ausfüllen und einreichen muss und dies Teil einer umfangreicheren Lösung ist, die mehrere automatisierte und von Menschen durchgeführte Aufgaben umfasst. Solche Vorgänge müssen fortgesetzt werden, während auf eine Antwort gewartet wird. Vorgänge mit langer Lebensdauer führen die ihnen zugrunde liegenden Aufgaben asynchron aus, dadurch können Ressourcen anderweitig genutzt werden, während sie darauf warten, beendet zu werden. Im Gegensatz zu einem Vorgang mit kurzer Lebensdauer wird ein Vorgang mit langer Lebensdauer von Work Manager nicht als abgeschlossen betrachtet, sobald er aufgerufen wird. Es muss ein externer Auslöser, z. B. ein System, das einen anderen Vorgang bei demselben Dienst anfordert oder ein Benutzer, der ein Formular sendet, eintreten, um den Vorgang zu beenden.

Informationen zu Work Manager

AEM Forms (und frühere Versionen) verwendeten JMS-Warteschlangen, um Vorgänge asynchron auszuführen. AEM Forms verwendet Work Manager, um asynchrone Vorgänge über verwaltete Threads zu planen und auszuführen.

Asynchrone Vorgänge werden wie folgt verarbeitet:

  1. Work Manager erhält ein Arbeitselement zur Ausführung.
  2. Work Manager speichert das Arbeitselement in einer Datenbanktabelle und ordnet ihm einen eindeutigen Bezeichner zu. Der Datenbankeintrag enthält alle zum Ausführen des Arbeitselements erforderlichen Informationen.
  3. Work Manager-Threads übernehmen Arbeitselemente, wenn die Threads frei werden. Vor der Übernahme der Arbeitselemente können Threads überprüfen, ob die erforderlichen Dienste gestartet wurden, ob ausreichend Heap-Größe zum Übernehmen des nächsten Arbeitselements vorhanden ist und ob ausreichend CPU-Zyklen zum Verarbeiten des Arbeitselements vorhanden sind. Work Manager wertet außerdem beim Planen der Ausführung die Attribute des Arbeitselements (z. B. die Priorität) aus.

AEM Forms-Administratoren können außerdem Work Manager-Statistiken, z. B. die Anzahl der Arbeitselemente in der Warteschlange und ihren jeweiligen Status, mithilfe von Health Monitor anzeigen. Sie können Health Monitor außerdem verwenden, um Arbeitselemente anzuhalten, fortzusetzen, es erneut zu versuchen oder sie zu löschen. (Siehe Statistiken mit Bezug auf Work Manager anzeigen.)

Einschränkungsoptionen für Work Manager konfigurieren

Sie können die Einschränkungen für Work Manager so konfigurieren, dass Arbeitselemente nur geplant werden, wenn ausreichend Arbeitsspeicherressourcen vorhanden sind. Sie können Einschränkungen konfigurieren, indem Sie die folgenden JVM-Optionen für Ihren Anwendungs-Server festlegen.

Eigenschaft

Beschreibung
 adobe.work-manager.queue-refill-interval

Gibt das Zeitintervall in Millisekunden an, das Work Manager beim Überprüfen auf neue Elemente in der Warteschlange verwendet.

Der Wert für diese Option ist eine Ganzzahl. Der Standardwert ist 1000 Millisekunden (1 Sekunde).

Wenn das Volumen asynchroner Aufrufe niedrig ist, können Sie diesen Wert erhöhen. Sie sollten den Wert beispielsweise auf einen Wert zwischen 2000 und 5000 (2 bis 5 Sekunden) erhöhen.

Wenn das Volumen asynchroner Aufrufe hoch ist, sollte der Standardwert ausreichend sein. Sie können jedoch auch einen niedrigeren Wert verwenden, sofern erforderlich. Wird der Wert zu sehr erhöht (z. B. unter 50, was zu einer Abrufhäufigkeit von 20 Mal pro Sekunde führt), wird das System zu stark überlastet.
 adobe.workmanager.debug-mode-enabled

Legen Sie diese Option auf true fest, um den Debug-Modus zu aktivieren, oder auf „false“, um den Modus zu deaktivieren.

Im Debug-Modus werden Meldungen zu Verstößen gegen Work Manager-Richtlinien sowie Anhalten-/Fortsetzen-Vorgänge in Work Manager protokolliert. Legen Sie diese Option nur beim Beheben von Problemen auf „true“ fest.
 adobe.workmanager.memory-control.enabled

Legen Sie diese Option auf true fest, um die Einschränkungen auf der Basis der unten beschriebenen Einstellungen zur Speicherbelegung zu aktivieren, oder auf false, um die Einschränkungen zu deaktivieren.
 adobe.workmanager.memory-control.high-limit

Gibt den maximalen Prozentsatz des Speicherplatzes an, der verwendet werden kann, bevor Work Manager eingehende Aufträge einschränkt.

Der Standardwert für diese Option ist 95. Dieser Wert sollte für die meisten Systeme ausreichend sein. Erhöhen Sie ihn nur, wenn Ihr System die maximale Kapazität ausnutzen soll. Wenn Sie diesen Wert erhöhen, steigt jedoch auch das Risiko, dass zu wenig Arbeitsspeicher zur Verfügung steht.

Wenn Sie AEM Forms in einer Clusterumgebung ausführen, möchten Sie möglicherweise die Einstellungen zur Begrenzung der Speicherbelegung auf anderen Knoten des Clusters anders festlegen. Sie können beispielsweise auf Knoten A und B, die in Ihrem Lastenausgleich für interaktive Arbeit programmiert sind, eine niedrigere Obergrenze festlegen. Und auf den Knoten C und D, die nicht von dem Lastenausgleich verwendet werden, jedoch für asynchrone Arbeit reserviert sind, können Sie höhere Obergrenzen festlegen.
 adobe.workmanager.memory-control.low-limit

Gibt den maximalen Prozentsatz des Speicherplatzes an, der verwendet werden kann, bevor Work Manager die Einschränkung für eingehende Aufträge aufhebt.

Der Standardwert für diese Option ist 20. Dieser Wert sollte für die meisten Systeme ausreichend sein.
Dadobe.workmanager.allocate.max-batch-size

Gibt die maximale Stapelgröße für Workmanager an. Die Standard-Stapelgröße ist 10.

Wenn der Status eines Vorgangs im Workmanager nicht aktualisiert wird, selbst, wenn die Aufgabe abgeschlossen ist, legen Sie die Stapelgröße auf 1 fest.

Java-Optionen zu JBoss hinzufügen

  1. JBoss-Anwendungsserver beenden.
  2. Öffnen Sie den Ordner „[Anwendungs-Server-Stammordner]/bin/run.bat“ (Windows) oder „run.sh“ (Linux oder UNIX) in einem Texteditor und fügen Sie die erforderlichen Java-Optionen im Format -Dproperty=value hinzu.
  3. Starten Sie den Server neu.

Java-Optionen zu WebLogic hinzufügen

  1. Starten Sie WebLogic-Administrationskonsole, indem Sie https://[host name]:[port]/console in einen Webbrowser eingeben.

  2. Geben Sie den von Ihnen erstellten Benutzernamen und das Kennwort für die WebLogic-Server-Domain ein und klicken Sie unter „Change Center“ auf „Log“ und dann auf „Lock & Edit“.

  3. Klicken Sie unter „Domain Structure“ auf Environment > Servers und anschließend im rechten Bereich auf den Namen des verwalteten Servers.

  4. Klicken Sie im nächsten Bildschirm auf die Registerkarten „Configuration“ > „Server-Start“.

  5. Fügen Sie im Feld „Arguments“ die erforderlichen Informationen am Ende des aktuellen Inhalts hinzu. Zum Deaktivieren von Health Monitor fügen Sie beispielsweise Folgendes hinzu:

    -Dadobe.healthmonitor.enabled=false deaktiviert den Health Monitor.

  6. Klicken Sie auf „Speichern“ und dann auf „Änderungen aktivieren“.

  7. Starten Sie WebLogic Managed Server neu.

Java-Optionen zu WebSphere hinzufügen

  1. Klicken Sie in der Navigationsstruktur von WebSphere Administrative Console auf „Servers“ > „Server Types“ > „WebSphere Application Servers“.
  2. Klicken Sie im rechten Fenster auf den Servernamen.
  3. Klicken Sie unter „Server Infrastructure“ auf „Arbeitsablauf für Formulare“ > „Process Definition“.
  4. Klicken Sie unter „Additional Properties“ auf Java Virtual Machine.
  5. Geben Sie in das Feld „Generic JVM Arguments“ die erforderlichen Argumente ein.
  6. Klicken Sie auf OK oder Apply und dann auf Save directly to the Master Configuration.

Auf dieser Seite