Apache Tomcat への HTTP プロキシー・サーブレットのデプロイ

Apache Tomcat に HTTP プロキシー・サーブレット・ファイルをロードしてインストールします。

始める前に

HTTP プロキシー・サーブレットをデプロイする前に、以下のタスクを実行する必要があります。

このタスクの概要

以下の手順を実行して、Apache Tomcat をインストールしてカスタマイズし、その後で HTTP プロキシー・サーブレットをデプロイします。 この手順では、 IBM App Connect Enterprise が Apache Tomcat と同じマシンにインストールされ、実行されていることを前提としています。

手順

  1. 「 Apache Tomcat 9」のダウンロードページから「 Apache Tomcat 」をダウンロードしてください。
  2. Apache Tomcat インストーラーを実行し、手順に従ってインストールを完了します。
    注: Java™仮想マシン( JVM )のパスを指定するよう求められた場合は、 IBM App Connect Enterprise とともにデプロイされている JVM などを使用できます C:\Program Files\IBM\ACE\13.0.n.0\common\jdk\jre
  3. ファイル catalina.propertiesを見つけます。

    これは、以下の場所にあります。

    Tomcat_installation_path/conf/catalina.properties

    ここで、Tomcat_installation_path は、Apache Tomcat インストール・ディレクトリーの名前です。

  4. catalina.properties を編集して、以下の行を見つけます。
    shared.loader=
  5. 次のテキストを含むようにこの行を編集します。
    shared.loader=${catalina.home}/shared/lib,${catalina.home}/shared/lib/*.jar
  6. ディレクトリー Tomcat_installation_path/shared/libを作成します。
  7. 以下の IBM MQ のJARファイルを、から WebSphere_MQ_installation_path\Java\lib へコピーしてください Tomcat_installation_path\shared\lib
    • com.ibm.mq.commonservices.jar
    • com.ibm.mq.headers.jar
    • com.ibm.mq.jar
    • com.ibm.mq.jmqi.jar
    • com.ibm.mq.pcf.jar
    • connector.jar
    HTTP プロキシ・サーブレットは、 IBM MQ を使用して IBM App Connect Enterprise と通信します。
  8. 「 Apache Tomcat 」 Windows サービスを起動します。
  9. Webブラウザを開き、Webアドレスを入力します http://localhost:port 。ここで、 port は「 Apache Tomcat 」のインストール時に指定した HTTP のポート番号です。
    ポートのデフォルト値は 8080 です。
    Apache Tomcat のホーム・ページが表示されます。
  10. 「Tomcat マネージャー」 をクリックし、管理ユーザー ID とパスワードを入力します。
  11. 「デプロイする WAR ファイル」 セクションまでスクロールダウンし、 「参照」をクリックします。
  12. IBM App Connect Enterprise 」からエクスポートした「 HTTP 」プロキシ・サーブレット・ファイルに移動します。
    例えば、myproxyservlet.warなどです。
    注:Apache Tomcat のデフォルト設定では、 HTTP プロキシサーブレットで使用されるコンテキストルートは、ファイル .war 名と同じです。 HTTP プロキシー・サーブレットに別のコンテキスト・ルートを割り当てるために、HTTP プロキシー・サーブレットをデプロイする前に .war ファイルの名前を変更することができます。 コンテキスト・ルートの説明については、 HTTP プロキシ・サーブレットを設定する際のコンテキスト・ルートの重要性をご覧ください。 HTTP プロキシー・サーブレットが空のコンテキスト・ルート (/) を使用するようにする場合は、.war ファイルの名前を ROOT.war に変更し、 現行のデフォルト Web アプリケーション (Tomcat のウェルカム・ページ) をアンインストールしてください。
  13. 「デプロイ」をクリックします。
  14. HTTP プロキシー・サーブレットがアクティブであるかどうかをテストするには、Web ブラウザーに以下の URL を入力します。
    http://host_name:port/context_root
    where:
    host_name
    Apache Tomcat サーバーのホスト名を指定します。
    ポート
    Apache Tomcat サーバーのポート番号を指定します。
    context_root
    HTTP プロキシー・サーブレットに割り当てたコンテキスト・ルートを指定します。

    例えば、http://localhost:8080/

    HTTP プロキシ・サーブレットが統合ノードに到達できる場合、 HTTP Status 404 から次のエラーメッセージを含む応答が返されるはずです
    URI/統合ノード integration_node 内のどのメッセージ・フローにもマップしない
    ここで、integration_node は、統合ノードの名前です。

結果

Apache Tomcat サーバーにプロキシー・サーブレットがデプロイされました。

次のタスク

HTTP プロキシサーブレットは、 HTTP ( HTTPS ではない)リクエストを受信し、それをメッセージフローに渡す統合ノードでテストする準備が整いました。 このタスクの完了方法については 、「 HTTP プロキシサーブレットのテスト」 を参照してください。