WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Befehl mqsiwebuseradmin - Windows-, Linux- und UNIX-Systeme

Mit dem Befehl mqsiwebuseradmin können Sie Benutzeraccounts für die Webbenutzerschnittstelle auf Linux-, UNIX- oder Windows-Systemen verwalten.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-mqsiwebuseradmin--| brokerSpec |--+- -l +-------------------->
                                     +- -c +   
                                     +- -m +   
                                     '- -d-'   

>--+-------------------+--+---------------+--+------------+----->
   '- -u -Benutzername-'  '- -a -Kennwort-'  '- -r -Rolle-'   

>--+--------------------+--+------------------------+----------><
   '- -w --ZeitlimitSek-'  '- -v -- Tracedateiname -'   

brokerSpec

|--+- Brokername -----------------+-----------------------------|
   +- -n --Brokerdateiname--------+   
   | .--------------------------. |   
   | V                          | |   
   '-----+- -i --IP-Adresse-+---+-'   
         +- -p --Port-------+         
         '- -q --WS-Manager-'         

Parameter

brokerSpec
(Erforderlich) Zur Identifizierung des Zielbrokers müssen Sie für diesen Befehl mindestens einen Parameter in einer der folgenden Formen angeben:
Brokername
Dieser Parameter gibt den Namen eines lokal definierten Brokers an. Diese Option kann nicht verwendet werden, wenn sich der Broker auf einem fernen Computer befindet.
-n Brokerdateiname
Dieser Parameter gibt den Namen einer Datei an, welche die Verbindungsdetails für einen lokalen oder fernen Broker enthält.

Verwenden Sie diese Option, wenn sich mehrere Benutzer mit demselben Broker verbinden möchten, oder wenn Sie erweiterte Verbindungsparameter wie beispielsweise SSL verwenden.

Klicken Sie zur Erstellung dieser Datei mit der rechten Maustaste auf den Broker imWebSphere Message Broker Explorer und wählen Sie *.broker-Datei exportieren aus. Wenn Sie dazu aufgefordert werden, navigieren Sie zu der Position, an der Sie die Datei speichern möchten, und geben Sie den Dateinamen ein; die Erweiterung .broker wird automatisch angehängt, wenn Sie auf Speichern klicken. Geben Sie bei der Festlegung dieses Parameters die Position (den Pfad) und den Dateinamen an. Bei der Ausführung dieses Befehls muss die Position unbedingt zugänglich sein.

Wenn Sie einen Befehl ausführen möchten, der SSL zur Verwaltung eines fernen Brokers über einen gesicherten Kanal verwendet, müssen Sie das Schlüsselspeicher- und Truststore-Kennwort für die Verbindung mithilfe der IBM_JAVA_OPTIONS-Umgebungsvariable angeben. Weitere Informationen finden Sie im Abschnitt Probleme bei der Befehlsausführung beheben.

-i IP-Adresse, -p Port, -q WS-Manager
Mit diesen Parametern werden die Verbindungsdetails für den Broker angegeben.

Nutzen Sie diese Option für Verbindungen mit fernen Brokern, die keine erweiterten Verbindungsparameter erfordern.

Bei Auswahl dieser Option müssen Sie mindestens einen dieser drei Parameter angeben. Die Reihenfolge ist dabei nicht relevant. Kein Parameter darf mehrmals angegeben werden.

Für die nicht angegebenen Parameter werden die Standardwerte übernommen:

  • -i IP-Adresse: Der Hostname oder die IP-Adresse des Computers, auf dem der Broker ausgeführt wird. Wenn Sie diesen Parameter nicht angeben, wird ein Wert verwendet, der den lokalen Computer repräsentiert.
  • -p Port: Der TCP-Port, auf dem der WS-Manager des Brokers empfangsbereit ist. Wenn Sie diesen Parameter nicht angeben, wird der Wert 1414 verwendet.
  • -q WS-Manager: Der Name des Broker-WS-Managers. Wenn Sie diesen Parameter nicht angeben, wird ein Wert verwendet, der den Standard-WS-Manager auf dem lokalen Computer repräsentiert.
-l
(Optional) Listet die im Broker definierten Webbenutzer sowie die Rollen auf, denen sie zugeordnet sind. Falls der Parameter -u (Benutzer) oder -r (Rolle) angegeben ist, wird die Liste nach diesem Benutzer bzw. dieser Rolle gefiltert.
-c
(Optional) Erstellt einen Webbenutzeraccount, der sich in der Webbenutzerschnittstelle anmelden und REST-API-Aufrufe vornehmen kann. Wenn Sie diesen Parameter verwenden, müssen Sie auch die Parameter -u und -a angeben. Wenn Sie den Parameter -r beim Erstellen eines Webbenutzeraccounts nicht angeben, wird eine Standardrolle mit dem gleichen Namen wie der Webbenutzeraccount erstellt. In diesem Fall muss der von Ihnen erstellte Webbenutzeraccount den gleichen Namen wie der Systembenutzeraccount haben, der im System angegeben wurde.
-m
(Optional) Ändert einen Webbenutzeraccount. Wenn Sie diesen Parameter verwenden, müssen Sie mit dem Parameter -u den Benutzeraccount angeben. Sie müssen außerdem einen Wert für mindestens einen der Parameter -a und -r angeben, abhängig davon, welchen Parameter Sie ändern.
-d
(Optional) Löscht einen Webbenutzeraccount. Wenn Sie diese Option verwenden, müssen Sie auch mit dem Parameter -u den Benutzeraccount angeben.
-u Benutzername
(Optional) Gibt den Namen eines Webbenutzeraccounts an. Dieser Parameter ist bei der Angabe der Parameter -c, -d oder -m erforderlich.
-a Kennwort
(Optional) Gibt einen Webbenutzeraccount an. Dieser Parameter ist bei Angabe des Parameters -c erforderlich.
-r Rolle
(Optional) Gibt eine Rolle an, die dem Webbenutzeraccount zugeordnet werden muss. Die Rolle ist der Systembenutzeraccount, dessen Berechtigungen für die Verwaltungssicherheit geprüft werden. Jedem Webbenutzeraccount ist eine einzelne Rolle zugeordnet und mehreren Webbenutzeraccounts kann die gleiche Rolle zugewiesen werden.

Wenn Sie den Parameter -r beim Erstellen eines Webbenutzeraccounts (durch die Angabe des Parameters -c) nicht angeben, wird eine Standardrolle mit dem gleichen Namen wie der Webbenutzeraccount erstellt. In diesem Fall muss der von Ihnen erstellte Webbenutzeraccount den gleichen Namen wie der Systembenutzeraccount haben, der im System angegeben wurde.

Weitere Informationen zu den Rollen finden Sie im Abschnitt Rollenbasierte Sicherheit.

-v Tracedateiname
(Optional) Dieser Parameter sendet interne Debug-Trace-Informationen an die angegebene Datei.
-w ZeitlimitSekunden
(Optional) Dieser Parameter definiert die maximale Zeitdauer in Sekunden, die der Befehl auf den Abschluss der Anforderung durch den Broker wartet, bevor er eine Rückgabe ausgibt.

Für diesen Parameter können Sie einen Wert im Bereich zwischen 1 und 2 145 336 164 festlegen. Wenn Sie keinen Zeitlimitwert angeben oder der Wert kleiner als 1 oder größer als 2 145 336 164, wird ein Fehler zurückgegeben.

Legen Sie für diesen Parameter einen Wert fest, der größer als die Summe der Zeitlimitparameter ConfigurationChangeTimeout und InternalConfigurationTimeout der Konfiguration ist, die Sie für den Broker angegeben haben, um sicherzustellen, dass eine Antwort innerhalb des Zeitlimitwerts zurückgegeben wird. Wenn ein geringerer Wert festgelegt wird, kann in der zurückgegebenen Antwort angezeigt werden, dass der Status der Implementierungsanforderungen unbekannt ist.

Beispiele

Erstellen Sie einen Account und ein Kennwort für den Webbenutzer und geben Sie die zugeordnete Rolle an (Systembenutzeraccount):
mqsiwebuseradmin MB8BROKER -c -u webuser1 -r admin -a passw0rd

Im vorherigen Beispiel entspricht der Wert admin einem Systemaccount.

Ändern Sie das Kennwort für webuser1:
mqsiwebuseradmin MB8BROKER -m -u webuser1 -a n3wpass
Löschen Sie den Webbenutzeraccount für webuser1:
mqsiwebuseradmin MB8BROKER -d -u webuser1
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:23:12


ReferenzthemaReferenzthema | Version 8.0.0.5 | bn28491_