WEBLOGIC服务器管理

 

1 WebLogic服务器管理概述

本章将介绍WebLogic服务器的管理工具，内容如下：

ü       域、管理服务器以及受管理的服务器

ü       启动管理控制台

ü       运行时对象与配置对象

ü       对日志消息的集中访问

BEA WebLogic Server™ 包含了许多互相关联的资源。对这些资源的管理包括下列任务：服务器的启动及终止，服务器以及连接池的负载平衡，资源配置的监控，诊断并修改问题，监控并评估系统性能，分发Web应用、EJB以及其它资源。

WebLogic服务器提供了一个健壮的基于Web的工具——管理控制台，它是执行上述任务的主要工具。通过管理控制台，你可以访问 WebLogic 管理服务。 管理服务实现了Sun的Java 管理扩展标准（ JMX），它是 WebLogic资源管理的基础。

你可以用管理控制台来配置资源的属性，分发应用及组件，监控资源的使用情况（如服务器负载，Java虚拟机的内存使用情况以及数据库连接池的负载），查看日志消息，终止服务器，以及执行其它管理任务。

域、管理服务器与受管服务器

作为一个单元来管理的并相互关联的一组 WebLogic 服务器资源被称为域。一个域可以包含一或多个WebLogic服务器，还可以包含WebLogic服务器集群。

域的配置使用扩展标记语言（XML）定义。install_dir/config/domain_name目录中的config.xml文件定义了域的配置，install_dir是WebLogic Server软件的安装目录。

域是一个完备的管理单元。向域里分发应用的时候，该应用的各组成部分只能分发到域之内的服务器上。如果域中包含集群，那么集群中的所有服务器都必须属于同一个域。

J2EE应用是一个组件集合，这些组件被组织成一个部署单元（例如EAR,WAR, 或JAR文件）。应用所需要的各种组件——EJBs或Web应用，服务器或集群，JDBC连接池等等都定义在一个域配置中。将这些资源组合在一个单一的、完备的域中使我们可以以统一的方式来看待或访问这些相互关联的资源。

运行管理服务的WebLogic服务器称为管理服务器。管理服务集中管理并监控域的所有资源。 如果要对某个域执行管理操作，该域的管理服务器必须处于运行状态。

一个包含多个WebLogic服务器的域只能有一个管理服务器，其它服务器称为受管服务器。每个WebLogic受管服务器都会在启动时从管理服务器得到各自的属性配置。

管理服务器和WebLogic受管服务器启动时都运行webLogic.Server类。没有作为受管服务器启动的WebLogic服务器就是管理服务器。

在生产环境中，系统的典型配置是这样的：应用及业务逻辑组件被分发在多个受管服务器上，而管理服务器则负责配置及监控受管服务器。管理服务器的作用是配置与监控受管服务器。如果管理服务器宕机了，部署在受管服务器上的应用不受影响，可以继续处理客户端的请求；这种情况下，当管理服务器被重启后，可以重新获得对活动域的控制（详细内容，参见“受管服务器运行时重启管理服务器”中的内容）。

把应用或应用组件分散到一组受管服务器上能带来一些好处。将EJB以及其它组件分布到一组服务器上可以保证主应用的可用性。如果不同的组件完成不同的功能可以提高系统的性能，例如将数据库访问与帐单事务分在不同的受管服务器上处理。象EJB这种可以实现各种功能的组件或应用是可以被隔离开的，从而使它的可用性不依赖于其它组件的状态。多个应用可以部署在一个域中。

当管理服务器使用这样的配置启动以后，我们说该域是活动（active）的。在管理服务器运行期间，只有管理服务器才可以修改配置文件。管理控制台及命令行管理工具提供了访问管理服务器的手段，你可以通过它们来修改域的配置。一个域被激活后，可以通过管理控制台监控或配置整个域的资源。

配置存储库（configuration repository）还保存了其它非活动的配置文件，你可以通过管理终端来编辑这些文件。配置存储库由位于/config目录下的一系列子目录构成。任何域都是由位于一个与该域同名的子目录下的config.xml唯一定义的。你可以通过管理控制台在启动时出现的欢迎页面上的Configuation链接来访问非活动的配置文件。

启动管理控制台

管理控制台是一个Web应用，它使用JSP来访问管理服务器所管理的资源。

管理服务器启动以后（见“启动与终止WebLogic服务器”），在浏览器中使用以下URL启动管理控制台。

http:// hostname:port/console

其中hostname为管理服务器终端的名字或IP地址，而port则为管理控制台用来监听请求的端口（缺省为7001）。如果你是用安全套接层(SSL)来启动管理服务器，那么必须在http后面加上s，如下所示。

https:// hostname:port/console

如果浏览器被配置为使用代理服务器来发送请求，要将浏览器配置改为不使用代理服务器。如果管理服务器与浏览器位于同一台机器上，那么你要确保发送给localhost以及127.0.0.1的请求没有被发送给代理服务器。

管理控制台的左窗格包含了一个树形结构，你可以通过这棵树来浏览数据表、配置页面、监控页面，或者是访问日志文件。在树中选择一个项目（即用鼠标左点项目），就可以显示某种类型的资源的相关数据或者显示某个资源的配置页面以及监控页面。树的最左边的节点是一些文件夹，如果文件夹里包含有叶子节点，那么你可以点击其左边的加号来展开树并访问叶子节点。

实体表（某特定类型的资源的数据表）是可以定制的，这可以通过减少或增加显示不同属性的列来实现。你也可以点击表格上部的“Customize this table”链接对它进行定制。表中的每一列都对应于被选中一个属性。

启动管理控制台需要输入口令。第一次可以使用与启动管理服务器相同的用户名和口令来启动管理控制台，然后你可以使用管理控制台来创建一组具有管理权限的用户，此后这些用户就可以通过管理控制台来执行管理工作了。

运行时对象与配置对象

管理服务器中有许多类似于JavaBean的Management Beans(MBeans)对象。Mbeans遵循Sun的Java管理扩展标准（JMX）。这些对象提供了对域资源的管理访问。

管理服务器包含了配置Mbeans与运行时Mbeans。管理Mbeans提供了配置属性的SET(写)与GET（读）访问。

运行时Mbeans提供了域资源信息的快照，例如当前HTTP会话的信息与JDBC连接池的负载信息。如果域的某个资源（例如Web应用）被实例化，那么服务器会创建一个Mbeans的实例来收集这个资源的信息。

当你从管理控制台访问某一资源的监控页面时，管理控制台执行GET操作获取当前的属性值。

管理服务使域资源的属性可以被动态修改，即使WebLogic服务器正在运行，也可以修改属性。许多属性改变不需要重启服务器就能生效。这时，修改后的属性不仅表示当前属性值，还会被保存到配置文件中。（有关配置WebLogic服务器的更多信息，请参见“ 配置 WebLogic 服务器与集群”中的内容。）

除了基于Web的管理控制台外，WebLogic服务器还提供了命令行工具来访问域资源配置及监控属性。可以用命令行工具创建script，使系统的管理自动化。（请参见“WebLogic域管理命令”）

日志消息的集中访问

通过管理服务器提供的域日志，你可以集中地访问所有服务器的关键系统消息。通过JMX提供的基本功能，消息可以转发到订阅该消息的实体。订阅实体通过设置过滤器来选择感兴趣的消息。本地服务器在启动时发向其它网络实体的信息称为一个布告。JMX布告使域内所有服务器的关键日志消息都被转发给管理服务器。在WebLogic受管服务器启动时，管理服务器会进行注册以便接受关键日志消息。这些消息被存储在域日志中。管理服务器向域里的每一个WebLogic服务器注册一个域日志过滤器来选择需要转发的消息。你可以通过管理控制台改变域日志过滤器，查看域日志以及查看本地服务器日志。（详细内容，请参见“ 使用日志消息管理 WebLogic 服务器”）

启动与终止WebLogic服务器

本章将介绍以下内容：

ü       WebLogic管理服务器与WebLogic受管服务器

ü       启动WebLogic管理服务器

ü       将一个WebLogic受管服务器加到域中

ü       启动WebLogic受管服务器

ü       从老版本WebLogic服务器升级

ü       通过管理控制台终止WebLogic服务器

ü       受管服务器暂停和恢复

ü       将WebLogic服务器设置为Windows服务

ü       注册启动类与终止类

WebLogic管理服务器与WebLogic受管服务器

一个 WebLogic 域由多个 WebLogic 服务器组成，其中必须有一个管理服务器，该域中的其它 WebLogic 服务器被称为受管服务器。你可以将服务器启动为WebLogic管理服务器或WebLogic受管服务器。

管理服务器是WebLogic服务器的缺省角色。因此如果域中只有一个WebLogic服务器，那么该服务器的角色就是管理服务器。在一个多服务器的域中，只有当服务器在启动时被要求从一个运行着的管理服务器获得配置时才会成为受管服务器。

管理服务器控制对WebLogic域配置的访问以及提供诸如监控及日志消息浏览等功能。用户通过管理控制台来访问管理服务器所提供的管理服务。

WebLogic受管服务器在启动时会从管理服务器获得它的配置。因此 启动一个多服务器的域只需要两个步骤：先启动管理服务器，然后启动受管服务器。

注意：受管服务器的版本必须与管理服务器的版本相同。

启动时的错误消息

在WebLogic启动时，标准日志子系统还不能用于日志记录。因此，任何在启动时发生的错误都会输出到stdOut以及一个特殊的启动日志文件——servername-startup.log文件中（其中servername是服务器的名字）。如果启动成功，那么该日志中的最后一条消息会指向本地服务器的日志文件所在的位置。有关WebLogic服务器的日志子系统的更多信息，请参见“利用日志消息管理WebLogic服务器”。

启动WebLogic管理服务器

启动WebLogic管理服务器有以下多种方式：

ü       从命令行启动

启动WebLogic服务器的命令可以手工输入，也可以把启动命令写在一个脚本中，从而避免每次启动服务器时都要重输命令。有关WebLogic服务器提供的脚本示例的详细信息，请参见“使用脚本启动WebLogic受管服务器”中的内容。

ü       从Start菜单启动WebLogic服务器（只用于Windows）

ü       如果你将WebLogic服务器安装为一个Windows服务，那么在计算机启动时WebLogic服务器将自动启动。

WebLogic服务器启动时的口令使用

安装WebLogic的过程中，会要求你输入一个用于WebLogic启动的口令。如果你是用脚本来启动管理服务器与受管服务器，那么应该在脚本中将口令加入命令参数（请参见“从命令行启动WebLogic管理服务器”）。如果启动服务器的脚本没有将口令指定为命令行参数，又没有password.ini文件，那么在启动时系统会提示你输入口令。

从Start菜单启动WebLogic管理服务器

如果WebLogic服务器是通过BEA安装程序安装的，那么你可以使用Windows启动菜单中的WebLogic Server快捷方式启动WebLogic管理服务器。选择：

Start-> Programs-> BEA WebLogic E-Business Platform-> Weblogic Server Version -> Start Default Server

其中version是指WebLogic服务器软件的版本号

调用Start菜单中的WebLogic Server快捷方式实际上就是启动了startWebLogic.cmd脚本（该脚本位于install_dir/config/domain_name目录下，其中domain_name是指域的名字，install_dir是指WebLogic服务器软件的安装目录）。

启动与终止Windows服务形式的WebLogic服务器

如果把WebLogic安装成Windows服务，那么WebLogic服务器会在计算机启动时自动启动。执行startWebLogic.cmd脚本会将WebLogic服务器启动为管理服务器。参见“从命令行启动WebLogic管理服务器”中的内容。

要使WebLogic服务器作为Windows服务运行，需要在安装时设定。有关安装及删除Windows服务形式的WebLogic服务器，请参见“ 将 WebLogic 服务器设置为 Windows 服务”。

你可以按以下步骤从服务控制面板启动或终止WebLogic服务器：

1．选择Start->Settings->Control Panel（编者注：对应中文windows就是开始->设置->控制面板->管理工具）

2．双击服务控制面板，这样便打开了服务控制面板

3．在服务控制面板中找到WebLogic服务器。如果WebLogic已经启动，你可以使用Stop按扭来终止WebLogic服务器。如果WebLogic已经终止，那么Start按扭就可以被用来启动WebLogic服务器。

Windows服务有三种模式：自动，手动与禁用。你可以通过Startup按钮来选择其中一种模式。

从命令行启动WebLogic管理服务器

因为WebLogic服务器是一个Java应用，因此与其它Java应用一样，你可以使用Java命令来启动WebLogic服务器。启动WebLogic服务器的参数非常长，因此如果要从命令行来启动它，那么你必须输入一长串的参数，这是非常烦人的。为了保证启动命令的正确性，BEA建议你将命令写入到一个脚本中，然后用这个脚本来启动WebLogic服务器。

以下参数是用Java命令行启动WebLogic管理服务器所必需的：

ü       Java堆内存的最大与最小值

例如，你想使用缺省的64M堆内存来启动WebLogic服务器，那么你就应该使用java –ms 64m 与–mx 64选项来启动服务器。

上述参数值会影响WebLogic服务器的性能，上面所提供的值只是一个缺省值。在生产环境中，你应该仔细考虑应用及环境所要使用的堆内存的大小。

ü       设置java –classpath选项

该选项的最简要的设置可以参见“设置类路径选项”

ü       指定服务器的名字

域的配置通过服务器名字指定。在命令行中通过以下参数来指定服务器的名字：

-Dweblogic.Name=Servername

缺省值为myserver。

ü       提供用户名与口令

缺省用户为system，口令为安装时所输入的口令。要将WebLogic管理服务器启动为某一特定用户，那么命令行应该使用以下参数：

-DwebLogic.management.username=username

使用以下参数给出该用户的口令：

-DwebLogic.management.password=password

ü       如果你不是从WebLogic根目录启动WebLogic服务器，那么需要指定WebLogic根目录的位置。

域的安全资源以及配置存储库（缺省为/config目录）位于WebLogic根目录下。你可以用以下参数在命令行中指定WebLogic的主目录：

-Dweblogic.RootDirectory= path

其中path是主目录的路径。如果命令行中没有指定该属性，那么当前目录就被设置为该属性的动态值。

ü       如果要使用SSL协议，那么在启动时需要把私钥密码传递给服务器以便服务器可以对SSL私钥文件解密。在命令行中用以下参数来传递SSL私钥口令：

-Dweblogic.pkpassword= pkpassword

其中pkpassword是SSL私钥密码。

ü       在命令行中使用以下参数可以在启动管理服务器时指定域配置文件的名字：

-Dweblogic.Domain=domain_name

其中domain_name是域的名称。用来启动域的配置文件保存在同名子目录下。

配置存储库由/config目录下的域组成。配置存储库可能包含多个域配置。每个域分别位于一个子目录中，子目录的名字与域的同名。指定domain_name时，实际指定的是这个子目录的名字。所指定的子目录包含了一个XML配置文件（config.xml）以及对应域的安全资源（见下面的例子）。域的配置由config.xml文件指定。

图1.1 –    配置存储库中域目录中的内容

启动管理服务器所使用的域配置使这个域成为活动域。

ü       在命令行中还可以指定WebLogic配置属性的值。所指定的值成为属性的运行时值。而保存在永久配置中的值将被忽略。在命令行中设置WebLogic属性的值采用以下格式：

-Dweblogic. attribute= value

设置类路径选项：

以下参数必须包含在java命令行的classpath选项中

ü       /weblogic/lib/weblogic_sp.jar

ü       /weblogic/lib/weblogic.jar

ü       WebLogic服务器还包含一个名为Cloudscape的数据库系统。Cloudscape数据库系统是纯Java的数据库管理系统。如果你想使用这个DBMS，那么CLASSPATH还应该包含:

/weblogic/samples/eval/cloudscape/lib/cloudscape.jar

ü       如果使用WebLogic Enterprise Connectivity，那么类路径中还应该包含：

/weblogic/lib/poolorb.jar

其中weblogic指WebLogic服务器的安装目录。

用脚本启动管理服务器

WebLogic软件提供了一个用于启动WebLogic服务器的脚本示例。你可以根据环境及应用的需要对该脚本做适当的修改。启动管理服务器与启动受管服务器使用不同的脚本。启动管理服务器的脚本为startWebLogic.sh(UNIX环境)与startWebLogic.cmd(Windows环境)。这些脚本位于域配置子目录下。

使用WebLogic软件所提供的脚本示例时，应注意以下问题：

ü       类路径的设置与目录名称

ü       将变量JAVA_HOME的值改为JDK所在的目录

ü       UNIX用户还要修改示例脚本文件的权限，以使该文件可以被执行。例如

chmod +x startAdminWebLogic.sh

在受管服务器运行时重启管理服务器

在生产环境中，我们建议将包含关键商业逻辑的应用分发在受管服务器中。这种情况下，管理服务器所起的作用只是配置与监控受管服务器。因此，在这种配置下，即使管理服务器不可用，运行在受管服务器中的应用仍然可以继续处理客户端请求。

管理服务器在启动时，会复制一份用来启动活动域的配置文件。所复制的文件被保存为：

install_dir/config/ domain_name/config.xml.booted

其中install_dir指WebLogic服务器软件所在的目录。只有当管理服务器成功启动并可以处理请求时，它才会创建config.xml.booted文件。

你应该对这个文件进行备份，它可以帮助你从被更改过的活动配置回退到以前的配置。

如果在受管服务器运行时，管理服务器发生失败，你不需要重启受管服务器来恢复对域的管理。如何恢复对活动域的管理取决于是否可以在同台机器上启动管理服务器。

在同台机器上重启管理服务器

在受管服务器正在运行的情况下重启管理服务器时，如果让管理服务器执行寻找操作，那么管理服务器会寻找到所有正在运行的受管服务器。要让管理服务器执行寻找受管服务器的操作，需要在启动管理服务器的命令行中使用以下参数：

-Dweblogic.management.discover=true

该属性的缺省值为false。域配置目录中的running-managed-servers.xml文件列出了该管理服务器能识别出的受管服务器。如果管理服务器被指示在启动时执行寻找操作，那么它将使用这个列表来检查运行着的受管服务器。

重启管理服务器不会改变受管服务器的运行时配置。因此如果你修改了那些只能静态配置的属性，那么只有重启受管服务器才能使更改生效。管理服务器的发现操作不会使管理服务器监控受管服务器或者是更改动态配置属性的运行时值。

在其它机器上重启管理服务器

如果机器崩溃导致你无法在先前运行管理服务器的机器上重启管理服务器，你可以按照以下步骤来恢复对受管服务器的管理。

1．将另一台机器的主机名设为先前管理服务器所在服务器的主机名。

2．在这台将作为管理服务器的新机器上安装WebLogic服务器软件（如果该机器上没有安装WebLogic软件的话）

3．先前用来启动管理服务器的机器中的/config目录（the configuation repository）必须可以被新机器使用。/config目录可以通过备份介质获得也可以通过NFS mount获得。该目录下包含用来启动活动域的配置文件(config.xml)以及安装在/applications目录下的应用与组件。

4．在命令行中加入以下参数来重启新机器中的管理服务器

-Dweblogic.management.discover=true

使用上述参数会强制管理服务器去检测正在运行的受管服务器。

将WebLogic受管服务器加入到域

在运行管理服务器之前，你必须在域的配置文件中添加该服务器的条目。步骤如下

1．启动域中的管理服务器

2．在浏览器中输入 http://hostname:port/console以启动管理控制台。其中hostname是运行管理服务器的主机名， port是管理服务器的监听端口（缺省为7001）。

3．在管理控制台中为服务器所在的机器创建一个条目（Machines->Create a new machine， Servers->Create a new server）（如果该服务器与管理服务器在不同的机器上）

有关服务器配置的更多内容，请参见“配置 WebLogic 服务器集群”中的内容。

启动WebLogic受管服务器

在把WebLogic受管服务器加入到配置中以后（见“将受管服务器加入到域中”），你可以用java命令行启动受管服务器。启动受管服务器的命令可以手工输入，也可以编写成脚本以避免每次重启服务器时重复输入相同的内容。有关WebLogic所提供的脚本示例请参见“用脚本启动WebLogic受管服务器”中的内容。

受管服务器与管理服务器启动参数的主要区别在受管服务器需要一个用来识别管理服务器位置的参数，受管服务器通过这个参数从管理服务器获取配置。如果命令中没有这个参数，那么WebLogic服务器将启动为管理服务器。

以下是启动WebLogic受管服务器所必须的参数：

ü       指定Java堆的最大内存与最小内存

例如，可以为WebLogic服务器分配64M Java堆内存，这是一个默认值。相应的选项为：java –ms64与 –mx64。

这两个参数的值对WebLogic服务器的性能有很大影响。在生成环境中，你应该谨慎考虑适合于应用与环境的值。

ü       设置java –classpath选项

该选项的最基本设置请参见“设置类路径选项”中的内容

ü       指定服务器的名字

当WebLogic受管服务器从管理服务器请求自己的配置信息时，管理服务器通过服务器名来识别该受管服务器，这样管理服务器就可以将合适的配置信息传递给受管服务器。因此，在启动受管服务器时，你必须设置服务器名。你可以在启动WebLogic受管服务器的命令中使用以下参数：

-Dweblogic.Name= servername

ü       提供用户名与口令

缺省的用户为System，System用户的口令是在安装时指定的。要用其它用户来启动WebLogic受管服务器，那么在命令行中使用以下参数：

-Dweblogic.management.password= password

有关如何使用口令的内容，请参见“在启动WebLogic服务器时使用口令”。

ü       如果要使用SSL协议，那么在启动时需要传入私有密钥口令以便服务器能够对SSL私钥文件进行解密。在启动服务器的命令中使用以下参数可以将SSL私有密钥传递给服务器。

-Dweblogic.pkpassword= pkpassword

其中pkppassword指的是私有密钥口令

ü       指定管理服务器的主机名与监听端口

在启动受管服务器时，必须指定管理服务器的主机名与监听端口，因为受管服务器需要从管理服务器获得配置信息。你可以在启动受管服务器的命令行中使用以下参数：

-Dweblogic.management.server= host: port

或

-Dweblogic.management.server=http:// host: port

其中host是管理服务器所在机器的名字或IP地址，port是管理服务器的监听端口。缺省情况下，该监听端口为7001

如果使用SSL与管理服务器通信，那么管理服务器必须指定为：

-Dweblogic.management.server= https:// host: port

如果管理服务器与受管服务器的通信采用SSL协议，那么你应该在管理服务器中启用SSL。详细内容请参见“安全管理”。

注意：如果WebLogic服务器在启动时没有指定管理服务器的位置，那么该WebLogic服务器将启动为管理服务器。

注意：因为受管服务器从管理服务器获得其配置，因此所指定的管理服务器必须与受管服务器在同一个域中。

ü       你可以在命令行中指定WebLogic配置属性的值。由这种方式设置的值将成为该属性的运行时值，保存在永久配置中的值将被忽略。在命令行中指定WebLogic属性值使用以下形式：

-Dweblogic. attribute= value

通过脚本启动WebLogic受管服务器

WebLogic提供了用来启动WebLogic服务器的脚本示例。你可以根据实际运行环境与应用的情况修改脚本示例。启动管理服务器与受管服务器的脚本是不一样的。启动受管服务器的脚本为startMangagedWebLogic.sh(Unix)与startManagedWebLogic.cmd(Windows)。这些脚本位于域的配置子目录中。

使用脚本示例时应注意以下事项：

ü       路径的设置与目录名称

ü       将变量JAVA_HOME的值设置为JDK所在的目录

ü       UNIX用户还应修改示例脚本的权限，使该文件成为可执行文件。例如：

chmod +x startManagedWebLogic.sh

以下是用脚本启动受管服务器的两种方式：

ü       如果已经设置了SERVER_NAME与ADMIN_URL环境变量，调用启动脚本时就不需要提供这两个参数的值了。SERVER_NAME变量应该设为要启动的WebLogic受管服务器的名字。ADMIN_URL设置为管理服务器所在机器的主机名及其监听端口（缺省为7001）。例如

set SERVER_NAME=bigguy

set ADMIN_SERVER=peach:7001

startManagedWebLogic

ü       你可以在调用启动脚本的命令中传入受管服务器的名字与管理服务器的URL。

startManagedWebLogic server_name admin:url

其中server_name是要启动的受管服务器的名字，admin_url可以是http:// host: port  或者是https:// host: port，其中host是指管理服务器所在机器的主机名或者是IP地址， port是管理服务器的监听端口。

从老版本WebLogic服务器升级

如果你想用老版本的启动脚本来启动WebLogic 6.0 服务器软件，那么你需要对该脚本作一些修改。以下是WebLogic6.0与以前版本的主要不同点：

ü       动态类装载

在启动以前版本的WebLogic服务器时，需要设置两种 类路径 (Class Path)

1．Java系统类路径

2．WebLogic类路径

WebLogic类路径属性用于动态类装载的配置。6.0版本的WebLogic不再使用WebLogic类路径属性，同时对Java系统路径也做了修改。因此，启动老版本WebLogic软件的脚本需要做相应的修改才能用来启动WebLogic 6.0 服务器。在这个版本中，需要动态装载的类由应用负责设置，这可以通过应用的XML描述符文件指定类的位置来实现。

有关Java类路径设置的信息，请参见“设置Classpath选项”。

ü       命令中不需要指定许可证文件或Policy文件所在的位置

ü       管理服务器与受管服务器的区别是在这个版本才出现的。如果你想将WebLogic服务器启动为受管服务器，那么在启动时，需要有指向一个正在运行着的管理服务器的URL。

ü       启动WebLogic受管服务器使用新的启动脚本——startManagedWebLogic.cmd（Windows）与startManagedWebLogic.sh（UNIX），而原来的startWebLogic.sh与startWebLogic.cmd则用来启动管理服务器。

从管理控制台终止WebLogic服务器

要终止一个WebLogic服务器：

ü       在管理控制台的域树上（位于左边窗格），选择要停止的服务器

ü       选择Monitoring->General标签页，点“Shutdown this server”链接

从命令行停止服务器

你可以用以下命令停止WebLogic服务器：

java weblogic.Admin -url host: port SHUTDOWN -username adminname -password password

其中：

host是运行WebLogic服务器的主机名或IP地址。

port是WebLogic服务器的监听端口（缺省为7001）。

adminname指的是具有WebLogic服务器管理员权限的用户，缺省为system。

password指的是adminname用户的口令。

暂停和恢复受管服务器

你可以通过管理控制台暂停一个WebLogic受管服务器，此时，WebLogic受管服务器只接受来自管理服务器的请求。这种情况的典型应用是将一个WebLogic服务器作为另一台服务器的“热”备份运行。该备份服务器将一直保持暂停状态，直到你让它处理请求为止。

注意：被暂停的WebLogic服务器只是不响应HTTP请求，而Java应用与RMI调用没有被暂停。

要暂停一个WebLogic受管服务器：

ü       在管理控制台的域树上（位于左边的窗格），选择你要暂停的服务器。

ü       在Monitoring->General标签页上，选择“Suspend this server”链接。

要使受管服务器恢复对客户端请求的处理：

ü       在管理控制台的域树上，选择需要恢复的服务器。

ü       在Monitoring->General标签页上，选择Resume this server链接

将WebLogic服务器设置为Windows服务

WebLogic服务器可以作为Windows服务运行。如果你将WebLogic安装为Windows服务，那么，在启动计算机时，系统会调用启动脚本startWeblogic.cmd而启动WebLogic服务器。WebLogic服务器是启动为管理服务器还是受管服务器取决于调用WebLogic服务器的java命令中的参数设置。具体内容请参见“通过命令行启动WebLogic受管服务器以及WebLogic管理服务器”。

要使WebLogic服务器以Windows服务的形式运行或者不再将其运行为Windows服务，你首先要有管理员级权限。要将WebLogic服务器作为Windows服务启动，需要：

1． 找到weblogic/config/mydomain目录（其中weblogic是安装WebLogic服务器的目录，mydomain是与你所在的域对应的子目录）。

2．执行installNTService.cmd脚本。

删除Windows服务形式的WebLogic服务器

删除Windows服务形式的WebLogic的步骤如下：

1．定位到weblogic/config/mydomain目录（其中weblogic是安装WebLogic服务器的目录，而mydomain是域配置所在的子目录）。

2．执行uninstallNTService.cmd脚本

你也可以从Windows的启动菜单中卸载WebLogic服务。

更改安装成Windows服务的服务器口令

如果你将缺省服务器安装为Windows服务，那么创建服务会用到安装WebLogic软件时键入的口令。如果要更改这个口令，你应该：

1．使用uninstallNTService.cmd脚本来卸载作为Windows服务的WebLogic服务器（该脚本位于install_dir/config/domain_name目录下，其中install_dir是安装WebLogic产品的目录）。

2．installNTservice.cmd脚本包含了以下命令：

rem *** 安装服务

“C:/bea/wlserver6.0/bin/beasvc” -install -svcname:myserver

-javahome:”C:/bea/jdk130” -execdir:”C:/bea/wlserver6.0”

-extrapath:”C/bea/wlserver6.0/bin” -cmdline:

%CMDLINE%

在上述命令后加上以下命令：

-password:” your_password”

其中your_password是新口令

3．执行更改后的installNTservice.cmd脚本。这将使用更新的口令创建一个新服务

注册启动与终止类

你可能想在WebLogic启动或正常关闭时执行某些任务，那么WebLogic所提供的启动类与终止类就是实现这些任务的一种机制。启动类是在WebLogic服务器启动或重启时自动装载并执行的Java程序，启动类在所有的服务器初始化任务都完成后才会被装载及执行。

终止类的工作原理与启动类相同。当你通过管理控制台或者是使用 weblogic.admin shutdown命令来终止WebLogic服务器时，终止类会自动装载并执行。

要使WebLogic服务器使用启动类或终止类，你必须通过管理控制台注册这些类。

注册启动类或终止类的步骤如下：

1．通过管理控制台的Domain树（位于左窗格）访问Startup & Shutdown表。在这个表中创建启动类与终止类的条目。

2．在Configuration标签页中，为所添加的终止及启动类提供名字及其它必要的参数。

详细信息，请参见管理控制台在线帮助以下部分的内容：

ü       启动类

ü       终止类

2 节点管理器

本章将介绍以下内容：

ü       节点管理器（Node Manager）概述

ü       配置与启动节点管理器

ü       受管服务器的远程启动与Killing

节点管理器概述

节点管理器是一个Java应用程序。借助该应用，你可以从管理控制台远程地启动或kill WebLogic受管服务器。节点管理器是单独的一个Java应用，随同WebLogic服务器软件供应。

你可以通过管理控制台来结束受管服务器，另一种方式是用节点管理器kill远程受管服务器。当远程服务器被hung或没有响应时，就需要杀掉远程服务器进程。

为了能远程启动受管服务器，首先要在受管服务器所在的机器上配置并运行节点管理器。一个节点管理器进行可以负责一台机器上所有受管服务器的远程启动与killing。为了保证节点管理器的可用性，应该把节点管理器配置为UNIX机器的守护程序或Windows NT机器的Windowns NT服务。这保证了机器上的管理服务器可以用来启动受管服务器。

如果一台机器中运行了节点管理服务器，那么当它获得管理服务器的请求后，可以启动或杀掉这台机器上所安装配置的任何受管服务器。节点管理器与管理服务器之间的通信采用安全套接字层（Secure Socket Layer）。

WebLogic服务器在启动时，会将各种启动与错误消息打印到STDOUT或STDERROR中。节点管理器将这些信息保存在节点管理器日志目录中的文件里，这些消息同时会显示在管理控制台的右窗格中。

缺省情况下，节点管理器的日志文件保存在节点管理器被启动时所在的那个目录中。节点管理器为每个由它启动的受管服务器创建一个日志文件子目录。

配置与启动节点管理器

节点管理器与管理服务器之间的所有通信都使用安全套接层以提供身份认证与加密。同时还用客户端验证保证节点管理器与管理服务器之间的所有通信都使用双向认证。为了进一步提高安全性，节点管理器还保存了一个可靠主机的列表。节点管理器只接受这些主机上的管理服务器所发出的命令。因此你需要为节点管理服务器编辑一个可靠主机列表文件，在文件中为每个可以向节点管理器发出命令的管理服务器所在主机加上一行。该主机列表文件的名字为nodemanager.host，安装在/config目录中。缺省情况下，该文件包括以下两个条目：

localhost

127.0.0.1

在典型的生成环境中，节点管理器与管理服务器不会运行在同一主机中。因此，应该编辑该可靠主机文件，使它只包含可以启动或killing本机受管服务器的管理服务器所在机器的主机名或IP地址。可靠主机文件的每个条目由一行构成，列出了管理服务器所在机器的DNS主机名或IP地址。

有关数字证书与安全套接层的更多信息，请参见“安全管理”中的内容。

启动节点管理器

启动节点管理器之前，首先应该保证JAVA_HOME环境变量指向了JDK的根目录。节点管理器需要用到JDK。以下是一个Window NT中的例子：

set JAVA_HOME=D:/bea/jdk130

节点管理器JDK版本的要求与WebLogic服务器的JDK版本要求一样。

类路径必须作为Java命令行的选项或者作为一个环境变量来设置。下面（在Window NT中）是一个将类路径设置为一个环境变量的例子。

set CLASSPATH=.;./lib/weblogic_sp.jar;./lib/weblogic.jar

启动节点管理器的命令为：

java weblogic.nodemanager.NodeManager

命令行参数

应该用以下参数指定节点管理器所在机器的IP地址或主机名：

-Dweblogic.nodemanager.listenAddress= address

节点管理器监听管理服务器请求的缺省端口号为5555，你可以用以下启动参数设置监听端口号：

-Dweblogic.nodemanager.listenPort= port

节点管理器为它所负责的每个受管服务器创建日志文件。缺省情况下，这些子目录位于NodeManagerLogs目录中，你可以用以下启动参数改变目录的位置：

-Dweblogic.nodemanager.saveFilesDirectory= path

节点管理器使用安全套接层与管理服务器进行通信。因此启动节点管理器时，必须指定一个数字证书。应该用以下参数指定数字证书所在的位置：

-Dweblogic.nodemanager.certificateFile= path_to_cert

如果在可靠主机文件中使用的是主机名而不是IP地址，那么应该包括以下启动参数：

-Dweblogic.nodemanager.reverseDnsEnabled=true

缺省情况下，DNS是禁用的。

可以用以下参数指定可靠主机文件所在的位置：

-Dweblogic.nodemanager.trustedHosts=path

其中path是指文件nodemanager.hosts所在的位置。

类路径选项

节点管理器要用到一些WebLogic服务器同样也要使用的Java类。在启动管理服务器时，-classpath选项中包含以下值：

ü       /weblogic/lib/weblogic_sp.jar

ü       /weblogic/lib/weblogic.jar

启动管理服务器

为了让管理服务器能够使用节点管理器来启动或结束WebLogic受管服务器，需要完成一些事情。你可以使用WebLogic管理控制台来完成这些任务。

步骤1：创建一个机器配置条目

你应该在域配置中每个安装了受管服务器的机器创建一个条目，步骤如下

1．运行管理服务器，调用管理控制台（如果还没有被运行起来）

2．在左窗格中选择Machines节点以显示机器表格

3．选择表上部的Create a new Machine链接（或Create a new UNIX Machine）。

4．填写这个机器的信息并点Apply按钮创建一个新的机器条目。

步骤2：配置每个机器的节点管理器

对于每个要使用节点管理器的机器，应该相应地改变这个机器的配置条目：

1．在管理控制台中，选择Machines-> machine_name->Node Manager。其中 machine_name是运行节点管理器的机器的名字。

2．填写Node Manager标签页的以下字段：

Listen Address:监听管理服务器请求的节点管理器所在机器的IP地址或主机名。该监听地址为你在启动节点管理器时所指定的地址。

Listen Port：该字段的值必须与你在启动节点管理器时所指定的端口号一样。

管理服务器用来与该节点管理器会话的证书。默认证书为democert。在生成环境中，建议你换一个证书。

3．点Apply按钮。

步骤3：配置受管服务器的启动信息

如果要用节点管理器启动WebLogic受管服务器，那么应该为它提供启动受管服务器所需要的启动参数与选项。步骤如下：

1．在管理控制台中，选择 server_name->Configuration->start其中 server_name是受管服务器的名字。

2．输入受管服务器启动所需要的类路径

Classpath选项中至少应该指定以下内容：

/weblogic/lib/weblogic_sp.jar

/weblogic/lib/weblogic.jar

该选项可能还需包含启动受管服务器所用到的JDK的根目录。有关设置类路径的更多信息，可以参见“启动与终止WebLogic服务器”中的内容。

3．在Arguments字段中输入启动命令所需要的参数。

例如，你想设置Java堆内存的最大最小值。可以使用-ms64m与-mx64m选项将默认的65M java堆内存指定给WebLogic服务器。

不需要指定服务器的名字，也不需要指定用户名与口令

远程启动与Killing受管服务器

如果在受管服务器所在的机器中运行了节点管理器，可以按以下步骤启动受管服务器：

1．启动管理控制台（如果它还没有运行起来）

2．在导航树（位于左窗格）中右点服务器的名字

3．选择Start this server…

在启动管理服务器时，通常打印到STDOUT与STDERROR的消息会显示在管理控制台的由窗格中。这些消息同时被写到节点管理器的日志文件中。

终止受管服务器的方式也一样：

1．右点左窗格中受管服务器的名字

2．选kill this server …

ü        

3 配置WebLogic服务器与集群

本章将介绍以下内容：

ü       服务器与集群配置概述

ü       管理服务器的角色

ü       启动管理控制台

ü       动态配置的原理

ü       服务器的配置任务列表

ü       集群的配置任务列表

ü       创建一个新的域

服务器与集群配置概述

一个域的WebLogic服务器与集群的永久配置保存在一个XML配置文件中，你可通过以下途径改变这个文件：

ü       通过管理控制台。管理控制台是用来管理与监控域配置的一个图形用户界面。这是改变或监控域配置的主要方式。

ü       使用WebLogic服务器所提供的配置应用编程接口，以编程的方式修改配置属性。

ü       通过行WebLogic服务器的命令行工具访问域资源的属性。这主要是为那些希望通过脚本自动管理域资源的用户提供的。

管理服务器的角色

无论你使用上述方式的哪一种，在修改域的配置之前首先要运行管理服务器。

管理服务器是运行管理服务的WebLogic服务器。管理服务提供了WebLogic服务器功能，同时还提供了管理域所需要的功能。

缺省情况下，WebLogic服务器的实例会成为管理服务器。当管理服务器启动时，它会从 WEBLOGIC_HOME目录的子目录Config目录中装载配置文件。与该管理服务器关联的每一个域在config目录下都有同名子目录。域的配置文件就存放在同名子目录的config.xml文件中。缺省情况下，管理服务器在启动时，首先会在缺省子目录下查找配置文件（config.xml），缺省子目录的名字为mydomain。

管理服务器启动后，会创建名为config.xml.booted的配置文件备份并将它保存在相应的域目录下。如果在服务器的生命周期中，config.xml文件遭到破坏（当然这种情况极为少见），你就可以将配置恢复到该备份文件中的配置。

一个域可能只有一个WebLogic服务器，这个服务器将是管理服务器。

在生产环境中，域由一个管理服务器与多个WebLogic服务器组成。在启动这个域的WebLogic服务器时，首先必须先启动管理服务器，其它服务器启动时，会被命令从管理服务器获得配置信息。这样，管理服务器就成为整个域的配置控制中心。一个域只能有一个活动的管理服务器，只有运行的管理服务器能够修改配置文件。

图3.1 –    WebLogic服务器的配置

启动管理控制台

访问管理服务器的主要途径是管理控制台。打开管理控制台的步骤如下：

http://host:port/console

URL中的host是管理服务器所在机器的主机名或IP地址。port是管理服务器监听请求的端口（缺省为7001）。

系统提示你输入用户名与口令。输入你的用户名与口令。系统会进行身份验证与权限检查，它依据用户数据库来验证用户号与口令。

如果通过了身份验证并被确认可以使用管理控制台，那么管理控制台将显示为系统管理员分配给你的访问模式：或者是只读模式，或者是读/写模式。

动态配置的工作原理

WebLogic服务器允许动态（即在运行时）改变域资源的配置属性，大多数情况下，不需要重启WebLogic服务器就能使修改生效。属性值的改变会立即反映到当前正在运行的属性值中，也会被作为永久值保存在XML配置文件中。

当然也会有例外。例如，如果你改变了WebLogic服务器的监听端口。新设置的端口只有等到下次重启时才生效。这种情况下，属性值的改变体现在保存属性值的XML文件中，当前的运行时配置值不同于属性文件中的值。

当属性的永久值与运行时的值不同时，管理控制台用图标表示这种情形，指示服务器需要重启才能使该值生效。

管理控制台会对用户修改的属性值进行有效验证。所支持的错误有越界错误与数据类型不匹配错误。在这两种情况下，都会弹出错误信息提示你属性值设置有误。

在管理控制台启动后，如果有其它进程使用了分配给管理服务器的监听端口，那么应该删除这个进程。如果不能删除这个进程的话，那么必须编辑Config.XML文件修改管理服务器的监听端口。有关编辑Config.XML文件的更多信息，请参见“配置参考”。

集群配置规划

在规划集群配置时，应该牢记以下关于网络环境与集群配置的限制。

1．首先，集群中的WebLogic主机必须使用静态IP地址。动态IP地址分配不能用于集群环境。如果服务器位于防火墙后面，而客户机位于防火墙前面，那么服务器必须有公共的静态IP地址，只有这样，客户端才能访问服务器。

2． 集群中的所有WebLogic服务器必须位于同一个局域网，并且必须是IP广播可到达的。

3．集群中的所有WebLogic服务器必须使用相同的版本。

配置集群中的服务器，使它们支持所提供的服务。

ü       对于使用了JDBC连接的EJB，所有分发了某EJB的服务器必须具有相同的分发与持久化配置。也就是说所有服务器都应该有相同的JDBC配置。

ü       所有分发了servlet的主机必须维护一组具有相同ACL的servlets。

ü       如果客户端应用直接使用JDBC连接池，那么你必须为每个WebLogic服务器创建相同的连接池（并具有相同的ACL）。这意味着集群所使用的连接池应该可以在所有的机器上创建。例如，一台运行WebLogic的NT服务器配置了连接Microsoft SQL Server数据库的连接池，那么一个包含非Windows机器（即不支持Microsoft SQL Server连接的机器）的集群不能使用这个连接池。

其它配置细节可能会因不同的集群成员而不同。例如，一台Solaris服务器可以比一台小的NT工作站处理更多的登录请求。这种差异是可以接受的。因此，正如这里所给出的例子，对于那些与性能相关的属性，你可以根据每个集群成员的特点来配置不同的值，只要所有成员的服务配置相同即可。因此，集群中的WebLogic服务器在所有与WebLogic服务、类文件以及外部资源（例如数据库）相关的方面具有相同的配置。

服务器配置任务列表

可以通过管理控制台进行以下服务器配置：

ü       通过管理控制台的Server节点配置单独的服务器。可以配置的属性包括名字，监听端口与IP地址。

ü       通过管理控制台的Server节点克隆一个服务器。克隆的服务器保存了原来服务器的属性值，你可以使用Server节点中的Configuration配置新服务器的名字。

ü       使用管理控制台的Server节点来删除一个服务器。点击要删除的服务器的图标，将弹出一个删除服务器的确认对话框，点击对话框中的Yes按钮将删除服务器。

ü       使用管理控制台的Server节点查看一个服务器的日志。点击要查看的服务器，点击Monitoring标签页。点击View Server Log连结，便可以在管理控制台的右窗格查看服务器日志。

ü       使用管理控制台的Server节点查看一个服务器的JNDI树。点击所要查看的服务器，然后点击Monitoring标签页，点击该页面上View JNDI Tree连接，该服务器JNDI树的信息便显示在管理控制台的右窗格中。

ü       使用管理控制台的Server节点查看服务器的执行队列。点击所要查看的服务器，然后点击View JNDI Tree连接，然后查看管理控制台右边窗格里的表格中的内容。

ü       使用管理控制台的Server节点查看server sockets。点击所要查看的服务器,点击View Sockets连接，然后查看管理控制台右边窗格里的表格中的内容。

ü       使用管理控制台的Server节点查看服务器连接。点击所要查看的服务器，点击View Connections连接，然后查看管理控制台右边窗格里的表格中的内容。

ü       使用管理控制台的Server节点进行强制垃圾收集。点击要监控的服务器，点击JVM标签页，点击页面上的Force Garbage Collection连接。将弹出是否要进行垃圾收集的确认对话框。

ü       通过管理控制台的Server节点监控服务器的安全。点击要监控的服务器，点击Monitoring标签页，点击Security标签页。将显示安全信息。

ü       通过管理控制台的Server节点查看服务器的版本。点击要查看的服务器，点击Version标签页，将显示服务器的版本信息。

ü       通过管理控制台的Server节点监控服务器集群。点击要监控的服务器，点击Cluster标签页，将显示该服务器的集群数据。

ü       通过管理控制台的Server节点来分发EJB。点击需要分发EJBs的服务器，点击需要分发的EJB并使用移动控件将它移到被选列中。点击Apply来保存你的选择。

ü       通过管理控制台的Server节点来监控分发在某一服务器上的所有EJB。点击需要监控的服务器，点击Monitor All EJB Deployments连接来显示EJB分发表。

ü       通过管理控制台的Server节点将web应用组件分发在某一服务器上。选择要分发web应用的服务器。选择需要分发的web应用，然后通过移动控件将它移到被选列中。点击Apply来保存你的选择。

ü       通过管理控制台的Server节点来监控某一服务器上的所有web应用组件。点击web应用所在的服务器，然后点击Monitor All Web Applications连接来显示Web Application Deployments表。

ü       通过管理控制台的Server节点在服务器上分发启动与终止类。点击需要分发启动类的服务器，然后点击需要分发的启动类并将它移到被选列中。点击Apply来保存你的选择。使用Shutdown Class控件来分发终止类的过程与此相同。

ü       通过管理控制台的Server节点来分配web服务器。点击一个用来分发web应用的服务器。显示在右窗格的对话框包含了与该实例相关的标签页。在Availble列中点击一到多个需要分发到该服务器的web应用，然后使用移动控件将它们移动到Chosen列中。点击Apply来保存上述选择。

ü       通过管理控制台的Server节点为服务器分配JDBC连接池。Click a server for web-server assignment。在Available列中点击一到多个JDBC连接池，并通过移动控件将所选择的JDBC连接池移到Chosen列。点击Apply来保存你所做的分配。

ü       通过管理控制台的Server节点监控某一服务器的JDBC连接池。点及一个需要监控的连接池所在的服务器。点Monitor All JDBC Connection Pools on This Server链接。分配给该服务器的所有连接池都显示在右窗格中的JDBC连接池表格中。

ü       通过管理控制台的Server节点为一个服务器分配WLEC连接池。点击需要分配WLEC连接池的服务器。在Available列中选择一个或多个要分配的WLEC连接池，使用移动控件将所选择的WLEC连接池移动到Chosen列。

ü       通过管理控制台的Server节点监控某一服务器上的所有WLEC连接池。选择一个需要监控连接池的服务器。点Monitor All WLEC Connection Pools on This Server链接，所有分配给这台服务器的连接池显示在右窗格中的WLEC Connection Pools表格中。

ü       通过管理控制台的Server节点为一台服务器分配JMS服务器，连接工厂，以及消息收信方。点击一个需要分配JMS的服务器，从Available列中选择需要分配给这个服务器的JMS服务器，然后点移动组件把所选择的JMS服务器移到Chosen列。使用JMS Connection Factories组件以及JMS Destination组件按照分配JMS服务器的步骤为服务器分配连接工厂与消息收信方。

ü       通过管理控制台的Server节点为一台服务器分配XML registries。选择要分配XML registry的服务器，从XML Registry下拉列表中选择一个registry。点Apply保存设置。

ü       通过管理控制台的Server节点分配邮件会话。选择一个要分配邮件会话的服务器。从Available列中选择要分配给服务器的邮件会话，使用移动控件把所选择的移动会话移动到Chosen列中。点Apply按钮保存设置。

ü       通过管理控制台为服务器分配文件T3s。选择一个要分配文件T3的服务器。从Available列中选择要分配给服务器的文件T3s，使用移动控件把所选择的文件T3s移动到Chosen列。点Apply按钮保存设置。

集群配置列表

通过管理控制台可以进行以下集群配置：

ü       通过管理控制台的Cluster节点配置集群服务器。可以配置的属性包括Cluster Name, Cluster ListenPort以及集群中的服务器名。

ü       通过管理控制台的Cluster节点克隆一个集群。克隆的服务器与原服务器具有相同的属性设置，包含同样的服务器。新集群的名字在Server节点中的Configuration部分设置。

ü       通过管理控制台的Cluster节点监控集群中的服务器。选择需要监控的集群，点Monitor Server Participating in This Cluster链接。该集群中的所有服务器显示在右窗格中的服务器表格中。

ü       通过管理控制台的Cluster节点为集群分配服务器。选择需要分配服务器的集群，从Available列中选择要分配的服务器，使用移动控件把所选的服务器移到Chosen列中。点Apply按钮保存设置。

ü       通过管理控制台的Cluster节点删除集群。选择Delete图标，删除一个集群，右窗格中显示一个删除确认对话框，点Yes确认你的删除请求。

新建一个域

本节说明如何创建一个新的域。所有WebLogic域的配置信息都保存在/config目录的配置存储库中。每个域在/config目录下都有一个同名子目录。

安装WebLogic服务器时，建议你对缺省的/mydomain配置目录进行备份保存在一个zip文件中。并保存该zip文件的一个备份。/mydomain目录包含了域配置的基本组件，例如fileRealm.properties文件与配置文件。

以下是新建一个域的步骤：

1． 启动一个已存在的域（例如缺省的mydomain域）中的管理服务器。

2． 使用以下URI调用管理控制台。

http:// hostname: port/console

其中hostname是管理服务器的主机名，port是管理服务器的监听端口（缺省为7001）。

3． 选择mydomain->Create或编辑其它域

这将显示domains表

4． 选择Default->Create a new Domain

输入新域的名字并点Create

5． 从左窗格的域列表中选择一个新域，使它成为当前域。

6． 为新建的域创建一个Administration Server条目。

选择Servers->Create a new Server

输入新建管理服务器的名字，然后点Create

7． 管理控制台会在/configure目录下创建一个与新建域同名的子目录，并在这个子目录中创建一个配置文件config.xml。然后使用shell命令或使用Windows的浏览器在域目录下创建一个/application子目录。

8． 将管理控制台应用复制到新建的/applications目录。即把位于mydomain域的/applications目录中的console.war文件复制到新建的/applications目录。

9． 缺省的mydomain目录中包含启动WebLogic服务器的脚本。在windows中，启动WebLogic服务器的脚本为startWebLogic与startManagedWeblogic.cmd，在UNIX中为startWebLogic.sh与startManagedWebLogic.sh。把这些启动脚本复制到新的域目录中。

10．你可以在文本编辑器中编辑上述启动脚本。缺省情况下，域的名字设置为：

-Dweblogic.Domain=mydomain

用新建域的名字代替mydomain

管理服务器的名字缺省设置为：

-Dweblogic.Name=MyServer

用新建管理服务器的名字代替上面的Myserver。

11．启动脚本的最后是一个cd命令：

cd config/mydomain

使用新建域的子目录名替换上面的mydomain。启动脚本还包含下面一行：

echo startWebLogic.cmd must be run from the config/mydomain directory

用新建域的名字替换上面的mydomain

12．把缺省域目录中的SerializedSystemIni.dat文件复制到新建的域目录中。如果还没有复制这个文件，千万别启动新建的管理服务器。

13．如果在安装时创建了password.ini文件，还必须把mydomain目录中的password.ini文件复制到新建域的子目录中。

完成上述步骤后，就可以启动新建域的管理服务器了。监控WebLogic域

本章主要介绍对WebLogic域的监控，包括以下内容：

ü       概述

ü       监控服务器

ü       监控JDBC连接池

ü       管理控制台的Monitoring页面一览表

概述

通过管理控制台，你可以对WebLogic域的性能以及运行状况进行监控。在管理控制台中，你可以查看到WebLogic资源的状态与统计数字，例如服务器、HTTP、JTA子系统、JNDI、安全性、CORBA连接池、EJB、JDBC与JMS等资源。

监控信息显示在管理控制台的右窗格中。在左窗格的域层次树上，选择一个容器或子系统或者是容器的某一实体，相关的监控信息便显示在管理控制台的右窗格中。

管理控制台提供了三种监控信息页面：

ü       某一实体的Monitoring标签页（例如JDBC连接池实例或服务器的性能）

ü       某一实体类型的数据表（例如WebLogic服务器表）

ü       域日志与本地服务器日志视图。有关日志消息的详细内容，请参见“通过日志消息管理WebLogic服务器”中的内容。

管理控制台从管理服务器获得有关域资源的信息。管理服务器包含了Management Beans(MBeans)。Mbeans基于Sun的Java管理扩展标准（JMX），它提供了对域资源的管理访问策略。

管理服务器包含两种Mbeans：配置Mbeans与运行时Mbeans.配置Mbeans用于域的配置，运行时Mbeans则提供了诸如JVM内存资源使用状况以及WebLogic服务器状态等资源的信息快照。当域中的某一资源实例化时（例如Web应用），相应地就会创建一个Mbeans实例来收集该资源的信息。

在通过管理控制台访问某一资源的Monitoring页面时，管理服务器执行Get操作来获得该资源的当前属性值。

以下部分的内容描述了部分用来管理WebLogic域的Monitoring页面。我们以这些页面为例简要说明管理控制台所提供的监控功能。

监控服务器

你可以通过服务器表格以及单个服务器的监控标签页来监控WebLogic服务器。服务器表格提供了域中所有服务器的状态摘要信息。如果服务器只将其部分日志消息上传到域日志中，那么通过本地服务器的日志来修复故障或研究事件将是非常有用的。

有关日志文件以及日志子系统的更多内容，请参见“使用日志消息管理WebLogic服务器”。

每个WebLogic服务器的监控标签页都包含了该服务器的监控数据。通过Logging标签页可以访问服务器的本地日志（即保存在运行服务器的机器上的日志）

Monitoring->General标签页显示了服务器的当前状态。从这个标签页，你还可以访问JNDI树、Execute Queues表、Active Sockets表以及Connections表。Execute Queues表包含了有关性能的信息，如挂起时间最长的请求以及当前被起的请求数量。

终止或暂停服务器

你可以通过Monitoring->General标签页来终止或暂停服务器。暂停的服务器只能接收管理服务器的请求，客户的请求被忽略。

性能

Monitoring->Performance标签页以图形的方式描述了有关JVM内存堆使用状况、请求对象与等待请求的实时数据。通过该页面，你还可以强制JVM对内存堆执行垃圾收集。

图4-1 服务性能图

Java堆中存放了Java对象（可以是活动对象也可以是死亡对象）。正常情况下，因为JVM会自动进行垃圾收集，因此不需要你手工处理。当JVM的内存要用光时，它会停止所有执行应并使用垃圾收集算法来释放不在被应用使用的空间。

另一方面，程序员在调试应用时可能会执行强制性垃圾收集。手工执行垃圾收集非常有用，例如，可以用来测试JVM内存泄漏。

集群数据

Monitoring->Cluster标签页提供了集群的信息（例如集群中有多少服务器处于活动状态）。

服务器安全

Monitoring->Security标签页包含了以下信息：无效登录的统计信息，被锁用户的统计信息与开启用户的统计信息。

JMS

Monitoring->JMS标签页提供了有关JMS服务器与连接的统计信息。在该页，你可以链接到活动JMS连接表格以及活动JMS服务器表格。通过这些表格，你可以监控诸如当前总会话数等属性。

JTA

Monitoring->JTA标签页提供了Java事务子系统的统计信息，如有关事务与所有回滚的统计信息。从该页面，你还可以链接到按资源或名字所选择的事务列表以及in-flight事务表格。

监控JDBC连接池

通过管理控制台，你可以对Java数据库连接（JDBC）子系统实行监控。在JDBC连接池的Monitoring标签页面上，你可以了解到有关连接池中的实例的统计信息。正如管理控制台的其它实体表，你可以定制该统计信息表，选择需要显示的属性。

许多属性提供了有关管理客户端数据库请求的重要信息。

Waiters Hight字段指明了最多有多少客户等待数据库连接。Waiters字段告诉你当前有多少客户正在等待连接。Connections Hight字段给出最大的并发连接数。Wait Seconds Hight字段显示了客户等待数据库连接的最长时间。通过这些属性，你可以判断当前的配置在响应用户请求方面是否有效。

如果Connections High字段的值近似于Maximum Capacity字段的值（该值在Configuration Connection标签页中设置），那么有必要考虑增加Maximum Capacity字段的值（即最大的并发连接数）。如果Waiters Hight字段的值显示用户必须经过长时间等待才能获得数据库连接，那么应该增加连接池的大小。

Shrink Period字段用来指定JDBC子系统在连接池开始进行缩减时所要等待的时间。当JDBC子系统要减小连接池的大小时，那么数据库连接将被释放。因为创建数据库连接非常消耗资源和时间，因此如果密集的客户端请求阵歇性地出现，那么比较短的收缩周期将意味数据库连接要不断地被重新创建，从而导致性能的下降。

管理控制台的Monitoring页面一览表

下表列出了管理控制台中所有的表格以及监控标签页面。

表4-1 Monitoring页面一览表

页面		页面的路径			监控的数据
Monitoring标签页面
一般的服务器信息	服务器名字-> Monitoring -> General			服务器的状态以及activation time
服务器性能	服务器名字-> Monitoring -> Performance			请求吞吐量、JVM的内存使用以及等候请求的实时图表
集群的统计信息	服务器名字-> Monitoring -> Cluster			有关集群的统计信息，如集群中活动服务器的数量、sent and received fragments
服务器的安全信息	服务器名字-> Monitoring -> Security			无效的登录数量以及所有被锁定的用户数与未锁定的用户数
服务器的版本信息	Servername -> Monitoring -> Version			JDK, WebLogic以及操作系统的版本信息
集群	Clusters -> clustername -> Monitoring			集群的相关统计信息，如the number of alive servers and sent and received fragments
实体表
服务器	Servers		服务器的相关数据，例如内存使用、启动时间、状态、cluster participation，无效登录、堆的状态、套接字的数量and total restarts
执行队列	Servername -> Monitoring -> General -> Monitor Execute Queues on this server		请求吞吐量、JVM内存使用状况以及等待请求等信息的实时显示
执行套接字	Servername -> Monitoring -> General -> Monitor Active Sockets on this server		活动套接字的协议及其它属性
连接	Servername -> Monitoring -> General -> Monitor Connections on this server		连接的相关数据，如连接时间、远程地址、所发送的字节数与接收到的字节数
集群	Clusters		缺省的负载算法以及多点传送地址的相关数据
Transactions By Name	Servername -> Monitoring -> JTA -> Monitor Transactions by Name on this server		按名字所组织的事务的相关数据
Transaction By Resource	Servername -> Monitoring -> JTA -> Monitor Transactions by Name on this server		按资源所组织的事务的相关数据
活动事务	Servername -> Monitoring -> JTA -> Monitor In-flight Transactions on this server		该服务器中有关活动事务的数据
机器	Machines		机器的地址以及其它属性
应用	Applications		应用列表
EJB的分发	Deployments -> EJB		各个EJB的URL、应用名字及其它属性
Web应用	Deployments -> Web Applications		Web应用的URL以及它的缺省Servlet等属性
活动的Web应用	Deployments -> Web Applications -> appname -> Monitoring -> Monitor all instances of appname		Data about deployed copies of this Web application
Web应用的Servlets	Deployments -> Web Applications -> appname -> Monitoring -> Monitor all servlets for this Web Application		有关Web应用的统计数据，如最大池容量以及最长的执行时间
启动类与终止类	Deployments -> Startup & Shutdown		经过注册的启动类与终止类列表
JDBC连接池	Services -> JDBC -> Connection Pools		JDBC连接池的初始容量、容量增量及其它属性
JDBC 多池	Services -> JDBC -> Multipools		JDBC多池的负载平衡及其它属性
JDBC数据源	Services -> JDBC -> Data Sources		JDBC数据源的Pool名、JNDI名字以及其它属性
JDBC Tx 数据源	Services -> JDBC -> Tx Data Sources		JDBC Tx数据源的Pool名字、JNDI名字以及其它属性
JMS Connection Factories	Services -> JMS -> Connection Factories		JMS connection factories的JNDI名字，客户号，缺省优先级及其它属性
JMS 模板	Services -> JMS -> Templates		JMS模板的有关数据
JMS收信方关键字	Services -> JMS -> Desination Keys		JMS收信方的关键字类型与其它属性
JMS 存储器	Services -> JMS -> Stores		JMS存储器的描述信息
JMS服务器	Services -> JMS -> Servers		JMS服务器的有关信息
活动JMS服务	Services -> JMS -> Servers ->  Monitor all Active JMS Services		连接的上限及其它活动JMS服务的有关数据
活动JMS服务器	Services -> JMS ->Servers -> Monitor all instances		有关会话与消息挂起的统计信息以及其它数据。
活动JMS 收信方	Services -> JMS ->Servers -> Monitor all Active JMS Destinations		活动JMS收信方的使用者、所收到的消息及其它属性。
活动JMS会话池	Services ->  JMS ->  Servers ->  Monitor all Active JMS Session Pools		使用者数量的上限及其它属性
JMS 收信方	Services -> JMS -> jmsservername -> Destinations		JNDI名字及其它数据
JMS会话池	Services -> JMS -> jmsservername -> Session Pools		JMS会话池的肯定应答模式、会话的最大量及其它属性
XML 注册记录	Services -> XML -> XML Registries		DocumentBuilderFactories以及SAXPArserFactories列表
WLEC 连接池	Services -> WLEC -> WLEC Connection Pools		WebLogic企业域的名字、失败转移地址、最大最小容量以及其它信息
Jolt连接池	Services -> Jolt		Jolt连接池的失败转移地址、连接池的最大与最小容量以及其它信息
活动Jolt连接池	Service-> Jolt-> joltconnectionpoolname->Monitoring -> Monitor all active pools		Jolt连接池的最大实例数、当前连接及其它实例数据
虚拟主机	ServiceVirtual Hosts		虚拟主机的格式、日志文件及其它属性
邮件会话	Service -> Mail		邮件会话的名字与虚拟列表
文件T3	Services -> File T3		文件的名字与路径
用户	Securit ->Users		用户列表
组	Security ->Groups		组列表
访问控制列表	Security->ACLs		ACL列表
缓存域	Security->Caching Realms		缓存域列表
域	Security->Realms		对域的描述
域日志过滤器	Domain Log Filters		Servers on which the filter is registered以及用于过滤消息的属性

 

4 用日志消息管理WebLogic服务器

本章将介绍以下内容：

ü       日志子系统概述

ü       本地服务器日志文件

ü       消息属性

ü       消息目录

ü       消息的严重级别

ü       浏览日志文件

ü       创建域日志的过滤器

日志子系统概述

日志消息是管理系统的一个非常有用的工具。通过日志可以发现问题，跟踪错误来源，及时了解系统性能。WebLogic服务器产生的日志消息被保存在两个地方：

ü       WebLogic服务器组件子系统产生的消息保存在本地文件中，即该文件位于运行服务器的机器上。如果一台机器上同时运行了若干个WebLogic服务器，那么每一个服务器都有自己的日志文件。分发在WebLogic服务器上的应用可以将它所产生的消息保存在服务器的本地日志文件中。

ü       此外，一部分本地日志消息还被存储在由管理服务器维护的域日志文件中。

嵌在WebLogic服务器的JMX（Java管理扩展）程序，会把WebLogic服务器产生的日志消息传送到管理服务器。如果本地WebLogic服务器主动将消息发送到其它实体，用JMX的术语来说，这就是“布告”。

在WebLogic服务器启动时，管理控制台的消息处理器会向该服务器注册以便接收来自该服务器的日志消息。在注册过程中，本地服务器将使用一个可以被用户修改的过滤器选择要转发到管理服务器的日志消息。这些消息被收集在域日志中。

一般而言，只有最重要的日志消息（由“Message severity”决定）才会从本地服务器转发到域日志中。域日志提供了域的一个总体视图，同时又能使你聚焦在那些最为关键的消息上。

你可以通过管理控制台来更改日志消息过滤器，这一过程是动态的，即不需要重启本地服务器，更新即可生效。（参见“创建日志过滤器”中的内容）。

开发人员可以用定制的消息处理器向WebLogic服务器注册并通过JMX布告接收日志消息

本地服务器的日志文件

老版本的WebLogic服务器在日志文件达到最大长度时会创建一个新的日志文件。这种自动创建日志文件的机制被称为日志回旋（Log Rotation）。在6.0版本中，你可以选择日志回旋的方式：（1）基于时间，（2）基于文件大小。在管理控制台中按以下步骤配置日志回旋：

1．在管理控制台的左窗格，选择一个服务器。

2．在右窗格，选择Configuration->Logging。

3．在Rotation Type字段中，选择时间或长度。

如果该字段的值为none，那么日志不进行回旋。如果选择基于时间的日志回旋，那么新日志文件按指定的时间间隔（由File Time Span指定）被创建。

缺省情况下，本地服务器的日志文件名为servername.log（其中servername指服务器的名字）。日志文件位于WebLogic服务器所在的目录。日志文件的名字可以在Configuration->Logging页面中设置。

File Count字段的值指定回旋日志文件的最大数量。如果日志文件的数量数达到这个数目，那么每次发生日志文件回旋时，最老的日志文件将被删除。日志文件按照创建的先后被命名为filenamennnnn，其中filename是在configuratin->Logging页面中设置的日志文件名。例如：webLogic.log00007

本地服务器日志包含所有被记录的日志消息。

在配置本地服务器日志时,你可以指定哪些日志消息将被输出到标准输出中。通过指定所要记录的日志的最低严重性级别，可以把一些不太严重的消息排除在外。也可以设置是否将调试消息输出到标准输出。

启动日志

在WebLogic服务器启动时，如果还未完成初始化就发生了错误，那么这些错误将输出到标准输出以及名字为weblogic-startup.log的本地服务器启动日志文件中。如果启动成功，那么启动日志文件的最后一条消息将指向记录普通日志信息的本地服务器日志文件。

客户端日志

使用WebLogic日志功能的Java客户端也会产生日志消息，但是这些客户端所产生的消息不能被转发到域日志中。要配置客户端的日志属性，可以在命令行中使用以下参数：

-Dweblogic.log. attribute= value

其中，attribute可以是任何LogMBean属性。缺省情况下，客户端的日志消息不会记录在日志文件中，而是输出到标准输出。

日志文件的格式

在日志文件中，每条消息的第一行都以####开始，紧跟其后是消息头。消息头说明了消息的运行时上下文。每个消息属性都包含在尖括号对中。

如果是异常消息，那么消息体后面是异常的堆栈形迹。如果消息不在事务上下文中，属性Transaction ID的尖括号对仍然会有，只是没有事务号而已。

以下是一个日志消息的例子：

####

<> <004500>

这个例子包含以下消息属性：ThreadID, UserID, Transaction ID, Message ID, 以及Message Text。

注意：客户端记录的日志消息没有Server Name与Thread ID属性

消息属性

日志文件中的每条消息都定义了下表所列出的属性。通过消息号，消息还可以关联Message Catalog的其它属性 (例如，Probable Cause与Recommended Action)。

属性	描述
时间戳	消息产生的日期与时间，格式因地区设置而异。
严重级别	指消息事件的重要性或严重程度见“消息的严重级别”
子系统	该属性指出了该消息是WebLogic服务器的哪个子系统产生的。例如:EJB, RMI与JMS
服务器名 机器名 线程号 事务号	这四个属性定义了该消息的来源。如果消息位于事务上下文中，那么就具有事务号属性。注意：Java客户端所产生的日志消息没有服务器名以及线程号属性。
用户号	在产生该消息时，安全上下文中的用户
消息号	唯一性的六位标识符。小于499999的消息号保留给WebLogic服务器系统消息
消息文字	对于WebLogic服务器消息，该属性的内容是由系统消息目录所定义的短描述（见“消息目录”），对于其它消息，该属性的内容由程序开发者指定。

消息目录

除了保存在日志消息中的那些信息外，WebLogic服务器系统组件（或者是用户编写的代码）产生的消息另外还包含了其它预定义的信息，这些信息被保存在消息目录中。下表描述了保存在消息目录中的属性：

属性	描述
消息体	对消息产生时的环境的简短的文字性描述。与消息的消息文字属性相同
消息细节	对消息产生时的环境的更详尽的描述
可能原因	解释记录该消息的原因。以及产生该消息的可能原因
建议	管理员对解决或避免引起该消息的问题建议

你可以在管理控制台的日志视图查看上述属性

消息的严重级别

WebLogic服务器消息具有一个称作“严重级别”的属性。该属性反映了消息所报告的事件或系统状态的重要性或者可能对用户的潜在冲击

下表描述了被定义的各类严重性。下表按严重程度列出了各种严重情形，其中Energency的严重级别最高

严重级别	缺省情况下是否发送到域日志	含义
报告	否	用于报告普通操作
警告	否	发生了可疑的操作或配置，但对普通操作没有影响
错误	是	发生了用户操作。系统或应用不需要中断服务就可以处理该错误
注意	是	发生了可疑的错误或配置，可能不会影响服务器的正常操作
严重	是	发生了系统或服务错误。系统可以恢复但是可能会造成瞬间或永久性的服务性能降低
警报	是	某个服务不能使用，系统的其它部分还能正常工作。不可能进行自动恢复；管理员需要立即采取措施解决问题
危急	是	服务器不能使用，该严重级别表明了发生服务器系统失败，情况十分危机。

消息调试

严重级别为调试的消息是一个特殊的情形。调试消息不会发送到域日志。调试消息包含了有关应用与服务器的详细信息。这些消息只有在应用是以调试模式运行时才会产生。

浏览日志文件

管理控制台提供了以下日志查看功能：

ü       查看任一服务器的本地日志文件

ü       查看域日志文件

无论是查看域日志还是本地服务器日志，你都可以

ü       按照产生时间、用户号、子系统、消息严重级别或者是消息的短描述选择所要查看的消息

ü       查看被记录的消息，或对日志消息进行查找

ü       选择要显示在管理控制台的消息属性及其排列顺序

查看日志

你可以从管理控制台访问域日志与本地服务器日志。有关这些任务的具体操作参见控制台的在线帮助：

ü       查看域日志（viewing the Domain Log）

ü       查看本地服务器日志（Viewing the Local Server Log）

创建域日志过滤器

缺省情况下，被WebLogic服务器转发到域日志的日志消息是本地消息日志的子集。过滤器决定了要把哪些日志消息发送到域日志，你可以对过滤器进行配置，这样就可以根据消息的严重级别、产生消息的子系统或者是用户号来选择要转发的日志消息。（调试消息属特殊情况，它不能被转发到域日志）你可以创建一个过滤器也可以更改域日志过滤器表中的过滤器。从Domain Monitoring标签页可以访问域日志过滤器表。有关创建域日志的详细内容参见管理控制台的在线帮助。

5 分发应用

本章将介绍如何在WebLogic服务器上分发应用程序以及应用组件，内容如下

ü       分发格式

ü       通过管理控制台分发应用

ü       动态分发

分发格式

J2EE应用可以以企业应用包（Enterprise Application Archive,简称为EAR）的形式或者是展开目录格式的形式部署到WebLogic服务器上。

如果以展开格式的形式部署J2EE应用，那么我们建议你在此格式中只包含Web应用组件。如果是以包的形式部署J2EE应用，我们建议所有应用组件都采用包的形式。

一个组件可以被打包在EJB包（JAR）文件中，也可以在Web应用包（Web Application Archive，简称为WAR）文件中，或者是资源适配器包（Resource Adaptor Archive，简称为RAR）文件中。

有关Web应用的更多信息，请参见“配置WebLogic服务器Web组件”中的内容。

有关资源适配器组件的信息，可以参见“管理WebLogic J2EE连接器构架”中的内容。

用管理控制台分发应用

你可以通过管理控制台安装或分发应用或应用的组件（例如EJB JAR文件）并且将应用组件的实例分发到目标WebLogic服务器上。步骤如下：

步骤1：配置与分发应用

1．选择Deployments->Application调用applications表格.

2．点击Configure a new Application链接调用Create a new Application页面。

3．填写以下字段

应用的名字

应用（EAR文件）所在的路径

应用是否已经被部署到WebLogic服务器上了

4．点Create按钮创建一个新的条目

当你用管理控制台分发应用（或应用组件）时，管理服务器会在为应用在域配置文件中（/config/domain_name/config.xml）加上与被分发的应用或应用组件加上一个相应的条目。同时，管理服务器还会创建用以配置及监控该应用或应用组件的JMX Management Beans（MBeans）。

步骤2：分发应用组件

可以在WebLogic服务器中分发以下三种类型的应用组件：Web应用组件，EJBs与资源连接器组件。

注意：如果把应用组件（如EJBs或WAR文件）分发到集群中的受管服务器上，那么必须保证集群中的所有成员服务器都部署了同样的应用组件。为此，你可以选择集群作为分发的目标。

部署Web应用组件

以下是将Web应用部署到受管服务器上的步骤：

1．选择Deployments->Web Applications调用Web Applications表

2．点击Configure a new Web Application链接调用Create a new WebApp Component配置页面

3．填写以下字段：

组件的配置条目的名字

指向该组件的统一资源标识符（URI）

WAR文件的路径，或者是展开格式的Web应用所在目录的路径

选择分发顺序。该顺序指定了服务器启动时Web应用的分发顺序。（见分发顺序）

指出应用是否已经被部署了

4．点击Create按钮创建一个新的组件条目

5．选择组件的部署目标是受管服务器还是集群。点Targets->Servers将组件部署到目标服务器上。点Targets->Clusters将组件部署到目标集群上。

6．Available字段列出了受管服务器（如果选择Targets->Clusters则列出集群）。使用箭头按钮将它们移到Chosen字段，这样便选择了要部署该Web组件的目标服务器。点Apply使你的设置生效。

有关配置Web应用的更多信息，请参见“配置WebLogic服务器的Web组件”中的内容。

部署EJB组件

以下是把EJBs部署到受管服务器上的步骤：

1．选择Deployments->EJB调用EJB Deployment表格

2．点击Configure a new EJB链接调用Create a new EJB Component页面

3．填写以下字段：

该组件的配置条目的名字

指向该组件的统一资源标识符（Uniform Resource Identifier，简称为URI）

JAR文件的路径

选择分发顺序。它决定了服务器启动时，该EJB被分发的顺序。

指出是否已经部署了该组件

4．点Create创建一个新的组件条目

5．选择组件的部署目标是受管服务器还是集群。点Targets->Servers将组件部署到目标服务器上。点Targets->Clusters将组件部署到目标集群上。

6．Available字段列出了受管服务器（如果选择Targets->Clusters则列出集群）。使用箭头按钮将它们移到Chosen字段，这样便选择了要部署该EJB的目标服务器。点Apply使你的设置生效。

部署资源适配器组件

以下是把EJBs部署到受管服务器上的步骤：

1．选择Deployments->Connectors调用EJB Deployment表格

2．点击Configure a new Connector Component链接调用Create a new Connector Component页面

3．填写以下字段：

该组件的配置条目的名字

指向该组件的统一资源标识符（Uniform Resource Identifier，简称为URI）

RAR文件的路径

选择分发顺序。它决定了服务器启动时，该资源连接器被分发的顺序。（见“分发顺序”中的内容）

指出是否已经部署了该组件

4．点Create创建一个新的组件条目

5．选择组件的部署目标是受管服务器还是集群。点Targets->Servers将组件部署到目标服务器上。点Targets->Clusters将组件部署到目标集群上。

6．Available字段列出了受管服务器（如果选择Targets->Clusters则列出集群）。使用箭头按钮将它们移到Chosen字段，这样便选择了要部署该EJB的目标服务器。点Apply使你的设置生效。

有关资源连接器的更多信息，可以参考“管理WebLogic J2EE连接器构架”中的内容。

如果一个应用或应用组件（如一个EAR或WAR文件，或EJB JAR文件）被部署到一个特定的WebLogic服务器上，那么管理控制台将调用一个文件分发servlet将文件复制到目标服务器的 /config/ domain_nam e/applications/ wlnotdelete目录中。

分发顺序

对于同一类型的组件，例如EJBs,你可以指定WebLogic服务器在启动时部署这些组件的顺序。你在部署组件时，为Deployment Order字段所指定的整数是该组件相对于其它同类型组件的优先级，例如各EJB的部署顺序。分发顺序为0的组件是同类型组件中最先部署的组件。

但是，各种组件类型之间的分发顺序不受用户所定义的同类型分发顺序所影响。WebLogic在启动时，按以下顺序启动各类型的组件：

1．JDBC连接池

2．JDBC多池

3．JDBC数据源

4．JDBC Tx数据源

5．JMS连接工厂

6．JMS服务器

7．连接器组件

8．EJB组件

9．Web应用组件

自动分发

自动分发（Auto-deployment）能够快速地在管理服务器上部署应用。但我们只建议你在开发环境中使用这种分发方式来测试应用。不建议你在生产环境或受管服务器上使用使用自动分发。

如果目标WebLogic服务器域启用了自动分发，当应用被复制到WebLogic管理服务器的 /config/domain_name/applications目录时，管理服务器会自动检测到新应用并自动部署该应用（如果管理服务器是运行着的）。（子目录 domain_name是启动管理服务器时所使用的WebLogic服务器域。 ）如果在你把应用复制到/applications目录时，WebLogic服务器没有被运行，那么当WebLogic服务器启动时将分发这个应用。

启用或禁用自动部署

缺省情况下，自动部署是启用的。

 

 

 

 

自动分发选项是否开启决定了应用的分发有两种方式：

ü       如果启用了自动分发选项，那么在把应用复制到管理服务器的/config/domain_name/applications目录下后，应用会自动分发到管理服务器上。

ü       如果禁用了自动分发选项，你必须在这个应用的Configuration标签页上指明要分发该应用，那么所安装的这个应用才会被分发。

3、将应用组件（或者是Web应用组件与EJB）的实例分发在受管服务器上

当应用被安装到管理服务器上（/config/domain_name/applications目录）之后，就可以将应用的组件分发到WebLogic受管服务器上。

在管理控制台中，打开目标服务器的Deployments->EJB（见图6-3）或Deployments->Web Applications标签页，选择需要分发的应用组件。

或者通过组件的Targets 标签页面来选择要分发应用组件的目标服务器。

图5.1 –    某一服务器的Deployment->EJB标签页

如果要把应用组件（例如EJBs或WAR文件）分发到集群中的受管服务器中，那么就必须保证集群中的所有受管服务器都分发了该应用组件，选择集群作为分发目标就可以确保这一点。

 

动态分发

当你将应用拷贝到WebLogic管理服务器的/config/domain_name/applications目录时（子目录domain_name是指要分发应用的WebLogic域的名字），如果目标WebLogic服务器域启用了自动分发并且运行了管理服务器，那么管理服务器将会检测到新应用并自动分发该应用。这种分发应用的方式被称为动态分发。如果在把应用复制到/applications目录下时没有运行WebLogic服务器，那么应用将在WebLogic服务器重新启动时分发。

缺省情况下，自动分发是启用的。如果禁用了自动分发，那么仍然可以通过管理控制台来手工分发应用组件，这种分发应用的方式被称为静态分发。

启用与禁用自动分发

缺省情况下，自动分发是启用的。

要确定是否启用了自动分发选项，可以进入管理控制台的域应用设置页面（domain_name->Configuration->Applications），在这个页面上可以设置自动分发是否启用以及设置WebLogic服务器检查新应用的时间间隔。缺省情况下，如果启用了自动部署，那么管理服务器每3秒种检查/applications目录的变化。

自动分发展开目录格式的应用

自动分发的应用或应用组件可以采用展开目录格式或者EAR文件、WAR文件以及JAR文件等格式。

以下是自动分发展开式应用的步骤：

1．展开式应用的目录名应该与应用的上下文路径相同。

2．把应用复制到 /config/domain_name/applications子目录下，其中。 Domain_name是要部署应用的目标域。如果启用了自动分发，那么该应用被自动部署。

卸载或重新分发被自动分发的应用

被自动分发的应用或应用组件可以在服务器运行的情况下动态地重新分发。因此可以不需要停止并重启WebLogic管理服务器，就能对应用或应用组件进行更新。如果要动态地重新部署一个应用或应用组件，只需要用更新后的文件覆盖/applications目录下的相应文件。

该功能对于开发人员很有用。开发人员只需要将更新后的文件复制到/applications目录下，服务器就会进行相应的更新。

展开式应用的自动重分发

你可以动态地重新分发分发展开式应用或应用组件。如果所分发的应用是展开格式，那么管理服务器会周期性地检查展开式应用目录中的REDEPLOY文件。如果该文件的时间戳改变了，那么管理服务器会自动地重新分发这个应用。

如果要更新展开式应用目录中的文件，按以下步骤：

1．第一次分发展开式应用时，在该应用所在的目录下创建一个名字为 REDEPLOY的空文件

2．用更新后的应用文件覆盖目录下的相应文件。

3．复制完文件后，改变这个目录下的REDEPLOY文件的时间戳

当管理服务器发现该文件的时间戳改变了，它会自动分发展开式应用目录下的内容。

 

6 配置WebLogic服务器的Web组件

本章将介绍Web组件的配置，主要内容如下：

ü       概述

ü       HTTP参数

ü       配置监听端口

ü       Web应用

ü       配置虚拟主机

ü       WebLogic服务器如何解析HTTP请求

ü       设置HTTP访问日志

ü       防止“POST拒绝服务”攻击

ü       设置WebLogic服务器的HTTP Tunneling

ü       用本地 I/O提供静态文件服务

概述

除了可以部署动态的、基于Java的分布式应用外，WebLogic服务器还是一个具有完整功能的Web服务器，它可以处理高流量的Web站点，提供HTML文件、图像文件、servlets以及JSP等静态页面服务。WebLogic服务器支持HTTP 1.1标准。

HTTP参数

你可以通过管理控制台配置每一个WebLogic服务器实例（或每个虚拟主机）的以下HTTP参数。

ü       Default Web Application

缺省应用处理不能被其它Web应用解析的请求。访问缺省应用的URI不需要包含上下文路径（Web应用的上下文通常是Web应用的名字）。

ü       Post Timeout Seconds

WebLogic服务器在相邻两次接收HTTP POST数据之间的等待时间，该参数被用来防止采用POST方法使服务器超载的“拒绝服务”攻击。

ü       Max Post Time

限制了WebLogic服务器用于接收POST数据的时间

ü       MAX Post Size

该参数限制了WebLogic服务器对每个请求所能接收的POST数据量（以字节为单位）。如果超出了该限制，将引发MaxPostSizeExceeded异常

ü       Enable Keep Alive

启用或禁用持久的HTTP连接。如果浏览器使用HTTP 1.1协议，那么该参数一般是开启的。

ü       Connection timeout

WebLogic服务器在关闭非活动的HTTP连接之前所等待的时间

ü       HTTPS Duration

WebLogic服务器在关闭非活动的HTTPS（安全套接层或SSL）连接之前所等待的时间。

ü       HTTP Access Logging

你可以禁用或启用HTTP访问日志，并且可以设置访问日志的回旋参数，如日志旋回的方式及时间。详细内容，请参见本章“设置HTTP访问日志”中的内容。

有关设置上述参数的详细信息，请参见以下网页的“虚拟主机”部分：

http://e-docs.bea.com/wls/docs60/ConsoleHelp/virtualhost.htm l.

配置监听端口

你可以指定WebLogic服务器监听HTTP请求的端口。尽管可以指定任何有效的监听端口，但是如果把WebLogic服务器的监听端口设为80，那么当你访问Web应用的资源时，你就可以省略HTTP请求中的端口号。例如，当你使用80端口作为监听端口时，你就可以采用以下形式的URI：

http://hostname/myfile.html而不是

http://hostname:portnumber/myfile.html

普通请求与安全（使用SSL）请求分别使用不同的监听端口。你可以通过管理控制台的Servers节点的Configuration/Gereral标签页定义普通的监听端口，在Configuration/SSL标签页中定义SSL监听端口。

Web应用

HTTP以及Web服务的部署遵照Sun MicroSystems的Servlet2.2标准。该标准定义 Web 应用作为组合各种基于Web应用的组件的标准。这些组件可以是JSP页面，HTTP servlets以及诸如HTML页面与图象文件等静态资源。Web应用可以访问外部资源，例如EJBs与JSP标记库。一个服务器可以分发任意多个Web应用。当你从Web应用请求资源时，一般都要在请求的URI中包含该应用的名字。

详细内容，以下页面的Assembling and Configuring Web Applications：

http://e-docs.bea.com/wls/docs61/webapp/index.htm l.

Web应用与集群

Web应用可以部署到WebLogic服务器组成的集群中。当用户请求Web应用的资源时，那么请求会被引导到集群中的一个服务器上。如果应用使用了会话对象，那么会话应该复制到集群中的所有节点上。有多种方式复制会话。

详细内容，参见以下页面的“Using WebLogic Server Clusters”部分：

http://e-docs.bea.com/wls/docs60/cluster/index.html .

指定缺省的Web应用

域中的每个服务器或虚拟主机都有一个特殊的Web应用——缺省Web应用。任何不能被其它Web应用所解析的请求将由缺省应用来处理。与一般Web应用不同的是，指向缺省Web应用的URI不需要包含应用的名字。部署在服务器或虚拟主机上的任何Web应用都可以声明为缺省Web应用。（稍后，我们将讨论“部署 Web应用”）。有关虚拟主机的更多信息，请参见本章“配置虚拟主机”中的内容。

如果没有声明缺省的Web应用，那么WebLogic服务器启动时时会自动创建一个缺省Web应用。所创建的缺省Web应用的名字为 DefaultWebApp_servername，其中servername是服务器的名字；如果是虚拟主机，那么将被命名为 DefaultWebApp_VirtualHostName。

如果没有正确分发所声明的缺省Web应用，那么当请求缺省Web应用的资源时，用户将接收到HTTP 400错误消息，同时日志中将记录这一错误消息。

例如，如果有一个名字为shopping的Web应用，那么应该用以下URI访问该Web应用的cart.jsp页面：

http://host:port/shopping/cart.jsp

但是，如果你将该Web应用声明为缺省Web应用，那么你就可以用以下URI访问cart.jsp：

http://host:port/cart.jsp

（其中host是运行WebLogic服务器的机器的主机名，port是WebLogic服务器监听请求的端口）。

以下是用管理控制台为服务器或虚拟主机指定缺省Web应用的步骤：

1．在左窗格中，点击Web Appliction节点

2．选择你的Web应用

3．在右窗格中，点Targets标签页

4．选择Servers标签页，将服务器（或虚拟主机）移到chosen列。 （选择Clusters标签页面，将集群移动到Chosen列中，可以使集群中所有的服务器作为设置的目标）。

5．点击Apply按钮

6．点击左窗格中的Servers（或虚拟主机）节点

7．选择合适的服务器或虚拟主机

8．点击右窗格中的General标签页面。

9．选择HTTP标签页面

10．从Default Web Application下拉列表中选择一个Web应用

11．点击Apply按钮

12．如果要为多个受管服务器指定缺省Web应用，那么对每个受管服务器重复上述步骤

配置虚拟主机

通过配置虚拟主机，你可以定义服务器或集群所响应的主机名。虚拟主机就是通过DNS将一个WebLogic服务器或集群的IP地址映射到一个或多个主机名并且指定用哪个虚拟主机来服务哪个Web应用。如果在集群中使用虚拟主机，那么负载平衡能够以最有效的方式使用硬件系统，即使是某一DNS主机名比其它DNS主机名处理更多的请求。

例如，你可以指定一个名字为books的Web应用响应对虚拟主机名www.books.com的请求，这些请求将由WebLogic服务器A,B,C来处理，而一个名字为cars的Web应用将响应对虚拟主机名www.autos.com的请求，这些请求将由WebLogic服务器D,E来处理。你可以根据应用以及Web服务器的需要来组合使用虚拟主机、WebLogic服务器、集群与Web应用。

每个虚拟主机都可以定义自己的HTTP参数与HTTP访问日志。为虚拟主机设置的这些参数会覆盖服务器的这些参相应数设置。你可以指定任意数量的虚拟主机。

当把服务器或集群作为虚拟主机的目标时，虚拟主机被激活。以集群为目标的虚拟主机会应用于集群中的所有服务器。

虚拟主机与缺省Web应用

每个虚拟主机都可以指定自己的缺省Web应用。一个虚拟主机的缺省应用将处理所有不能为该虚拟主机的其它Web应用所解析的请求。

与其它Web应用不同的是，在访问缺省应用的资源时，URI不需要包含缺省应用的名字（即上下文路径）。

例如，有一个www.mystore.com虚拟主机名，该虚拟主机名以WebLogic服务器为目标。如果你在该服务器上部署了一个名为shopping的web应用，那么你可以要以下URI访问该应用的cart.jsp页面：

http://www.mystore.com/shopping/cart.jsp

如果，shopping应用被声明为虚拟主机www.mystore.com的缺省Web应用，那么访问cart.jsp页面的URI是：

http://www.mystore.com/cart.jsp

详细信息，请参见本章的“WebLogic服务器如何解析HTTP请求”

设置虚拟主机

可以通过管理控制台来定义虚拟主机：

1．创建一个新的虚拟主机

a.在左窗格中点击Services节点，该节点被展开并显示一组服务。

b.点击Virtural Host节点。如果定义了虚拟主机，那么该节点将被展开并显示所有的虚拟主机

c.在右窗格中点击Create a New Virtual Host

d.输入新建虚拟主机的名字

e.输入虚拟主机名，一行一个。只有那些与虚拟主机名匹配的请求才会被虚拟主机的目标WebLogic服务器或WebLogic集群处理。

f.（可选步骤）为虚拟主机分配一个缺省Web应用。

g.点击Create按钮

2．定义日志与HTTP参数

a.（可选步骤）点击Logging标签页，填写HTTP访问日志属性（详细内容，请参见本章“设置HTTP访问日志”中的内容）

b.选择HTTP标签页，填写HTTP参数

3．定义虚拟主机的目标服务器

a.选择Targets标签页

b.选择Servers标签页，将列出可用服务器列表

c.选择available列中的一个服务器并用右箭头按钮将该服务器移到Chosen列中。

4．定义虚拟主机的目标集群（可选步骤）。在此之前先要定义一个WebLogic集群。详细内容，参见以下页面的“Using WebLogic Server Clusters”部分：

http://e-docs.bea.com/wls/docs60/cluster/index.htm l.

a.选择Targets标签页

b.选择Clusters标签页，该标签页上显示了一组可用的服务器集群。

c.选择Available列中的一个集群，用右箭头按钮将该服务器移到Chosen列中。集群中的所有服务器都将成为该虚拟主机的目标。

5．将Web应用部署到虚拟主机上。

a.点击左窗格中的Web Applications节点

b.选择要部署到虚拟主机上的Web应用

c.选择右窗格中的Targets标签页面

d.选择Virtual Hosts标签页面

e.选择Available列中的虚拟主机并用右箭头按钮将它移动到Chosen列中。

WebLogic服务器如何解析HTTP请求

当WebLogic服务器接到一个HTTP请求时，它对URL的各个部分进行解析，然后根据解析所得到的信息来确定由哪个Web应用或服务器处理该请求。以下的例子说明了WebLogic服务器如何解析对Web应用、虚拟主机、servlets、JSP以及静态页面的请求及响应。

注意：如果Web应用包含在企业应用中，那么Web应用可以有另一个名字，可以用这个名字可解析对Web应用的请求。有关这方面的更多内容，请参见以下页面的“Deploying WebApplications as Part of an Enterprise Application”：

http://e-docs.bea.com/wls/docs61/webapp/deployment.html#war-ea r.

下表给出了一些示例URL以及WebLogic服务器所服务的文件。Index Directories Checked列指的是Index Directories属性，该属性决定当请求没有指定文件时是否要提供目录列表服务。该属性在管理控制台的Web Application节点的Configuration/Files标签页设置。

表8-1 WebLogic应用解析URL示例

URL	Index Directories Checked	响应的文件
http://host:port/apples	No	Apples web应用所定义的欢迎页面
http://host:port/apples	Yes	列出apples web应用的最顶层目录的子目录
http://host:port/oranges/naval	无关要紧	oranges应用中映射为/naval的servlet。有关servlet映射还有一些需考虑的东西。详细内容，请参见以下页面的“Configuring Servlets”： http://e-docs.bea.com/wls/docs61/webapp/components.html#configuring-servlets
http://host:port/naval	无关要紧	Oranges应用中映射到为/naval的servlet并且oranges是缺省的Web应用。详细内容，参见以下页面的“Configuring servlets”。 http://e-docs.bea.com/wls/docs61/webapp/components.html#configuring-servlets
http://host:port/apples/pie.jsp	无关要紧	Apples应用顶层目录中的pie.jsp文件
http://host:port	Yes	缺省Web应用顶层目录的目录列表
http://host:port	No	缺省Web应用的欢迎页面
http://host:port/apples/myfile.html	无关要紧	Apples应用顶层目录中的myfile.html文件
http://host:port/myfile.html	无关要紧	缺省Web应用顶层目录的myfile.html文件
http://host:port/apples/images/red.gif	无关要紧	Apples应用顶层目录的images子目录中的red.gif
http://host:port/myFile.html apples应用没有定义myFile.html并且也没有定义缺省servlet	无关要紧	Error 404 详细内容，参见8-20页的“定制HTTP 错误响应”
http://www.fruit.com/	No	虚拟主机 www.fruit.com的缺省Web应用的欢迎页面
http://www.fruit.com/	Yes	给出虚拟主机 www.fruit.com上的缺省应用的最高层目录的子目录列表
http://www.fruit.com/oranges/myfile.html	无关要紧	位于虚拟主机 www.fruit.com上的oranges Web应用中的myfile.html文件

详细内容参见以下页面的“Configuring Welcome Pages”

http://e-docs.bea.com/wls/docs61/webapp/components.html#welcom-pages

设置HTTP访问日志

WebLogic服务器可以把所有关于HTTP事务的日志保存到一个文本文件，该文本文件可以采用 普通日志格式（common log format）或 扩展日志格式（extended log format），缺省格式为遵循标准约定的普通日志格式。扩展日志格式可以定制要记录的信息。每个服务器或虚拟主机都可以定义自己的HTTP访问日志属性。

日志回旋（Log Rotation）

日志的回旋可以基于文件大小也可以基于时间间隔。当满足其中的一个条件时，当前访问日志被关闭，新的访问日志被创建。如果没有配置日志回旋，那么HTTP访问日志会无限增长。访问日志名中的数字部分随日志回旋而增长。每个Web服务器都定义了自己的HTTP访问日志。

使用管理控制台设置HTTP访问日志

有关使用管理控台设置HTTP访问日志的内容可以参见以下页面中的信息：

http://e-docs.bea.com/wls/docs60/ConsoleHelp/virtualhost.htm l:

1．如果设置了虚拟主机：

a.在左窗格中选择Services节点

b.选择Virtual hosts节点，该节点被展开并显示了一组虚拟主机

c.选择一个虚拟主机

如果还没有设置虚拟主机

a.选择左窗格中的Servers节点，该节点被展开并显示了一组服务器。

b.选择一个服务器

c.选择Logging标签页

d.选择HTTP标签页

2．选中Enable Logging复选框

3．输入日志文件的名字

4．从Format下拉列表中选择Common或Extended

5．选择Rotation类型：By Size类型还是By Date类型的

By Size：当日志文件的大小大于Log Buffer Size参数的值时发生日志回旋。

By Date：当时间间隔大于Rotation Period参数的数值时发生日志回旋。

6．如果日志回旋的类型为By Size，那么将the Max Log File Size K Bytes字段设置为所期望的日志文件的最大容量（以字节数为单位）

7．设置Flush Every参数。该参数设置了每隔多长时间访问日志进行日志条目的写操作。.

8．如果日志回旋的类型设置为By Date，那么把Rotate time参数设为日志文件进行第一次回旋的时间（该参数只对By Date类型的日志回旋有效），日期的格式使用java.text.SimpleDateFormat，即MM-dd-yyyy-k:mm:ss。详细内容请参见java.text.SimpleDateFormat类的javadocs文档。

9．如果日志回旋的类型设为By Date，那么将Rotation Period设置为日志回旋的时间间隔。

普通日志格式

HTTP日志信息的缺省格式为 普通日志格式。 普通日志格式由http://www.w3.org/Daemon/User/Config/Logging.html#common-logfile-format定义，它遵循以下模式：

host RFC931 auth_user [day/month/year:hour:minute:second UTC_offset] "request" status bytes

其中：

host

    指远程客户端的DNS名字或IP地址

RFC931

    任何由INDENTD 返回给客户端的消息；WebLogic服务器不支持用户标识

auth_user

    如果远程客户发送了一个用于身份验证的用户号，那么就是指用户名，否则就为“-”

Day/month/year:hour:minute:second UTC_offset

日期、月份、年以及时间（使用24-小时格式）以及当地时间与GMT时间的时间差，它们被括在方括号中

“request”

远程HTTP请求的第一行，被双引号括起

status

服务器返回的HTTP状态代码，如果服务器没有返回HTTP状态代码，则为“-”。

bytes

HTTP头中记录的内容长度（不包括HTTP头本身）。如果不可知，则为“-”

使用扩展日志格式

WebLogic服务器支持由W3C定义的1.0版本的扩展日志文件格式，这是一个正在形成的标准。目前 WebLogic 服务器遵循该标准的草案规范（www.w3.org/TR/WD-logfile.htm l ）。请参见以下页面的“W3C Technical Reports and Publications ”：

www.w3.org/pub/www/TR

当所记录的HTTP日志采用扩展日志格式时，可以指定记录哪些类型的信息以及按什么顺序排列信息。在管理控制台的HTTP标签页中，将Format属性设置为Extended，这样便启用了扩展日志格式。（请参见本章“用管理控制台设置HTTP访问日志”中的步骤4）。

日志文件所要记录的信息类型通过日志文件中的指令来指定。每条指令必须新起一行，以#符号开始指令。如果系统还没有日志文件，那么会新建一个包含缺省指令的日志文件。如果在服务器启动时，已经有日志文件了，那么这个日志文件头中必须包含合法指令。

创建Fields指令

日志文件的第一行必须是表明日志文件格式的指令，紧跟其后是Fields指令：

#Version: 1.0

#Fields: XXXX XXXX XXXX …

其中，每个 XXXX描述要记录的数据字段。字段类型要么由简单的标识符来指定，要么采用W3C规范中的前缀标识符格式。以下是一个例子：

#Fields: date time cx-method cs-url

该指令要求服务器要记录每次HTTP访问的以下信息：事务的日期与时间，客户端请求方式以及请求的URI。字段之间用空格阁开。每条日志记录都新起一行。

注意：#Fields指令后面必须有一新行，这样第一条日志信息才不会与#Fields指令在同一行上

字段标识符

以下是所支持的标识符，这些标识符不需要前缀。

date

事务完成的日期，类型为W3C规范定义的类型

time

事务完成的时间，类型为W3C规范定义的类型

time-taken

事务花费的时间（以秒为单位），类型为W3C规范定义的类型

bytes

传送的字节数，类型为

注意，WebLogic服务器不支持W3C规范中定义的cached字段。

以下是需要前缀的标识符，这些标识符不能单独使用。

与IP地址相关的字段：

这些字段给出了请求客户端或应答服务器的IP地址与监听端口。字段的类型为W3C规范定义的

类型。所支持的前缀有：

c-ip

客户端的IP地址

s-ip

服务器的IP地址

与DNS相关的字段

这些字段给出了客户端与服务器的域名。字段的类型为W3C规范定义的类型。所支持的前缀有：

c-dns

客户端的域名

s-dns

被请求服务器的域名

sc-status

响应的状态代码。例如（404）表示状态为“文件没有找到”。该字段的类型为W3C规范所定义的类型

sc-comment

状态码的注释。例如，“文件没有找到”。该字段的类型为类型

cs-method

请求方式，例如GET或POST。该字段的类型为W3C规范所定义的类型

cs-uri

请求的完整URI。该字段的类型为W3C规范所定义的类型

cs-uri-stem

URI的主干部分（省略了查询）。该字段的类型为W3C规范所定义的类型

cs-uri-query

URI的查询部分。该字段的类型为W3C规范所定义的类型

定制字段标识符

扩展日志格式的HTTP访问日志可以使用用户定义的字段。要创建一个定制字段，你必须在扩展日志格式（即ELF格式）的日志文件中使用Fields指令来标识定制的字段，同时定义与该字段匹配的Java类以生成所需要的输出。你可以为每个字段创建一个Java类，也可以用一个Java类匹配多个字段。本文提供了这种Java类的代码示例。详细内容，请参见7-18页的“Java类与创建定制ELF字段”。

要创建一个定制字段，

1． 在Fields指令中包含该字段的名字，形式如下：

x-myCustomField

其中myCustomField为类的完整名字

有关Fields指令的详细信息，请参见7-12页的“创建Fields指令”

2． 创建一个与定制字段同名的Java类（例如myCustomField）。这个类定义了要记录自定制字段中的信息。该Java类必须实现以下接口：

weblogic.servlet.logging.CustomELFLogger

这个Java类必须实现logField()方法，该方法使用HttpAccountingInfo对象与FormatStringBuffer对象作为参数。

用HttpAccountingInfo对象访问HTTP请求与响应的数据，这些数据将被输出到所定制的字段中。它提供了许多Get方法来访问这些信息。Get方法的完整列表请参见7-15页的“HttpAcountingInfo对象的Get方法”。

用FormatStringBuffer类创建定制字段的内容。他提供了创建定制字段的合适的方法。有关这些方法的详细内容，请参见FomatStringBuffer类的Java文档。（见以下网页：http://e-docs.bea.com/wls/docs60/javadocs/weblogic/servlet/logging/FormatStringBuffer.html）

3． 编译Java类，并把它加到启动WebLogic服务器的CLASSPATH语句中。如果用脚本启动WebLogic服务器，那么要修改脚本中的CLASSPATH语句

注意：不要将这个类放在扩展格式的Web应用或企业应用中。

4． 对WebLogic服务器进行配置，让它使用扩展日志格式。详细内容，参见7-11页“使用扩展日志格式”。

注意：在编写定制字段的Java类时，务必不要在这个类中执行降低系统性能的代码（例如，访问DBMS，以及执行繁重的I/O或网络调用。）记住，对于每一个HTTP请求，系统都会相应地创建一条HTTP访问日志记录。

注意：如果要输出到多个字段，那么这些字段之间应该用制表符分隔开。有关字段分隔以及扩展日志格式的更多内容，请参见以下网页的“扩展日志格式”部分

http://www.w3.org/TR/WD-logfile-960221.html

HttpAccountingInfo对象的Get方法

以下方法返回与HTTP请求相关的数据。这些方法与javax.servlet.ServletRequest, javax.servlet.http.Http.ServletRequest以及javax.servlet.http.HttpServletResponse等类的方法相似。

这些方法在Java接口中定义，下表列出了这些方法以及从什么地方可以找到有关这些方法的信息。

表7-1    HttpAccountingInfo的Getter方法

HttpAccountingInfo	参考以下类中的相应方法
Object getAttribute	javax.servlet.ServletRequest
Enumeration getAttributeName()	javax.servlet.ServletRequest
String getCharacterEncoding()	javax.servlet.ServletRequest
Int getResponseContentLength()	Javax.servlet.servletResponse.setContentLength() 该方法返回响应的长度，该长度由setContentLenth()方法设置
String getResponseContentLength()	javax.servlet.ServletRequest
Strng getContentType();	javax.servlet.ServletRequest
Locale getLocale();	javax.servlet.ServletRequest
Enumeration getLocales();	javax.servlet.ServletRequest
String getParameter(String name);	javax.servlet.ServletRequest
Enumeration getParameterNames();	javax.servlet.ServletRequest
String[] getParameterValues(String name);	javax.servlet.ServletRequest
String getProtocol();	javax.servlet.ServletRequest
String getRemoteAddr();	javax.servlet.ServletRequest
String getRemoteHost();	javax.servlet.ServletRequest
String getScheme();	javax.servlet.ServletRequest
String getServerName();	javax.servlet.ServletRequest
int getServerPort();	javax.servlet.ServletRequest
boolean isSecure();	javax.servlet.ServletRequest
String getAuthType();	javax.servlet.http.Http.ServletRequest
HttpAccountingInfo Methods	javax.servlet.http.Http.ServletRequest
String getContextPath();	javax.servlet.http.Http.ServletRequest
Cookie[] getCookies();	javax.servlet.http.Http.ServletRequest
long getDateHeader(String name);	javax.servlet.http.Http.ServletRequest
String getHeader(String name);	javax.servlet.http.Http.ServletRequest
Enumeration getHeaderNames();	javax.servlet.http.Http.ServletRequest
Enumeration getHeaders(String name);	javax.servlet.http.Http.ServletRequest
int getIntHeader(String name);	javax.servlet.http.Http.ServletRequest
String getMethod();	javax.servlet.http.Http.ServletRequest
String getPathInfo();	javax.servlet.http.Http.ServletRequest
String getPathTranslated();	javax.servlet.http.Http.ServletRequest
String getQueryString();	javax.servlet.http.Http.ServletRequest
String getRemoteUser();	javax.servlet.http.Http.ServletRequest
String getRequestURI();	javax.servlet.http.Http.ServletRequest
String getRequestedSessionId();	javax.servlet.http.Http.ServletRequest
String getServletPath();	javax.servlet.http.Http.ServletRequest
Principal getUserPrincipal();	javax.servlet.http.Http.ServletRequest
boolean isRequestedSessionIdFromCookie();	javax.servlet.http.Http.ServletRequest
boolean isRequestedSessionIdFromURL();	javax.servlet.http.Http.ServletRequest
boolean isRequestedSessionIdFromUrl();	javax.servlet.http.Http.ServletRequest
boolean isRequestedSessionIdValid();	javax.servlet.http.Http.ServletRequest
String getFirstLine();	javax.servlet.http.Http.ServletRequest
HttpAccountingInfo Methods	返回HTTP请求的第一行。例如GET/index.html HTTP/1.0
long getInvokeTime();	返回查找servlet的service()方法所花费的方法，这个servlet的作用是把数据回写到客户端
int getResponseStatusCode();	javax.servlet.http.HttpServletResponse
String getResponseHeader(String name);	javax.servlet.http.HttpServletResponse

列表7-1 用于创建ELF字段的Java类

import weblogic.servlet.logging.CustomELFLogger;

import weblogic.servlet.logging.FormatStringBuffer;

import weblogic.servlet.logging.HttpAccountingInfo;

/* This example outputs the User-Agent field into a

custom field called MyCustomField

*/

public class MyCustomField implements CustomELFLogger{

public void logField(HttpAccountingInfo metrics,

FormatStringBuffer buff) {

buff.appendValueOrDash(metrics.getHeader("User-Agent"));

}

}

 

防止“POST拒绝服务”攻击

拒绝服务工具是通过假冒请求造成服务器过载的一种恶意攻击。这种攻击类型通常采用HTTP的POST方法发送大量数据。在WebLogic服务器中，你可以通过设置三个属性来防止这种攻击。这三个属性可以在管理控制台的Servers或virtural hosts节点下设置。如果为一个虚拟主机定义了这些属性，那么所设置的值将覆盖Servers节点中的设置

PostTimeoutSecs

通过这个属性，你可以限制WebLogic服务器接收HTTP POST数据段之间的等待时间

MaxPostTimeSecs

限制WebLogic服务器用于接收POST数据的时间。如果触发了该限制，那么将会引发PostTimeoutException异常并将以下信息发送到服务器日志中。

Post time exceeded MaxPostTimeSecs

MaxPostSize

限制每个请求中的POST数据量。当请求中的POST数据量超过该限制时，将引发MaxPostSizeExceeded异常并将以下信息发送到服务器日志中。

POST size exceeded the parameter MaxPostSize

同时向客户端返回HTTP 413错误代码

如果客户端使用了监听模式，那么它将得到这个信息。如果没有采用监听模式，则断开连接。

设置WebLogic服务器的HTTP隧道

如果你只能采用HTTP协议连接WebLogic服务器与Java客户端，那么可以用HTTP隧道功能来模拟有状态的套接字连接。HTTP隧道通常被用来穿越安全防火墙的HTTP端口。HTTP是一种无状态协议，因此WebLogic服务器所提供的隧道功能使得连接看上去象是一个T3连接。但比起标准的套接字连接，这会造成性能的下降。

配置HTTP隧道连接

当使用HTTP协议时，客户端只能发送请求，然后接收服务器的响应。服务器不能主动地与客户端通信，并且HTTP协议是无状态的，这就意味这服务器与客户端之间不可能发生连续的双向连接。

WebLogic HTTP隧道通过HTTP协议模拟T3Connection协议，从而克服上述限制。有两个属性与隧道连接的性能有关。这两个属性可以通过管理控制台的Servers部分的Configuration标签页的Tunning标签页来设置。大多数情况下，你应该使用这两个属性的缺省值，除非你对在处理连接问题方面非常有经验。服务器通过这些属性来决定一个客户端连接是否有效以及客户端是否是活动的。

Enable Tunneling

启用或禁用HTTP隧道。缺省情况下，HTTP隧道是被禁用的

Tunneling Ping

在建立HTTP隧道连接时，客户端会自动地向服务器发一个请求，使服务器可以主动响应客户端。客户端可以在请求中包含指示，无论客户端应用是否需要与服务器进行通信。如果服务器没有在由该属性所设置的时间内响应客户端，那么它就会主动地给客户端一个响应，客户端接收该响应并立即发送另一个请求。

缺省值为45秒；有效的范围为20至900秒

Tunning Timeout

在继上次客户端请求之后，如果在该属性所指定的时间内，客户端还没有发出新的请求，那么服务器就认为客户端已经死了并结束该HTTP隧道连接。在服务器响应客户端请求时，它会按该属性所指定的时间间隔来检测继上一次请求后所过去的时间。

缺省值为40秒，有效范围为10至900秒

建立客户端与WebLogic服务器之间的连接

如果客户端要与WebLogic服务器建立HTTP隧道连接，那么只需要URL中指定HTTP协议。例如：

Hashtable env = new Hashtable();

env.put(Context.PROVIDER_URL, "http://wlhost:80");

Context ctx = new InitialContext(env);

客户端会在HTTP协议后面附加一个特殊标签，这样WebLogic服务器就知道这是一个隧道连接而不是普通的HTTP请求，这些都是自动的，你的应用不需要做额外的工作。

客户端必须在URL中指定端口号，即便是使用80端口。尽管WebLogic服务器可以在任何端口监听HTTP请求，但一般使用80端口，因为通常只有该端口才能穿越防火墙。

你可以在管理控制台的Servers节点的Network标签页配置WebLogic服务器的简听端口。

用本地I/O提供静态文件服务（只适用于Windows）

当你在Windows NT/2000上运行WebLogic服务器，可以让WebLogic服务器通过本地操作系统调用Tramsmitfile来代替Java方法服务静态页面，例如HTML文件，文本文件以及图象文件。在服务较大的静态页面时，使用本地I/O会提高服务器的性能。

要使用本地I/O，那么需要在Web应用的分发描述符web.xml中增加两个I/O参数。参数weblogic.http.nativeIOEnabled应该设置为TRUE以启用本地I/O文件服务。参数weblogic.http.minimumNativeFileSize指定要用本地I/O进行服务的文件的最小长度。如果一个文件的长度大于该参数所设置的值，那么就会用本地I/O来服务该文件。如果没有指定该参数的值，那么默认为400个字节。

一般而言，对于较大的文件，使用本地I/O会提高服务的效率。但随着运行服务器的计算机的负载的增大，这种效益会消失。因此需要通过实验来寻求weblogic.http.minimumNativeFilesize参数的最佳值。

下面的例子演示了如何在web.xml中添加本地I/O的相关参数的配置。这些设置必须放在元素与元素之间。

weblogic.http.nativeIOEnabled

TRUE

weblogic.http.minimumNativeFileSize

500

有关编写分发描述符的详细内容，请参见以下页面的“Writing Web Application Deployment Descriptors”:

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html .

 

7 代理对另一个HTTP服务器的请求

 

 

 

概述

如果把WebLogic服务器作为主Web服务器，通过配置，可以让它把请求委托给另一个HTTP服务器处理，例如Netscape Enterprise服务器,Apache或者是 Microsoft Internet Information 服务器。任何被代理的请求都会重定向到一个指定的URL。被代理的Web服务器可以位于其它机器上。我们一般基于请求的URL来决定把请求委托给哪个服务器处理。

HttpProxyServlet将HTTP请求重定向到代理URL上，然后通过WebLogic服务器将响应返回给浏览器。要使用代理功能，必须在Web应用中配置该功能，并把它分发到一个重定向请求的WebLogic服务器中。

设置从服务器的代理

要设置从服务器的代理：

1．在Web应用分发描述符（见“使用ProxyServet的web.xml示例”）注册代理servlet。Web应用必须是响应请求的服务器的缺省应用。代理servlet的类名为weblogic.t3.srvr.HttpProxyServlet。详细信息可以参见以下资源中的“分发与配置Web应用”

http://e-docs.bea.com/wls/docs60/adminguide/config_web_app.html

2． 定义ProxyServlet的初始化参数。为redirectURL， 为从服务器的URL。

3． 在Web应用分发描述符web.xml中使用元素把ProxyServlet映射到。特别地，把文件扩展名映射到ProxyServlet，例如*.jsp，或*.html。

如果设置为“/”，那么任何不能被WebLogic服务器所解析的请求都会委托给远程服务器处理。如果你只希望代理特定扩展名的文件，那么应该映射以下扩展：*.jsp， .html以及*.htm。

代理Servlet的分发描述符示例

以下是使用Proxy servlet的Web应用分发描述符示例。

表8-4    使用ProxyServlet的web.xml示例

 

 

ProxyServlet

weblogic.t3.srvr.ProxyServlet

redirectURL

tehama1:7736:7737|tehama2:7736:7737|tehama:7736:7737

 

ProxyServlet

/

 

ProxyServlet

*.jsp

 

ProxyServlet

*.htm

 

ProxyServlet

*.html

 

 

8 代理对WebLogic集群的请求

本章将介绍如何代理对WebLogic集群的请求，主要有以下内容：

ü       概述

ü       设置HttpClusterServlet

ü       HttpClusterServlet示例

概述

HttpClusterServlet负责把请求从一个WebLogic服务器代理到WebLogic集群中的服务器成员，同时HttpClusterServlet还为代理的HTTP请求提供负载平衡与失败转移。有关servlets与WEbLogic集群的更多内容，可以参见以下页面的“理解HTTP会话状态复制”部分：

http://e-docs.bea.com/wls/docs60/cluster/servlet.htm l.

设置HttpClusterServlet

以下是使用HttpClusterServlet所需要的配置：

1．在WebLogic服务器的管理控制台配置一个代理HTTP请求的WebLogic服务器实例，该服务器实例负责把请求重定向到WebLogic服务器。

a. 新建一个域。

b. 在新建的域中新建一个应用

c. 在新建的域中新建一个服务器，或使用缺省的服务器

d. 把在步骤b中创建的Web应用设置为新建服务器的缺省Web应用。

2．在步骤1所创建的Web应用的分发描述符中注册HttpClusterServlet。（见本章的“HttpServlet的分发描述符示例”）。该Web应用必须是响应请求的服务器的缺省Web应用。相关信息参见第8章的“指定一个缺省Web应用”。

HttpClusterServlet的类名是weblogic.servlet.internal.HttpClusterServlet。HttpClusterServlet的分发描述符示例见下文

3． 定义HttpClusterServlet的初始化参数。初始化参数用web.xml的元素定义。defaultServers参数是必须定义的，其它参数视需要而定。有关HttpClusterServlet的参数可以参见本章表10-1 “HttpClusterServlet Parameters”中的内容。

4．把代理servlet映射到一个。特别地，映射要代理的文件扩展名，例如“*.jsp”或*.html。

如果设置为“/”，那么任何不能被WebLogic服务器所解析的请求都将交给远程服务器处理。如果你只希望代理特定扩展名的文件，那么应该映射以下扩展名文件：*.jsp， .html以及*.htm。

设置URL模式的另一方式是：首先映射一个url模式，例如/foo，然后把pathTrim参数设置为foo，该设置的作用是把foo从被代理的URL中删除。

表10-1 HttpClusterServlet的参数

		缺省值
defaultServlets	（必须设置该参数）一组代理请求的服务器，采用以下形式：hostname1:HTTP port1:HTTPS port1 | hostname2:HTTP port2:HTTPS port2 如果secureProxy参数设置为ON（见下面的secureProxy参数），那么HTTPS端口将在运行HttpClusterServlet的WebLogic服务器与集群的成员服务器之间使用SSL协议。即使把secureProxy参数设为OFF，你也必须定义HTTPS端口	None
secureProxy	ON/OFF。如果设置为ON，那么HTTPClusterServlet与WebLogic服务器集群成员之间的连接将使用SSL协议	OFF
DebugConfigInfo	ON/OFF。如果设置为on，那么在请求中加上一个请求参数?_WebLogicBridgeConfig就可以查询HttoClusterServlet的调试信息。因为安全性的原因，建议在生产环境中把该参数设置为OFF。	OFF
connectionTimeout	套接字等待读入数据的时间，单位为微秒。超时会引发java.io.InterruptedIOException异常	0（即没有限制）
numOfRetries	HttpClusterServlet重试一个失败连接的次数	5
PathTrim	从原始URL的开头部分裁减的字符串	None
TrimExt	从原始URL的最后裁减掉的文件扩展名	None
pathPrepend	在PathTrim被裁减后，在请求被代理到一个WebLogic服务器集群成员之前，附加在原始URL之前的字符串。	None

HttpClusterServlet的分发描述符示例

以下是使用HttpClusterServlet的Web应用分发描述符示例：

列表10-1 使用HttpClusterServlet的web.xml示例

 

HttpClusterServlet

weblogic.servlet.internal.HttpClusterServlet

 

defaultServers

myserver1:7736:7737|myserver2:7736:7737|myserver:7736:7737

 

DebugConfigInfo

ON

 

 

HttpClusterServlet

/

 

HttpClusterServlet

*.jsp

 

HttpClusterServlet

*.htm

 

HttpClusterServlet

*.html

 

 

 

9  

配置Web应用的安全性

通过验证，限制对Web应用中某些资源的访问或者在servlet中使用安全调用，你可以保护你的应用。WebLogic定义了几种安全域，有关安全域的讨论见以下资源的“安全基础知识”：

http://e-docs.bea.com/wls/docs60/security/concepts.html

注意，安全域为多个虚拟主机所共享。

设置对Web应用的授权

Web应用的验证在web.xml的元素中定义。用该元素定义安全域。安全域包含用户证书、验证方式与需要进行验证的资源所在的位置。有关设置安全域的更多内容，请参见以下资源中的“安全基础”部分。

要设置Web应用的安全验证：

1．选择一种验证方式。有以下几种选项

BASIC

BASIC验证通过Web浏览器显示一个用户名/口令对话框。然后依照安全域对用户名及口令进行验证。

FORM

基于表单的验证需要一个包含用户名与口令的HTML表单。该表单所返回的字段必须是j_username与j_password，表单的action属性必须设为j_security_check，以下是一个用FORM授权的HTML示例：

 

产生该表单的资源可能是HTML页面、JSP或者是servlet。你必须用元素定义产生该表单的资源。

会话对象在返回登录页面时创建。因此在验证通过后，从被服务的页面中调用session.isNew()方法，该方法将返回FALSE。

CLIENT-CERT

使用客户端验证对请求进行验证。详细内容，参见以下资源的“配置SSL协议”部分：

http://e-docs.bea.com/wls/docs60/adminguide/cnfgsec.html#cnfgsec015

2．如果选用FORM验证，那么还需要定义生成HTML页面的资源所在的位置与响应验证失败的资源。有关配置表单验证的详细信息，请参见以下网页中的“”的内容：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#login –config.

3．定义用来验证的域。如果没有指定域，将使用缺省的WebLogic FileRealm域。详细内容，参见以下网页发“”部分：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#login-config

多Web应用、Cookies与身份验证

缺省情况下，所有Web应用都使用一样的cookie名字（JSESSIONID）。无论你用何种验证方式，所有使用相同cookie名的应用对授权都采用单点签到的方式。即一旦一个用户验证通过后，那么该验证对于其它使用同样cookie名字的Web应用的请求也是有效的，用户不会被要求重新验证。

如果要对一个应用单独授权，那么应该为这个应用指定一个不同的cookie名字。该名字由weblogic.xml的元素中的CookieName参数定义。详细内容，参见以下网页“session-descriptor元素”中的内容：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descriptor.

限制对Web应用资源的访问

你可以对Web应用中的资源（servlets, JSPs, 或者HTML页面）应用安全约束。要使用安全约束，你应该：

1、定义一个角色，该角色对应于安全域里的一到多个准则（principal）。角色在web.xml中的元素中定义（见 http://e-docs.bea.com/wls/docs60/programming/）。然后在weblolgic.xml中，用元素把这些角色映射到域中的准则(见 http://e-docs.bea.com/wls/docs60。 /programming/weblogic_xml.html#security-role-assignment) web_xml.html#security-role

2．用元素的子元素定义Web应用中需要实施安全限制的资源。可以是一个目录、文件名或者是一个

要对整个应用实施安全限制，那么应该用以下:

/*

3、使用元素中的子元素定义需要应用安全限制的HTTP方法（Get或Post）

4、使用元素中的子元素设置客户端与服务器端的通信是否使用SSL。

列表8-6 资源限制示例

 

web.xml entries:

SecureOrdersEast

Security constraint for resources in the orders/east directory

/orders/east/*

POST

GET

constraint for east coast sales

east

manager

SSL not required

NONE

...

east coast sales

east

managers

manager

weblogic.xml中的条目:

east

tom

jane

javier

maria

manager

peter

georgia

 

在servlet中使用用户和角色

你可以在servlet中用javax.servlet.http.HttpServletRequest.isUserInRole (String role)方法访问用户与角色。字符串role对应于Web应用分发描述符的元素的子元素所定义的名字，元素位于声明中。元素映射到Web应用分发描述符的元素所定义的元素。

例如

列表 8-7 安全角色映射示例

 

Servlet代码:

isUserInRole(" manager");

web.xml 中的条目:

. . .

manager

mgr

...

mgb

weblogic.xml中的条目:

mgr

al

george

ralph

 

配置Web应用的外部资源

在访问外部资源时，例如通过JNDI从Web应用访问数据源，你可以让代码中使用的JNDI名字映射到绑定在JNDI树中的实际名字。这种映射是通过web.xml以及Weblogic.xml分发描述符来实现的。这样当这些资源发生变化时，就不需要更新应用程序的代码。你应该为这些资源提供一个由代码使用的名字，即资源在JNDI树中所绑定的名字，以及资源的Java类型；并且还应该指出是否应该由servlet以编程的方式来处理该资源的安全性还是通过HTTP请求加密来保证资源的安全。

要配置外部资源：

1．在分发描述符中定义资源的名字、Java类型以及安全验证类型。有关编写分发描述符的内容请参见以下网页中的“引用外部资源”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#resource-re f.

2．将资源名映射到JNDI名。有关编写分发描述符的内容请参见以下网页的“Map external resources ”部分:

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#resource-descriptio n.

下面的例子假定你定义了一个名字为accountDataSource的资源。详细内容，参见以下页面的“JDBC数据源”部分：

http://e-docs.bea.com/wls/docs60/ConsoleHelp/jdbcdatasource.htm l.

表8-8 Example of Using a DataSource

 

Servlet代码:

javax.sql.DataSource ds = (javax.sql.DataSource) ctx.lookup("myDataSource");

web.xml 中的设置:

...

myDataSource

javax.sql.DataSource

CONTAINER

...

weblogic.xml中的设置：

myDataSource

accountDataSource

 

 

在Web应用中引用EJBs

当Web应用要引用EJB时，你应该在web应用分发描述符中为所引用EJB的定义一个名字，这个名字应该与webloigc-ejb-jar.xml文件中所定义的EJB的JNDI名相同，然后你就可以在程序中用所定义的名字来引用EJB。

要在Web应用中使用EJB，需要进行以下配置：

1．在Web应用分发描述符的元素中定义EJB的引用名（程序用这个名字来查找EJB）、Java类名以及home接口与remote接口的类名。有关如何编写分发描述符的条目，参见以下页面的“引用EJB资源”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#ejb-re f.

2．将在weblogic.xml的元素中所定义的引用名映射到weblogic-ejb-jar.xml文件中定义的JNDI名。关于如何编写分发描述符中的条目，你可以参见以下页面的“Map EJB resources”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#ejb-reference-descriptio n.

如果Web应用是企业应用的组成部分，你可以用元素通过名称来引用.ear文件中的EJB。

配置会话管理

WebLogic服务器被缺省设置为处理会话跟踪，因此要使用会话跟踪，不需要配置任何以下将要提到的属性。但WebLogic服务器如何管理会话对于提升应用的性能非常关键。性能提升与以下因素有关：

ü       预期会有多少个用户访问一个servlet。

ü       会有多少个并发用户访问一个servlet。

ü       每个会话持续的时间

ü       为每个用户存储的数据量

HTTP会话属性

你可以在特定于WebLogic的分发描述符中配置HTTP会话属性，配置WebLogic服务器的会话跟踪。详细内容，参见以下网页的“定义会话参数”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html r.#session-descripto

会话属性的完整列表可在以下网页获得：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descripto r.

会话超时

你可以指定HTTP会话隔多长时间失效。在会话失效后，所有保存在会话中的数据都将丢失。以下两种方式可以配置会话失效的时间间隔。

TimeoutSecs属性在特定于WebLogic的分发描述符——weblogic.xml文件的元素中定义，属性值以秒为单位。你可以参见以下资源：

http://e-docs.bea.com/wls/ docs60/programming/ weblogic_xml.html #session-descriptor

也可以用Web应用分发描述符——web.xml文件中的元素定义会话超时，以分钟为单位。该属性会覆盖在weblogic.xml的元素中所设置的属性。有关在web.xml中定义超时属性的内容可以参见以下资源：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#web_xml_session-config）

配置会话Cookies

如果客户的浏览器支持cookies，那么WebLogic服务器将用Cookies来管理会话。

缺省情况下，WebLogic服务器把跟踪会话的cookies设置为暂态的，即浏览器关闭时，cookie丢失并且会话的生命期便被看作是结束了。这种行为是使用会话的精髓所在，推荐你以这种方式使用会话。

通过定义weblogic.xml中的有关属性，你可以配置cookies的方方面面。有关会话与cookie的属性的完整列表可以参见:

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descriptor

有关如何编辑weblogic.xml的内容，可以参见以下资源的“定义会话参数”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.htm . l#session-descriptor

使用长效 cookies

对于长效的客户端数据，应用程序应该通过HTTP servlet API创建自己的cookies，并且尽量让这个cookie与HTTP会话存在什么关联。应用程序可能要用cookie来实现用户从某一机器上的自动登录功能，这种情况下就需要创建一个长效的cookie。记住，该cookie只能由该用户的机器发送。如果该用户要从多台机器上访问，那么必须把数据保存在服务器端。

注意，浏览器cookie的生命周期与会话的生命周期没有直接的联系。如果，一个cookie先于它所关联的会话失效，那么该会话就成了孤儿。如果会话先于它所关联的cookie失效，那么servlet就找不到会话。此时，当getSession()方法被调用时，会创建一个新的会话。

配置持久化会话

持久会话有以下四种实现：

ü       内存（单服务器，不存在复制）

ü       文件系统

ü       JDBC

ü       内存复制（在集群中的服务器之间）

这里只介绍前面三种实现；有关内存复制的方式参见以下资源的“HTTP会话状态的复制”部分：

http://e-docs.bea.com/wls/docs60/cluster/servlet.html

要通过文件系统、JDBC或者内存复制来实现持久会话，那么需要设置包括PersistentStoreType在内的一些属性。每种实现方式都有一组自己的属性。

通用属性

在weblogic.xml中，以下属性设置保存在内存中的会话数量。只有在使用持久会话时，这些属性才是有效的

CacheSize

该属性限制了缓存在内存中的活动会话的数量。如果可能会有大量并发的活动会话，而又不希望活动会话占用太多的内存使得内存页面交换频繁发生而导致性能问题，那么可以通过这个属性来控制。当缓冲区满了时，最少使用的那些会话将被保存在持久存储设备中，当需要时，会话被自动地装载到缓冲区中。如果不使用持久会话，那么该属性被忽略，并且不限制内存中的会话数量。缺省情况下，缓存会话的数量为1024个，最小为16个，最大为Integer.MAX_Value个。一个空会话所使用的字节数少于100个字节，但随着数据的加入，它所使用的内存数量也虽之增加

SwapIntervalSecs

当内存中会话的数量达到cacheEntries界限时，服务器每隔多长时间把新近最少使用的会话保存到持久存储器中。

该属性缺省为10秒，最小为1秒，最大为604800秒（一个星期）。

InvalidationIntervalSecs

该属性设置了WebLogic服务器检查超时与失效会话并删除这些会话以释放内存空间的时间间隔。该属性值应该大于元素中设置的值。该参数可以用来对WebLogic服务器的性能进行优化。

最小设置为1秒一次，最大设置为一星期一次（604800秒），缺省为60秒。

在web.xml的元素中设置，详细内容见以下资源：

http://e-docs.bea.com/wls/docs60/programming/web_xml.html#web_xml_session-config

使用基于内存的、单服务器的、非复制的持久存储

如果要用基于内存的、单服务器的、非复制的方式来实现持久会话，那么应该把PersistentStoreType属性设置为memory。对于这种实现方式，所有的会话数据都保存在内存中。因此当你终止并重启WebLogic服务器时，所有的会话数据都将丢失。

使用基于文件的持久存储

要以基于文件存储的方式实现持久会话：

1．将PersistentStoreType属性设置为file

2．设置存储会话的目录。有关如何设置该目录的详细内容，请参见以下资源中的“PersistentStoreDir”部分：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#persistentStroeDir

如果没有设置该属性，WebLogic服务器会创建一个临时目录保存会话。

如果在集群中，持久会话采用基于文件存储的实现方式，那么必须明确设置一个能被集群中所有成员访问的共享目录，而且你必须自己创建该目录。

使用基于数据库的持久存储

要以基于JDBC的方式实现持久会话：

1．将PersistentStoreType属性设置为jdbc

2． 设置PersistentStorePool属性，该属性被设置为一个在控制台中定义的连接池。通过设置该属性，持久会话将使用JDBC连接池。

所使用的连接池必须是仅被用于JTS驱动器的JDBC连接。也就是说，一个被非JTS驱动器所使用的JDBC连接池不能用于会话的持久化。为保险起见，你应该为持久会话单独创建一个JDBC连接池。不过，持久会话可以与servlet持久会话以及EJB共用一个JDBC连接池，因为后两者都要用到JTS驱动器

有关设置数据库连接池的详细内容请参见以下资源的“管理JDBC连接”部分：

http://e-docs.bea.com/wls/docs60/adminguide/jdbc.htm l

总结一下：尽管servlet可以用非-JTS连接访问数据库，但是你不能在持久会话中使用该连接。

3．设置连接的ACL。只有那些有权限的用户才能使用该连接。有关设置数据库连接的详细内容，请参见以下资源的“管理数据库连接”部分：

http://e-docs.bea.com/wls/docs60/adminguide/jdbc.htm l.

4．创建一个名字为wl_servlet_sessions的数据库表。基于JDBC实现的持久会话要用到这个表。数据库连接池应该具有该表的读/写权限。下表列出了wl_servlet_sessions表的字段及其类型。

表8-4    wl_servlet_sessions表

列名	类型
Wl_id	长度不超过100的可变字符串型。例如Oracle的VARCHAR2(100)。主键必须设置为wl_id + wl_context_path
Wl_context_path	长度不超过100的可变字符串型。例如Oracle的VARCHAR2(100)。该列是主键的组成部分
Wl_is_new	单字符型。例如，Oracle的 CHAR(1)
Wl_create_time	长度为20的数值型。例如，Oracle的NUMBER(20)
Wl_is_valid	单字符型。例如，Oracle的CHAR(1)
Wl_session_values	Large binary column。例如，Oracle的Long RAW类型
Wl_access_time	长度为20的数值型。例如，Oracle的NUMBER(20)
Wl_max_inactive_interval	整数型。例如Oracle的Integer类型。该列指的是两次客户端请求的最大时间间隔（单位为秒），超过该时间间隔会话就变为无效。如果该列的值为负数，表明会话永远不过期。

如果使用Oracle数据库管理系统，那么可以用以下SQL语句创建wl_servlet_session表。

create table wl_servlet_sessions

( wl_id VARCHAR2(100) NOT NULL,

wl_context_path VARCHAR2(100) NOT NULL,

wl_is_new CHAR(1),

wl_create_time NUMBER(20),

wl_is_valid CHAR(1),

wl_session_values LONG RAW,

wl_access_time NUMBER(20),

wl_max_inactive_interval INTEGER,

PRIMARY KEY (wl_id, wl_context_path) );

对上述SQL语句作一些改动，就可以用于其它数据库管理系统上。

注意：JDBCConnectionTimeoutSecs属性设置了JDBC持久会话在连接池中的连接装载数据失败前的最长等待时间。详细内容，参见以下网页：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#JDBCConnectionTimeoutSecs)

使用URL重写

某些情况下，因为浏览器不支持cookies，从而不能用cookie来跟踪会话。在这种情况下，WebLogic服务器检测到浏览器不支持cookie时，它会自动起用URL重写来进行会话跟踪。URL 重写将会话号编写在页面的超级链接中，你的servlet把这个页面返回到浏览器。当用户点击页面上的链接时，WebLogic服务器从URL地址中抽取出会话号并在servlet调用getSession()方法时找到合适的HttpSession。

要在WebLogic中启用URL重写，需要在特定于WebLogic的分发描述符——weblogic.xml中把元素的URLRewritingEnabled属性设置为true（该属性的缺省值为true）。有关URLRewritingEnabled属性的信息，请参见以下网页中的内容：

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#URLRewritingEnabled

URL重写的编码指南

以下是在使用URL重写时如何在代码中处理URL的指导性规则：

ü       不要将URL直接输出到输出流中，就象下面这样：

out.println("catalog");

而是应该使用HTTPServletResponse.encodeURL()方法。例如：

out.println("catalog");

encodeURL()方法会确定是否要重写URL，如果需要重写，该方法会在URL中加上会话号。会话号附加在URL后并且以分号开头

ü       除了作为响应返回到Weblogic的URL外，还要对需要redirect的URL重编码。例如 :

if (session.isNew())

response.sendRedirect(response.encodeRedirectUrl(welcomeURL));

对于新建的会话，即使浏览器支持cookies，WebLogic服务器也会使用URL重写，因为服务器在第一次访问一个会话时，不能区分浏览器是否支持cookies。

ü       通过检测HttpServletRequest.isRequestedSessionIdFromCookie()方法返回的值，Servlet可以确定所会话号是否是来自于cookie。应用程序可以对此作出合适的响应，或者只是使用WebLogic服务器的URL重写。

URL重写与无线访问协议(WAP)

如果要编写WAP应用，那么就必须使用URL重写，因为WAP协议不支持cookies。而且某些WAP设备把URL的长度限制在128个字符（包括参数在内），从而限制了URL重写所能传送的数据量。要使参数能有更多的空间，你可以设置IDLength属性来限制WebLogic服务器随机产生的会话号的长度。有关该属性的详细内容，请参见以下网页中的内容

http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#IDLength

使用字符集与POST数据

对于一个使用Post方法的表单，你可以设置处理该表单数据的字符集。通过在处理表单数据的URL中加上特定的“信号”字符（在

标签的action属性中指定），应用程序就知道如何处理使用了特殊字符集的表单数据并且会将这些字符映射到Web应用分发描述符-web.xml中指定的编码方式。通常POST数据被看作是ASCII字符。如果要处理非ASCII码的POST数据，应该使用以下步骤：

1．在Web应用分发描述符（web.xml）的元素与元素之间增加元素。在这个元素中，中的内容是类名weblogic.httpd.inputCharse，后跟句点号与信号字符传。中的内容是HTTP字符集的名字。在下面的这个例子中，字符串/rus/jo*映射到windows-1251字符集。

weblogic.httpd.inputCharset./rus/jo*

windows-1251

2．在需要发送数据的表单中使用信号字符串。例如：

...

信号字符串应该在Web应用名（也被称为上下文路径，上面的例子中为myWebApp）与URL的其它部分之间。

有关Web应用分发描述符的详细内容，请参见以下网页的“上下文参数”部分：

http://e-docs.bea.com/wls/docs60/programming/webappdeployment.html#context-param .

 

10 配置Apache-Weblogic服务器插件

本章将介绍如何配置Apache-WebLogic Server插件。主要有以下内容：

ü       概述

ü       平台支持

ü       安装库

ü       配置httpd.conf文件

ü       Apache-WebLogic Server插件的配置参数

ü       使用SSL

ü       与SSL-Apache配置有关的问题

ü       httpd.conf文件示例

ü       分发Apache-WebLogic Server插件

概述

本章描述如何安装与配置Apache-Weblogic Server插件。该插件可以把Weblogic服务器的HTTP功能平滑地集成到Apache服务器中。因为可以透明地访问Weblogic Server的servlet引擎，从而增强了原有Apache服务器的功能。

插件用于这样一种环境中：Apache服务器提供静态页面的服务，而把文档树中的另一部分转交给工作在另一个进程也可能是在另一个主机中的Weblogic服务器。对于终端用户即浏览器而言，转交给webLogic服务器的HTTP请求是来自相同的源；后端的WebLogic Server是不可见的。因为WebLogic服务器的客户-服务器协议的HTTP-隧道部件可以在插件中运行，因此插件可以访问包括HTTP servlets在内的所有WebLogic Server服务。

Apache-WebLogic Server插件在Aparhe服务器中作为一个Apache模块运行。Apache Server在启动时会装载Apache模块，然后把HTTP请求交给被装载的Apache模块来处理。Apache模块类似于HTTP(Java) servlets，只是Apache模块是与平台相关的。Apache插件已经过测试，并且可以与Apache Server1.3.9一同使用。

平台支持

Linux，Solaris与HPUX11等平台都支持Apache-WebLogic Server插件。该插件可以与Apache Server 1.3.9以及Apache Server 1.3.12一起使用。

安装库

在Solaris、Linux以及HPUX11平台上，Apache插件是一个共享对象（.so）。这些文件位于weblogic/lib目录中。

在Solaris上，Apache插件由weblogic/lib/solaris目录中的以下共享对象文件组成：

mod_wl.so

mod_wl_ssl.so

mod_wl_ssl_raven.so

在Linux上，Apache插件由weblogic/lib/linux目录中的以下共享对象文件组成：

mod_wl.so

mod_wl_ssl.so

mod_wl_ssl_raven.so

在HPUX11上，Apache插件由weblogic/lib/hpux11目录中的以下共享对象文件组成：

mod_wl.so

mod_wl_ssl.so

mod_wl.so是标准Apache(没有EAPI)共享对象。Mod_wl_ssl.so用于Apache+SSL/EAPI安装（Stronghole, modssl等）。Mod_wl_ssl_raven.so用在Apache+Raven安装。此时，需要mod_wl_ssl_raven.so，因为Raven使用了frontpage的补丁，使之与mod_wl_ssl.so不兼容。

上述二进制文件通过了C2Net的Stronghold/3.0 (Apache/1.3.12)以及Covalen的Raven/1.4.3 (Apache/1.3.12)认证。

安装后的Apache插件是一个Apache DSO（动态共享对象）。Apache对DSO的支持依赖于一个名为mod_so.c的模块，你必须在装载mod_wl.so之前先启用该模块。如果你用所提供的脚本在Solaris上安装Apache，那么mod_so.c已经启用。要确定是否启用了mod_so.c，运行以下命令：

APACHE_HOME/conf/http –l

该命令列出所有已启用的模块，如果其中包含了mod_so.c，那么安照本节末列出的六个步骤来完成Apache插件的安装。如果该命令没有列出mod-so.c，那么请按照相关说明用以下参数手工配置Apache：

./configure –prefix=

--enable-module=so

--enable-rule=SHARED_CORE

然后，根据Apache安装指南安装该产品。

安装完Apache并启用了mod_so.c后，你可以用一个名为apxs（Apache eXtenSion）的支持程序来安装Apache插件，该程序会在Apache源文件树之外构建DSO，并在httpd.conf文件中加入这样一个条目：addModule mod_so.c。以下是安装Apache_Weblogic Server插件的步骤：

1．进入weblogic/lib/PLATFORM目录，用以下命令激活weblogic_module：

APACHE_HOME/bin/apxs –i –a –n weblogic mod_wl.so

注意这是一个perl脚本，因此在运行该脚本前，先要安装Perl:

perl APACHE_HOME/bin/apxs –i –a –n weblogic mod_wl.so

2．该命令将把mod-wl.so文件复制到APACHE_HOME/libexec目录，并在httpd.conf文件的weblogic_module块添加了两条语句，同时激活了该模块。验证APACHE_HOME/conf/httpd.conf文件是否加入了以下行：

LoadModule weblogic_module

AddModule mod_weblogic.c

3．用以下命令验证APACHE_HOME/conf/httpd.conf 文件的语法是否正确：

APACHE——HOME/bin/apachect1 start

4．配置Apache的httpd.conf配置文件（下节将介绍该文件）

5．启动Weblogic服务器

6．启动Apache

配置httpd.conf文件

安装完库后，需要修改httpd.conf文件来配置Apache插件。修改httpd.conf文件是为了通知Apache web服务器应该以Apache 模块的形式来装载插件的本地库。该配置文件位于APACHE_HOME/conf/目录中（APACHE_HOMES是安装Apache的根目录）。

在httpd.conf文件中添加设置WebLogic Apache插件的以下信息：

ü       weblogic_module的配置信息（是由apxs工具所添加的）：

LoadModule weblogic_module        libexec/mod_wl.so

AddModule mod_weblogic.c（该行不总是被加上）

ü       确定由Apache插件交给WebLogic处理的HTTP请求类型。你可以通过URL或MIME文件扩展类型来转交该类型的请求。下面将讨论这些选项。

通过URL代理

如果用URL的形式转交HTTP请求，那么要使用位置块与SetHandler。SetHandler指出了Weblogic 模块的处理器，如下所示：

setHandler weblogic_handler

例如：

SetHandler weblogic-handler

 

SetHandler weblogic-handler

通过这种方式，某些形式的URL被传递到WebLogic Server中进行语义分析。因为PathTrim设置为从URL中剥离/weblogic，因此转发到WebLogic服务器的URL为：

http://myenterprise.server.com:7001

注意，Apache-WebLogic 服务器插件不能将请求转发到multiple WebLogic Cluseter。但你可以通过多虚拟主机来实现相同的功能。与位置块中所指定的任何URL匹配的请求将被转发到同一集群中。

通过MIME文件类型代理

如果以MIMI文件扩展类型的方式转发HTTP请求，那么应该在IfModule块中加上MatchExpression语句。例如：

MatchExpression *.jsp

...

在MatchExpression语句可以包含多个表达式，表达式之间用逗号隔开。例如：

example:

MatchExpression *.jsp,*.xyz

...

Apache-WebLogic Server插件的参数

Apache的Weblogic模块识别以下参数。要改变Apache-WebLogic Server插件的属性，你应该把这些参数放在在IfModule中或包含在IfModule中的Weblogic.conf文件。

# Config file for Weblogic which defines the parameters

Include conf/weblogic.conf

或者

# define your parameters here.

注意一行只能包含一个参数，在参数与值列表之间不能使用‘=’。例如：

PARAM_1 value1

PARAM_2 value2

PARAM_3 value3

WebLogicHost domain name

必须使用该参数（如果是WebLogic集群，则应该用WebLogicCluster参数）。HTTP请求将递交到该WebLogic Server主机。

WebLogicPort port

    必须使用该参数（如果是WebLogic集群，则应该使用WebLogicCluster参数）。WebLogic Server主机将在该端口监听WebLogic连接请求。

WebLogicCluster cluster list

    必须使用该参数（如果你正在使用一个WebLogic集群），该参数列出了在集群中进行负载平衡的WebLogic服务器。集群列表是由冒号分割的host:port条目的一个列表。例如，

WebLogicCluster myweblogic.com:7001,

yourweblogic.com:6999,theirweblogic.com:6001

应该用该参数取代WebLogicHost与WebLogicPort参数。WebLogic Server将首先查找WebLogicCluster参数，如果没有找到该参数，它将寻找并使用WebLogicHost与WebLogicPort参数。

Aparche插件在所有可利用的集群成员中进行简单的负载平衡计算，然后将包含cookie的HTTP请求递交到集群中创建该cookie的服务器。

PathTrim string

要裁减掉的字符串，缺省为“weblogic”。

PathPrepend string

在去除了PathTrim字符串后并在请求被递交到WebLogic之前，将该字符串加到原始URL的前面。缺省为“”。

ConnectTimeoutSecs seconds

Weblogic模块进行WebLogic Server主机连接尝试的最大时间间隔，缺省为10秒，应该大于ConnectRetrysecs。如果超过了ConnectTimeoutSecs所指定的时间还未能连接上，那么将把HTTP 501/Service Unavailable回复发送到客户端。

ConnectRetrySecs seconds

该参数确定了在进行连接WebLogic Server主机尝试之间模块应该休眠的时间。缺省为2秒，该参数的值应该小于connectTimeoutSecs参数的值。在将HTTP503/Service Unavailable回复返回到客户端之前，Apache插件每ConnectRetruSecs会进行一次连接尝试。如果ConnectRetrySecs参数的值等于ConnectTimeoutSecs参数的值，那么只会进行一次连接尝试。

StatPath boolean

如果该参数设置为真，那么Apache-Weblogic Server插件会在把请求传递到WebLogic服务器之前检查翻译路径是否存在及其可读权限。

缺省值为false。如果文件不存在，那么把HTTP 404/Not found回复返

回到客户端。如果存在该文件，但是它的读权限不是设置为world-readable，那么将返回HTTP 403/Forbidden回复。在这两种情况下，Apache服务器处理这些回复的缺省机制是完成回复中提的内容。如果WebLogic Server servlet引擎以及Apache Server具有相同的文档根的话，将使用这个选项。

ErrorPage URL

你也可以创建自己的错误页面，当Apache服务器无法将请求递交给WebLogic服务器时，将显示这个页面。把URL设置为错误页面所在的位置。

使用SSL协议

使用安全套接层（SSL）协议可以保护WebLogic服务器代理插件以及Apache服务器之间的连接，保护在WebLogic服务器代理插件与Apache服务器之间所传输的数据的机密性与完整性。此外，使用SSL协议还可以让WebLogic服务器代理插件向Apache服务器进行自我身份验证，从而保证信息被传递到一个truested principal。

WebLogic服务器代理插件不会用传输协议（http或https）来确定代理插件与Apache插件之间的连接是否使用了SSL协议保护。要使用SSL协议，必须把使用代理插件的WebLogic服务器配置为使用SSL协议。WebLogic服务器插件代理使用WebLogic服务器监听SSL通信的端口与Apache服务器通信。

在WebLogic服务器代理插件使用SSL协议，必须在httpd.conf文件中指定以下参数：

SecureProxy ON/OFF

如果WebLogic服务器代理插件与Apache之间的通信采用SSL协议，那么这个参数应该设置为ON，该参数缺省为OFF。在定义这个参数之前，不要忘了先定义WebLogic服务器监听SSL请求的端口。

该参数可以在两个层次上定义：在主服务器配置或在虚拟主机配置中定义。如果没有在虚拟主机的配置中指定这个参数，那么它将从主服务器的配置中继承SSL配置。

TrustedCAFile= filename

数字证书所在的文件，该数字证书由可靠的证书管理机构发放并被WebLogic服务器插件使用。如果SecurityProxy参数设置为ON，那么必须设置这个参数。该参数没有缺省值。

文件名必须是数字证书文件的全路径文件名。

RequireSSLHostMatch TRUE/FALSE

该参数决定WebLogic服务器代理插件连接的主机名是否必须与连接代理插件的WebLogic服务器所使用的数字证书中的Subject Distinguished Name字段匹配。参数缺省为TRUE。

SSLHostMatchOID Integer

This parameter is the ASN.1 Object ID (OID) that identifies which field in theSubject Distinguished Name of the peer digital certificate is to be used toperform the host match comparison.缺省为22，对应于Subject Distinguished Name中的CommonName字段。Common OID有以下值：Sur Name—23，Common Name—22，Email—13，Organizational Unit—30，Organization—29，and Locality—26。

与SSL-Apache配置有关的问题

在Apache插件中使用SSL时，应该注意以下两个问题：

ü       标签中必须使用PathTrim。以下的配置是不正确的：

SetHandler weblogic-handler

WebLogicHost localhost

WebLogicPort 7001

PathTrim /weblogic

以下才是正确的配置

SetHandler weblogic-handler

PathTrim /weblogic

ü       指令对apache SSL不起作用。避免在apache SSL中使用以下设置：

MatchExpression *.jsp

Include weblogic.conf

Httpd.conf文件示例

下面是一个httpd.conf文件的例子。你可以把它作为模板，然后在此基础上对该文件进行修改以与你的环境与服务器相适应。以#开始的行是注释行。请注意apache不区分大小写，apxs工具会自动添加LoadModule与AddModule行。

####################################################

APACHE-HOME/conf/httpd.conf file

####################################################

 

 

LoadModule weblogic_module libexec/mod_wl.so

SetHandler weblogic-handler

PathTrim /weblogic

ErrorPage http://myerrorpage1.mydomain.com

 

SetHandler weblogic-handler

PathTrim /something

ErrorPage http://myerrorpage1.mydomain.com

 

MatchExpression *.jsp

WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001

ErrorPage http://myerrorpage.mydomain.com

 

# The following line is not always added:

 

AddModule mod_weblogic.c

配置文件示例

当然，也可以不在httpd.conf文件中的location块中定义Weblogic参数，而是在weblogic.conf文件中定义Weblogic参数，该文件由httpd.conf文件的IfModule装载。你可以将以下的示例作为模板，然后针对你所使用的环境与服务器做适当的修改。以 ‘#’开始的行是注释。

使用WebLogic集群的例子

# These parameters are common for all URLs which are

# directed to the current module. If you want to override

# these parameters for each URL, you can set them again in

# the or blocks. (Except WebLogicHost,

# WebLogicPort, WebLogicCluster, and CookieName.)

 

WebLogicCluster w1s1.com:7001,w1s2.com:7001,w1s3.com:7001

ErrorPage http://myerrorpage.mydomain.com

MatchExpression *.jsp

####################################################

不使用WebLogic集群的例子

# These parameters are common for all URLs which are

# directed to the current module. If you want to override

# these parameters for each URL, you can set them again in

# the or blocks (Except WebLogicHost,

# WebLogicPort, WebLogicCluster, and CookieName.)

 

WebLogicHost myweblogic.server.com

WebLogicPort 7001

MatchExpression *.jsp

配置虚拟主机的例子

NameVirtualHost 172.17.8.1

WebLogicCluster tehama1:4736,tehama2:4736,tehama:4736

PathTrim /x1

ConnectTimeoutSecs 30

WeblogicCluster green1:4736,green2:4736,green3:4736

PathTrim /y1

ConnectTimeoutSecs 20

分发Apache-WebLogic Server插件

在你安装并配置了Apache-WebLogic Server插件后，按照以步骤进行分发与测试：

1．启动WebLogic服务器

2．如果Apache服务器已经运行，为了使新配置生效，必须重启Apache服务器

3．测试Apache插件：打开浏览器，并将URL设置为Apache服务器+ “/weblogic”，这将使用缺省的WebLogic HTTP servlet，如这个例子：

http://myenterprise.server.com/weblogic/

11 配置Microsoft-IIS插件

本章将介绍如何在Microsoft Internet Information Server中安装与配置WebLogic Server插件。通过插件，可以把WebLogic服务器的HTTP功能平滑地集成到Microsoft IIS中。通过WebLogic-to-IIS插件，客户端可以透明地访问WebLogic中的资源，从而增强了IIS的功能。

主要介绍以下内容：

ü       概述

ü       安装库

ü       更新IIS设置使代理可以代理到WebLogic

ü       创建iisproxy.ini文件

ü       使用SSL协议

ü       将servlets从IIS代理到WebLogic Server

ü       安装测试

概述

如果要让IIS处理静态页面而把动态页面如HTTP Servlets与JSP交给WebLogic服务器处理，那么就需要用到IIS插件。WebLogic服务器可能运行在另一个进程，也可能是在另一主机上。但对于终端即浏览器用户而言，转交给WebLogic处理的HTTP请求与由IIS处理的请求都来自相同的服务器。运行在后端的WebLogic服务器是不可见的。WebLogic客户-服务器协议的HTTP隧道功能可以在插件中使用，因而也就提供了对所有WebLogic服务的访问，而不仅仅是HTTP servlets

连接池以及保持活动状态

通过把插件和WebLogic服务器的连接放在一个可重用的连接池中，可以使得WebLogic Server ISAPI插件具有极高的性能。ISAPI插件会自动保持插件与WebLogic服务器连接的活动状态。如果一个连接处于非活动状态的时间超过30秒，那么该连接将自动关闭。

有关兼容WebLogicISAPI插件的平台的最新信息，请见以下网站中的“平台支持”页面：

http://www.weblogic.com/platforms/index.html

安装库

在NT上，WebLogic ISAPI是作为一个动态链接库“iisproxy.dll”来分发的。该文件位于weblogic/bin目录下。

要安装ISAPI插件：

1．启动WebLogic服务器

2．启动IIS

3.按照下面的说明修改IIS设置

4．创建初始化文件

5．测试安装

更新IIS设置使请求转给WebLogic

要使用IIS能与webLogic服务器ISAPI一同工作，你需要做以下配置：

1． 将iisproxy.dll文件复制到一个可以被IIS所使用的目录中，而且该目录中应该包含iisporix.ini文件

2． 选择Microsoft IIS启动菜单，启动IIS服务管理器

3． 在服务管理器的左窗格中，选择你的web站点（缺省为“缺省Web站点”）。

4． 选工具栏中的“Play”(编者注:中文版应该为”启动项目”)箭头来启动站点

5． 在左窗格中，用鼠标右键点选你所选择的web站点，打开这个站点的属性设置。在Properties(属性)窗格中，选择Home Directory(编者注:中文版为”主目录”)标签，在Applications Setting(编者注:中文版为”应用程序设置”)部分点Configuration(编者注:中文版为”配置”)按钮。

6． 在App Mapping(应用程序映射)标签页中，点Add按钮选择要转交给WebLogic服务器处理的文件类型。

在对话框中，找到“iisproxy.dll”文件，缺省情况下，该文件位于WebLogic服务器产品的weblogic/bin目录下

7． 设置要委托给WebLogic服务器处理的文件类型的扩展名。

a. 不选”Script engine”(编者注:中文版为”脚本引擎”)复选框。

b. 不选“Check that file exists”(编者注:中文版为”检查文件是否存在”)复选框

c. 设定”Method exclusions”符合安装的安全惯例.

e. 完成上述步骤后，点OK按扭保存所做的设置，然后对每一种要交给WebLogic处理的文件类型都重复上述步骤。

注意与NSAPI插件不同的是，NSAPI可以基于目录结构提供文件服务，而ISAPI插件可以基于文件类型（文件扩展名）或者路径来提供文件服务。通常的配置是使IIS通过JSP扩展名来提供JSP页面服务。详细内容，你可以参见10-8页的“通过路径代理页面请求”

在配置完所有要代理的文件类型后，点OK按钮关闭Properties窗格

创建iisProxy.ini文件

必须为iisproxy.dll创建一个.ini文件。WebLogic服务器会按照以下顺序来寻找iisproxy.ini文件。

1． iisproxy.dll所在的目录

2. 被Windows注册表所引用的WebLogic服务器最新版本所在的目录。如果WebLogic服务器在这个目录下没有找到iisproxy.ini文件，那么它会在Windows注册表中所引用老WebLogic服务器版本所在的安装目录下查找iisproxy.ini文件。

3． C:/weblogic

我们建议你把该初始化文件放在与iisproxy.dll相同的目录中。

初始化文件包含了以下变量的设置，其形式为:名字=值

WebLogicHost=域名或者虚拟主机名

HTTP请求被转交到的WebLogic主机（或者是运行在WebLogic服务器中的Web服务器中所定义的虚拟主机名）。例如：WebLogicHost=localhost。

WebLogicPort=端口号

WebLogic主机监听WebLogic连接请求的端口。例如：WebLogicPort=7001。

WebLogiCluster=集群列表

一个集群中的所有WebLogic服务器列表。该列表是一组由逗号分隔开的host:port条目。例如：myweblogic.com:7001,yourweblogic.com:7001。

插件可以在集群的所有成员之间通过轮询算法实现简单的负载平衡。该列表是服务器以及插件维护动态集群列表的起始点。WebLogic服务器同插件一起根据新加入的、失败的与恢复了的集群成员来自动地更新集群列表。

此外，插件会把包含cookie的HTTP请求引导到最初创建该cookie的集群成员。

ConnectTimeoutSecs=秒数

插件对WebLogic服务器主机进行连接尝试的最大时间间隔。缺省为10秒。该属性值应该大于ConnectRetrySecs属性值。如果超过了ConnecTimeoutSecs属性所指定的时间，即使进行了适当次数连接尝试，还未能成功（见ConnectRetrySecs），那么将返回HTTP 503/Service Unavaiable给客户端。例如，ConnectTimeSecs=20。

ConnectRetrySecs=秒数

在两次连接尝试之间的时间间隔。缺省为2秒，该参数值应该不大于ConnectTimeoutSecs参数值。在将HTTO 503/Service UnavailableSecs返回给客户端之前，插件会做ConnectTimeoutSecs/ConnectRetrySecs次连接尝试。如果不想让插件重试，那么把ConnectRetrySecs设为与ConnectTimeoutSecs相等。例如，ConnectRetrySecs=5。

ErrorPage=url

你可以创建一个错误页面，当IIS不能把请求转交给WebLogic服务器时，它就用这个页面来响应请求。将url设为错误页面所在的位置。

CookieName=cname

如果你在WebLogic服务器中改变了会话cookie的名字，相应地要在iisproxy.ini文件中加上这个属性。WebLogic会话cookie在特定于WebLogic的分发描述符文件，weblogic.xml的元素中用CookieName属性定义（参见http://e-docs.bea.com/wls/docs60/programming/weblogic_xml.html#session-descriptor）

Debug ON/OFF/HFC/HTW/HFW/HTC/ALL

该属性设置了进行调试时的日志记录类型，不建议在生产系统中使用这些调试选项。

调试信息保存在c:/temp/wlproxy.log文件中

该参数的设置有以下选项（HFC, HTW, HFW以及HTC选项可以联合使用，选项之间用逗号隔开，例如“HFC, HTW”）：

ON

       只记录报告性消息与错误消息

OFF

       不记录调试信息

HFC

       记录来自客户端消息、报告性消息以及错误消息的消息头。

HTW

       记录发送到WebLogic服务器消息的消息头，报告性消息以及错误消息

HFW

       记录来自WebLogic服务器消息的消息头，报告性消息与错误消息

HTC

       记录发送到客户端消息的消息头，报告性消息与错误消息

ALL

       记录发送到客户端以及客户端发送的消息的头，发送到WebLogic服务器以及WebLogic服务器发送的消息的消息头，报告性消息，错误消息。

缺省值为“OFF”

DebugConfigInfo=ON/OFF

该参数的设置决定是否启用特殊查询参数“__WebLogicBridgeConfig”。用这个查询参数获得插件的配置参数。

例如，如果把DebugConfigInfo设置为ON，那么“__WebLogicBridgeConfig”查询参数被起用。发送一个如下的请求：

http://www.mywebserver.com:8000/weblogic/foo.jsp?__WebLogicBridgeConfig

插件会把配置信息返回到浏览器。注意这种情况下，不能连接到WebLogic服务器。

该参数只用在调试过程中，消息的输出格式随版本的变化而不同。处于安全性的考虑，建议你在生产系统中把该参数设置为OFF

DefaultFileName=filename

如果URI是“/”，那么缺省的文件名被附加在URL后面，这样可以防止WebLogic服务器的重定向。DefaultFileName应该设置为WebLogic服务器的缺省欢迎也面。如果DefaultFileName设置为welcom.html，那么下面的这个HTTP请求：“http://somehost/weblogi c ”变为:

http://somehost/weblogic/welcome.html” 。只有当所有被重定向到的Web应用指定相同的欢迎页面，该参数才起作用。例如，把欢迎页面都设置为welcome.html

HungServerRecoverSecs =seconds

该参数定义了插件等待WebLogic服务器响应的时间。如果过了HungServerRecoverSecs时间，WebLogic服务器没有响应请求，插件就认为该服务器死了,并失败转移(fail over)到另一台服务器。该参数的最小设置为10，最大设置为600，缺省为300。

Idempotent =ON/OFF

这是一个URL级别的标志。缺省值为”ON”，这意味着如果服务器没有在HungServerRecoverSecs时间内响应，那么插件会进行失败转移。如果设置为”OFF”，插件不会进行失败转移。根据不同的URL或Mime类性，该参数可以有不同的设置。该参数应该设为一个比较大的值。如果是设置的值小于servlet的处理时间，就会得到意想不到的结果。

PathPrepend=string

在PathTrim被裁减(trim)之后，请求转交给WebLogic之前，加在原始URL之前的字符串。该参数的缺省值为””。

WlForwardPath=string

如果wlForwardPath设置为空，那么iis把所有请求交给iis.proxy处理。如果只转交某一特定字符串开头的请求，那么应该设置wlForwardPath参数。例如，把wlForwardPath设置为/weblogic，那么所有以/weblogic开头的请求都被转交给WebLogic服务器。该参数的缺省值为””。如果使用路径方式的请求代理，那么必须设置该参数。

MaxPostSize

如果内容的长度超过MaxPostSize，插件会返回一个错误消息。如果设置为-1，不会检查那么Post数据的长度。设置该参数可以防止通过发送大量数据使服务器超载的拒绝服务攻击。该参数的缺省值为-1。

文件扩展名方式的请求代理

ISAPI模块能够把那些在Internet Service Manager注册的代理文件类型的文件转交给WebLogic服务器处理。例如，你注册了”.jsp”类型代理，那么所有扩展名为”.jsp”的请求都将转交给WebLogic处理。

位于URL的服务器与端口部分后面的路径信息会直接传递给WebLogic。例如从IIS请求以下URL：“http://myiis.com:80/jspfiles/myfile.jsp” ，转交给WebLogic的URL变为：

http://WebLogic:7001/jspfiles/myfile.jsp

路径方式的请求代理

如果以路径的方式代理请求：

1．把iisforward.dll放在iisproxy.dll所在的目录中，并且在IIS中加入iisfoward.dll作为过滤器服务(WebSite “Properties” -"ISAPI Filters" tab -> “Add” the iisforward.dll）。

2．把.wlforward注册为由iisproxy.dll处理的一种特殊文件类型。

3．在iisproxy.ini文件中添加“wlForwardPath”属性。例如：WlForwardPath=/weblogic。

4．如果需要，在iisproxy.ini文件加入PathTrim参数。例如使用WlForwardPath=/weblogic, PathTrim=/weblogic对要转发到WebLogic服务器的请求URL进行裁减，因此/weblogic/session转变为/session。

5．如果用户希望直接用http://someroot.com/ 把请求转交给WebLogic服务器处理，那么还应该在iisproxy.ini文件中设置DefaultFileName参数。

6．如果要改变参数设置，特别是DefaultFileName, Debug, PathTrim, PathPrepend以及WlForwardPath参数，那么应该启动“IIS管理服务”（在控制窗格的services下）。

7．如果在iisproxy.ini文件中Debug参数设置为ON，那么会生成一个用于调试的”c:/tmp/iisfoward.log”文件。

.ini文件示例

这是一个不使用WebLogic集群情况下的iisproxy.ini文件示例。注释行以‘#’号开始。

# This file contains initialization name/value pairs

# for the IIS/WebLogic plug-in.

WebLogicHost=localhost

WebLogicPort=7001

ConnectTimeoutSecs=20

ConnectRetrySecs=2

下面是使用了weblogic集群情况下的iisproxy.ini文件示例。注释行以‘#’号开始。

# This file contains initialization name/value pairs

# for the IIS/WebLogic plug-in.

WebLogicCluster=myweblogic.com:7001,yourweblogic.com:7001

ConnectTimeoutSecs=20

ConnectRetrySecs=2

使用SSL

使用安全套接层（SSL）协议可以保护WebLogic服务器代理插件以及IIS服务器之间的连接，保护在WebLogic服务器代理插件与IIS服务器之间所传输的数据的机密性与完整性。此外，使用SSL协议还可以让WebLogic服务器代理插件向IIS服务器进行自我身份验证，从而保证信息被传递给可靠委托人(truested principal)。

WebLogic服务器代理插件不会用传输协议（http或https）来确定代理插件与IIS插件之间的连接是否使用了SSL协议保护。要使用SSL协议，必须把使用代理插件的WebLogic服务器配置为使用SSL协议。WebLogic服务器插件代理使用WebLogic服务器监听SSL通信的端口与IIS服务器通信。

在WebLogic服务器代理插件使用SSL协议，必须在iisproxy.ini文件中指定以下参数：

SecureProxy ON/OFF

如果WebLogic服务器代理插件与IIS之间的通信采用SSL协议，那么这个参数应该设置为ON，该参数缺省为OFF。在定义这个参数之前，不要忘了先定义WebLogic服务器监听SSL请求的端口。

该参数可以在两个层次上定义：在主服务器配置或在虚拟主机配置中定义。如果没有在虚拟主机的配置中指定这个参数，那么它将从主服务器的配置中继承SSL配置。

TrustedCAFile= filename

数字证书所在的文件，该数字证书由可靠的证书管理机构发放并被WebLogic服务器插件使用。如果SecurityProxy参数设置为ON，那么必须设置这个参数。该参数没有缺省值。

文件名必须是数字证书文件的全路径文件名。

RequireSSLHostMatch TRUE/FALSE

该参数决定WebLogic服务器代理插件连接的主机名是否必须与连接代理插件的WebLogic服务器所使用的数字证书中的Subject Distinguished Name字段匹配。参数缺省为TRUE。

SSLHostMatchOID Integer

This parameter is the ASN.1 Object ID (OID) that identifies which field in theSubject Distinguished Name of the peer digital certificate is to be used toperform the host match comparison.缺省为22，对应于Subject Distinguished Name中的CommonName字段。Common OID有以下值：Sur Name—23，Common Name—22，Email—13，Organizational Unit—30，Organization—29，and Locality—26。

将servlets请求转交给WebLogic服务器处理

如果把iisforward.dll注册成一个过滤器，就可以使用路径方式代理Servlets请求。你可以用类似以下格式的URL调用servlet

http://weblogic:7001/weblogic/snoop

如果没有注册iisforward.dll，那么必须以扩展名方式代理servlets请求。以下是使用扩展方式将servlet请求转交给WebLogic服务器处理的三个步骤：

1．在IIS注册一种文件类型（扩展名）。详细内容，可以参见“更新IIS设置使请求转给WebLogic”。

2．在Web应用中注册servlet。有关注册servlets的详细内容，可以参见“配置Servlets”中的内容。

3．用以下模式的URL访问servlet

http://www.myserver.com/ virtualName/anyfile. ext

virturalName是在Web应用分发描述符的元素中为servlet定义的URL模式。Ext是在IIS中注册的文件类型（文件扩展名），这种文件类型由WebLogic服务器处理。URL的anyfile部分被忽略。

注意：

ü       servlet调用的所有图形连接也必须在IIS中注册相应类型(例如:.gif和.jpg)以能够代理。

ü       如果被调用的servlet调用了其它servlets，那么这些链接也必须使用上面所提到的URL模式。

安装测试

在安装并配置了ISAPI插件后，按以下步骤分发并测试ISAPI插件：

1．运行WebLogic与IIS

2．在Web应用的文档根下保存一个用来测试ISAPI插件的JSP文件。打开浏览器，URL设置为IIS+filename.jsp。例如：

http://myii.server.com/ filename.jsp

12 配置Netscape插件

本章将介绍如何配置Netscape Enterprise Server(NES)代理插件。通过插件，可以把WebLogic的HTTP功能平滑地集成到NES中，客户端可以透明地访问webLogic中的资源，从而增强了NES的功能。

主要介绍以下内容：

ü       概述

ü       配置插件

ü       使用SSL

ü       使用NASAPI时，有关WebLogic服务器集群失败转移的注意事项

ü       obj.con文件示例（不使用WebLogic集群）

ü       obj.con文件示例（使用WebLogic集群）

概述

插件用于这样的环境之中：NES提供静态网页服务，而WebLogic服务器（运行在另一个进程之中，也可能是另一主机之中）则负责提供对动态页面的服务（例如JSP以及HTTP Servlet生成的页面）。WebLogic服务器与NSAPI插件之间的通信可以是明文的也可以使用SSL。对于终端用户即浏览器而言，提交给WebLogic服务器的HTTP请求与静态网页来自相同的源。也就是说，后端的WebLogic是不可见的。而且WebLogic客户-服务器协议的HTTP-隧道功能可以作为插件运行，因此，通过它可以访问所有WebLogic服务（而不仅仅是动态网页）。

WebLogic插件在Enterprise服务器中被当作一个NSAPI模块运行。NES在启动时会装载NSAPI模块，然后某些类型的HTTP请求就交由该模块处理。NSAPI类似于HTTP(Java) servlet。只是NSAPI模块是与平台有关的。

连接池和保持激活

通过使用插件到WebLogic服务器的可重用连接池，WebLogic Server NSAPI插件提供了高效率的性能。NSAPI插件自动实现了在插件和WebLogic 服务器之间“保持激活”的连接。如果连接超过30秒不活动，连接将被关闭。

插件的配置

配置NSAPI插件有以下四个步骤：

1．把相关的NSAPI库文件复制到NES的安装目录中。

2．修改obj.conf文件

3．更改NES配置目录中的mimes.types文件

4．分发并测试NSAPI插件

步骤1：复制库

在UNIX平台上WebLogic NSAPI插件模块作为共享对象（.so文件）分发，在Windows平台上作为动态连接库分发。这些文件分别位于WebLogic分发的/lib于/bin目录中。从平台支持表( http://e-docs.bea.com/wls/docs60/../platforms/index.html#plugi n)中选择适合于您的环境的库文件。然后将所选择的库文件复制到NES所在的文件系统中。

步骤2：设置obj.conf文件

为了使用NSAPI插件，需要修改NES的obj.conf文件。包括以下改动：

ü       指示NES将本地库装载为NSAPI模块的代码

ü       应该交由NSAPI插件处理的请求类型的对象定义

ü       允许通过NSAPI插件使用WebLogic协议的HTTP-协议隧道功能的可选代码。

以下是配置obj.conf文件的步骤

a． 找到并打开obj.conf文件

用于NES实例的obj.conf文件位于以下位置：

NETSCAPE_HOME/https-INSTANCE_NAME/config/obj.conf

其中，NETSCAPE_HOME是安装NES的根目录，INSTANCE_HOME是正在使用的特定实例或服务器配置。例如，在一台叫作goldengate的UNIX机器中，你可以在以下位置找到obj.conf文件。

/usr/local/netscape/enterprise-351/https-goldengate/config/obj.conf

b． 指示NES将本地库装载为一个NSAPI模块

在obj.conf文件的开头加入以下代码行。这些行指示NES应该把本地库（共享对象或dll）装载为一个NSAPI模块。

Init fn="load-modules" funcs="wl-proxy,wl-init"/

shlib=/usr/local/netscape/plugins/ SHARED_LIBRARY

Init fn="wl-init"

这里的SHARD_LIBRARY是你在第一步中所安装的共享对象或dll（例如libproxy.so）。功能“load-modules”表明在NES启动时要装载的共享库。值“wl-proxy”与“wl-init”标识了NSAPI插件将执行的功能。

c． 声明交由NSAPI插件处理的请求

所有经过NSAPI插件传递给WebLogic服务器的请求都必须在位于obj.conf文件中的对象定义中声明。有两种方式识别这些请求：通过MIME文件扩展，或者通过请求的URL中的特定字符串（被称为ppath）

无论是使用MIME方式还是ppath方式来代理请求，你都应该在