配置文档

WebSphere® Application Server 将配置数据存储在目录的级联层次结构中的多个文档中。 大多数配置文档具有 XML 内容。

配置文档描述您的服务器及其配置和内容。

文档的目录层次结构

对配置文档所作的更改存储在单元存储库中。

层次结构的顶层是 cells 目录。 该目录下有单元子目录。 单元子目录的名称与单元的名称相匹配。 例如,子目录 cell1 中有名为 cell1 的单元的配置文档。

单元子目录包含该单元中节点和服务器的全部文档集。

每个单元子目录都具有下列文件和子目录:

  • cell.xml 文件,它提供单元的配置数据。
  • 诸如 security.xmlvirtualhosts.xmlresources.xmlvariables.xml 之类的文件,这类文件提供适用于单元中的节点的配置数据。

  • nodes 子目录,该子目录下有子目录,分别与单元中的节点对应。 节点子目录的名称与节点的名称相匹配。

    节点子目录中包含一些文件(如 variables.xmlresources.xml),这些文件提供适用于该节点的配置数据。 注意,这些文件的名称与文件所属单元的目录中所包含相应文件的名称相同。 这些节点文档中指定的配置覆盖同名的单元文档中指定的配置。 例如,如果特定变量在单元级别和节点级别的 variables.xml 文件中,那么节点上的服务器将使用节点文档中的变量定义,而不使用单元文档中的定义。

    节点子目录下有服务器子目录,分别与节点上定义的服务器对应。 子目录的名称与服务器的名称相匹配。 服务器子目录中包含 server.xml 文件,它提供特定于该服务器的配置数据。 服务器子目录会有一些文件(如 security.xmlresources.xmlvariables.xml),它们提供的配置数据仅适用于该服务器。 这些服务器文档中指定的配置覆盖服务器所属单元和所属节点中同名的文档中指定的配置。

  • applications 子目录,它下面有应用程序子目录,分别与单元中部署的每个应用程序对应。 应用程序子目录的名称与单元中部署的应用程序的名称匹配。

    每个部署应用程序子目录都有 deployment.xml 文件,它包含有关应用程序部署的配置数据。 每个子目录还包含一个 META-INF 子目录,该子目录包含 Java™ 2 Platform , Enterprise Edition (J2EE) 应用程序部署描述符文件以及 IBM® 部署扩展文件和绑定文件。 已部署的应用程序子目录还有子目录,存放应用程序中所有 .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 主配置存储库存储单元中所有节点的配置文件。 将 Deployment Manager 从 WebSphere Application Server 的一个发行版升级到另一个发行版时,会将旧发行版上节点的主存储库中存储的配置文件转换为新发行版的格式。

由于该转换,Deployment Manager 将可以统一处理配置文件。 但是,旧发行版的节点却无法轻松使用具有新发行版格式的配置文件。 WebSphere Application Server 在将配置文件从主存储库同步到旧发行版上的节点时解决了该问题。 在将配置文件提供给节点之前,首先要将它们变换为旧发行版的格式。 WebSphere Application Server 对配置文档执行以下变换:
  • 将 XML 名称空间从新发行版的格式更改为旧发行版的格式。
  • 移除仅可适用于新发行版的单元级别文档的属性
  • 移除旧发行版的节点无法识别的新资源定义