Befehl "createSIBus"
Sie verwenden den Befehl createSIBus, um einen neuen Service Integration Bus (SIB) zu erstellen.
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 erstellt einen neuen Service Integration Bus.
Zielobjekt
Ohne
Erforderliche Parameter
- -bus Busname
- Der Name für den Service Integration Bus. Wählen Sie einen eindeutigen Namen.
Vorgegebene Parameter
Ohne.
Optionale Parameter
- -description Text
- Eine optionale Beschreibung des Busses für Verwaltungszwecke.
- -secure TRUE | FALSE
- Dieser Parameter ist für diese Version verwaltet.
- interEngineAuthAlias Name
- Der Name des Authentifizierungsalias, der für die Berechtigung der Kommunikation zwischen Messaging-Engines
im Bus verwendet wird.
Sie müssen einen Alias für die gegenseitige Authentifizierung von Messaging-Engines angeben, wenn der Bus ein Busmember der WebSphere Application Server Version 6.x ist. Wenn die Bussicherheit aktiviert ist, verwendet der Bus den Alias für die gegenseitige Authentifizierung von Messaging-Engines, um eingehende Verbindungen von anderen Messaging-Engines zu authentifizieren. Eine nicht berechtigte Messaging-Engine kann keine Verbindung zum Bus herstellen.
- -mediationsAuthAlias Name
- -securityGroupCacheTimeout Zeitlimit
- Zeitlimitwert
steht für einen Wert zwischen 0 und 99999.
Der Standardwert ist 120.
Ein höheres Zeitlimit verringert die Last der Benutzerregistry und verbessert die Leistung, wirkt sich aber nachteilig auf die Reaktionsfähigkeit des Systems bei Änderungen der Gruppenzugehörigkeit eines Benutzers aus. Zum Optimieren des Gruppencaches müssen Sie den Bedarf nach Reaktionsfähigkeit gegen Registrylast abwägen. Muss das System beispielsweise schnell auf Änderungen der Gruppenzugehörigkeit eines Benutzers reagieren, geben Sie ein Zeitlimit von 15 Minuten an. Wenn das System weniger häufig antworten muss, z. B. nur auf Änderungen, die nachts vorgenommen werden, geben Sie ein Zeitlimit von 1440 Minuten (24 Stunden) an. Bei der Einstellung 0 verfallen die Einträge im Cache nicht und verbleiben dort bis zum nächsten Neustart des Servers.
Eine Änderung dieses Wertes wird sofort wirksam und betrifft nur den Gruppencache des Busses, für den die Konfiguration geändert wurde.
- -protocol Protokoll
Die Transportkette muss einer der Transportketten entsprechen, die in den Einstellungen der Messaging-Engine für eingehende Transporte für den Server definiert sind. Für alle Server wird automatisch eine Reihe von Transportketten definiert, aber Sie können auch neue Transportketten erstellen.
Die Standardtransportkette ist InboundBasicMessaging.
- -discardOnDelete TRUE | FALSE
- Setzen Sie diese Option auf TRUE, wenn Nachrichten an einem gelöschten Nachrichtenpunkt verworfen werden können. Setzen Sie diese Option auf FALSE, wenn Nachrichten an einem gelöschten Nachrichtenpunkt an einem Systemausnahmeziel aufbewahrt werden sollen.
- highMessageThreshold Zahl
- Die maximale Anzahl von Nachrichten, die eine Messaging-Engine im Bus an diesen Nachrichtenpunkten speichern kann.
Dieser Wert wird verwendet, um den oberen Standardnachrichtenschwellenwert für eine Messaging-Engine beim Erstellen der Messaging-Engine festzulegen.
- configurationReloadEnabled TRUE | FALSE
- Setzen Sie diese Option auf TRUE, um die Konfigurationsdateien für diesen Bus dynamisch zu laden.
Wenn diese Option den Wert TRUE hat, werden bestimmte Änderungen an der Buskonfiguration angewendet, ohne dass ein Neustart der Messaging-Engines erforderlich ist. Diese Änderungen werden angewendet, wenn Ziele oder Mediationen im Bus hinzugefügt oder entfernt werden. Diese Option steuert auch, ob automatische Aktualisierungen in allen Messaging-Engines im Bus vorgenommen werden.
- -busSecurity TRUE | FALSE
- Setzen Sie diese Option auf TRUE, um die Berechtigungsrichtlinie für den Bus umzusetzen. Dies setzt außerdem voraus, dass die Verwaltungssicherheit aktiviert ist. Setzen Sie diese Option auf FALSE, wenn die Sicherheit für den Bus generell inaktiviert werden soll. Wenn die Verwaltungssicherheit inaktiviert ist, ist der Bus nicht sicher.
- -bootstrapPolicy SIBSERVICE_ENABLED | MEMBERS_AND_NOMINATED | MEMBERS_ONLY
- Definieren Sie eine der drei Optionen, um die Busmemberrichtlinie für den Bus umzusetzen.
- SIBSERVICE_ENABLED
- Jeder Server in der Zelle, für den der SIB-Service aktiviert wurde, kann zum Bearbeiten von Bootstrapanforderungen verwendet werden.
- MEMBERS_AND_NOMINATED
- Nur Busmember oder benannte Bootstrap-Server können Bootstrapanforderungen bearbeiten.
- MEMBERS_ONLY
- Nur Busmember können Bootstrapanforderungen bearbeiten.
- -useServerIdForMediations TRUE | FALSE
- Setzen Sie diese Option auf TRUE, wenn Sie Mediationen unter einer einzigen Serveridentität für den Bus ausführen möchten. Diese Option ermöglicht Ihnen, Mediationen über mehrere Sicherheitsdomänen verteilt auszuführen, ohne für jede einzelne Domänen einen Mediationsauthentifizierungsalias angeben zu müssen. Sie können eine Serveridentität verwenden, um Mediationen in der globalen Domäne auszuführen. Setzen Sie diese Option auf FALSE, wenn Sie Mediationen unter einem Mediationsauthentifizierungsalias ausführen möchten.
- -auditAllowed TRUE | FALSE
- Setzen Sie diese Option auf TRUE, um die Sicherheitsprüfung für den Bus zu aktivieren. Setzen Sie diese Option auf FALSE, um die Sicherheitsprüfung für den Bus zu inaktivieren. Der Standardwert ist TRUE. Zur Verwendung dieses Parameters benötigen Sie die Berechtigungen eines Prüfadministrators.
Beispiel
AdminTask.createSIBus('[-bus bus1 -description [A new bus] -busSecurity false ]')
'bus1(cells/cell01/buses/bus1|sib-bus.xml#SIBus_1213019988044)'