Befehl "modifySIBus"
Verwenden Sie den Befehl modifySIBus, um die Eigenschaften eines Service Integration Bus zu ändern.
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 Eigenschaften eines Service Integration Bus.
Zielobjekt
Ein Bus.
Erforderliche Parameter
- -bus Busname
- Der Name des Service Integration Bus. Mit dem Befehl listSIBuses können Sie die Namen vorhandener Busse auflisten.
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.
- -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
- -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.
- -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 gesichert.
- -permittedChains ALL | SSL_ENABLED | LISTED
- Definieren Sie eine der drei Optionen, um eine Transportrichtlinie für den Bus umzusetzen.
- ALL
- Es können alle definierten Transportkanalketten verwendet werden.
- SSL_ENABLED
- Die Verwendung definierter Transportkanalketten ist auf die Ketten beschränkt, die durch SSL geschützt sind.
- LISTED
- Die Verwendung definierter Transportkanalketten ist auf die Liste geschützter Transporte beschränkt.
- -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.modifySIBus('[-bus bus1 -description [Eine neue Beschreibung des Busses]]')
'bus1(cells/cell01/buses/bus1|sib-bus.xml)'