構成文書

WebSphere® Application Server は、ディレクトリーのカスケード階層内の複数の文書に構成データを保管します。ほとんどの構成文書には XML コンテンツが入っています。

構成文書には、サーバーとその構成および内容が記述されています。

文書のディレクトリー階層

構成文書に加えられた変更は、セル・リポジトリーに保管されます。

階層の最上位は cells ディレクトリーです。 ここには、セルのサブディレクトリーが保持されます。 セルのサブディレクトリーの名前は、セルの名前と一致します。 例えば、cell1 というセルの構成文書は、サブディレクトリー cell1 にあります。

セルの下のサブディレクトリーには、 セル内のノードおよびサーバーの完全な文書セットが含まれます。

個々のセルのサブディレクトリーに、以下のファイルとサブディレクトリーがあります。

  • cell.xml ファイル。 セルの構成データを提供します。
  • security.xml、virtualhosts.xml、resources.xml、variables.xml などの ファイル。セル内のノードに適用される構成データを提供します。

  • nodes サブディレクトリー。 セル内のノードのサブディレクトリーを保持します。 ノードのサブディレクトリーの名前は、ノードの名前と一致します。

    ノードのサブディレクトリーには、variables.xml および resources.xml などの、 ノード全体に適用される構成データを提供するファイルが保持されます。 これらのファイルが、 これらを含んでいるセルのディレクトリー内のファイルと同じ名前であることに注意してください。 これらのノード文書で指定される構成は、 同名のセル文書で指定される構成をオーバーライドします。 例えば、セルとノードの両レベルの variables.xml ファイルに 特定の変数がある場合、このノード上のサーバーはノード文書内の変数定義を使用し、 セル文書内の定義は無視します。

    ノードのサブディレクトリーには、 ノード上で定義されるサーバーのサブディレクトリーが保持されます。 サブディレクトリーの名前は、サーバーの名前と一致します。 サーバーのサブディレクトリーには、 そのサーバーに固有の構成データを 提供する server.xml ファイルが保持されます。 サーバーのサブディレクトリーには、 security.xml、resources.xml および variables.xml などの、 サーバーにのみ適用される構成データを提供するファイルが保持されることがあります。 これらのサーバー文書で指定される構成は、 これらを含むセル、および同じ名前を持つノード文書で指定される構成をオーバーライドします。

  • applications サブディレクトリー。 ここには、セルにデプロイ済みのアプリケーションごとのサブディレクトリーが保持されます。 アプリケーションのサブディレクトリー名は、デプロイ済みのアプリケーション名と一致します。

    各デプロイ済みアプリケーションのサブディレクトリーには、 アプリケーションのデプロイメントにおける構成データの入った deployment.xml ファイルが保持されます。 各サブディレクトリーには、IBM® デプロイメント拡張ファイルおよびバインディング・ファイルのみでなく、 Java™ 2 Platform, Enterprise Edition (J2EE) アプリケーションのデプロイメント記述子ファイルを保管する META-INF サブディレクトリーも保持されます。 デプロイ済みアプリケーションのサブディレクトリーには、 そのアプリケーションのすべての .war および エンティティー Bean .jar ファイルのためのサブディレクトリーも保持 されます。 .jar ファイルのようなバイナリー・ファイルも、構成構造の一部です。

以下に、ファイル構造の例を挙げます。

cells
  cell1
     cell.xml resources.xml virtualhosts.xml variables.xml security.xml
     nodes
        nodeX
           node.xml variables.xml resources.xml serverindex.xml
           serverA
              server.xml variables.xml
     applications
        sampleApp1
           deployment.xml
           META-INF
              application.xml ibm-application-ext.xml ibm-application-bnd.xml
        sampleApp2
           deployment.xml
           META-INF
              application.xml ibm-application-ext.xml ibm-application-bnd.xml

構成文書の変更

管理ツールのいずれか (コンソール、wsadmin、Java API) を使用して、構成文書を変更したり、 直接編集したりできます。 管理コンソールは構成に対して行われる変更のすべてを検証するため、 管理コンソールを使用する方をお勧めします。 構成文書の説明で、 管理ツールを使用して文書を編集できるか、あるいは直接編集しなければならないかを説明しています。

構成ファイルの変換

WebSphere Application Server のマスター構成リポジトリーには、セル内のすべてのノードの構成ファイルが保管されています。デプロイメント・マネージャーをアップグレードして、WebSphere Application Server のリリースを新しくすると、マスター・リポジトリーに保管された前のリリースのノードの構成ファイルは、新しいリリースのフォーマットに変換されます。

この変換により、デプロイメント・マネージャーは、構成ファイルを一律に処理することができます。ただし、前のリリースのノードは、新しいリリースのフォーマットの構成ファイルをそのまま使用することはできません。WebSphere Application Server では、マスター・リポジトリーの構成ファイルを前のリリース上にあるノードに同期する場合に発生する問題に対応しています。構成ファイルは、最初に前のリリースのフォーマットに変換されてから、ノードに適用されます。WebSphere Application Server は、構成文書を以下のように変換します。
  • XML 名前空間を新しいリリースのフォーマットから前リリースのフォーマットに変更します。
  • 新しいリリースのみに適用可能なセル・レベルの文書の属性を除去します。
  • 前のリリースのノードでは認識されない新しいリソース定義を除去します。

トピックのタイプを示すアイコン 概念トピック



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