X4 Server kontrolliert herunterfahren (via JMX)

Ein kontrolliertes Herunterfahren des X4 Servers im laufenden Betrieb stellt sicher, dass alle aktuell ausgeführten Prozesse vollständig ausgeführt und keine Prozesse mehr gestartet werden.

Voraussetzungen zum Herunterfahren

Es muss bei allen Prozessen, die nicht während der Ausführung abgebrochen werden dürfen, die Eigenschaft Can Stop deaktiviert sein. Zudem müssen Endlosprozesse so modelliert sein, dass sie in regelmäßigen Abständen die Verarbeitung unterbrechen, damit sie gestoppt werden können.

Je nach Warteschlangen-Adapter ist dies wie folgt möglich:

• JMS und RequestReply Transfer: In Parameter timeout eine entsprechende Zeitbeschränkung setzen. Wenn der Adapter den Status 0 zurückgibt, ist die Warteschlange leer und die Prozesskontrolle wird dem Adapter zurückgegeben, sodass der Prozess anhalten kann.

• MQ Series Transfer und WebSphere MQ: Parameter MQGetMessageOptions.options.MQC.MQGMO_WAIT aktivieren, um das Warten auf eine Nachricht zu aktivieren, und in Parameter MQGetMessageOptions.waitInterval eine Zeitdauer in Millisekunden angeben, die beim Auslesen gewartet wird, bis eine geeignete Nachricht ankommen kann.

1. Die MBean X4Management aufrufen:

   • Das Werkzeug jconsole starten.

   • JMX MBean X4Management in einer Domain de.softproject.X4 aufrufen.

2. Die MBean-Methode setAllOutOfService() ausführen.
   Für alle Prozesse wird damit die Eigenschaft OutOfService gesetzt. Dies bewirkt, dass keine Prozesse mehr gestartet werden.

3. Die MBean-Methode stopAllProcesses() ausführen.
   Alle momentan ausgeführten Prozesse, die abgebrochen werden dürfen, werden damit beendet.

4. Warten, bis die MBean-Methode runningWorkflowCount() 0 anzeigt.
   Nun wird kein Prozess mehr ausgeführt.

   
   

   

   Alternativ können Sie auch die Methode shutdownAllProcesses(longtimeoutInMS) aufrufen. Dies bewirkt, dass die MBean-Methoden setAllOutOfService(), stopAllProcesses() und runningWorkflowCount() nacheinander ausgeführt werden.

   • In ParamValue eine Zeitbegrenzung in Millisekunden angeben, die die Methode als Parameter longtimeoutInMS erhält.

   • Auf Invoke klicken, um die Methode auszuführen. Diese gibt True zurück, wenn runningWorkflowCount() innerhalb der Zeitbeschränkung 0 anzeigt.

5.  X4 Server herunterfahren.