weblogic中文文档domainconfig.docx

1、weblogic中文文档domainconfigweblogic中文文档domain_config第一章 介绍与导览本文描述Weblogic Server的域以及如何配置域。域是WebLogic Server的基本管理单元。一个域可以包括一个或多个WebLogic Server实例以及相关资源，只需使用一个Administration Server进行管理。以下章节描述该指南的内容与结构理解域配置。 文档范围与读者 文档向导 相关文档 示例与指南 该发布版本中新的域特性文档范围与读者文档主要适用于基于一个或多个Weblogic server域开发和部署Web应用的J2EE系统架构师、应用开发人

2、员和系统管理员。文档的主题仅和软件项目的设计与开发阶段相关，不涉及产品过程管理、监控或者性能调整。对于这些主题的WebLogic Server文档和资源链接，参见“相关文档”。文档假定读者熟悉J2EE，XML的基本概念以及应用管理的一般概念。文档向导 本章“介绍与导览”，介绍该指南的目的、结构和上下文关系。 第二章“理解WebLogic Server域”介绍Weblogic Server域。 第三章“使用WebLogic工具配置域”，展示你可以用来修改域配置的几种工具。 第四章“域配置文件”描述维护域和域的内容的磁盘表现形式的配置与目录。 第五章“管理配置变更”描述如何变更Weblogic S

3、erver的管理特性。相关文档关于用于创建和配置Weblogic Server域的工具的更多信息，参见： 使用配置向导创建WebLogic域 WebLogic脚本工具 使用JMX部署可管理的应用 WebLogic Server命令参考 管理控制台在线帮助关于其他系统管理任务的信息，参见系统管理文档，尤其是： 设计和配置WebLogic Server环境 使用WebLogic Server集群示例和向导BEA系统公司为本文档提供了和域配置、管理相关的以下代码示例和指南： BEA WebLogic Server的示例安装（可选）于目录WL_HOME/samples/server/examples/

4、src/examples，WL_HOME是你安装WebLogic Server的顶级目录，这些示例也可以通过Windows开始菜单使用。集群示例会在BEA WebLogic Server集群指南示例中描述，指导你掌握使用WebLogic配置向导和管理控制台来创建和配置一个新的server实例集群的整个过程。本版中新的域特性Weblogic Server 9.0在Weblogic Server域配置中引入了几项重要变化： config.xml的XML Schema 域目录结构 配置变更管理config.xml的XML SchemaWebLogic Server域和实例配置的磁盘表现形式在本版本中

5、有所不同。在原版本中，配置信息被保存在单个XML仓库文件config.xml中，默认位于user_projects/domains/domain_name目录下。在本版的WebLogic Server中，config.xml文件符合XML Schema定义（用来验证域配置文件格式的有效性）。而且，config.xml融合了其他配置文件（符合各自的XML Schema）的配置信息。在本版中，config.xml默认位于user_projects/domains/domain_name/config目录下，config.xml核心文件涉及的辅助配置文件位于user_projects/domains

6、/domain_name/config目录的子目录中。更多信息，参见第四章“域配置文件”。域目录结构本版中，Weblogic Server域在磁盘上的目录结构有了改变。域的父目录命名为domains。域的配置信息保存在domains/domain_name/config目录和config目录的子目录中。更多信息，参见“域目录内容”。配置变更管理WebLogic Server提供了一些新特性用来管理服务配置变更，这使你可以安全、可预知地实现分发某个域的配置变更。当然这要求你在使用控制台进行配置变更前获得管理员控制台锁。The change management process in WebLog

7、ic Server loosely resembles a database transaction. The Administration Server maintains a separate, editable representation of the domains configuration, which is referred to as the edit hierarchy. Server instances do not refer to the edit hierarchy. Instead, server instances use a read-only hierarc

8、hy to discover their configuration. To start the edit process, you obtain a lock on the edit hierarchy to prevent other people from making changes. When you finish making changes, you save and distribute them to all server instances in the domain. When you distribute changes, each server determines

9、whether it can accept the change. If all servers are able to accept the change, they update their working configuration hierarchy and the change is completed.WebLogic Server中的变更管理过程大致类似于数据库事务。管理服务器维护一个域配置的分离、可编辑的表示，指向编辑层。server实例并不指向编辑层。相反，server实例使用一个只读层发现配置。为了开始一个编辑过程，你可以获得编辑层锁以防止其他人更改。当你完成更改后，你保存

10、并将其分发至域中的所有server实例。当你分发完后，每一个server决定是否接受变更。如果所有的server都能够接受该变更，它们更新工作配置层，变更完成。现在的管理控制台包括一个名为Change Center（变更中心）的区域。当你使用管理控制台进行配置变更时，你必须首先通过点击Change Center的Lock & Make Changes（锁且变更）获得锁。进行期望的配置变更以后，然后可以在Change Center： 点击Activate Changes（激活变更）接受更改，向域中的sever实例分发，或者 点击Undo All Changes（撤销所有变更），释放锁。WebLo

11、gic Server一般采用相同方式控制配置变更，无论变更是使用管理控制台实现，还是WebLogic 脚本工具、配置管理服务或者JMX API。更多信息，参见第五章“管理配置变更”。第二章 理解Weblogic Server域以下章节介绍Weblogic Server域和域的内容： 域是什么 组织域 域的内容 域约束域是什么？一个Weblogic Server管理域是逻辑上相关的Weblogic Server资源组。域包括一个特殊的Weblogic Server实例，叫做管理服务器（Administration Server），这是你配置和管理域的所有资源的关键。通常，你配置的一个域会加入另外

12、的WebLogic Server实例，叫作托管服务器（Managed Server）。你的Web应用、EJB和其他资源会部署在托管服务器上，而管理服务器只是用于配置和管理。多个托管服务器可以组织成集群（clusters），这使你能够保持负载平衡和对于临界的应用提供失败保护，同时只使用一个管理服务器会使托管服务器实例的管理变得简单。组织域如何将WebLogic Server装置组织成域，这取决于你的业务需求。你可以基于系统管理员职责、应用边界或者server运行的地理位置的不同定义多个域。与之相反，你也可以决定将所有WebLogic Server管理行为集中于一个域。根据你特定的业务需求和系统管

13、理实际，你可以按照如下标准决定如何组织你的域： 应用的逻辑区分。比如，你可以有一个域用于类似购物车的终端用户功能，另一个域用于后台记账。 物理位置。你可以为业务的不同地理位置和分支分别建域。 大小。你会发现域被组织成更小的单元可能会使不同的系统管理员管理效率更高。反之，你也会发现维护单个域或者少量的域，配置更容易保持一致。一个域由一个管理服务器和一个或多个托管服务器组成，也可以只由单个孤立的server组成，既扮演管理服务器的角色又驻留应用。 由分散的托管服务器组成的域：简单的产品环境由几个驻留应用的托管服务器，一个执行管理操作的管理服务器组成。在这种配置下，应用和资源部署在各自的托管服务器中

14、；类似地，访问应用的客户端与各自的托管服务器连接。如果产品环境对增强应用性能、吞吐量或者可用性有要求，那么应该将两个或者更多的托管服务器配置成集群。机群允许多个托管服务器作为单个个体驻留应用和资源。关于在孤立的和集群托管服务器之间差异的更多信息，参见“托管服务器和托管服务器集群”。 孤立的server域：对于开发或测试环境而言，你可能想在部署单个应用和server独立于产品域中的server。这种情况下，你可以部署一个简单域，只由单个server实例组成，既作为管理服务器，又驻留你开发的应用。你用WebLogic Server安装的wl_server域就是一个孤立server域的例子。注意：在

15、产品环境中，BEA建议你只在域中的托管服务器部署应用，管理服务器应当只负责管理任务。域的内容尽管域的范围与目的会有很大差异，但是大多数 WebLogic Server域都包含本章节中描述的组件。下图展示了产品环境，包括一个管理服务器，三个孤立的托管服务器和三个托管服务器组成的集群。管理服务器每个Weblogic Server域都必须有一个server实例作为管理服务器。你使用管理服务器（编程或者通过管理服务器）来配置域中的所有其他server实例和资源。管理服务器的角色在启动域的托管服务器之前，应先启动管理服务器。当你启动一个孤立或集群托管服务器时，它会按配置信息与管理服务器相联。这种方式下，

16、管理服务器在整个域配置中充当核心控制体。当管理服务器启动时，加载域的config.xml文件，除非你在创建域时指定另一个目录存储config.xml。BEA_HOME/user_projects/domains/mydomain/config这里mydomain是特定域的目录，名称与域相同。config.xml引用的其他配置文件，位于域的config目录的子目录下。管理服务器每一次成功启动后，将在域目录中创建一份命名为config-booted.jar的备份配置文件。万一配置文件在server实例生命周期内有损坏，有可能恢复原先的配置。如果管理服务器出错会发生什么？域的管理服务器出错不会影响域

17、中的托管服务器的操作。如果域的管理服务器变得不可用，而它所管理的server实例集群或者其他方式仍在运行，那么那些托管服务器将继续运行。如果该域包含集群server实例，那么由域配置支持的负载平衡和失败性能保持可用，即使管理服务器出错。如果域的管理服务器停止运行而托管服务器继续运行，那么每一个托管服务器会周期性地尝试重新连接管理服务器，周期由ServerMBean属性AdminReconnectIntervalSecs指定。AdminReconnectIntervalSecs默认为10秒。如果管理服务器因为主机的硬件或软件错误而失败，同一台机器的其它server实例都可能受到同样的影响。然而，

18、管理服务器自身的失败不会中断域的托管服务器的运行。而且即使管理服务器不在运行状态，你也可以启动托管服务器。这种情况下，托管服务器使用配置文件的本地拷贝来作为它的启动配置，然后周期性地向管理服务器作连接尝试，连接后利用管理服务器来同步配置状态。对于重启管理服务器的指令，参见“管理服务器启动与关闭”。托管服务器和托管服务器集群在域中，非管理服务器的server实例，指向托管服务器。托管服务器驻留构成你应用的组件和相关资源，比如JSP和EJB。当某个托管服务器启动后，它会连接域的管理服务器来获得配置和部署设置。注意：即使管理服务器不可用，域中的托管服务器也可以独立于管理服务器启动。更多信息参见“管理

19、server启动与关闭”中的“避免server失败与恢复”。两个或更多的托管服务器可以配置成一个WebLogic Server集群，来增加应用的可伸缩性与可用性。在WebLogic Server集群中，大多数资源与服务平均部署给每一个托管服务器（与单个托管服务器相反），来使失败与负载平衡。要想了解哪种组件类型和服务可以进行集群（部署给集群中的所有server实例），参见“使用WebLogic Server集群”中的“理解WebLogic Server集群”。你可以创建一个非集群的托管服务器，然后通过配置有关server实例和集群的参数将其加入集群。你也可以通过重新配置参数从集群中删除某个托管服

20、务器。在集群与非集群托管服务器之间的根本区别在于对失败和负载平衡的支持。这些特性仅在集群托管服务器中可用。你对于可伸缩性与可靠性的要求将决定你是否采用集群托管服务器。比如，如果你的应用不常遇到易变的加载，应用服务中可能的中断也是可以接受的，那么就没有必要采用集群。关于WebLogic Server集群的好处与性能的更多信息，参见“使用WebLogic Server集群”中的“理解WebLogic Server集群”。单个域可以包含多个WebLogic Server集群，同样多个托管服务器也可以不被配置成集群。资源与服务除了管理服务器和托管服务器之外，域还包括托管服务器所需的资源和服务及部署在该

21、域上的应用。域配置包括域运行的网络计算机环境信息，比如： Machine definitions identify a particular, physical piece of hardware. A machine definition is used to associate a computer with the Managed Servers it hosts. This information is used by Node Manager in restarting a failed Managed Server, and by a clustered Managed Serve

22、r in selecting the best location for storing replicated session data. For more information about Node Manager, see Using Node Manager to Control Servers in Designing and Configuring WebLogic Server Environments. 网络通道，一个可以用来定义默认端口、协议和协议设置的可选资源。在创建一个网络通道后，可以将它分配给域中任意一个托管服务器和集群。更多信息，参见“设计与配置WebLogic Se

23、rver环境”中的“配置网络资源”。域配置还包括与驻留在域中应用相关的资源和服务信息。这些资源和服务的例子包括： 应用组件，比如EJB 连接器 JDBC连接池 JMS server 启动类资源和服务可能被限制于域中一个或多个托管服务器，而不是对于整个域可用。你可以选择托管服务器或者集群进行部署资源与服务。域约束WebLogic Server环境可以由单个域组成，包括驻留应用所需的所有托管服务器，也可以是多个域。你可以选择创建多个域，根据组织单元、系统管理员职责、应用边界或者其它要考虑的事项来划分。在设计域配置时，注意以下约束： 每一个域都需要自身的管理服务器执行管理操作。当你使用管理控制台执行

24、管理和监控任务时，你可以在域中来回切换，同时你会连接不同的管理服务器。 同一个集群中的所有托管服务器必须位于相同的域，你不能将集群拆分至多个域。 同一个域中的所有托管服务器运行的WebLogic Server软件版本必须相同。域中的管理服务器可以和托管服务器运行相同的版本，也可以是更新的版本。你不能在域中共享配置资源与子系统。比如，如果你在一个域中创建了一个JDBC连接池，你就不可能在另一个域中的托管服务器或集群中使用。代之，你必须在第二个域中创建一个类似的连接池。第三章 使用Weblogic工具配置域WebLogic包括了你可以用来创建、修改或者复制域配置的一系列工具。包括以下工具： 域配置

25、向导域配置向导是创建一个新的域或集群的推荐工具。关于使用域配置向导的更多信息，参见“使用配置向导创建WebLogic域”。 WebLogic Server管理控制台管理控制台是管理服务器的图形化用户界面（GUI）。管理控制台描述参见“管理控制台在线帮助”。 WebLogic脚本工具（WLST）你可以使用命令行脚本接口来创建、管理和维护WebLogic Server配置变更。WebLogic脚本工具描述参见“WebLogic脚本工具”。 WebLogic Server应用编程接口（API） 你可以使用WebLogic Server提供的API编写程序修改配置属性。JMX API描述参见“使用JM

26、X开发可管理的应用”。 WebLogic Server命令行工具该工具允许你创建脚本来自动进行域管理。关于该工具的更多信息，参见“WebLogic Server命令参考”。对于大多数方式而言，要修改域配置域的管理服务器必须运行。然而，你如果使用 WLST 来进行域配置变更不需要运行管理服务器。这种情况下，WLST造成的变更也不会立即生效直到管理服务器和托管服务器重启。域配置文件本章节描述如何在文件系统中表示域。它包括以下部分： 配置文件概览 config.xml 域域目录概览 域目录内容域配置文件概览WebLogic Server管理和配置服务通过Java管理扩展（JMX）API来访问。域的配

27、置保存在域目录下的配置目录中。这些配置目录中的文件用来持久化存储WebLogic Server在使用JMX API运行期间创建和修改的托管对象。config.xml的目的是存储托管配置对象的变更以使得WebLogic Server重启时可以访问。域的核心配置文件为domain_name/config/config.xml文件。它指定域的名称和域中每一个server实例、集群、资源和服务的配置参数。域的一些主要子系统配置保存在domain_name/config目录的子目录中。域目录还包括你用来启动域的管理服务器和托管服务器的默认脚本文件。config.xml域的核心配置文件为/domains/

28、domain_name/config/config.xml文件。它指定域的名称和域中每一个server实例、集群、资源与服务的配置参数。config.xml文件符合XML Schema，URL为 Schema来修改和验证config.xml文件。编辑配置文件大多数情况下，你不应该直接修改config.xml或其他配置文件，而应该使用管理控制台或者用第三章“使用WebLogic工具配置域”中列出的某个工具来修改域配置。配置变更将会映射到配置文件中。Directly modifying configuration files may be appropriate if you choose to

29、place configuration files and other components of your installation under source control, managing them using WLST.警告：当WebLogic Server运行时你不能编辑配置文件，因为WebLogic Server会周期性地重写该文件。你的更改将会丢失，也可能造成WebLogic Server失败，这取决于你的平台。Since the WebLogic Server configuration files are well-formed XML files, it is possi

30、ble to script certain repetitive changes using an XML parser application such as Apache Xerces, or JDOM.Be sure to test any scripts you create thoroughly and always make a backup copy of each configuration file before you make any changes to it.因为WebLogic Server配置文件是格式友好的XML文件，因此它有可能使用XML解析程序比如 Apac

31、he Xerces, or JDOM 。辅助配置文件在原版本中，config.xml文件存放了所有配置信息。新版本中，几个WebLogic Server子系统被配置在辅助配置文件中，由核心的config.xml来引用。这些辅助配置文件位于/domains/domain_name/config目录的子目录中。关于辅助配置文件的更多信息，参见“域目录概览”和“域目录内容”。配置文件压缩包WebLogic Server对配置文件作备份拷贝。万一配置变更需要推倒重来或者配置文件被破坏（当然这种情况不太可能），这使得恢复很容易。当管理服务器启动时，它将配置文件保存在一个命名为config-booted.jar的JAR文件中。当你变更配置文件时，旧文件以JAR文件的形式保存在域目录下的configArchive目录中，命名带数字序列，比如config-1.jar。域目录概览图4-1是域目录树型结构的概览。 domain-name 、deployment-name和server-name目录名称不是字面所示，实际上替换成任何指定的名称都是