配置文档

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

配置文档描述可用的应用程序服务器、它们的配置和内容。

文档的目录层次结构

目录的级联层次结构和文档的结构支持多节点复制,以同步单元中所有服务器的活动。在 WebSphere Application Server Network Deployment 环境中,对单元存储库中配置文档所进行的更改会自动复制到在该单元中各节点上存储的相同配置文档。

层次结构的顶层是 cells 目录。对于每个单元它都有一个子目录。单元子目录的名称匹配单元的名称。例如,子目录 cell1 中有名为 cell1 的单元的配置文档。该单元的名称必须与集群名称对不同。

WebSphere Application Server Network Deployment 节点上,单元子目录包含该单元上所有节点和服务器的全部文档集。在其他节点上,只有适用于该特定节点的文档集。如果配置文档仅适用于 node1,那么该文档存在于 node1 上的配置中以及 WebSphere Application Server Network Deployment 配置中,而不存在于单元中的任何其他节点上。

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

  • cell.xml 文件,它提供单元的配置数据。
  • 诸如 security.xmlvirtualhosts.xmlresources.xmlvariables.xml 等文件,这类文件提供应用到单元中的每个节点的配置数据。

  • clusters 子目录,它下面有在单元中定义的每个集群的子目录,分别与集群的名称对应。

    每个集群子目录都有 cluster.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
           nodeAgent
              server.xml variables.xml
        nodeY
           node.xml variables.xml resources.xml serverindex.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)修改配置文档或直接对它们进行编辑。由于管理控制台能对配置更改进行验证,所以使用它较好。“配置文档描述”说明您可以使用管理工具编辑文档还是必须直接对它进行编辑。

对于转换用户 对于转换用户: V8.x 配置文档中不再存在下列 z/OS 变量定义:
  • 服务器范围 variables.xml 中的 private_Enable_zWAS_for_64bit
  • server.xml 中用于控制进程、服务方进程或助手进程的 processDefinition 中的 AMODE=64
  • server.xml 中用于控制进程的 processDefinition 中的 was.com.ibm.websphere.zos.jvmmode
在 V8.0 中,在服务器进程的 Start 命令参数中看不到 AMODE=64。要查看服务器当前的位方式,请完成下列步骤:
  • 使用 wsadmin 运行 AdminTask 命令来获取所使用的位方式。
  • 使用管理控制台在“应用程序服务器设置”页面上查看以 64 位 JVM 方式运行。单击服务器 > 服务器类型 > WebSphere 应用程序服务器 > server_name
trns

配置文件的变换

WebSphere Application Server 主配置存储库存储单元中所有节点的配置文件。将 Deployment Manager 从 WebSphere Application Server 的一个发行版升级到另一个发行版时,在主存储库中存储的旧发行版上节点的配置文件将转换为新发行版的格式。

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

指示主题类型的图标 概念主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ccfg_confdoc
文件名:ccfg_confdoc.html