Apache Tomcat に HTTP プロキシー・サーブレット・ファイルをロードしてインストールします。
始める前に
HTTP プロキシー・サーブレットをデプロイする前に、以下のタスクを実行する必要があります。
このタスクの概要
以下の手順を実行して、Apache Tomcat をインストールしてカスタマイズし、その後で HTTP プロキシー・サーブレットをデプロイします。 この手順では、 IBM App Connect Enterprise が Apache Tomcat と同じマシンにインストールされ、実行されていることを前提としています。
手順
- 「 Apache Tomcat 9」のダウンロードページから「 Apache Tomcat 」をダウンロードしてください。
- Apache Tomcat インストーラーを実行し、手順に従ってインストールを完了します。
注: Java™仮想マシン( JVM )のパスを指定するよう求められた場合は、 IBM App Connect Enterprise とともにデプロイされている JVM などを使用できます C:\Program Files\IBM\ACE\13.0.n.0\common\jdk\jre。
- ファイル catalina.propertiesを見つけます。
これは、以下の場所にあります。
Tomcat_installation_path/conf/catalina.properties
ここで、Tomcat_installation_path は、Apache Tomcat インストール・ディレクトリーの名前です。
- catalina.properties を編集して、以下の行を見つけます。
- 次のテキストを含むようにこの行を編集します。
shared.loader=${catalina.home}/shared/lib,${catalina.home}/shared/lib/*.jar
- ディレクトリー Tomcat_installation_path/shared/libを作成します。
- 以下の 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 と通信します。
- 「 Apache Tomcat 」 Windows サービスを起動します。
- Webブラウザを開き、Webアドレスを入力します http://localhost:port 。ここで、 port は「 Apache Tomcat 」のインストール時に指定した HTTP のポート番号です。
ポートのデフォルト値は 8080 です。
Apache Tomcat のホーム・ページが表示されます。
- 「Tomcat マネージャー」 をクリックし、管理ユーザー ID とパスワードを入力します。
- 「デプロイする WAR ファイル」 セクションまでスクロールダウンし、 「参照」をクリックします。
- 「 IBM App Connect Enterprise 」からエクスポートした「 HTTP 」プロキシ・サーブレット・ファイルに移動します。
例えば、myproxyservlet.warなどです。
注:Apache Tomcat のデフォルト設定では、 HTTP プロキシサーブレットで使用されるコンテキストルートは、ファイル
.war 名と同じです。 HTTP プロキシー・サーブレットに別のコンテキスト・ルートを割り当てるために、HTTP プロキシー・サーブレットをデプロイする前に
.war ファイルの名前を変更することができます。 コンテキスト・ルートの説明については、
HTTP プロキシ・サーブレットを設定する際のコンテキスト・ルートの重要性をご覧ください。 HTTP プロキシー・サーブレットが空のコンテキスト・ルート (
/) を使用するようにする場合は、
.war ファイルの名前を
ROOT.war に変更し、
現行のデフォルト Web アプリケーション (Tomcat のウェルカム・ページ) をアンインストールしてください。
- 「デプロイ」をクリックします。
- 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 プロキシサーブレットのテスト」 を参照してください。