Work Manager und Einschränkungen

LiveCycle ES (und frühere Versionen) verwendeten JMS-Warteschlangen, um Vorgänge asynchron auszuführen. In LiveCycle 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 LiveCycle 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

    LiveCycle (und frühere Versionen) verwendeten JMS-Warteschlangen, um Vorgänge asynchron auszuführen. LiveCycle 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.

    LiveCycle-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 Anwendungsserver 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 LiveCycle 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.

    Java-Optionen zu JBoss hinzufügen

    1. JBoss-Anwendungsserver beenden.

    2. Öffnen Sie den Ordner „[Anwendungsserver-Stammordner]/bin/run.bat“ (Windows) oder „run.sh“ (Linux oder UNIX) in einem Texteditor und fügen Sie die Java-Optionen den Anforderungen im Format -Dproperty=value entsprechend hinzu.

    3. Starten Sie den Server neu.

    Java-Optionen zu WebLogic hinzufügen

    1. Starten Sie die WebLogic Administration Console, indem Sie in die Adresszeile eines Browsers http://[Hostname]:[Anschluss]/console eingeben.

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

    3. Klicken Sie unter „Domain Structure“ auf „Environment“ > „Servers“ und klicken Sie dann 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 wird Health Monitor deaktiviert.

    6. Klicken Sie auf „Save“ und dann auf „Activate Changes“.

    7. Starten Sie den 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 „Java and Process Management“ > „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 klicken Sie dann auf „Save directly to the Master Configuration“.