Befehl "createSIBEngine"
Verwenden Sie den Befehl createSIBEngine, um mit dem Tool "wsadmin" eine Messaging-Engine für ein Busmember des Typs "Server" oder "Cluster" zu erstellen. Wenn Sie einen Server oder einen Cluster als Member eines Service Integration Bus hinzufügen, wird automatisch mindestens eine Messaging-Engine erstellt. Verwenden Sie den Befehl createSIBEngine, um eine weitere Messaging-Engine für ein Busmember des Typs "Cluster" zu erstellen.
Jedes Busmember des Typs "Server" hat genau eine Messaging-Engine, aber Busmember des Typs "Cluster" können weitere Messaging-Engines unterstützen. Wenn Sie eine weitere Messaging-Engine für einen Cluster erstellen und einen Datenspeicher für den Nachrichtenspeicher verwenden, müssen Sie den Datenspeicher und die JDBC-Datenquelle, die die Messaging-Engine für die Interaktion mit dem Datenspeicher verwendet, explizit konfigurieren. Sie müssen die Datenquelle im Clusterbereich und nicht im Knotenbereich erstellen. Weitere Informationen zum Erstellen von Messaging-Engines finden Sie im Artikel Eine Datenquelle für eine Messaging-Engine in einem Cluster konfigurieren.
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
Der Befehl createSIBEngine erstellt eine neue Messaging-Engine für ein Busmember des Typs "Server" oder "Cluster". Verwenden Sie diesen Befehl, um eine weitere Messaging-Engine für ein Busmember des Typs "Cluster" zu erstellen.
Wenn die Richtlinienunterstützung für Messaging-Engines im Cluster aktiviert und die Richtlinie "Skalierbarkeit" oder "Skalierbarkeit mit hoher Verfügbarkeit" angegeben ist, werden die Einstellungen für die Messaging-Engine automatisch der angegebenen Richtlinie entsprechend erstellt.
Wenn die Richtlinienunterstützung für Messaging-Engines im Cluster aktiviert und die Richtlinie "Angepasst" für Messaging-Engines angegeben ist, können Sie nach der Ausführung dieses Befehls den Befehl createMissingSIBEnginePolicy verwenden, um eine Stammgruppenrichtlinie für eine Messaging-Engine zu erstellen.
Zielobjekt
Ohne.
Erforderliche Parameter
- -bus Busname
- Der Name des Service Integration Bus, in dem das Busmember konfiguriert ist. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
Vorgegebene Parameter
- -node Knotenname
- -server Servername
- Wenn Sie eine Messaging-Engine für ein Busmember des Typs "Server" erstellen möchten, geben Sie den Namen des Knotens, auf dem der Server ausgeführt wird, und den Namen des Servers an.
- -cluster Clustername
- Wenn Sie eine Messaging-Engine für ein Busmember des Typs "Server-Cluster" erstellen möchten, geben Sie den Namen des Clusters an.
Optionale Parameter
- -description Text
- Eine optionale Beschreibung der Messaging-Engine für Verwaltungszwecke.
- -initialState STARTED | STOPPED
- Der Anfangsstatus bestimmt, ob die Messaging-Engine automatisch gestartet wird,
wenn der Server bzw. Server-Cluster gestartet wird.
- STARTED
- Wenn der zugehörige Anwendungsserver gestartet ist, ist die Messaging-Engine gestartet und in der Lage, Nachrichten zu verarbeiten.
- STOPPED
- Wenn der zugehörige Anwendungsserver gestartet ist, ist die Messaging-Engine gestoppt und kann keine Nachrichten verarbeiten.
- -highMessageThreshold Anzahl
- Die maximale Anzahl von Nachrichten, die die Messaging-Engine an diesen Nachrichtenpunkten speichern kann.
Beim Erstellen der Messaging-Engine wird der obere Schwellenwert für Nachrichten des Busses verwendet, um den Standardwert für diese Eigenschaft zu definieren. Wenn ein Nachrichtenpunkt in dieser Messaging-Engine erstellt wird, wird der Wert dieser Eigenschaft verwendet, um den oberen Standardschwellenwert für Nachrichten für den Nachrichtenpunkt festzulegen.
- -failover TRUE | FALSE
- Ein Parameter, der angibt, ob die Messaging-Engine im Cluster von einem anderen Server im Cluster übernommen werden kann (Failover), wenn der Host-Server für die Messaging-Engine ausfällt.
Dieser Parameter hat zwei gültige Werte:
- TRUE
- Die Messaging-Engine kann von einem anderen Server übernommen werden.
- FALSE
- Die Messaging-Engine kann nicht von einem anderen Server übernommen werden.
Der Standardwert ist FALSE. Verwenden Sie diesen Parameter, wenn die Richtlinienunterstützung für Messaging-Engines im Cluster aktiviert ist und der Richtlinientyp "Angepasst" ausgewählt wurde. Hierfür verwenden Sie den Befehl addSIBusMember oder modifySIBusMemberPolicy.
- -failback TRUE | FALSE
- Ein Parameter, der angibt, ob die Messaging-Engine im Cluster, die von einem anderen Server übernommen wurde, auf
einen in der Liste der bevorzugten Server weiter oben stehenden Server zurückversetzt werden kann, wenn dieser Server
wieder verfügbar ist.
Dieser Parameter hat zwei gültige Werte:
- TRUE
- Die Messaging-Engine kann zurückversetzt werden. Wenn Sie diese Option verwenden, geben Sie den Parameter -preferredServerList an.
- FALSE
- Die Messaging-Engine kann nicht zurückversetzt werden.
Der Standardwert ist FALSE. Verwenden Sie diesen Parameter, wenn die Richtlinienunterstützung für Messaging-Engines im Cluster aktiviert ist und der Richtlinientyp "Angepasst" ausgewählt wurde. Hierfür verwenden Sie den Befehl addSIBusMember oder modifySIBusMemberPolicy.
- -preferredServersOnly TRUE | FALSE
- Ein Parameter, der angibt, ob die Messaging-Engine im Cluster nur auf Servern aus der Liste der bevorzugten Server oder auf einem beliebigen Server im Cluster ausgeführt werden
kann.
Dieser Parameter hat zwei gültige Werte:
- TRUE
- Die Messaging-Engine kann nur auf Servern aus der Liste der bevorzugten Server ausgeführt werden. Wenn Sie diese Option verwenden, geben Sie den Parameter "-preferredServerList" an.
- FALSE
- Die Messaging-Engine kann auf jedem Server im Cluster ausgeführt werden.
Der Standardwert ist FALSE. Verwenden Sie diesen Parameter, wenn die Richtlinienunterstützung für Messaging-Engines im Cluster aktiviert ist und der Richtlinientyp "Angepasst" ausgewählt wurde. Hierfür verwenden Sie den Befehl addSIBusMember oder modifySIBusMemberPolicy.
- -preferredServerList {{Knotenname Servername}}
- Die Liste mit den Servern, auf denen die Messaging-Engine im Cluster bevorzugt ausgeführt werden sollte. Die Liste ist in absteigender Reihenfolge sortiert. Geben Sie für jeden Server in der Liste den Namen des Knotens, auf dem der Server ausgeführt wird, und den Namen des Servers an. Für diesen Parameter gibt es keinen Standardwert. Verwenden Sie diesen Parameter, wenn die Richtlinienunterstützung für Messaging-Engines im Cluster aktiviert ist und der Richtlinientyp "Angepasst" ausgewählt wurde. Hierfür verwenden Sie den Befehl addSIBusMember oder modifySIBusMemberPolicy.
- -fileStore
- Erstellen Sie einen Dateispeicher, der als Nachrichtenspeicher für die Messaging-Engine verwendet werden soll. Ein Dateispeicher ist ein Typ von Nachrichtenspeicher, der Dateien in einem Dateisystem direkt über das Betriebssystem verwendet. Die Alternative ist die Verwendung eines Datenspeichers. Weitere Informationen finden Sie unter den zugehörigen Links.
- -logSize Größe
- Die Größe der Protokolldatei in MB. Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -logDirectory Verzeichnisname
- Der Name des Protokolldateiverzeichnisses, wenn Sie das Standardprotokollverzeichnis nicht verwenden möchten. Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -minPermanentStoreSize Größe
- Die Mindestgröße der permanenten Speicherdatei in MB. Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -minTemporaryStoreSize Größe
- Die Mindestgröße der temporären Speicherdatei in MB. Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -maxPermanentStoreSize Größe
- Die maximale Größe der permanenten Speicherdatei in MB. Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -maxTemporaryStoreSize Größe
- Die maximale Größe der temporären Speicherdatei in MB. Verwenden Sie diesen Parameter, wenn der Parameter "-fileStore" angegeben ist.
- -unlimitedPermanentStoreSize TRUE | FALSE
- Ein Parameter, der angibt, ob die Größe des permanenten Speichers unbegrenzt ist. Dieser Parameter hat zwei gültige Werte:
- TRUE
- Die Größe des permanenten Speichers ist unbegrenzt.
- FALSE
- Die Größe des permanenten Speichers ist begrenzt. Wenn Sie diese Option verwenden, geben Sie den Parameter -maxPermanentStoreSize an.
Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -unlimitedTemporaryStoreSize TRUE | FALSE
- Ein Parameter, der angibt, ob die Größe des temporären Speichers unbegrenzt ist. Dieser Parameter hat zwei gültige Werte:
- TRUE
- Die Größe des temporären Speichers ist unbegrenzt.
- FALSE
- Die Größe des temporären Speichers ist begrenzt. Wenn Sie diese Option verwenden, geben Sie den Parameter -maxTemporaryStoreSize an.
Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -permanentStoreDirectory Verzeichnisname
- Der Name des Verzeichnisses für den permanenten Speicher, wenn Sie das Standardverzeichnis für den permanenten Speicher nicht verwenden möchten. Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -temporaryStoreDirectory Verzeichnisname
- Der Name des Verzeichnisses für den temporären Speicher, wenn Sie das Standardverzeichnis für den temporären Speicher nicht verwenden möchten. Verwenden Sie diesen Parameter, wenn der Parameter -fileStore angegeben ist.
- -dataStore
- Erstellen Sie einen Datenspeicher, der als Nachrichtenspeicher für die Messaging-Engine verwendet werden soll.
Ein Datenspeicher setzt sich aus einer Reihe von Tabellen zusammen, die eine Messaging-Engine verwendet, um persistente Daten in einer Datenbank zu speichern. Der Artikel Datenspeichertabellen enthält eine Liste mit den Tabellen, aus denen sich der Datenspeicher zusammensetzt. Alle Tabellen in einem Datenspeicher werden im selben Datenbankschema gespeichert. Sie können mehrere Datenspeicher in derselben Datenbank erstellen, sofern Sie für jeden Datenspeicher einen anderen Schemanamen verwenden.
Die Alternative ist die Verwendung eines Dateispeichers (Standardeinstellung). Weitere Informationen finden Sie unter den zugehörigen Links. - -createDefaultDatasource TRUE | FALSE
- Ein Parameter, der angibt, ob eine Standarddatenquelle erstellt werden soll, wenn die Messaging-Engine erstellt wird.
Dieser Parameter hat zwei gültige Werte:
- TRUE
- Es wird eine Standarddatenquelle erstellt.
- FALSE
- Es wird keine Standarddatenquelle erstellt.
Verwenden Sie diesen Parameter, wenn der Parameter -dataStore angegeben ist. Verwenden Sie diesen Parameter nicht, wenn der Parameter -cluster angegeben ist.
- -datasourceJndiName JNDI-Name
- Der JNDI-Name der Datenquelle, die die Messaging-Engine verwendet, um auf das Verwaltungssystem für relationale Datenbanken für den Datenspeicher zuzugreifen. Verwenden Sie diesen Parameter, wenn der Parameter -dataStore angegeben ist.
- -authAlias Authentifizierungsalias
- Der Name des Authentifizierungsalias, den die Messaging-Engine verwendet, um eine Verbindung zur Datenbank in ihrem Datenspeicher herzustellen. Verwenden Sie diesen Parameter, wenn der Parameter -dataStore angegeben ist.
- -createTables TRUE | FALSE
- Ein Parameter, der angibt, ob die Datenbanktabellen für die Datenquelle automatisch erstellt werden sollen.
Dieser Parameter hat zwei gültige Werte:
- TRUE
- Datenbanktabellen für die Datenquelle erstellen
- FALSE
Datenbanktabellen für die Datenquelle nicht erstellen. Wenn Sie diese Option verwenden, muss der Datenbankadministrator die Tabellen erstellen.
Datenbanktabellen für die Datenquelle nicht erstellen. Für das Betriebssystem z/OS müssen Sie diese Option verwenden, weil Sie keine Tabellen erstellen dürfen.
Verwenden Sie diesen Parameter, wenn der Parameter -dataStore angegeben ist.
- -restrictLongDBLock TRUE | FALSE
- Dieser Parameter
gibt an, ob die aktive Messaging-Engine Sperren mit langer Laufzeit in der Tabelle
SIBOWNER in der Datenbank beibehalten muss.Wenn Sie diese Option auswählen, richtet die Messaging-Engine nur kurze Sperren für die Datenbank ein.
Wenn die aktive Messaging-Engine nicht auf die Datenbank reagiert, kann die
Standby-Messaging-Engine das Eigentumsrecht an der Datenbank übernehmen, weil die aktive
Messaging-Engine nur kurze Sperren setzt.Dieser Parameter hat zwei gültige Werte:
- TRUE
- Sperren mit langer Laufzeit in der Datenbank beschränken
- FALSE
- Sperren mit langer Laufzeit in der Datenbank nicht beschränken
Verwenden Sie diesen Parameter, wenn der Parameter -dataStore angegeben ist.
Wichtig: Trotz Auswahl der Eigenschaft ist die Eigenschaft erst wirksam, nachdem ein Upgrade der Datenbanktabellen mit dem Befehl sibDBUpgrade für WebSphere Application Server Version 9.0 und höher durchgeführt wurde. - -schemaName Schemaname
- Der Name des Datenbankschemas, das die Tabellen für den Datenspeicher enthält, wenn Sie den Standardschemanamen nicht verwenden möchten. Weitere Einzelheiten zum Standardschema finden Sie im Artikel Benutzer und Schemata in der Datenbank erstellen. Verwenden Sie diesen Parameter, wenn der Parameter -dataStore angegeben ist.
Je nach ausgewähltem Nachrichtenspeicher und dessen Attributen müssen Sie unterschiedliche Kombinationen von Parametern angeben. Wie Sie Fehler bei der Angabe des Nachrichtenspeichers für die Messaging-Engine vermeiden können, ist im Artikel Fehler beim Erstellen einer Messaging-Engine mit einem Dateispeicher oder einem Datenspeicher mit dem Tool "wsadmin" vermeiden beschrieben.
Beispiele
Eine Messaging-Engine für den Cluster mit dem Namen "cluster1" im Bus mit dem Namen "bus1" erstellen, die einen Standarddateispeicher verwendet:
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1]')
Eine Messaging-Engine für den Cluster mit dem Namen "cluster1" im Bus mit dem Namen "bus1" erstellen, die einen Dateispeicher verwendet, mit Standardeinstellungen erstellen:
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore]')
Eine Messaging-Engine für den Cluster mit dem Namen "cluster1" im Bus mit dem Namen "bus1", die einen Dateispeicher verwendet, mit Optionen erstellen:
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore
-logSize 3636363 -logDirectory C:\mylogdirectory]')
Eine Messaging-Engine für den Cluster mit dem Namen "cluster1" im Bus mit dem Namen "bus1", die einen Dateispeicher verwendet, mit Standardeinstellungen erstellen:
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore]')
Eine Messaging-Engine für den Cluster mit dem Namen "cluster1" im Bus mit dem Namen "bus1", die einen Datenspeicher verwendet, mit Optionen erstellen:
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
Verwenden Sie den folgenden Befehl, um dem Cluster "cluster1", der Member des Busses "bus1" ist und der einen Dateispeicher als Nachrichtenspeicher verwendet, eine Messaging-Engine hinzuzufügen:
AdminTask.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore ]')
Verwenden Sie den folgenden Befehl, um dem Cluster "cluster1", der Member des Busses "bus1" ist, eine neue Messaging-Engine hinzuzufügen, wobei im Cluster "cluster1" die Richtlinienunterstützung für Messaging-Engines aktiviert und die Richtlinie "Angepasst" für Messaging-Engines angegeben ist. Verwenden Sie einen Dateispeicher als Nachrichtenspeicher für die Messaging-Engine. Konfigurieren Sie die Messaging-Engine so, dass sie von anderen Servern übernommen, nicht auf einen Server mit höherer Präferenz zurückversetzt und nur in den Servern "server1" und "server2" ausgeführt werden kann.
AdminTask.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore -failover true -failback false
-preferredServersOnly true -preferredServerList [[node1 server1] [node2 server2]]]')