[AIX Solaris HP-UX Linux Windows][z/OS]

Web サーバー・プラグイン構成を動的に更新するための ODR の構成

Web サーバーが要求をオンデマンド・ルーター (ODR) に転送する トポロジーでは、Web サーバー・プラグイン構成ファイル plugin-cfg.xml を 動的に生成および更新するように ODR を設定することができます。 動的に plugin-cfg.xml を更新するよう ODR を構成することに よって、管理アクション中にこのファイルを手動で更新するという、内容に影響を及ぼす可能性のある操作を 避けることができます。

始める前に

plugin-cfg.xml 生成を構成する前に、環境トポロジーを検討してください。 各 ODR は 1 つの plugin-cfg.xml ファイルを生成でき、そのファイルには、 処理できるすべての URI が含まれます。生成される plugin-cfg.xml ファイル は、allcellnode、 および server に構成できます。構成の有効範囲は、 どの ODR が plugin-cfg.xml に含まれるのか、 つまり、どの ODR に Web サーバーが要求を転送するのかを決定します。デフォルトでは、plugin-cfg.xml は稼働中の ODR のみを 含みます。
plugin-cfg.xml 構成の有効範囲は、以下のいずれかにできます。
  • all: 環境内のすべての ODR を含みます。
  • cell: plugin-cfg.xml を生成する ODR と同じセル内のすべての ODR を含みます。
  • node: plugin-cfg.xml を生成する ODR と同じノードにあるすべての ODR を含みます。
  • server: plugin-cfg.xml を生成する ODR のみを含みます。

このタスクについて

plugin-cfg.xml を生成するよう構成 された ODR は、動的更新が発生するためには稼働している必要があります。1 つだけの ODR が plugin-cfg.xml ファイルを生成するよう構成されていて、 その ODR が停止している場合、plugin-cfg.xml はその ODR が再始動 するまで再生成されません。したがって、plugin-cfg.xml ファイルのジェネレーター は可用性の高いサービスとして実行するようにしてください。詳しくは、 HA 環境でのプラグイン構成の生成に関する説明をお読みください。

plugin-cfg.xml ファイル は、ODR プロセスによって生成されます。したがって、このファイルは、生成する ODR をホスティングしているファイル・システム に生成されます。allcell、 および node の場合、ODR が plugin-cfg.xml ファイルを生成するデフォルトのディレクトリーは、WAS_HOME/profiles/profile_name/etc/ です。 server の場合のデフォルトのディレクトリーは WAS_HOME/profiles/profile_name/etc/odr_name/ です。 デフォルトの生成ディレクトリーは、生成する ODR に Java™ 仮想マシン (JVM) システム・プロパティーを 設定することによってオーバーライドできます。この JVM システム・プロパティーを設定するには、 「サーバー」 > 「サーバー・タイプ」 > 「オンデマンド・ルーター」 > ODR_name > 「Java およびプロセス管理」 > 「プロセス定義」 > 「Java 仮想マシン」 > 「カスタム・プロパティー」 > 「新規」と進みます。この JVM システム・プロパティーに ODCPluginXmlDir という名前を付け、 生成ディレクトリーの絶対パスを含んでいる値を入力します。

手順

  1. 管理コンソールで、「オンデマンド・ルーター設定」ページに移動します。
    • スタンドアロン ODR プロセスの場合、「サーバー」 > 「サーバー・タイプ」 > 「オンデマンド・ルーター」 > ODR_name > 「オンデマンド・ルーター・プロパティー」 > 「オンデマンド・ルーター設定」とクリックします。
    • ODR プロセスの静的クラスターの場合、「サーバー」 > 「クラスター」 > 「オンデマンド・ルーター・クラスター」 > ODR_static_cluster_name > 「オンデマンド・ルーター・プロパティー」 > 「オンデマンド・ルーター設定」とクリックします。
    • ODR プロセスの動的クラスターの場合、「サーバー」 > 「クラスター」 > 「動的クラスター」 > ODR_dynamic_cluster_name > 「サーバー・テンプレート」 > > 「オンデマンド・ルーター・プロパティー」 > 「オンデマンド・ルーター設定」と進みます。
  2. 「プロキシー・プラグイン構成ポリシー」セクションで、 「プラグイン構成の生成」ドロップダウン・リストから有効範囲を 選択します。
  3. オプション: 「プロキシー・プラグイン構成ポリシー」セクションで、「プラグイン構成変更スクリプト」テキスト・ボックスに 入力するスクリプトの絶対パスを定義します。 定義されたスクリプトは、plugin-cfg.xml が 動的に更新されるたびに起動されます。
    「プラグイン構成変更スクリプト」テキスト・ボックスを使用する際の考慮事項は次のとおりです。
    • plugin-cfg.xml の生成後に実行する複数のスクリプトを定義することができます。 各スクリプトへのパスを区切るために使用される区切り文字はセミコロン ( ; ) です。 スクリプトは定義された順に実行されます。
      /tmp/executeFirst.sh;/bin/executeSecond.sh
    • 生成された plugin-cfg.xml ファイルが自動的に伝搬されるようにするためには、「プラグイン構成変更スクリプト」テキスト・ボックスで autoPropagate キーワードを使用します。
      例:
      • autoPropagate,*:*:*
      • /tmp/executeFirst.sh;/bin/executeSecond.sh;autoPropagate,*:*:*
    • propagatePluginCfg.py スクリプトを使用して、生成された plugin-cfg.xml ファイルが自動的に伝搬されるようにするためには、「プラグイン構成変更スクリプト」テキスト・ボックスでそのスクリプトを入力します。

      例:

      • /opt/WAS/bin/wsadmin.sh -f /opt/WAS/bin/propagatePluginCfg.py -lang jython https://myIHSHost:8192 
        ihsusr ihsusrPassword /tmp/plugin-cfg.xml /opt/HTTPServer/plugins/config/webserver1/plugin-cfg.xml
      • /tmp/executeFirst.sh;/bin/executeSecond.sh;/opt/WAS/bin/wsadmin.sh -f /opt/WAS/bin/propagatePluginCfg.py 
        -lang jython https://myIHSHost:8192 ihsusr ihsusrPassword /tmp/plugin-cfg.xml 
        /opt/HTTPServer/plugins/config/webserver1/plugin-cfg.xml
  4. 「適用」をクリックし、変更を保存し、同期します。
  5. 変更を有効にするには、ODR を再始動してください。 plugin-cfg.xml は ODR が開始するたびに、 ODR が処理する URI に影響する管理アクションがある場合、 および、環境において plugin-cfg.xml ファイルの内容に影響するような変更がある場合に、生成されます。

タスクの結果

構成変更があると、ODR は自動的に plugin-cfg.xml ファイル を更新します。

次のタスク

ODR によって自動的に生成される plugin-cfg.xml デフォルト属性 値をオーバーライドすることができます。詳しくは、 『plugin-cfg.xml ファイルの生成の制御』を参照してください。

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



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