WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

mqsiwebuseradmin コマンド - WindowsLinux、および UNIX システム

mqsiwebuseradmin コマンドを使用して、LinuxUNIX、または Windows システム上で Web ユーザー・インターフェースのユーザー・アカウントを管理します。

構文

構文図を読む構文図をスキップする
>>-mqsiwebuseradmin--| brokerSpec |--+- -l-+-------------------->
                                     +- -c +   
                                     +- -m-+   
                                     '- -d '   

>--+---------------+--+---------------+--+-----------+---------->
   '- -u -username-'  '- -a -password-'  '- -r -role-'   

>--+-------------------+--+-----------------------+------------><
   '- -w --timeoutSecs-'  '- -v -- traceFileName -'   

brokerSpec

|--+- brokerName ----------------+------------------------------|
   +- -n --brokerFileName--------+   
   | .-------------------------. |   
   | V                         | |   
   '-----+- -i --ipAddress-+---+-'   
         +- -p --port------+         
         '- -q --qMgr------'         

パラメーター

brokerSpec
(必須) このコマンドのターゲット・ブローカーを識別するには、以下のいずれかの形式で、1 つ以上のパラメーターを指定しなければなりません。
brokerName
このパラメーターは、ローカルに定義されているブローカーの名前を識別します。 ブローカーがリモート・コンピューター上にある場合は、このオプションは使用できません。
-n brokerFileName
このパラメーターは、ローカル・ブローカーまたはリモート・ブローカーに関する接続の詳細を含むファイルの名前を識別します。

このオプションは、複数のユーザーが同じブローカーに接続する場合や、SSL などの拡張接続パラメーターを使用する場合に使用します。

このファイルを作成するには、WebSphere® Message Broker Explorer 内でブローカーを右クリックし、「*.broker のエクスポート」を選択します。 プロンプトが出た場合は、ファイルを保存する場所にナビゲートし、ファイル名を入力してください。「保管」をクリックする際に、拡張子 .broker が自動的に付加されます。 このパラメーターの指定時には、場所 (パス) とファイル名を含めてください。 このコマンドの実行時には、この場所がアクセス可能であることを確認しなければなりません。

SSL を使用して、セキュア・チャネルを介してリモート・ブローカーを管理するコマンドを実行する場合、IBM_JAVA_OPTIONS 環境変数を使用して、接続用の鍵ストアおよびトラストストアのパスワードを指定する必要があります。 詳細は、コマンド実行時の問題の解決を参照してください。

-i ipAddress, -p port, -q qMgr
これらのパラメーターは、ブローカーに関する接続の詳細を識別します。

拡張接続パラメーターが必要ないリモート・ブローカーへの接続の場合は、このオプションを使用します。

このオプションを選択する場合は、以下の 3 つのパラメーターのうち 1 つ以上を指定しなければなりません。指定する順序は意味を持ちません。 それぞれのパラメーターを複数回指定することはできません。

省略したパラメーターは、デフォルト値が想定されます。

  • -i ipAddress: ブローカーが稼働中のコンピューターのホスト名または IP アドレス。 このパラメーターを指定しない場合、ローカル・コンピューターを表す値が使用されます。
  • -p port: ブローカーのキュー・マネージャーが listen する TCP ポート。 このパラメーターを指定しない場合、値 1414 が使用されます。
  • -q qMgr: ブローカーのキュー・マネージャーの名前。 このパラメーターを指定しない場合、ローカル・コンピューター上のデフォルトのキュー・マネージャーを表す値が使用されます。
-l
(オプション) ブローカー内で定義されている Web ユーザー、および関連付けられている役割をリストします。 -u (ユーザー) または -r (役割) を指定する場合、リストがユーザーまたは役割でフィルターに掛けられます。
-c
(オプション) Web ユーザー・インターフェースにログオンして REST API 呼び出しを行うことができる Web ユーザー・アカウントを作成します。このパラメーターを使用する場合、-u パラメーターと -a パラメーターも指定する必要があります。 Web ユーザー・アカウントを作成する際に -r パラメーターを指定しない場合、Web ユーザー・アカウントと同じ名前でデフォルトの役割が作成されます。 この場合、作成する Web ユーザー・アカウントの名前は、システムで指定されているシステム・ユーザー・アカウントと同じでなければなりません。
-m
(オプション) Web ユーザー・アカウントを変更します。このパラメーターを使用する場合、 -u パラメーターを使用してユーザー・アカウントを指定する必要があります。 また、変更するパラメーターに応じて、少なくとも -a-r のいずれかのパラメーターに値を指定する必要もあります。
-d
(オプション) Web ユーザー・アカウントを削除します。このオプションを使用する場合、-u パラメーターを使用してユーザー・アカウントを指定する必要もあります。
-u username
(オプション) Web ユーザー・アカウントの名前を指定します。 パラメーター -c-d、または -m を指定する場合、このパラメーターは必須です。
-a password
(オプション) Web ユーザー・アカウントのパスワードを指定します。 -c パラメーターを指定する場合、このパラメーターは必須です。
-r role
(オプション) Web ユーザー・アカウントと関連付ける役割を指定します。 この役割は、管理セキュリティー権限の検査対象となるシステム・ユーザー・アカウントです。 各 Web ユーザー・アカウントは単一の役割と関連付けられており、複数の Web ユーザー・アカウントを同じ役割に割り当てることができます。

Web ユーザー・アカウントを作成 (-c パラメーターを指定) する際に -r パラメーターを指定しない場合、Web ユーザー・アカウントと同じ名前でデフォルトの役割が作成されます。 この場合、作成する Web ユーザー・アカウントの名前は、システムで指定されているシステム・ユーザー・アカウントと同じでなければなりません。

役割について詳しくは、役割ベースのセキュリティーを参照してください。

-v traceFileName
(オプション) このパラメーターは、指定されたファイルに内部デバッグ・トレース情報を送信します。
-w timeoutSecs
(オプション) このパラメーターは、戻されるまでにブローカーが要求を完了するのをこのコマンドが待つ最大時間を秒数で指定します。

このパラメーターは、1 から 2 145 336 164 までの範囲の値に設定できます。 timeoutValue 値を指定しない場合や、1 より小さい値または 2 145 336 164 より大きい値を設定した場合には、エラーが戻されます。

応答が timeoutValue の期間内に受け取られるようにするには、このパラメーターを、ブローカーに指定した構成タイムアウト・パラメーター (ConfigurationChangeTimeout および InternalConfigurationTimeout) の合計よりも大きな値に設定してください。 それより小さい値を設定した場合、戻される応答はデプロイ要求の状態が不明であること示す可能性があります。

Web ユーザー・アカウントとパスワードを作成し、関連付けられる役割 (システム・ユーザー・アカウント) を指定します。
mqsiwebuseradmin MB8BROKER -c -u webuser1 -r admin -a passw0rd

前の例では、値 admin がシステム・アカウントに対応します。

webuser1 のパスワードを変更します。
mqsiwebuseradmin MB8BROKER -m -u webuser1 -a n3wpass
webuser1 の Web ユーザー・アカウントを削除します。
mqsiwebuseradmin MB8BROKER -d -u webuser1
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

        
        最終更新:
        
        最終更新: 2015-02-28 17:49:21


参照トピック参照トピック | バージョン 8.0.0.5 | bn28491_