このページを使用して、Web サーバー・プラグイン構成ファイルの設定を表示または変更します。 プラグイン構成ファイル plugin_cfg.xml は、Web サーバーとアプリケーション・サーバーの間の通信を確立するためのプロパティーを提供します。
この管理コンソール・ページを表示するには、「サーバー」> 「サーバー・タイプ」>「Web サーバー」>「web_server_name」> 「プラグイン・プロパティー」とクリックします。
「構成」タブで、フィールドを編集することができます。「ランタイム」タブに、 読み取り専用の情報を表示することができます。
「ランタイム」タブは、この Web サーバーがアプリケーション・サーバー上で実行されているアプリケーションにアクセスしていて、http_plugin.log ファイルがある場合にのみ使用可能です。
プラグインが、開始時に構成内の DNS 障害を無視するかどうかを指定します。
このフィールドは plugin-cfg.xml ファイルの IgnoreDNSFailures エレメントに対応します。
true に設定すると、プラグインは構成内の DNS 障害を無視し、 各 ServerCluster で少なくとも 1 つのサーバーがホスト名を解決できる場合、正常に開始します。 ホスト名を解決できないサーバーは、構成の間 unavailable としてマーク付けされます。 それ以降、要求のルーティング時にホスト名の 解決は試行されません。DNS 障害が発生した場合、Web サーバーの開始が阻止されるのではなく、プラグイン・ログ・ファイルにログ・メッセージが書き込まれ、プラグインの初期化が継続されます。false が指定されている場合、DNS 障害によって Web サーバーは 開始されません。
データ型 | ストリング |
デフォルト | false |
更新または変更が行われたかどうかを確認するために、プラグインが構成ファイルを検査する時間間隔を秒で指定します。 プラグインはファイルをチェックして、プラグイン構成が最後 にロードされてから変更が行われたかどうかを調べます。
変更が頻繁に行われる開発環境では、 設定値をデフォルトの 60 秒より小さくすることをお勧めします。 実動環境では、構成の更新がそれほど頻繁に行われるわけではないので、 値をデフォルトより大きくしておくことをお勧めします。 何らかの理由でプラグインの再ロードに失敗すると、 プラグインのログ・ファイルにメッセージが書き込まれ、 プラグイン構成ファイルが正常に再ロードされるまでは、以前の構成が使用されます。 プラグイン構成を変更したのにそれが反映されていない場合は、 プラグインのログ・ファイルを調べて、問題が示されていないかどうか確認してください。
データ型 | 整数 |
デフォルト | 60 秒。 |
プラグインの構成ファイルのファイル名を指定します。 Application Server は、デフォルトで plugin-cfg.xml ファイルを生成します。 構成ファイルは、Web サーバーのアプリケーション、Application Server、 クラスター、および HTTP ポートを識別します。 Web サーバーは、このファイルを使用して、さまざまな Application Servers 上のデプロイされたアプリケーションにアクセスします。
プラグイン構成ファイルの名前を変更することができます。ただし、ファイル名を変更する場合は、 Web サーバー構成も、新規プラグイン構成ファイルを指すように変更する必要があります。
インストール中に Web サーバー・プラグインを選択する場合、インストーラー・プログラムは、 可能な場合は、plugin-cfg.xml ファイルのロケーションを識別するように Web サーバーを構成します。 プラグイン構成ファイルは、デフォルトで plugins_root/config/web_server_name ディレクトリーにインストールされます。
インストーラー・プログラムは、plugin-cfg.xml ファイルのロケーションを指定するディレクティブを Web サーバー構成に追加します。
リモート Web サーバーの場合、Application Server がインストールされているローカル・ディレクトリーから リモート・マシンにファイルをコピーする必要があります。これは、プラグイン構成ファイルの伝搬として知られています。 Web サーバーに IBM® HTTP Server V6.1 以降を使用する場合、ファイルを伝搬するための作業 HTTP トランスポート・メカニズムがあるときは、WebSphere® Application Server はプラグイン構成ファイルをリモート・マシンに自動的に伝搬することができます。
「表示」をクリックすると、現在のプラグイン構成ファイルのコピーを表示することができます。
データ型 | ストリング |
デフォルト | plugin-cfg.xml |
デフォルトでは、このフィールドはチェックされています。この Web サーバーのプラグイン構成ファイルを手動で生成する場合は、チェック・ボックスをクリアします。
プラグイン構成サービスはバックグラウンドで稼働しており、管理コンソールとは関連していないため、管理コンソールは自動伝搬の結果を表示することができません。
分散プラットフォームの場合、ユーザーはデプロイメント・マネージャーの SystemOut.log ファイルの関連メッセージを確認して、自動伝搬が正常に終了したことを確認できます。
z/OS® プラットフォームの場合、ユーザーは TSO JOB ログで関連したメッセージをチェックし、自動伝搬が正常に終了したことを確認することができます。
データ型 | ストリング |
デフォルト | なし |
Web サーバー上にある、Web サーバー・プラグイン構成ファイルのコピーの完全修飾パスを指定します。このパスは、ファイルの名前と、Web サーバーが稼働しているマシン上でのそのファイルの場所から構成されています。
Web サーバー上にある、セキュリティー鍵リングを含むデータベース・ファイルのコピーの完全修飾パスを指定します。このパスは、ファイルの名前と、Web サーバーが稼働しているマシン上でのそのファイルの場所から構成されています。
http_plugin.log ファイルのロケーションおよび名前を指定します。 また、ログ内のメッセージのスコープを指定します。
ログは、プラグインがログ・メッセージを書き込む場合のロケーションとレベルを示します。 構成ファイル内でログが指定されていないと、場合によっては、 Web サーバーのエラー・ログにログ・メッセージが書き込まれます。
分散プラットフォームで、ログ・ファイルが存在しない場合は、作成されます。 ログ・ファイルが既に存在している場合は、ファイルは付加モードで開かれ、 それまでのプラグイン・ログ・メッセージは残ります。
ログ・ファイル名 - プラグインがエラー・メッセージを書き込むログ・ファイルへの完全修飾パス。
データ型 | ストリング |
デフォルト | plugins_root/logs/web_server_name/http_plugin.log http_plugin.log ファイルのファイル・パスを指定します。 |
ログ・レベルが指定されない場合、デフォルト値には「Error」が使用されます。
レベルを「Trace」に設定する場合は、注意してください。このレベルでは多くのメッセージが記録されるため、 ディスク・スペース/ファイル・システムが急速に満杯になる可能性があります。 「Trace」の設定は、パフォーマンスに悪い影響を与えるため、正常に機能している環境では絶対に使用しないでください。
ERROR: ws_config_parser:handleLogEnd: Failed to open log file '/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
データ型 | ストリング |
デフォルト | エラー |
http_plugin.log ファイルのロケーションおよび名前を指定します。 また、ログ内のメッセージのスコープを指定します。
ログは、プラグインがログ・メッセージを書き込む場合のロケーションとレベルを示します。 構成ファイル内でログが指定されていないと、場合によっては、 Web サーバーのエラー・ログにログ・メッセージが書き込まれます。
分散プラットフォームで、ログ・ファイルが存在しない場合は、作成されます。 ログ・ファイルが既に存在している場合は、ファイルは付加モードで開かれ、 それまでのプラグイン・ログ・メッセージは残ります。
ログ・ファイル名 - プラグインがエラー・メッセージを書き込むログ・ファイルへの完全修飾パス。
データ型 | ストリング |
デフォルト | plugins_root/logs/web_server_name/http_plugin.log http_plugin.log ファイルのファイル・パスを指定します。 |
ログ・レベルが指定されない場合、デフォルト値には「Error」が使用されます。
レベルを「Trace」に設定する場合は、注意してください。このレベルでは多くのメッセージが記録されるため、 ディスク・スペース/ファイル・システムが急速に満杯になる可能性があります。 「Trace」の設定は、パフォーマンスに悪い影響を与えるため、正常に機能している環境では絶対に使用しないでください。
ERROR: ws_config_parser:handleLogEnd: Failed to open log file '/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
データ型 | ストリング |
デフォルト | エラー |
マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。