Befehl "modifySIBusMemberPolicy"

Verwenden Sie den Befehl modifySIBusMemberPolicy, um die Konfiguration der Messaging-Engines für einen Cluster zu ändern, der Member eines Service Integration Bus (SIB) ist.

Zum Ausführen des Befehls verwenden Sie das AdminTask -Objekt des wsadmin-Scripting-Clients.

[IBM i][IBM i]Der Scripting-Client wsadmin wird über die Qshell ausgeführt.

Für die Befehle des Service Integration Bus steht eine Befehlszeilenhilfe zur Verfügung:
  • Geben Sie den folgenden Befehl an der wsadmin-Eingabeaufforderung ein, um eine Liste der verfügbaren SIB-Befehle in Jython und eine Kurzbeschreibung jedes einzelnen Befehls anzuzeigen:

    print AdminTask.help('SIBAdminCommands')

  • Geben Sie für eine Übersichtshilfe zu einem bestimmten Befehl den folgenden Befehl in der wsadmin-Eingabeaufforderung ein:

    print AdminTask.help('command_name')

Nachdem Sie den Befehl verwendet haben, speichern Sie Ihre Änderungen an der Masterkonfiguration mit dem folgenden Befehl.

AdminConfig.save()

Zweck

Dieser Befehl ändert die Richtlinie für Messaging-Engines, die auf einen Cluster angewendet wird, der Member eines Service Integration Bus (SIB) ist. Sie können die Richtlinienunterstützung für Messaging-Engines aktivieren oder inaktivieren oder die Richtlinienunterstützung für Messaging-Engines verwenden, um die Konfiguration der Messaging-Engines für einen Cluster zu ändern. Beispielsweise können Sie die Richtlinie für Messaging-Engines von "Hohe Verfügbarkeit" auf "Skalierbarkeit" umstellen.

Wenn Sie die Richtlinienunterstützung für Messaging-Engines verwenden und die Richtlinie "Hohe Verfügbarkeit" auswählen, werden die Einstellungen der ersten Messaging-Engine im Cluster automatisch für die Unterstützung dieser Richtlinie gesetzt. Wenn der Cluster derzeit zusätzliche Messaging-Engines enthält, müssen Sie unter Umständen den Befehl deleteSIBEngine verwenden, um die nicht erwünschten Messaging-Engines aus dem Cluster zu entfernen und der Richtlinie zu entsprechen.

Wenn Sie die Richtlinienunterstützung für Messaging-Engines aktivieren und die Richtlinie "Skalierbarkeit" oder "Skalierbarkeit mit hoher Verfügbarkeit" auswählen, werden die Einstellungen der Messaging-Engines, die derzeit im Cluster enthalten sind, automatisch für die Unterstützung der ausgewählten Richtlinie gesetzt. Möglicherweise müssen Sie den Befehl createSIBEngine oder deleteSIBEngine verwenden, um die Anzahl der Messaging-Engines zu erreichen, die für die Einhalt der Richtlinie erforderlich sind (es muss für jeden Anwendungsserver im Cluster eine Messaging-Engine vorhanden sein). Für jede neue Messaging-Engine, die Sie erstellen, werden die Einstellungen für die Unterstützung der ausgewählten Richtlinie automatisch gesetzt.

Wenn Sie die Richtlinienunterstützung für Messaging-Engines aktivieren und die Richtlinie "Angepasst" auswählen, bleiben die Einstellungen der Messaging-Engines, die derzeit im Cluster vorhanden sind, unverändert. Sie können den Befehl createMissingSIBEnginePolicy verwenden, um die Einstellungen für jede Messaging-Engine im Cluster festzulegen, oder Sie können den Befehl createSIBEngine verwenden, um weitere Messaging-Engines zu erstellen.

Zielobjekt

Keine.

Die Konfiguration der Messaging-Engines im Cluster wird geändert, um die angegebene Richtlinie für Messaging-Engines zu implementieren.

Erforderliche Parameter

-bus Busname
Der Name des Service Integration Bus, zu dem der Cluster gehört. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
-cluster -Cluster
Der Name des Clusters, den Sie ändern möchten.

Optionale Parameter

-enableAssistance TRUE | FALSCH
Gibt an, ob die Richtlinienunterstützung für Messaging-Engines aktiviert wird oder nicht. Dieser Parameter hat zwei gültige Werte:
TRUE
Die Richtlinie für Messaging-Engines wird aktiviert. Sie müssen einen Parameter -policyName angeben.
FALSCH
Die Richtlinie für Messaging-Engines wird nicht aktiviert.
Der Standardwert ist false.
-policyName HA | SKALIERBARKEIT | SCALABILITY_HA | CUSTOM
Der Typ der Richtlinie für Messaging-Engines, die auf den Cluster angewendet werden soll. Dieser Parameter hat vier gültige Werte:
ha
Richtlinie "Hohe Verfügbarkeit" auf den Cluster anwenden.
Skalierbarkeit
Richtlinie "Skalierbarkeit" auf den Cluster anwenden.
SCALABILITY_HA
Richtlinie "Skalierbarkeit mit hoher Verfügbarkeit" auf den Cluster anwenden.
CUSTOM
Angepasste Richtlinie auf den Cluster anwenden.
Dieser Parameter hat keinen Standardwert. Verwenden Sie diesen Parameter, wenn der Parameter -enableAssistance auf TRUE gesetzt ist.

Beispiel

Sie aktivieren die Richtlinienunterstützung für Messaging-Engines für den Cluster "cluster1", der ein Member des Busses "bus1" ist, und wenden die Richtlinie "Skalierbarkeit" für Messaging-Engines an:

AdminTask.modifySIBusMemberPolicy('[-bus bus1 -cluster cluster1 
-enableAssistance true -policyName SCALABILITY ]')

Sie inaktivieren die Richtlinienunterstützung für den Cluster "cluster1", der Member des Busses "bus1" ist:

AdminTask.modifySIBusMemberPolicy('[-bus bus1 -cluster cluster1 
-enableAssistance false ]')