test

Sun Java System Instant Messaging 7.2 管理ガイド

Instant Messaging XMPP/HTTP ゲートウェイ の設定

インストール後に configure ユーティリティーを実行するとき、XMPP/HTTP ゲートウェイ を配備するかどうかを選択できます。有効にした場合、ゲートウェイのデフォルト設定ファイル (httpbind.conf) が configure ユーティリティーによって作成されます。このファイル内の値を変更することによって、設定を変更できます。httpbind.conf ファイルの構文の説明、ファイルの場所、このファイル内の設定パラメータの一覧については、付録 B 「httpbind.conf の Instant Messaging XMPP/HTTP ゲートウェイ 設定パラメータ」を参照するか、この節の手順説明を参照してください。

また、ゲートウェイを配備することを初期設定中に選択した場合、configure ユーティリティーによって im-svr-base/work ディレクトリに .war ファイルが作成され、このファイルが、Web サーバーまたはアプリケーションサーバーのコードベースで指定したディレクトリ内に配備されます。

クライアントリソースとともに Web コンテナに配備される web.xml 内の値を変更することによって、デフォルト以外の設定ファイルを使用するようにゲートウェイを設定することもできます。

この節の手順説明は、ゲートウェイ設定ファイルが httpbind.conf であることを前提にしています。デフォルト以外の設定ファイルを使用している場合は、説明中の httpbind.conf をその設定ファイルに置き換えてください。

httpbind.conf に変更を行うたびに、XMPP/HTTP ゲートウェイ を再起動する必要があります。

この節では、次の各手順を説明します。

ゲートウェイのロギングを設定する手順については、「XMPP/HTTP ゲートウェイ のロギングの管理」を参照してください。

ProcedureInstant Messaging XMPP/HTTP ゲートウェイ を有効または無効にする

ゲートウェイを有効にするには、configure ユーティリティーを実行してから、iim.conf 内のパラメータを設定します。Web コンテナまたはアプリケーションサーバーで提供されるツールを使用して、あとからゲートウェイを無効にできます。

  1. ゲートウェイを有効にする手順は、次のとおりです。

    1. configure ユーティリティーを実行します。

    2. プロンプトが表示されたら、ゲートウェイの配備を選択します。

      詳細は、第 1 章「インストール後の Instant Messaging の設定」を参照してください。

    3. iim.conf で、iim_agent.httpbind.enable パラメータを true に設定します。

      たとえば、次のようになります。


      iim_agent.httpbind.enable=true

  2. ゲートウェイを無効にするには、Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して Web アプリケーションを無効にします。

ProcedureXMPP/HTTP ゲートウェイ が処理する並行要求数を設定する

始める前に

JEP 124 標準規格 (ドラフト版) の内容を理解しておく必要があります。詳細は、 http://www.jabber.org/jeps/jep-0124.html を参照してください。

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. httpbind.requests パラメータに、単一クライアントがゲートウェイに送信できる最大の並行要求数を設定します。

    デフォルトは 2 です。次に例を示します。


    httpbind.requests=2

    クライアントがゲートウェイに対して行うことができる並行要求の数です。このパラメータの値がクライアント要求の JEP 124 hold 属性の値よりも小さい場合、このパラメータの値は hold+1 に設定されます。このパラメータの値を 1 に設定しないでください。パフォーマンスが著しく低下する可能性があります。httpbind.hold パラメータの詳細は、「クライアント要求の JEP 124 hold 属性を XMPP/HTTP ゲートウェイ に設定する」および表 B–1を参照してください。

  3. httpbind.conf を保存して閉じます。

  4. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

Procedureクライアント要求の JEP 124 hold 属性を XMPP/HTTP ゲートウェイ に設定する

始める前に

JEP 124 標準規格 (ドラフト版) の内容を理解しておく必要があります。詳細は、 http://www.jabber.org/jeps/jep-0124.html を参照してください。

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. httpbind.hold パラメータに、クライアント要求の hold 属性に対してゲートウェイで許可する最大値を設定します。

    デフォルトは 5 です。次に例を示します。


    httpbind.hold=5

    クライアントによって送信されたホールド値がゲートウェイのホールド値よりも大きい場合、ゲートウェイのホールド値が使用されます。

  3. httpbind.conf を保存して閉じます。

  4. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

ProcedureXMPP/HTTP ゲートウェイ のクライアント非アクティブ許容時間を指定する

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. httpbind.inactivity パラメータに、ゲートウェイがアイドル状態の接続を終了するまでの時間 (秒) を設定します。

    デフォルトは 180 秒です。たとえば、次のようになります。


    httpbind.inactivity=180

    この時間が経過するまでにクライアントがゲートウェイをポーリングしない場合、ゲートウェイは接続を終了します。

  3. httpbind.conf を保存して閉じます。

  4. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

ProcedureXMPP/HTTP ゲートウェイ の content-type HTTP ヘッダーを設定する

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. httpbind.content_type パラメータに、クライアントがその最初の要求でコンテンツタイプを指定しない場合にゲートウェイが使用するコンテンツタイプを設定します。

    デフォルトは「text/xml; charset=utf-8」です。たとえば、次のようになります。


    httpbind.content_type=text/xml; charset=utf-8

  3. httpbind.conf を保存して閉じます。

  4. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

ProcedureXMPP/HTTP ゲートウェイ のラウンドトリップ遅延値を設定する

ラウンドトリップ遅延値は、ゲートウェイとクライアント間のラウンドトリップで、タイムアウト時間に加算される許容時間の合計 (秒) です。これは、ネットワーク遅延を考慮に入れた設定に役立ちます。

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. httpbind.round_trip_delay パラメータを必要に応じて設定します。

    この値を大きく設定しすぎると、パフォーマンスが低下する場合があります。値は秒数です。デフォルトは 1 秒です。たとえば、次のようになります。


    httpbind.round_trip_delay=1

    この値を大きく設定しすぎると、パフォーマンスが低下する場合があります。このパラメータを変更する前に、ネットワークの全般的な遅延を考慮してください。

  3. httpbind.conf を保存して閉じます。

  4. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

ProcedureXMPP/HTTP ゲートウェイ がクライアントに応答を送信するまでのデフォルト時間を設定する

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. httpbind.wait_time パラメータを必要に応じて設定します。

    クライアントは、このパラメータで指定した待ち時間以内に XMPP/HTTP ゲートウェイ から応答を得ることが保証されます。このパラメータを設定するときは、ネットワークの速度を考慮してください。この値を小さく設定しすぎて、XMPP/HTTP ゲートウェイ が時間内にほとんど応答を返せないという状況を避けるようにしてください。

    値は秒数です。デフォルトは 120 秒です。たとえば、次のようになります。


    httpbind.wait_time=120

    クライアントに対する設定値がゲートウェイに対する設定値よりも大きい場合、ゲートウェイの待ち時間が使用されます。

  3. httpbind.conf を保存して閉じます。

  4. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

ProcedureInstant Messaging ゲートウェイプールで XMPP/HTTP ゲートウェイ を設定する

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. Instant Messaging ゲートウェイプールを備える配備の一部としてゲートウェイを設定する手順は、次のとおりです。

    1. httpbind.pool.support パラメータを true に設定します。


      httpbind.pool.support=true

    2. httpbind.pool.nodeId パラメータに、ゲートウェイの完全 URL を設定します。

      URL はゲートウェイの nodeId として使用されます。この nodeId は、サーバープール内で一意である必要があります。ゲートウェイはこの nodeId を使用して、受け取った要求を処理する必要があるか、それとも要求をプール内の別のゲートウェイに転送する必要があるかを決定します。

  3. ゲートウェイプールの内部で機能しないようにゲートウェイを設定するには、httpbind.pool.support パラメータを次のように設定します。


    httpbind.pool.support=false

  4. httpbind.conf を保存して閉じます。

  5. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

Procedureサポート対象 XMPP/HTTP ゲートウェイ ドメインのキー ID リストを設定する

  1. httpbind.conf を開きます。

    このファイルの場所については、「httpbind.conf ファイルの場所」を参照してください。

  2. httpbind.config パラメータに、ゲートウェイで使用する ID のリストを設定します。

    このパラメータでは、各ドメインに対し別個の ID を指定する必要があります。たとえば、次のようになります。


    httpbind.config=gwdomain-id

    gwdomain-id は、ドメインに対して使用する識別子です。

    たとえば、次のようになります。


    httpbind.config=siroe.com

  3. 指定する gwdomain-id ごとに、次のパラメータを httpbind.conf ファイルに追加します。


    gwdomain-id.domain=domain-name
gwdomain-id.hosts=gateway-host
gwdomain-id.componentjid=component-jid
gwdomain-id.password=password

    説明:

    • gwdomain-id は、前の手順でゲートウェイに対して httpbind.config に指定した ID です。

    • domain-name は、識別されたゲートウェイが動作するドメインです。

    • gateway-host は、このドメインをサポートするゲートウェイホストの完全指定のドメイン名 (FQDN) およびポート番号のコンマ区切りまたはスペース区切りのリストです。

    • component-jid は、ゲートウェイのコンポーネント JID です。

    • password は、識別されたゲートウェイのパスワードです。

    たとえば、gwdomain-id を siroe に設定する場合、次のようになります。


    siroe.domain=siroe.com
siroe.hosts=gateway.siroe.com:5222
siroe.componentjid=http.gateway.siroe.com
siroe.password=gatewaypassword

    これらのキーパラメータの詳細は、「httpbind.config のゲートウェイドメイン ID キーパラメータ」を参照してください。

  4. httpbind.conf を保存して閉じます。

  5. Web サーバーまたはアプリケーションサーバーで提供されるツールを使用して、ゲートウェイを再起動します。

Procedureデフォルト以外の設定ファイルを使用するように Instant Messaging XMPP/HTTP ゲートウェイ を設定する

  1. Instant Messenger リソースファイルが配備される Web コンテナで、web.xml を編集します。

    このファイルを編集するには、Web コンテナのツールを使用します。

  2. httpbind.config.file パラメータの値を、ゲートウェイが使用する設定ファイルの場所に変更します。