メッセージ・フロー内で、クライアント・アプリケーションと HTTP ノードとの間の HTTP メッセージを経路指定するために、ブローカーおよび実行グループを構成する方法を決めます。
HTTP メッセージを管理するために、ブローカー全体のリスナーと実行グループ・リスナーとの間で選択します。
- ブローカー・リスナー (httplistener コンポーネント) には、HTTP メッセージを処理するための HTTPConnector と、HTTPS (HTTP over SSL) メッセージを処理するための HTTPSConnector があります。
各コネクターには、それぞれに割り当てられたポートがあります。
デフォルト値は、HTTP では 7080、HTTPS では 7083 です。
mqsichangeproperties コマンドを使用して、これらのポート番号を変更できます。
デフォルトで、すべての HTTPInput および HTTPReply ノードは、ブローカー全体のリスナーを使用します。
- 組み込みリスナーは、各実行グループの一部です。
組み込みリスナーには HTTPConnector および HTTPSConnector があります。
各コネクターにはそれぞれの割り当てられたポートがあり、それは一定の範囲の数値から必要に応じて割り当てられます。
HTTPConnector のデフォルト範囲は 7800 - 7842、HTTPSConnector のデフォルト範囲は 7843 - 7884 です。
組み込みリスナーを開始する最初の実行グループにはポート 7800 が割り振られ、2 番目のものには 7801 が割り振られ、以下同様となります。
mqsichangeproperties コマンドを使用して、これらのポート番号の範囲を変更し、特定のポートを実行グループに割り当てることができます。
1 つ以上の実行グループを構成して、
その実行グループにデプロイしたすべての HTTPInput および HTTPReply が組み込みリスナーを使用するようにすることができます。
組み込みリスナーを使用するためのオプションは実行グループ・レベルなので、一部の実行グループがブローカー全体のリスナーの使用を継続する一方で、特定の実行グループが組み込みリスナーを使用するように構成を変更することができます。
ただし、ブローカー全体のリスナーを使用不可にする場合、実行グループ・リスナーが、それらのサポートを明示的に使用可能にしなくてもすべての HTTP ノードのために使用されます。
そのため、関係するすべてのブローカーおよび実行グループのプロパティーを false に設定した場合、実行グループ・リスナーがすべての HTTP メッセージを処理します。
HTTPRequest ノードは、HTTP トランスポートと直接通信するので、選択の影響を受けません。
HTTP または HTTPS メッセージを処理しているリスナーおよびポートを変更する場合、その更新された構成を使用するようにアプリケーションも必ず更新する必要があります。
HTTP ノードのためのリスナーを選択する際に、以下の考慮事項を検討してください。
使用している特定の構成に対して、すべての項目が適用されるとは限りません。
要件に最も適したオプションを選択してください。
- ブローカー全体のリスナー
- 利点
- インバウンドおよびアウトバウンドのすべてのメッセージは、1 つのポートを介して HTTP 用に経路指定され、2 番目のポートを介して HTTPS 用に経路指定されます。
HTTP メッセージは、すべての実行グループ内のすべてのメッセージ・フローによって処理されます。
- 処理するメッセージが大量にある場合、メッセージ・フローの複数のコピーを異なる実行グループにデプロイできます。
Web サービスに由来する URL アドレスがそのメッセージ・フロー内のそのノードの「URL のパス接尾部」プロパティーの値と一致する場合、ブローカーは、インバウンド・メッセージを HTTPInput ノードの 1 つに割り当てます。
- そのように選択した場合、HTTPInput および HTTPReply ノードを別のメッセージ・フローに含め、別個の実行グループに分けることができます。
すべてのフローが単一のリスナーを使用するので、すべての到着および応答メッセージは同じポートを介して送信されます。
- 欠点
- 1 つのリスナーだけが、ブローカー上の 2 つのポートを介して送信されるすべての HTTP およびすべての HTTPS メッセージを処理します。
この単一の処理点は、高いメッセージのスループットが必要な場合に、ボトルネックとなることがあります。
- これらのリスナーは、SYSTEM.BROKER.WS.INPUT という固定の名前を持つ WebSphere® MQ キューを使用して、HTTP ノードと通信します。
リスナーは TCP/IP ネットワークからインバウンド・メッセージを受け取り、WebSphere MQ メッセージを作成して、それをキューに入れます。
それらは応答メッセージをキュー SYSTEM.BROKER.WS.REPLY から受け取り、HTTP トランスポート・ネットワークに送達します。
この構成の結果、それぞれの HTTP および HTTPS メッセージで追加の処理が行われます。
- 実行グループ・リスナー
- 利点
- 実行グループ・リスナーは、HTTP および HTTPS メッセージの両方のために常に使用可能です。
どちらのリスナーも、最初はデフォルト構成で構成されて、必要なときにブローカーによって開始されます。
- これらのリスナーは、HTTP トランスポート・ネットワークと直接通信します。中間のキューは必要ありません。
- メッセージ・フローを異なる実行グループにデプロイして、HTTP および HTTPS メッセージを複数のポート上の複数のリスナーで処理して、高いスループットの要件を満たすようにすることができます。
- 欠点
- HTTPInput および HTTPReply ノードの両方を同じメッセージ・フローに含めるか、または異なるメッセージ・フローを同じ実行グループにデプロイして、同じリスナーを使用するようにする必要があります。
一致する入力メッセージおよび応答メッセージを、同じポートで処理する必要があります。
必要とする構成を決定したとき:
- すべての実行グループに対してブローカー全体のリスナーを使用する場合は、このリスナーに有効な 1 つ以上のパラメーターを変更する場合を除いて、構成を変更する必要はありません。
詳細および例については、mqsichangeproperties コマンドの説明を参照してください。
- 1 つ以上の実行グループで実行グループ・リスナーを使用する場合は、実行グループ・リスナーへの切り替えの指示に従ってください。
- 現在 1 つ以上の実行グループで実行グループ・リスナーを使用していて、ブローカー全体のリスナーを使用するように戻すためには、ブローカー全体のリスナーへの切り替えの指示に従ってください。
例の中で示されているコマンドは、読みやすいように複数の行に分けられています。
コマンドを入力するときには、単一の行を使用する必要があります。