Befehl "migrateServerMEtoCluster"
Wenn ein Server, der Member eines Busses ist, in einen Cluster konvertiert wird, verwenden Sie den Befehl migrateServerMEtoCluster, um die Messaging-Engine im Server in den Geltungsbereich des Clusters zu migrieren. Während der Konvertierung wird die Buszugehörigkeit nicht automatisch in den Clustergeltungsbereich übertragen. Wenn Sie den Cluster als Member des Busses verwenden möchten, verwenden Sie diesen Befehl, um diese Umstellung durchzuführen.
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.
Dieser Befehl ist nur gültig, wenn er mit Anwendungsservern der WebSphere Application Server Version 7.0 oder höher verwendet wird. Verwenden Sie diesen Befehl nicht in früheren Versionen.
- 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
Der Befehl migrateServerMEtoCluster migriert eine Messaging-Engine eines Servers in den Geltungsbereich eines Clusters. Dies ist hilfreich, wenn ein Server, der Member eines Service Integration Bus ist, in einen Cluster konvertiert wurde. Bei der Konvertierung in einen Cluster wird der Cluster nicht automatisch als Member des Busses definiert. Verwenden Sie diesen Befehl, um die Buszugehörigkeit auf den Cluster zu übertragen. Sie können dies tun, um eine hohe Verfügbarkeit der Messaging-Engine zu gewährleisten oder um dem Cluster für die Skalierbarkeit weitere Messaging-Engines hinzuzufügen. In dieser Situation dürfen Sie die Messaging-Engine auf Serverebene nicht löschen und auf Clusterebene erneut erstellen, weil die eindeutige ID (UUID) der Messaging-Engine verloren gehen und die Messaging-Engine mit den zuvor konfigurierten Zielen nicht mehr funktionieren würde.
Der Befehl migrateServerMEtoCluster macht den neuen Server-Cluster zum Member des Busses.
Dieser Befehl ist beispielsweise hilfreich, wenn ein Server, der Member eines Busses ist, unter Verwendung der Option für den Einschluss in den Bus in eine Zelle eingebunden und anschließend auf ein Member eines Busses hochgestuft wird, indem ein neuer Cluster mit diesem Server als erstem Member erstellt wird.
Zielobjekt
Eine Messaging-Engine.
Die Messaging-Engine wird auf die Ebene des Clusters kopiert, und alle Lokalisierungsreferenzen auf Ziele werden kopiert, sodass sichergestellt ist, dass die Messaging-Engine mit den zuvor konfigurierten Zielen funktioniert. Die Definition der Messaging-Engine auf Serverebene wird gelöscht.
Erforderliche Parameter
- -bus Busname
- Der Name des Service Integration Bus, zu dem der Server gehört, wenn dieser Server die zu migrierende Messaging-Engine enthält. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
- -node Knotenname
- Der Name des Knotens, auf dem der Server ausgeführt wird, wenn dieser Server die zu migrierende Messaging-Engine enthält.
- -server Servername
- Der Name des Servers, der die zu migrierende Messaging-Engine enthält.
Der Server muss Member des angegebenen Busses sein, auf dem angegebenen Knoten ausgeführt werden und bereits in den Cluster konvertiert worden sein, der mit dem Befehl angegebenen wurde.
- -cluster Clustername
- Der Name des Server-Clusters, in den der Server konvertiert wurde und
in den Sie die Messaging-Engine migrieren möchten.
Der Cluster muss vorhanden und der Server ein Member des Clusters sein. Der Cluster darf noch kein Member des Service Integration Bus sein, zu dem der Server gehört.
Optionale Parameter
- -rename TRUE | FALSE
- Gibt an, ob die Messaging-Engine und die Nachrichtenpunkte umbenannt und die Namenskonventionen für diese Ressourcen in einem Cluster verwendet werden sollen.
Der Name einer Messaging-Engine in einem Server, der die Namenskonvention
Knotenname.Servername-Busname verwendet, wird
beispielsweise auf die Namenskonvention Clustername.nnn-Busname umgestellt.
- TRUE
- Die Messaging-Engine und die Nachrichtenpunkte werden unter Verwendung der Namenskonventionen für diese Ressourcen in einem Cluster umbenannt.
- FALSE
- Die Messaging-Engine und die Nachrichtenpunkte werden nicht unter Verwendung der Namenskonventionen für diese Ressourcen in einem Cluster umbenannt.
Beispiel
Migrieren Sie eine Messaging-Engine, die derzeit auf "node1, server1" konfiguriert ist, auf "cluster1", und benennen Sie die Messaging-Engines und alle zugehörigen Nachrichtenpunkte unter Verwendung der Clusterterminologie um. Der Server "Server1" ist Member des Busses "bus1" und wurde bereits in den Cluster "cluster1" konvertiert. Cluster1 ist noch kein Member von bus1.
AdminTask.migrateServerMEtoCluster ('-bus bus1 -node node1 -server server1 -cluster cluster1 -rename TRUE')