IBM HTTP Server for WebSphere Application Server プラグインは、
WebSphere Application Server for z/OS Optional Materials に付属しています。
このプラグインにより、IBM HTTP Server for WebSphere Application Server は WebSphere Application Server と
通信できるようになります。このプラグインを使用するには、
IBM HTTP Server for WebSphere Application Server (Apache を装備し、z/OS 上で実行される) が
必要です。
このタスクについて
Web サーバー構成プロセスの一部として、Web サーバー・インスタンス用のインストール・ディレクトリーを作成します。
以下の例では、/etc/websrv1 の値が Web サーバー・インストール・ディレクトリーに使用されます。
プラグイン構成ファイルの推奨ロケーションは、
Web サーバー・インストール・ディレクトリーの Plugins サブディレクトリーです。
Plugins ディレクトリーには、サブディレクトリー conf/WAS_webserver_name が含まれ、プラグイン構成ファイル plugin-cfg.xml は、
通常このディレクトリーにあります。
この手順は、
IBM HTTP Server for WebSphere Application Server プラグイン (z/OS 用) をインストールおよび構成する方法の
概要を示しています。
プロシージャー
- SMP/E を使用して、IBM HTTP Server for WebSphere Application Server プラグインの PTF を
インストールおよびロードします。 デフォルトでは、
プラグインは /usr/lpp/zWebSphere_OM/V6R1/HTTP/Plugins/ にあります。
- Web サーバー・インスタンスのサーバー ID を使用して、OMVS シェルにログオンします。
すべてのファイルを Web サーバー・インスタンスと同じグループが所有するためには、
install_plugin スクリプトと ConfigureIHSPlugin スクリプトを
このユーザー ID で実行する必要があります。
- プラグインのインストール・ディレクトリーを作成します。
プラグインのディレクトリーには、この Web サーバー・インスタンスでの実行中にプラグインが使用する
構成情報が含まれます。このディレクトリーの推奨ロケーションは、Web サーバー・インスタンスの
インストール・ディレクトリーの Plugins サブディレクトリーです。
ランタイム・インストール・イメージを作成するには、
コマンド
plugin_smp_location/bin/install_plugin.sh を実行します。
./install_plugin.sh
-pluginInstallLocation product_directory_of_plugin_code
-pluginRuntimeLocation install_directory_of_Web_server_plugin
-wasInstallLocation product_directory_of_WebSphere_Application_Server
以下の例は、
このコマンドの呼び出しサンプルです。
cd /usr/lpp/zWebSphere_OM/V6R1/HTTP/Plugins/bin
./install_plugin.sh
-pluginInstallLocation /usr/lpp/zWebSphere_OM/V6R1/HTTP/Plugins
-pluginRuntimeLocation /etc/websrv1/Plugins
-wasInstallLocation /usr/lpp/zWebSphere/V6R1
- IBM HTTP Server for z/OS インスタンスを、Web サーバー・プラグインを使用するように
構成します。
コマンド
plugin_runtime_location/bin/ConfigureIHSPlugin.sh を
実行して、IBM HTTP Server を、Web サーバー・プラグインを使用するように構成します。
./ConfigureIHSPlugin.sh
-plugin.home install_directory_of_Webserver_plugin
-plugin.config.xml location_of_plugin-cfg.xml_file
-ihs.conf.file location_of_httpd.conf_file
-operating.system ZOS
-WAS.webserver.name Webserver_name_defined_to_WebSphere_Application_Server
-WAS.host.name hostname_or_IP_address_of_WebSphere_Application_Server
以下の例は、
このコマンドの呼び出しサンプルです。
cd /etc/websrv1/Plugins/bin
./ConfigureIHSPlugin.sh
-plugin.home /etc/websrv1/Plugins
-plugin.config.xml /etc/websrv1/Plugins/config/webserver1/plugin-cfg.xml
-ihs.conf.file /etc/websrv1/conf/httpd.conf
-operating.system ZOS
-WAS.webserver.name webserver1
-WAS.host.name appsrv1.mycorp.com
- ローカルまたはリモートの z/OS Web サーバーの WebSphere Application Server で、
Web サーバー定義を作成します。
- プロファイルの作成中に Web サーバー定義を追加するには、
ISPF カスタマイズ・ダイアログまたは z/OS PMT を使用します。
重要: プロファイルの作成中に Web サーバーを追加するには、以下の手動ステップを
実行します。IBM HTTP Server for z/OS は、
バージョン 6.1 WebSphere Application Server 用の PTF により提供されているので、
Web サーバー・プラグインを作成するためには、手動で応答ファイルの更新を行って、
新しい Web サーバー・タイプを正しく処理するためのプロファイル作成を許可する必要があります。
ISPF カスタマイズ・ダイアログを使用して
カスタマイズ・ジョブを生成する場合は、そのジョブ生成後に以下のステップを
実行してください。z/OS プロファイル管理ツール (PMT) を使用する場合は、
ジョブをターゲット z/OS システムにアップロードしてから以下のステップを実行します。
スタンドアロン・アプリケーション・サーバー・プロファイルで、
ISPF カスタマイズ・ダイアログまたは z/OS PMT を使用する場合:
- BBOWRESP メンバーを編集用に開きます。これは .DATA データ・セットにあります。
- 以下の応答ファイルの値を指定のとおりに変更します。
webServerCheck=true
webServerType=IHS
webServerOS=os390
webServerName=name_used_in_defining_the_Webserver_to_Application_Server
webServerHostname=IPname_or_address_of_Webserver
webServerPort=HTTP_port_on_which_Webserver_listens
webServerInstallPath=directory_name_where_Webserver_is_installed
webServerPluginPath=directory_name_where_Webserver_plugins_are_installed
- カスタマイズ・ジョブを実行依頼します。
z/OS プロファイル管理ツールのみを使用するセル・プロファイルの場合:
- BBOWRECN メンバーを編集用に開きます。これは .DATA データ・セットにあります。
- 以下の応答ファイルの値を指定のとおりに変更します。
webServerCheck=true
webServerType=IHS
webServerOS=os390
webServerName=name_used_in_defining_the_Webserver_to_Application_Server
webServerHostname=IPname_or_address_of_Webserver
webServerPort=HTTP_port_on_which_Webserver_listens
webServerInstallPath=directory_name_where_Webserver_is_installed
webServerPluginPath=directory_name_where_Webserver_plugins_are_installed
- カスタマイズ・ジョブを実行依頼します。
この手動更新が必要なのは、関連のある z/OS PMT と ISPF カスタマイズ・ダイアログ・パネルの
検証で、
webServerType=IHS と
webServerOS=os390 の
組み合わせを入力できないためです。
- 既存の WebSphere Application Server プロファイルに Web サーバーを追加するには、
管理コンソール、createWebServerDefinition.jacl スクリプト、
または wsadmin createWebServer コマンドを使用します。
Web サーバーを WebSphere Application Server に定義する場合:
- Web サーバー名には、WAS.webserver.name に指定した値を使用します。
- Web サーバー・プラグインのインストール・ディレクトリーには、
PluginRuntimeLocation に指定した値を使用します。
- プラグインを構成します。
管理コンソールを使用するか、
GenPluginCfg
コマンドを発行して、plugin-cfg.xml ファイルを作成します。
注: 両方のメソッドによって、ASCII フォーマットでプラグイン構成
ファイル
plugin-cfg.xml が作成されます。
- このファイルを編集する必要がある場合は、以下のコマンドを実行して、その
ファイルを EBCDIC フォーマットに変換します。
iconv -f ISO8859-1 -t IBM-1047 plugin-cfg.xml.ASCII > plugin-cfg.xml.EBCDIC
- ファイルを編集し、以下のコマンドを発行して、ASCII フォーマットへ変換し直します。
iconv -f IBM-1047 -t ISO8859-1 plugin-cfg.xml.EBCDIC > plugin-cfg.xml.ASCII
管理コンソールを使用するには、次の手順を実行します。
- 「サーバー」>「Web サーバー」>「webserver」>「プラグイン・プロパティー」を
選択します。
- 「Automatically generate plug-in configuration file」を選択するか、
以下のトピックを 1 つ以上クリックして、plugin-cfg.xml ファイルを手動で
構成します。
- 「OK」をクリックします。
-
Web サーバーで plugin-cfg.xml ファイルを
見つけられるようにするには、アプリケーション・サーバーを停止して、
再度アプリケーション・サーバーを始動する必要があります。
場合によっては、plugin-cfg.xml ファイルを、
Web サーバー・プラグイン・インストール・ディレクトリーの正しい場所へ手動でコピーする必要があります。
- 仮想ホストが、
IBM HTTP Server for z/OS で使用されるポート番号の別名を使用して
構成されていることを確認します。plugin-cfg.xml
ファイルを手動で構成した場合、管理コンソールの「サーバー」>「アプリケーション・サーバー」>「プラグイン・プロパティー」>「要求ルーティング」ページへ移動し、
「仮想ホスト・マッチング」で「要求で指定されたポートを物理的に使用」が選択されていることを確認します。
- Web サーバー・プラグインがプライベート・ヘッダーを使用できる
ようにする場合は、トラスト・ファイルを定義する SSL 構成レパートリーを定義
します。次に、管理コンソールで、
「アプリケーション・サーバー」>「server1」>「Web コンテナー設定」>
「Web コンテナー・トランスポート・チェーン」>「transport_chain」>
「SSL インバウンド・チャネル (SSL_2)」と選択し、そのトランスポート・チェーン用にこのレパートリーを指定します。 トラスト・ファイル定義を含まない SSL 構成レパートリーを
セットアップせずにプライベート・ヘッダーを使用すると、プライベート・
ヘッダーは無視されます。プライベート・ヘッダーが無視されると、アプリケーション・サーバーは、要求されたアプリケーションを見つけることができません。
プライベート・ヘッダーを使用できるようにすると、
トランスポート・チェーンの SSL インバウンド・チャネルは、
受信するすべてのプライベート・ヘッダーを信頼するようになります。
このため、トランスポート・チェーンの SSL インバウンド・チャネルへのすべてのパスが信頼できるものであることを確認する必要があります。
- Web サーバー・プラグインが、stashfile プロパティーを指定した kdb ファイルではなく、
System Authorization Facility (SAF) 鍵リングを使用できるようにするには、
管理コンソールから次の 2 つのカスタム・プラグイン・プロパティーを
作成する必要があります。
- KeyringLocation。SAF 鍵リングのディレクトリー・ロケーションに設定します。
- StashfileLocation。"" (ヌル) に設定します。
SSL 構成で SAF 鍵リングを使用するために
管理コンソールから KeyringLocation と StashfileLocation を作成する方法については、
Web サーバー・プラグインの構成プロパティー
を参照してください。
plugin-cfg.xml ファイル
も参照してください。
- 構成が完了しました。 構成をアクティブにするには、アプリケーション・サーバーおよび
IBM HTTP Server を停止して再始動します。
結果
IBM HTTP Server の再始動時に IBM HTTP Server プラグイン (z/OS 用) が
正常に起動すると、プラグイン・ログ・ファイル /plugin_runtime_dir/log/webserver_name/http_plugin.log にメッセージが追加されます。http_plugin.log に表示されるメッセージの出力例は、以下のとおりです。
PLUGIN: Plugins loaded.
PLUGIN: --------------------System Information-----------------------
PLUGIN: Bld version: 6.1.0
PLUGIN: Bld date: Jul 13 2006, 09:55:09
PLUGIN: Webserver: IBM_HTTP_Server/6.1 Apache/2.0.47 (Unix)
PLUGIN: Hostname = ZWASAXXX
PLUGIN: NOFILES = hard: 3000, soft: 3000
PLUGIN: MAX COREFILE SZ = hard: 4194304, soft: 4194304
PLUGIN: DATA = hard: INFINITE, soft: INFINITE
PLUGIN: --------------------------------------------------------------
次の作業
アプリケーション・サーバーを構成した後、IBM HTTP Server およびプラグインを正しく構成します。
- WebSphere Application Server for z/OS プラットフォームは、このプラグインを使用して、
通常のプラグイン機能を実行できます。
- ブラウザーからの要求は、IBM HTTP Server およびプラグインを経由して、
要求されたアプリケーションがデプロイされるアプリケーション・サーバーに経路指定されます。
新規の要求は、アプリケーションがデプロイされている、無作為に選択されたアプリケーション・サーバーへ送信されます。
セッションが確立されると、後続の要求はオリジナルの要求に割り当てられたアプリケーション・サーバーに経路指定されます。
- プライベート・ヘッダー
を、
Web サーバー・プラグインから z/OS システムのアプリケーション・サーバーにプロキシー情報を
転送するためのメカニズムとして使用します。
(このように構成しないと、プロキシー情報は HTTP 要求に組み込まれません。)