構成文書
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 のリリースを新しくすると、マスター・リポジトリーに保管された前のリリースのノードの構成ファイルは、新しいリリースのフォーマットに変換されます。
- XML 名前空間を新しいリリースのフォーマットから前リリースのフォーマットに変更します。
- 新しいリリースのみに適用可能なセル・レベルの文書の属性を除去します。
- 前のリリースのノードでは認識されない新しいリソース定義を除去します。
概念トピック