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.
Verwenden Sie zum Ausführen des Befehls das Objekt AdminTask des Scripting-Clients wsadmin.
Der Scripting-Client wsadmin wird über die Qshell ausgeführt.
Weitere Informationen finden Sie unter Qshell für die Ausführung von WebSphere-Scripts mit wsadmin-Scripting konfigurieren.
- 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')
- Zum Anzeigen einer übersichtlichen Hilfe zu einem bestimmten Befehl geben Sie an der
wsadmin-Eingabeaufforderung den folgenden Befehl ein:
print AdminTask.help('Befehlsname')
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
Ohne.
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 | FALSE
- 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.
- FALSE
- Die Richtlinie für Messaging-Engines wird nicht aktiviert.
- -policyName HA | SCALABILITY | 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.
- SCALABILITY
- 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.
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 ]')