企业应用程序设置

使用此页面来配置企业应用程序。

要查看此管理控制台页面,单击应用程序 > 企业应用程序 > application_name

相关概念
crun_classload.html
crun_entapp.html
crun_app_moduleversion.html

相关任务
trun_appl.html

相关参考
udat_nestjcaconfac.html
uejb_rimod.html
ucws_rlibref.html
uprs_rsession_manager.html
urun_rtargetmap.html
ucws_rvars.html
rcfg_objectnames.html

名称

指定应用程序的逻辑名。应用程序名在单元中必须是唯一的,并且不能包含不允许的字符。

应用程序名不能以句点(.)开头,前面和后面都不能包含空格,并且不能包含任何以下字符:

不允许使用的字符
/ 正斜杠 $ 美元符 ' 单引号
\ 反斜杠 = 等号 " 双引号
* 星号 % 百分号 | 竖线
, 逗号 + 加号 < 左尖括号
: 冒号 @ at 符号 > 右尖括号
; 分号 # 散列符号 & 与符号
? 问号 ]]> 此字符组合不存在特定名称
数据类型 字符串

应用程序二进制文件

指定将安装应用程序 EAR 文件的目录。此应用程序二进制文件设置与应用程序安装和更新向导上的用来安装应用程序的目录字段相同。

缺省值为 APP_INSTALL_ROOT/cell_name 的值,其中 APP_INSTALL_ROOT 变量是 install_root/installedApps;例如,C:\WebSphere\AppServer\profiles\profile_name\installedApps\cell_name

您可以指定绝对路径或使用路径图变量,例如,${MY_APPS}。尽管路径图变量在包含异构节点成员的集群中安装应用程序时特别要用到,但您仍可以使用任何安装中的路径图变量。这是因为在这些情况下,可能有不止一种方法来指定绝对路径。表示当前单元名的 WebSphere Application Server 变量 ${CELL} 也可以在路径图变量中;例如,${MY_APP}/${CELL}

您可以在管理控制台的“WebSphere 变量”页面上定义 WebSphere Application Server 变量,您可以通过单击环境 > WebSphere 变量访问该页面。

数据类型 字符串
单位 完整路径名

使用来自二进制文件的元数据

指定应用程序服务器是使用与应用程序部署文档 deployment.xml 文件放在一起的绑定、扩展和部署描述符(缺省情况)还是使用企业应用程序资源(EAR)文件中的那些内容。

使用二进制文件中的元数据设置与应用程序安装和更新向导上的使用二进制配置字段相同。仅对安装在 6.x 部署目标上的应用程序选择此设置。

数据类型 布尔
缺省值 false

启用分布

指定 WebSphere Application Server 在安装目标中是扩展还是删除应用程序二进制文件。缺省为启用应用程序分布。已安装的应用程序的应用程序二进制文件扩展到指定的目录。当您卸载并将更改保存到配置时,这些二进制文件也被删除了。如果您禁用此选项,则您必须确保在运行应用程序的所有节点的目标目录中适当地扩展应用程序二进制文件。

重要事项:如果您禁用此选项,并且不将应用程序二进制文件复制并展开到节点中,则稍后保存配置或手工同步时不会将这些应用程序二进制文件移至节点中。

启用分发设置与应用程序安装和更新向导上的分布式应用程序字段相同。

数据类型 布尔
缺省值 true

验证

指定 WebSphere Application Server 在应用程序安装或更新期间是否检查应用程序引用,并且如果启用验证,则警告使用错误引用或操作失败的用户。

应用程序通常引用使用容器管理的持久性(CMP)bean 的数据源的资源,或使用在部署描述符中定义的资源引用或资源环境引用的资源。验证检查应用程序引用的资源是否在该应用程序的部署目标作用域中定义。

该资源可以定义于服务器上、它的节点上、单元上或集群中(如果该服务器属于该集群的话)。选择关闭以不验证资源,警告用于有关错误的资源引用的警告消息,或失败以停止由于错误的资源引用而导致的操作失败。

验证设置与应用程序安装和更新向导上的验证输入关闭/警告/失败字段相同。

数据类型 字符串
缺省值 警告

类装入器方式

指定类装入器在装入类时是首先在父类装入器中搜索还是首先在应用程序类装入器中搜索。开发工具包类装入器和 WebSphere Application Server 类装入器的标准为父代最先。通过指定父代最后,您的应用程序可以覆盖包含在父类装入器中的类,但如果您混合使用了被覆盖的类和没有被覆盖的类,则此操作有可能会导致 ClassCastException 或 LinkageErrors。

选项是父代最先父代最后。缺省是在应用程序类装入器装入一个类中搜索之前,在父类装入器中搜索。

要让应用程序使用 WebSphere Application Server 中 Jakarta Commons Logging 的缺省配置,将此应用程序类装入器方式设置为父代最先。要让应用程序覆盖 WebSphere Application Server 中 Jakarta Commons Logging 的缺省配置,应用程序必须以 Jakarta Commons Logging 支持的格式提供配置,并且必须将此类装入器方式设置为父代最后。另外,要覆盖缺省配置,应设置应用程序中每个 Web 模块的类装入器方式,以便装入正确的记录器工厂。

数据类型 字符串
缺省值 父代最先

WAR 类装入器策略

指定是使用单个类装入器装入此应用程序的所有 WAR 文件,还是为每个 EAR 文件使用不同的类装入器。

选项是应用程序模块。缺省值是使用独立的类装入器装入每个 WAR 文件。

数据类型 字符串
缺省值 Module

启用类重新装入

指定在更新应用程序文件时,是否启用类重新装入。

对于 EJB 模块或任何非 Web 模块,选择启用类重新装入将把应用程序的 deployment.xml 文件中的 reloadEnabled 设置为 true。如果应用程序的类定义更改了,则应用程序服务器运行时停止,并启动应用程序重新装入应用程序类。

对于 Web 模块(如 Servlet 和 JavaServer page(JSP)文件),仅当 ibm-web-ext.xmi 文件中的 IBM 扩展 reloadingEnabled 设置为 true 时,Web 容器才重新装入 Web 模块。 您可以在使用组装工具编辑 Web 模块的扩展部署描述符时将 reloadingEnabled 设置为 true

要启用重新装入 Web 模块,在这种情况下您还要启用重新装入 EJB 和非 Web 模块:

  1. ibm-web-ext.xmi 文件中的 IBM 扩展 reloadingEnabled 设置为 true
  2. 选择此启用类重新装入属性。
  3. 重新装入时间间隔属性设置为大于 0 的值(例如,1 到 2147483647)。

要仅启用重新装入 Web 模块,而不启用重新装入 EJB 或非 Web 模块:

  1. ibm-web-ext.xmi 文件中的 IBM 扩展 reloadingEnabled 设置为 true
  2. ibm-web-ext.xmi 文件中的 IBM 扩展重新装入时间间隔属性设置为大于 0 的值(例如,1 到 2147483647)。
  3. 不要选择此启用类重新装入属性。

要禁用 Web 模块的重新装入,将 ibm-web-ext.xmi 文件中的 IBM 扩展 reloadingEnabled 设置为 false。或者,如果 Web 模块将 ibm-web-ext.xmi 文件中的 IBM 扩展 reloadingEnabled 设置为 true,要使用管理控制台禁用重新装入:

  1. 选择此启用类重新装入属性。
  2. 重新装入时间间隔属性设置为零(0)。
数据类型 布尔
缺省值 false

重新装入时间间隔

指定扫描应用程序的文件系统以查找已更新文件的秒数。缺省为 EAR 文件的 IBM 扩展(META-INF/ibm-application-ext.xmi)文件中重新装入时间间隔属性的值。

重新装入时间间隔设置与应用程序安装和更新向导上的重新装入时间间隔(以秒计)字段相同。

要启用重新装入,指定大于零的值(例如,1 到 2147483647)。要禁用重新装入,指定零(0)。

此处指定的重新装入时间间隔覆盖 EAR 文件中每个非 Web 模块的 IBM 扩展中指定的值(其又覆盖 EAR文件中应用程序的 IBM 扩展中指定的重新装入时间间隔)。仅当启用类重新装入时,重新装入时间间隔属性才生效。

范围为从 0 到 2147483647。

数据类型 整型
单位
缺省值 3

启动权重

指定服务器启动时应用程序启动的顺序。 具有最低启动权重的应用程序首先启动。

数据类型 整型
缺省值 1
范围 0 到 2147483647

后台应用程序

指定应用程序是否必须在服务器启动之前完全初始化。

缺省设置 false 表示服务器启动在应用程序启动之前不会完成。

设置为 true 将通知 WebSphere Application Server 应用程序可在后台线程上启动,并且因此服务器启动可继续,而无需等待应用程序启动。因此,在应用程序服务器启动时,应用程序可能还不能使用。

仅当应用程序在 V6 应用程序服务器上运行时,才应用此设置。

数据类型 布尔
缺省值 false

为资源创建 MBean

指定当应用程序启动时,是否在应用程序内创建各种资源(如 servlet 或 JSP 文件)的 MBean 文件。缺省值为创建 MBean 文件。

数据类型 布尔
缺省值 true

“服务策略”选项卡

在服务策略上可查看下列属性:

HTTP 工作类 展开以查看或管理 HTTP 请求的工作类。
SOAP 工作类 展开以查看或管理 SOAP 请求的工作类。
在此选项卡中,您可以执行下列操作:
  • 单击查看服务策略拓扑以查看树形层次结构中的服务策略和工作类。
  • 通过下列操作来管理工作类:为给定的请求类型选择工作类并单击新建删除,或者展开现有工作类并单击编辑 HTTP 模式以将 URI 添加至工作类成员列表或者从该列表中除去 URI。
  • 管理规则条件:
    • 要构建新的规则,单击添加规则。添加规则之后,可以在“规则详细信息”面板中编辑它。
    • 要除去现有规则,单击删除规则
    • 要使用现有规则,在 If 字段中输入它,并将它归类到适当的事务类。
    • 在一个工作类具有多项规则的情况下,要将这些规则按优先顺序排列,单击上移下移。在确定匹配项时,规则的顺序是很重要的。如果在处理第一项规则时就找到了匹配项,则不会继续处理后续规则。
    • 对于没有任何规则的工作类,将 URI 指定给列表中的事务类。
  • 单击应用确定以落实新的规则设置。

“路由策略”选项卡

在路由策略上可查看下列属性:

HTTP 工作类 展开以查看或管理 HTTP 请求的工作类。
SOAP 工作类 展开以查看或管理 SOAP 请求的工作类。
在此选项卡中,您可以执行下列操作:
  • 单击查看路由策略拓扑以查看树形层次结构中的路由策略和工作类。
  • 通过下列操作来管理工作类:为给定的请求类型选择工作类并单击新建删除,或者展开现有工作类并单击编辑 HTTP 模式以将 URI 添加至工作类成员列表或者从该列表中除去 URI。
  • 管理规则条件:
    • 要构建新的规则,单击添加规则。添加规则之后,可以在“规则详细信息”面板中编辑它。
    • 要除去现有规则,单击删除规则
    • 在一个工作类具有多项规则的情况下,要将这些规则按优先顺序排列,单击上移下移。在确定匹配项时,规则的顺序是很重要的。如果在处理第一项规则时就找到了匹配项,则不会继续处理后续规则。
    • 在编辑每项新规则之后,对该规则单击应用
    • 对于没有任何规则的工作类,将类指定给下列其中一个事务类:
      • 允许路由至:在此处选择版本名称列表中选择版本名称。
      • 拒绝路由,以及产生的返回码:在此处选择版本名称列表中选择版本名称,并在“输入返回码”字段中输入返回码。
      • 将路由重定向至:从在此处选择版本名称列表中选择版本名称,并在“输入要重定向至的 URI”字段中输入 URI。
      • 允许,将客户机亲缘关系路由至:在此处选择版本名称列表中选择版本名称。
  • 单击应用确定以落实新的规则设置。