Erweiterungen der Broker-Administration

In Message Queue 4.0 wurden ein neuer Unterbefehl und mehrere Befehlsoptionen zum Befehlsdienstprogrammm (imqcmd) hinzugefügt, um es Administratoren zu ermöglichen, einen Broker stillzulegen (zu inaktivieren), einen Broker nach einem angegebenen Zeitraum herunterzufahren, eine Verbindung zu vernichten oder Java-Systemeigenschaften (z. B. Verbindungsbezogene Eigenschaften) festzulegen.

• Bei der Stilllegung (Inaktivierung) des Brokers wird dieser in einen inaktiven Zustand versetzt, in dem Nachrichten entfernt werden können, bevor der Broker heruntergefahren oder neu gestartet wird. Zu einem Broker, der inaktiviert wird, können keine neuen Verbindungen erstellt werden. Um den Broker zu inaktivieren, geben Sie einen Befehl ähnlich dem folgenden ein.

  imqcmd quiesce bkr -b Wolfgang:1756

• Um den Broker nach einem bestimmten Intervall herunterzufahren, geben Sie einen Befehl ähnlich dem folgenden ein. (Das Zeitintervall gibt die Anzahl an Sekunden bis zum Herunterfahren des Brokers an.)

  imqcmd shutdown bkr -b Hastings:1066 -time 90

  Wenn Sie ein Zeitintervall angeben, protokolliert der Broker eine Meldung, die darauf hinweist, wann er heruntergefahren wird. Zum Beispiel:

  Broker wird in 29 Sekunden (29996 Millisekunden) heruntergefahren.

  Während der Broker auf das Herunterfahren wartet, wird sein Verhalten folgendermaßen beeinflusst.

  • Administrative JMS-Verbindungen werden weiterhin akzeptiert.

  • Neue JMS-Verbindungen werden nicht akzeptiert.

  • Bestehende JMS-Verbindungen werden weiterhin funktionieren.

  • Der Broker kann nicht die Funktionen für einen anderen Broker in einem erweiterten Broker-Cluster übernehmen.

  • Das Dienstprogramm imqcmd wird nicht gesperrt, es wird die Anforderung zum Herunterfahren des Brokers senden und umgehend zurückgeben.

• Um eine Verbindung zu löschen, geben Sie einen Befehl ähnlich dem folgenden ein.

  imqcmd destroy cxn -n 2691475382197166336

  Verwenden Sie den Befehl imqcmd list cxn oder imqcmd query cxn, um die Verbindungs-ID abzurufen.

• Zur Angabe einer Systemeigenschaft über den Befehl imqcmd verwenden Sie die neue –D-Option. Dies ist nützlich, um die Werkseinstellungen der JMS-Verbindung oder verbindungsbezogene Java-Systemeigenschaften außer Kraft zu setzen. Beispiel:

  imqcmd list svc -secure -DimqSSLIsHostTrusted=true
  imqcmd list svc -secure -Djavax.net.ssl.trustStore=/tmp/mytruststore 
              -Djavax.net.ssl.trustStorePassword=mytrustword

Vollständige Informationen über die Syntax des Befehls imqcmd finden Sie in Kapitel 16, Command Line Reference in Sun GlassFish Message Queue 4.4 Administration Guide.