[AIX Solaris HP-UX Linux Windows][IBM i]

同一マシン上の Web サーバーおよびアプリケーション・サーバー・プロファイルの構成

WebSphere® Application Server は、特定のブランドの Web サーバーと通信するように構成できる Web サーバー・プラグインを提供します。 同じマシンに Web サーバー、その Web サーバー・プラグイン (WebSphere Application Server 用)、およびアプリケーション・サーバーをインストールする方法を学習します。

始める前に

[IBM i]複数のプロファイル が存在する場合は、Web サーバー・プラグイン構成ツールで構成されるプロファイルを選択することができます。構成するプロファイルを選択する方法を決定する論理の流れについての説明は、プラグイン構成を参照してください。

[AIX Solaris HP-UX Linux Windows]複数のプロファイルが存在する場合は、Web サーバー・プラグイン構成ツールがプロファイルを選択することが可能です。構成するプロファイルを選択する方法を決定する論理の流れについての説明は、プラグイン構成を参照してください。

WebSphere Application Server 製品ファミリー が、ある特定の Web サーバー製品 (例えば、IBM® HTTP Server または Microsoft Internet Information Services (IIS) など) をサポートする場合、WebSphere Application Server 製品でその Web サーバー用のバイナリー・プラグインが提供され、ユーザーはそれをインストール する必要があります。

WebSphere Application Server 製品ファミリーが、特定のブランドの Web サーバー用にバイナリー・プラグインを提供していない場合、その Web サーバーはサポートされません。バイナリー・プラグインの目的は、Web サーバーとアプリケーション・サーバーの間に通信プロトコルを提供することです。

[AIX Solaris HP-UX Linux Windows]新規プロファイルを作成し、Web サーバーも使用したいと仮定します。新しいプロファイル用の新規 Web サーバーをインストールした後で、Web サーバー・プラグインをインストールし、Web サーバー・プラグイン構成ツールを使用して Web サーバーとアプリケーション・サーバーの両方を構成する必要があります。

Web サーバーがインストールされていない場合でも、将来の利用に備えて Web サーバー・プラグインをインストールすることができます。

この手順では、マシン上のデフォルト・プロファイルであるアプリケーション・サーバー・プロファイルを構成します。Web サーバーとアプリケーション・サーバーの間には 1 対 1 の関係が存在します。

ただし、スタンドアロン・アプリケーション・サーバー・プロファイルおよび管理対象プロファイルでは、複数の Web サーバーをそれぞれ別個の Web サーバー定義内に定義できます。

この項目では、以下のトポロジーの作成方法について説明します。

単一マシン上のアプリケーション・サーバーとオプションの Web サーバー

注: プラグイン・コンポーネントの非 root インストールは、 アプリケーション・サーバーも同じ非 root ユーザーによってインストールされている場合にのみサポートされます。 それ以外の場合、Web サーバー構成スクリプトは、アプリケーション・サーバー・インストール・システムに対して実行できません。

このタスクについて

注: このトピックでは、 1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。推奨される代替案として、分散システムや IBM i システムの SystemOut.log、SystemErr.log、trace.log、activity.log ファイルではなく、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成できます。また HPEL は、ネイティブ z/OS® ロギング機能と連携させて使用することができます。HPEL を使用する場合、LogViewer コマンド・ライン・ツールを サーバー・プロファイルの bin ディレクトリーから使用して、すべてのログ・ファイルにアクセスし、 情報をトレースできます。HPEL の使用について詳しくは、HPEL を使用してのアプリケーションの トラブルシューティングに関する情報を参照してください。
Web サーバー・プラグイン構成ツールは、以下の情報を収集した後で、サポートされる Web サーバー用にプラグインを構成します。
  • 構成する Web サーバーのタイプ
  • インストール済みのターゲット Web サーバーのアーキテクチャー (64 ビットまたは 32 ビット)
  • 構成される Web サーバー用構成ファイルのロケーション
  • Web サーバー・ポート
  • IBM HTTP Server の場合は以下の情報:
    • オプションの IBM HTTP Server 管理サーバー・セットアップ用のポート番号
    • 管理コンソールからオプションの IBM HTTP Server 管理サーバーへの認証を受けるためのユーザー ID とパスワード
    • [AIX][Linux]IBM HTTP Server、IBM HTTP Server 管理サーバー、および Web サーバー・プラグイン構成ファイルへの書き込みアクセス権を取得するためのシステム・ユーザー ID とグループ
    • [Windows]ウィンドウ・サービスとして IBM HTTP Server 管理サーバーを実行するよう選択する場合はユーザー ID とパスワード
  • Web サーバー定義の名前
  • 使用される構成シナリオ
    • リモート・シナリオの場合、ツールはアプリケーション・サーバーのホスト名または IP アドレスを収集します。
    • ローカル・シナリオの場合、ツールは WebSphere Application Server 製品のインストール・ルート・ディレクトリーを収集します。
  • Web サーバー・プラグインによって構成されるプロファイル

Web サーバー・プラグイン構成ツールは、バイナリー・プラグイン・モジュールおよびプラグイン構成ファイルのロケーションを指すディレクティブを作成することによって、Web サーバーの構成ファイルを編集します。

バイナリー・プラグイン・モジュールの名前は、Web サーバーのタイプによって異なります。 プラグイン構成ファイルは、常に plugin-cfg.xml ファイルです。

Web サーバー・プラグイン構成ツールは、アプリケーション・サーバーの構成に Web サーバー定義が存在しない場合に、これを作成します。

管理コンソールを使用して、Web サーバー構成を管理することができます。 例えば、アプリケーション・サーバーにアプリケーションをインストールする場合、そのアプリケーションを Web サーバー定義にインストールすることも選択できます。 その場合、更新済み plugin-cfg.xml ファイルには、新規アプリケーションが使用可能であることが示されます。 Web サーバーが更新済みプラグイン構成ファイルを読み取ると、Web サーバーは、Web クライアントに対して提供できる新規アプリケーションを認識します。

Web サーバー定義上に新規アプリケーションをインストールしないことを選択した場合、アプリケーションはプラグイン構成ファイルに追加されません。 Web サーバーはそのアプリケーションを認識しないため、Web クライアントに提供することができません。

サポートされる構成 サポートされる構成: このツールは、AIX®、Linux、および Windows 上でのみサポートされます。Web サーバー・プラグイン構成ツールを使用する代わりに、応答ファイルを指定して pct コマンド行ツールを使用することで、Web サーバーを構成できます。詳しくは、pct ツールを使用した Web サーバー・プラグインの構成を参照してください。sptcfg

この手順を使用して、Web サーバー・プラグインをインストールし、Web サーバーを構成し、デフォルト・アプリケーション・サーバー・プロファイルで Web サーバー定義を作成します。

手順

スタンドアロン・アプリケーション・サーバーを構成します。
  1. オペレーティング・システムにログオンします。

    非 root ユーザーまたは管理ユーザー以外としてインストールする場合は、一定の制約があります。

    [AIX][Linux]また、オーナーがファイルの読み取り/書き込みを行えるようにし、その他のユーザーが現行のシステム・ポリシーにしたがってファイルにアクセスできるようにする、umask を選択します。 root の場合は、022 の umask を推奨します。非 root ユーザーの場合は、グループを共有しているかいないかによって異なりますが、002 または 022 の umask が使用できます。umask 設定を確認するには、以下のコマンドを実行します。
    umask
    umask 設定を 022 に設定するには、以下のコマンドを実行します。
    umask 022
    [Windows]Windows オペレーティング・システムで管理ユーザーとしてインストールを行う際、Windows サービスが自動的に作成され、アプリケーション・サーバーを自動始動します。インストーラーのユーザー・アカウントが以下の上級者権限を持っている必要があります。
    • オペレーティング・システムの一部として機能
    • サービスとしてログオンする
    例えば、一部の Windows オペレーティング・システムで、「コントロール パネル」>「管理ツール」>「ローカル セキュリティ ポリシー」>「ローカル ポリシー」>「ユーザー権利の割り当て」をクリックして、拡張オプションを設定します。詳しくは、Windows オペレーティング・システムの資料を参照してください。

    [Windows]アプリケーション・サーバーを Windows サービスとして実行する予定の場合は、スペースを含むユーザー ID からインストールしないでください。ユーザー ID にスペースが含まれていると、妥当性検査ができません。 このようなユーザー ID を使用すると、インストールを続行できません。 この制約を回避するには、スペースを含まないユーザー ID を使用して、インストールを行います。

  2. Installation Manager をインストールします。
  3. Installation Manager を使用して、以下をインストールします。
    • WebSphere Application Server
    • WebSphere Application Server の Web サーバー・プラグイン
    • Websphere Customization Toolbox
  4. Installation Manager を使用して、IBM HTTP Server または別のサポートされる Web サーバーをインストールします。
  5. Websphere Customization Toolbox を開き、Web サーバー・プラグイン構成ツールを起動します。
  6. Web サーバー・プラグインのランタイム・ロケーションを選択します。
    以前にインストール済みの、使用する Web サーバー・プラグインのロケーションがリストにない場合は、以下のアクションを実行してロケーションを作業セットに追加します。
    1. 「追加」をクリックします。
    2. Web サーバー・プラグイン・ロケーションの名前を入力します。
    3. 以下のいずれかのアクションを実行します。
      • ロケーションを入力します。
      • 「参照」をクリックして、ロケーションを検索し、「OK」をクリックします。
  7. 「作成」をクリックします。
  8. 構成する Web サーバーのタイプを選択し、「次へ」をクリックします。
  9. インストール済みのターゲット Web サーバーのアーキテクチャー (64 ビットまたは 32 ビット) を選択し、次に進むかどうかを確認された場合は、「次へ」をクリックします。
  10. 「参照」をクリックして、ご使用の Web サーバーの構成ファイルを選択し、Web サーバー・ポートが正しいことを確認し、終了してから「次へ」をクリックします。

    ファイルのディレクトリーだけでなく、ファイルを選択します。 Web サーバーに 2 つの構成ファイルがある場合は、ファイルごとにブラウズする必要があります。

    以下のリストは、サポートされる Web サーバーの構成ファイルを示します。
    Apache HTTP Server
    apache_root/config/httpd.conf
    Lotus® Domino® Web サーバー
    names.nsf and Notes.jar

    ウィザードは notes.jar ファイルを求めるプロンプトを出します。 実際の名前は、Notes.jar です。

    Web サーバー・プラグイン構成ツールは、ファイルの存在については検証しますが、いずれのファイルも確認しません。

    IBM HTTP Server
    [AIX Solaris HP-UX Linux Windows]IHS_root/conf/httpd.conf
    [IBM i]IHS_profile_root/conf/httpd.conf
    Microsoft Internet Information Services (IIS)
    Web サーバー・プラグイン構成ツールは、正しいファイルを判別して編集することができます。
    Sun Java™ System Web サーバー (旧 Sun ONE Web サーバーおよび iPlanet Web サーバー) バージョン 6.0 以降
    obj.conf および magnus.conf
  11. IBM HTTP Web サーバー・プラグインを構成する場合は、以下のアクションを実行します。
    1. オプションで、Web サーバーを管理する場合は、管理サーバーの構成をセットアップします。
      重要: Web サーバー・プラグイン構成ツールを使用して IBM HTTP Server 管理サーバーを構成する場合、Websphere Customization Toolbox を管理者/root 権限で「ローカル」アカウントとして実行する必要があります。
      1. 「IBM HTTP Server 管理サーバーのセットアップ」を選択します。
      2. IBM HTTP 管理サーバーが通信するポート番号を指定します。
      3. オプションで、「IBM HTTP Server 管理サーバー認証のユーザー ID の作成」を選択し、管理コンソールから IBM HTTP Server 管理サーバーへの認証を受けるために、ユーザー ID とパスワードを入力します。
    2. 「次へ」をクリックします。
    3. [AIX][Linux]IBM HTTP Server、IBM HTTP Server 管理サーバー、および Web サーバー・プラグイン構成ファイルへの書き込みアクセス権を取得する場合は、システム・ユーザー ID とグループを指定します。

      必要に応じて、「クレデンシャルを使用した新規の固有のシステム・ユーザー ID およびグループの作成」を選択します。

      [AIX]制約事項: プラットフォームの制限を超える新規ユーザー ID または新規グループ名を指定すると、構成が失敗する場合があります。通常、制限は 8 文字で、構成できる場合もあります。
    4. [Windows]オプションで、IBM HTTP Server 管理サーバーを Windows サービスとして実行するようセットアップします。
      1. 「IBM HTTP Server 管理サーバーを Windows サービスとして実行する」を選択します。
      2. 以下のいずれかのアクションを実行します。
        • 「ローカル・システム・アカウントとしてログオンする」を選択します。
        • 「指定されたユーザー・アカウントとしてログオンする」を選択して、そのアカウントのユーザー ID とパスワードを入力します。
          このユーザー ID には、以下の拡張ユーザー権限が必要です。
          • オペレーティング・システムの一部として機能
          • サービスとしてログオンする
      3. 始動タイプが自動が手動かを選択します。
    5. 「次へ」をクリックします。
  12. Web サーバー定義の固有の名前を指定して、「次へ」をクリックします。
  13. 構成シナリオを選択します。
    1. ローカル・シナリオを選択します。
    2. 以下のいずれかのアクションを実行します。
      • WebSphere Application Server のインストール・ロケーション (app_server_root) を入力します。
      • 「参照 (Browse)」をクリックして、WebSphere Application Server のインストール・ロケーション (app_server_root) を見つけて、「OK」をクリックします。
    3. 「次へ」をクリックします。
  14. 現在の Web サーバー・プラグインを使用して構成するプロファイルを選択し、「次へ」をクリックします。
  15. 要約情報を確認し、「構成 (Configure)」をクリックして、Web サーバー、Web サーバー・プラグイン、およびアプリケーション・サーバー・プロファイルの構成を開始します。
  16. 要約パネルでインストールが成功したことを確認し、「終了」をクリックします。

    問題が発生し、インストールが失敗した場合は、plugins_root/logs ディレクトリーのログを調べてください。 問題を修正したら、再構成してください。

  17. Lotus Domino Web サーバーのみ: WAS_PLUGIN_CONFIG_FILE 環境変数を設定します。

    AIX または Linux などのプラットフォームでは、スクリプトを親シェルに提供することで、エクスポートされた変数を子プロセスが継承することができます。Windows システムでは、他のコマンドを実行するのと同様にスクリプトを実行します。Windows システムでのソースは自動です。

    1. コマンド・ウィンドウをオープンします。
    2. ディレクトリーをプラグイン・インストール・ルート・ディレクトリーに変更します。
    3. plugins_root/bin/setupPluginCfg.sh スクリプトに適したコマンドを実行します。
      • [AIX]. plugins_root/bin/setupPluginCfg.sh (ピリオドとインストール・ルート・ディレクトリーの間のスペースに注意してください。)
      • [Linux] source plugins_root/bin/setupPluginCfg.sh

    AIX または Linux などのオペレーティング・システムの場合、このスクリプトは lotus_root/notesdata ディレクトリーにもあります。

    Lotus Domino Web サーバーを開始する前に、スクリプトに適切なコマンドを実行します。

  18. Snoop サーブレットを開始し、アプリケーション・サーバーからアプリケーションを検索する Web サーバーの機能を検証します。

    ご使用のアプリケーション・サーバーおよび Web サーバーを開始し、IP アドレスとスヌープ・サーブレットを使用して、ご使用の環境をテストします。

    1. アプリケーション・サーバーを始動します。
      ディレクトリー profile_root/bin に移動し、 startServer コマンドを実行します。
      • [AIX][Linux]./startServer.sh server1
      • [Windows]startServer server1
      • [IBM i]startServer server1
    2. 使用している IBM HTTP Server または Web サーバーを始動します。

      [IBM i]2001 ページまたは STRTCPSVR SERVER(*HTTP) HTTPSVR(instance_name ) コマンドを使用して、IBM HTTP Server を始動します。

      [AIX Solaris HP-UX Linux Windows]コマンド・ウィンドウを使用して、ディレクトリーを IBM HTTP Server のインストール済みイメージ、またはユーザーの Web サーバーのインストール済みイメージに変更します。IBM HTTP Server に適切なコマンドを実行して、Web サーバーを始動します。コマンドの例を以下に示します。

      [AIX Solaris HP-UX Linux Windows]IBM HTTP Server をコマンド行から始動する方法は、以下のとおりです。

      [AIX Solaris HP-UX Linux Windows] IBMHttpServer/bin ディレクトリーの apache コマンドと apachectl コマンドにアクセスします。
      • [AIX][Linux]./apachectl start
      • [Windows]apache
    3. ブラウザーで http://localhost:9080/snoop を参照して、アプリケーション・サーバーによって提供される内部 HTTP トランスポートをテストします。ブラウザーで http://Host_name_of_Web_server_machine/snoop を参照して、Web サーバー・プラグインをテストします。

      HTTP トランスポート・ポートはデフォルトで 9080 であり、すべてのプロファイルで固有でなければなりません。このポートは、default_host という名前の仮想ホストと関連し、その仮想ホストは、インストール済みの DefaultApplication をホストするよう構成されています。Snoop サーブレットは、DefaultApplication の一部です。ポートを変更して、 実際の HTTP トランスポート・ポートに一致させます。

    4. スヌープが稼働していることを確認します。

      どちらかの Web アドレスで「Snoop Servlet - Request/Client Information」ページが表示されるはずです。

      ヒント: HTTP エラー・コードの 500 が表示されて検査が失敗した場合は、「IIS マネージャー (IIS Manager)」>「デフォルトの Web サイト (Default Web Site)」>「sePlugins」 に進みます。 右クリックして、権限を編集することを選択します。共有タブをクリックし、すべてのユーザーと共有することを選択します (権限レベル: read/write)。
    5. リモート IBM HTTP Server のみ:
      [AIX Solaris HP-UX Linux Windows]以下のステップを使用することによって、自動伝搬機能がリモート IBM HTTP Server に対して動作することを確認します。この手順は、ローカル Web サーバーでは必須ではありません。
      1. IHS_root /conf/admin.passwd ファイル内に user=adminUser、password=adminPassword を作成します。 例: c:¥ws¥ihs80¥bin¥htpasswd -cb c:¥ws¥ihs80¥conf¥admin.passwd adminUser adminPassword
      2. アプリケーション・サーバーの管理コンソールを使用して、IBM HTTP Server の管理ユーザー用に作成したユーザー ID およびパスワード情報を入力します。「サーバー」>「Web サーバー」> web_server_definition >「リモート Web サーバー管理」へ進みます。値を admin Port=8008、User Id=adminUser、Password=adminPassword と設定します。
      3. httpd.conf ファイルおよび plugin-cfg.xml ファイルについて、正しい読み取り/書き込み許可を設定します。 詳しくは、IHS_root /logs/admin_ERROR.LOG ファイルを参照してください。
      プラグイン構成ファイルの自動伝搬では、IBM HTTP 管理サーバーが稼働中である必要があります。WebSphere Application Server 管理コンソールを使用して IBM HTTP Server を管理している場合は、次のエラー・メッセージが表示される場合があります。
      「Could not connect to IHS Administration server error」
      以下の手順を実行して、エラーを訂正します。
      1. IBM HTTP Server 管理サーバーが稼働していることを確認します。
      2. WebSphere Application Server 管理コンソールで定義された Web サーバーのホスト名とポートが、IBM HTTP Server の管理ホスト名とポートと一致することを確認します。
      3. ファイアウォールが原因で WebSphere Application Server 管理コンソールから IBM HTTP Server 管理サーバーへのアクセスが不能になっていないことを確認します。
      4. リモート管理対象の WebSphere Application Server 管理コンソールで指定したユーザー ID とパスワードが、htpasswd コマンドを使用して admin.passwd ファイルに作成されることを確認します。
      5. 安全に接続するには、IBM HTTP Server 管理サーバー keydb 個人証明書を署名者証明書として WebSphere Application Server 鍵データベースにエクスポートすることを確認します。 この鍵データベースは、ご使用の管理コンソールが稼働しているプロファイルの sas.client.props ファイル内の com.ibm.ssl.trustStore ディレクティブによって指定されます。 この考慮事項は、主に自己署名証明書用です。
      6. 問題が解決しない場合は、IBM HTTP Server の admin_ERROR. LOG ファイルおよび WebSphere Application Server のログ (trace.log ファイル) を確認して、問題の原因を判別します。

タスクの結果

Web サーバー・プラグインをインストールすると、Plugins ディレクトリーおよびいくつかのサブディレクトリーが作成されます。例えば、以下のディレクトリーは、Linux システムで作成されたものです。
  • plugins_root/bin/32bits または plugins_root/bin/64bits には、サポートされるすべての Web サーバーのバイナリー・プラグインが含まれています。
  • plugins_root/logs には、ログ・ファイルが含まれています。
  • plugins_root/properties には、バージョン情報が含まれています。

Web サーバー・プラグイン構成ツールは、アプリケーション・サーバー・プロファイル内に Web サーバー定義が存在しない場合に、これを作成します。

Web サーバー・プラグイン構成ツールは、profile_root/plugin-cfg.xml ファイルを使用するよう、Web サーバーを構成します。

アプリケーション・サーバーは、ファイルに影響を及ぼすイベントが発生する際には必ず、Web サーバー・プラグイン構成ファイル plugin-cfg.xml を再生成します。そのようなイベントには、アプリケーション、サーバー、または仮想ホストの追加または除去が含まれます。スタンドアロン・アプリケーション・サーバーは、このファイルを以下のロケーションに再生成します。
profile_root 
   /config/cells/cell_name/nodes/
   web_server_name_node/servers/
   web_server_name/plugin-cfg.xml

次のタスク

スタンドアロン・アプリケーション・サーバーおよび Web サーバーは、ローカル Web サーバーのプラグインを構成した直後に始動することができます。サーバーを始動して、構成の変更を保管した後で、アプリケーション・サーバーの管理コンソールを開きます。

インストール手順の概要については、『Web サーバーのトポロジー・ダイアグラムおよびロードマップの選択』を参照してください。

プラグイン構成ファイルのロケーションについて詳しくは、プラグイン構成を参照してください。

Web サーバーの構成に関連するファイルについて詳しくは、Web サーバーの構成 を参照してください。

サポートされる Web サーバーの、Web サーバー・プラグイン構成ツールによる構成方法について詳しくは、Web サーバー構成ファイルの編集を参照してください。

Web サーバー・プラグインのインストールに関するその他のインストール・シナリオについては、Web サーバー・プラグインの構成を参照してください。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tins_webplugins_local
ファイル名:tins_webplugins_local.html