Java 虚拟机定制属性

可以使用管理控制台来更改 Java™ 虚拟机 (JVM) 定制属性的值。

注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.logSystemErr.logtrace.logactivity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件 bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用 HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。

要设置定制属性,请连接到管理控制台并转到适当的 Java 虚拟机定制属性页面。

应用程序服务器 Deployment Manager Node Agent

[z/OS]单击服务器 > 服务器类型,然后单击 WebSphere 应用程序服务器 > server_nameWebSphere 代理服务器 > server_name。接着,在“服务器基础结构”部分中,单击 Java 和进程管理 > 进程定义,然后选择控制服务方附件。然后单击 Java 虚拟机 > 定制属性

[AIX Solaris HP-UX Linux Windows][IBM i]单击服务器 > 服务器类型,或者单击 WebSphere 应用程序服务器 > server_nameWebSphere 代理服务器 > server_name。然后,在“服务器基础结构”下,单击 Java 和进程管理 > 进程定义 > Java 虚拟机 > 定制属性

[z/OS]单击系统管理 > Deployment Manager > Java 和进程管理 > 进程定义 > 控制 > Java 虚拟机 > 定制属性

[AIX Solaris HP-UX Linux Windows][IBM i]系统管理 > Deployment Manager > Java 和进程管理 > 进程定义 > Java 虚拟机 > 定制属性

[z/OS] 系统管理 > Node Agent > nodeagent_ name > Java 和进程管理 > 进程定义 > 控制 > Java 虚拟机 > 定制属性

[AIX Solaris HP-UX Linux Windows][IBM i] 系统管理 > Node Agent > nodeagent_name > Java 和进程管理 > 进程定义 > Java 虚拟机 > 定制属性

如果在已定义的定制属性列表中未包含该定制属性,那么创建新属性,在“名称”字段中输入属性名,并在“值”字段中输入有效值。重新启动服务器以完成更改。

可以使用“定制属性”页面来定义下列属性以供 Java 虚拟机使用。

allowDeployerRoleGenPluginCfg

将此定制属性设置为 true,以允许具有部署者角色的用户生成和配置 plugin-cfg.xml 文件。在设置并保存此定制属性之后,请重新启动应用程序服务器。

如果未指定此定制属性或者将它的值设置为 false,那么当用户拥有部署者角色许可权时,将发生下列情况:
  • 生成和配置过程失败。
  • 发出错误消息。

要禁用此功能,请删除此定制属性或者将其值设为 false

并且,您还可以使用 wsadmin 工具和以下 Jacl 脚本从命令行设置此定制属性:
#-------------------------------------------------------------------------
# setAllowDeployer.jacl - Jacl script for setting a the allowDeployerRoleGenPluginCfg
property 
# of the web server plug-in for WebSphere Application Server
#-------------------------------------------------------------------------
#    This Jacl file modifies the server.xml file for an application
server. This script is designed 
#    to be invoked while the AppServer is running.
#
#    Here is an example of how to invoke the script:
#	   wsadmin -f setAllowDeployer.jacl &ltnodeName> &ltserverName> &ltenableValue>

#------------------------------------------------------------------------
proc printUsageAndExit {} {
     puts " "
     puts "Usage: wsadmin -f setAllowDeployer.jacl &ltnodeName> <serverName> <boolEnable>"
     puts "Note: enableValue argument is of type boolean; valid values
are true and false."	
     exit
 }
 if { [llength $argv] >= 3 } {
     set nodename [lindex $argv 0]
     set servername [lindex $argv 1]
     set enablevalue [lindex $argv 2]
 } else {
     printUsageAndExit
 }  

set cellname [$AdminControl getCell]
set propname "allowDeployerRoleGenPluginCfg" 
set propdesc "Allow conditional deployer role for plug-in generation
and propagation" 
set required "false"  

set jvm [$AdminConfig getid 
/Cell:${cellname}/Node:${nodename}/Server:${servername}/JavaProcessDef:/JavaVirtualMachine:/]

$AdminConfig modify $jvm [subst {{systemProperties {{{name {$propname}}
{value {$enablevalue}} 
{description {$propdesc}} {required {$required}}}}}}]  
$AdminConfig save   

exit 0
用法:
wsadmin -f setAllowDeployer.jacl node_name server_name true

com.ibm.cacheLocalHost

将此属性设置为 true,以指示 IBM SDK for Java 在 JVM 的生命期内对从 java/net/InetAddress.getLocalHost 返回的 IP 地址进行高速缓存。这是性能增强功能,如果进程的 localhost 地址在该进程运行时不会更改,建议对所有进程使用此增强功能。

注: 使用 DHCP 配置的服务器地址随时间推移而更改。除非为服务器使用静态分配的 IP 地址,否则请勿设置此属性。

com.ibm.apc.nodeMMTimeout

如果将节点设置为处于维护方式并且 APC 设置为自动,那么缺省情况下,Deployment Manager 将在 20 分钟过后使维护方式操作超时。通过在 Deployment Manager 上设置通用 JVM 自变量 -DnodeMMTimeout,然后重新启动 Deployment Manager,可以更改此设置。例如,可以将 -DnodeMMTimeout 设置为 60,以指定维护方式操作在 60 分钟后发生超时。相关地,apcConcurrentStartSize 可以帮助减少 APC 处理维护方式操作所用的时间,并且有关动态集群的其他注意事项(例如 min != max)可以降低 APC 需要执行更改的可能性。

com.ibm.config.allow.set.session.timeout

设置此定制属性可在 PI20040 应用于 web.xml 元素 session-timeout 时还原其行为。

将此定制属性保留为不设置,以获取 PI20040 提供的更新行为。

缺省行为是获取 PI20040 的更新行为。根据 Servlet 规范,更新的行为是正确的,且是写入 session-timeout. 值时的新缺省行为。提供了定制属性以重新启用先前行为。

com.ibm.config.eclipse.wtp.enablejemtrim

使用此定制属性,以便在对应用程序的元数据执行 XML 解析之后能够修改中间 DOM 节点。

避免故障 避免故障: 此属性的设置应该与 com.ibm.config.eclipse.wtp.enablexmltrim 定制属性的设置匹配。要么这两个属性都不设置,要么都设为 falsetruegotcha

缺省值为 false

com.ibm.config.eclipse.wtp.enablexmltrim

使用此定制属性,以便能够共享 JavaClass 实例以及在使用展开的 JavaClass 和 JavaMethod 对象后将这些对象转换为轻量组级代理。

避免故障 避免故障: 此属性的设置应该与 com.ibm.config.eclipse.wtp.enablejemtrim 定制属性的设置匹配。要么这两个属性都不设置,要么都设为 falsetruegotcha

缺省值为 false

com.ibm.config.eclipse.wtp.jem=finer

使用此定制属性可在 com.ibm.config.eclipse.wtp.enablejemtrim 定制属性设置为 true 时从启用的代码区生成跟踪。

避免故障 避免故障: 此属性可能会影响性能。因此,仅当对应用程序的元数据执行 XML 解析之后修改中间 DOM 节点期间出现问题,并且您需要获取其他信息以找出该问题的原因时,才应该指定此属性。gotcha

com.ibm.config.eclipse.wtp.xmltrim=finer

使用此定制属性可在 com.ibm.config.eclipse.wtp.enablexmltrim 定制属性设置为 true 时从启用的代码区生成跟踪。

避免故障 避免故障: 此属性可能会影响性能。因此,仅当共享 JavaClass 实例或在使用展开的 JavaClass 和 JavaMethod 对象后将这些对象转换为轻量组级代理的过程中出现问题,并且您需要获取其他信息以找出该问题的原因时,才应该指定此属性。gotcha

com.ibm.disableCommonsElCache

如果由于表达式求值程序挂起散列映射而遇到内存不足状况,请将 com.ibm.wsspi.jsp.disableElCache Web 容器定制属性设置为 true 以禁用 commons-el 表达式高速缓存。

缺省值为 false。

[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]

com.ibm.eclipse.wtp.allowRootedEntries

在先前服务发行版中,无法正确读取企业归档 (EAR) 文件的根目录中的属性文件。因此,本服务发行版和更高发行版对行为作了更改,以便将 META-INF 和 MANIFEST.MF 文件中的类路径视为相对 URI。要恢复原始行为,请将 com.ibm.eclipse.wtp.allowRootedEntries 设置为 true

com.ibm.ejs.ras.disablerasnotifications

使用此属性可禁用和启用 RAS 服务。将此属性设置为 true 时,将禁用 RAS 服务。此属性的缺省值为 false。

com.ibm.ejs.ras.writeSystemStreamsDirectlyToFile

使用此定制属性来支持 JSR-47 定制日志记录功能,以在不使用 WebSphere® Application Server 格式的情况下写入 SystemOut 流。WebSphere Application Server 格式包含时间戳记和线程标识等信息。应用程序可能不想在 SystemOut 流中显示此信息(或者也许首选以其他格式显示该信息)。要禁用 WebSphere Application Server 格式,请将此定制属性设置为 true

com.ibm.ejs.sm.server.quiesceInactiveRequestTime

使用此定制属性来指定可以接收和处理通过对象请求代理 (ORB) 发出的 IIOP 请求的速度(以毫秒计)。例如,如果对此属性指定值 5000,那么服务器在入局请求至少间隔 5 秒后才会尝试进行关闭。如果对此属性指定的值太大,那么从管理控制台停止应用程序服务器时,可能会发出以下错误消息:
停止 Server1 时发生错误。请检查错误日志,以了解更多信息。

缺省值是 5000(5 秒)。

如果您决定使用此定制属性,那么可以将其指定为应用程序服务器、Node Agent 或 Deployment Manager 的 JVM 定制属性。通常将其设置为应用程序服务器 JVM 定制属性。

com.ibm.ejs.sm.server.quiesceTimeout

使用此定制属性来指定停顿超时的总长度(以秒计)。如果请求在超出此秒数后仍未完成,那么服务器可能会开始关闭。例如,值 180 表示 3 分钟。如果超过了停顿时间,那么工作负载调整器将拒绝所有入局请求,并且服务器将关闭。
注: 如果在服务器处于停顿状态时存在未完成的事务,那么将发出 WTRN0036W 消息。
缺省值是 180。
注: 如果超时值设置为零,那么将禁用停顿功能。

如果您决定使用此定制属性,那么可以将其指定为应用程序服务器、Node Agent 或 Deployment Manager 的 JVM 定制属性。通常将其设置为应用程序服务器 JVM 定制属性。

com.ibm.ffdc.log

使用此定制属性,指定在进行产品运行时处理期间发生故障时,用于存储首次故障数据捕获 (FFDC) 数据的位置。FFDC 功能部件会立即收集关于可导致该失败的事件及错误的信息。然后,可以使用所捕获的数据来分析问题。收集信息并将该信息保存在日志文件中之后,FFDC 会将控制权返回给受影响的引擎。

以下是用于为日志文件指定文件夹位置的用法示例:
Name: com.ibm.ffdc.log
Value: C:\my_FFDC_CP\
以下是用于为日志文件指定实际文件名的用法示例:
Name: com.ibm.ffdc.log
Value: C:\my_FFDC_CP_log

com.ibm.websphere.application.updateapponcluster.waitforappsave

使用此定制属性可指定您希望 Deployment Manager 在启动更新的应用程序之前等待完成保存操作的扩展任务的时间(以秒计)。

避免故障 避免故障: 仅当对 Deployment Manager 指定此属性时,此属性才有效。gotcha

通常,在使用推广更新过程执行的应用程序更新的保存操作期间,保存操作的扩展任务作为后台操作在单独的线程中运行。如果保存操作的主线程在推广更新过程的同步阶段之前完成,那么更新后的应用程序将无法正常启动。

将此定制属性添加到 Deployment Manager 设置后,如果保存操作的扩展任务未能在指定的时间内完成,那么推广更新过程将停止应用程序更新过程,从而防止应用程序在推广更新过程的同步阶段损坏。

缺省值是 180。

[z/OS]

com.ibm.websphere.bean.delete.sleep.time

使用此属性来指定进行扫描以查找超时 Bean 的间隔时间。输入的值以秒计。例如,值 120 表示 2 分钟。此属性还控制服务方进程中的时间间隔,该进程用于查找仍对企业 Bean 容器可视的超时 Bean。

缺省值是 4200(70 分钟)。最小值为 60(1 分钟)。可以通过管理控制台来更改此值。要应用此属性,必须在“控制”和“服务方 JVM”定制属性中都指定值。

com.ibm.websphere.deletejspclasses

使用此属性可指示在删除或更新应用程序之后,要删除所有这些应用程序的 JavaServer Pages 类。缺省值为 false

避免故障 避免故障: 在 Network Deployment 环境中,此属性适用于 WebSphere Application Server。gotcha

当应用程序服务器在联合单元中运行时,请对 Node Agent 设置此属性。

com.ibm.websphere.deletejspclasses.delete

使用此属性可指示在删除(而不是更新)应用程序之后,要删除所有这些应用程序的 JavaServer Pages 类。缺省值为 false

避免故障 避免故障: 在 Network Deployment 环境中,此属性适用于 WebSphere Application Server。gotcha

当应用程序服务器在联合单元中运行时,请对 Node Agent 设置此属性。

com.ibm.websphere.deletejspclasses.update

使用此属性可指示在更新(而不是删除)应用程序之后,要删除所有这些应用程序的 JavaServer Pages 类。缺省值为 false

避免故障 避免故障: 在 Network Deployment 环境中,此属性适用于 WebSphere Application Server。gotcha

当应用程序服务器在联合单元中运行时,请对 Node Agent 设置此属性。

com.ibm.websphere.ejb.UseEJB61FEPScanPolicy

使用此属性可控制在应用程序安装过程中或服务器启动期间,产品是否扫描 Java EE 5 以前的模块以获取更多元数据。缺省情况下,不扫描这些旧的 EJB 模块。

缺省值为 false

对于每个要求对缺省值进行更改的服务器或管理服务器,必须将此属性设置为 true

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName

当用户的 JNDI 名称包含用户定义的应用程序服务器变量时,EJB 容器应该支持展开 CMP 连接工厂 JNDI 名称。定制属性 com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName 使您有可能展开 CMP 连接工厂 JNDI 名称。

如果值为 true(这是缺省值),那么 EJB 容器在 CMP 连接工厂 JNDI 名称中找到变量时,将展开该变量。如果值设为 false,那么 EJB 容器不展开变量。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.ejbcontainer.includeRootExceptionOnRollback

使用这个 Enterprise JavaBeans (EJB) 定制属性可启用以下功能:
  • 如果事务由本地调用者发出,那么允许将该事务回滚的根本原因包括在 TransactionRolledbackLocalException 中。
  • 允许将造成事务从落实方法进行回滚的根本原因包括在 TransactionRolledbackLocalException 中,即使该事务由远程调用者发出也是如此。
  • 允许返回试探性异常以代替 TransactionRolledbackLocalException(对于本地客户机)或 TransactionRolledbackLocalException(对于远程客户机)。
  • 允许从远程 EJB 方法返回 RemoteException,即使该方法正在该调用所在事务的场景中运行也是如此。例如,假定 EJB1 方法 m1 开始一个事务并调用 EJB2 方法 m2,而 m2 导致未处理的异常。在这种情况下,EJB 规范要求 m1 接收 TransactionRolledbackException。将此属性设置为 true 将允许返回包含任何嵌套异常的 RemoteException,而不是返回 TransactionRolledbackException,尽管此功能与 EJB 规范的要求不符。

要启用此功能,请将此属性设置为 true。要禁用此功能,请将此属性设置为 false

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.jaxrpc.stub.typemapping.per.thread

使用此属性来指示 JAX-RPC 运行时是否应使用特定于线程的类型映射对象。

JAX-RPC 运行时对所有 JAX-RPC 客户机使用单个 TypeMappingRegistry 对象。此设计是有意的,它允许您创建 JAX-RPC 存根并在多个线程上使用该存根。但是,如果并行调用具有不同映射的多个 JAX-RPC Web Service,那么单体 TypeMappingRegistry 会被污染。虽然这种情况不常见,但是如果系统上存在这种情况,那么可以将 com.ibm.websphere.jaxrpc.stub.typemapping.per.thread 定制属性设置为 true,以指示 JAX-RPC 运行时可使用特定于线程的类型映射对象。这些独立映射对象可避免污染问题,各种 Web Service 将成功。

缺省值为 false

避免故障 避免故障: 除非遇到单体 TypeMappingRegistry 被污染的情况,否则不应使用此定制属性。启用此属性可能会使多个线程中依赖于对同一 JAX-RPC 存根进行访问的应用程序回退。gotcha

com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine

使用此属性以禁止 JAX-RS 集成运行时自动处理 JAX-RS 应用程序。缺省值为 false
避免故障 避免故障: 将此属性设置为值 true 还会禁止 IBM JAX-RS 运行时与 EJB 和 JCDI 进行集成。gotcha

com.ibm.websphere.logging.useJULThreadID

使用此属性来控制 WebSphere Application Server 日志文件中使用的线程标识类型。

当您将此属性设置为 true 时,将使用 LogRecord 实例来检索线程标识。当您将此属性设置为 false 时,将使用 Thread 实例来检索线程标识。

缺省值为 false

对于转换用户 对于转换用户: 从 V8.5 开始,此属性的缺省值为 false。在较低版本中,com.ibm.websphere.logging.useJULThreadID 属性的缺省值为 truetrns

com.ibm.websphere.management.application.client.EnvEntry_processBindings

使用此属性来指定应用程序部署期间处理环境条目值的方式。

如果此属性的值为 false,那么将在部署描述符中读取和写入环境条目值。将忽略在 XML 绑定中指定的所有环境条目值。

如果未指定此属性或者此属性的值为 true,那么在 XML 绑定中指定的环境条目值将优先于部署描述符中指定的值。将处理注释中的环境条目。缺省值为 true

如果在启用 com.ibm.websphere.management.application.client.EnvEntry_processBindings 的情况下部署应用程序,然后导出应用程序以部署到 V8.0 以前的环境中,那么部署环境和运行时环境均无法识别 XML 绑定中的环境条目值。

如果在启用 com.ibm.websphere.management.application.client.EnvEntry_processBindings 的情况下部署应用程序,然后导出应用程序以部署到 V8.0 或更高版本的环境中,那么部署环境无法识别 XML 绑定中的环境条目值,但运行时环境可识别该值。

避免故障 避免故障: 如果 com.ibm.websphere.management.application.client.EnvEntry_processBindings 定制属性设置为 true,请勿在 JVM 配置设置中包括 com.ibm.websphere.management.application.client.EnvEntry_processAnnotations 定制属性。gotcha
避免故障 避免故障: 当环境中包含版本低于 8.0 的节点,并且应用程序以版本低于 8.0 的节点为目标时,如果在此应用程序中定义了环境条目,并且将在部署期间(包括安装、编辑或更新)提供或更改此环境条目值,请将此属性的值设置为 false。否则,应用程序部署将失败。gotcha

com.ibm.websphere.management.application.fullupdate

使用此属性来指定,在更新任何应用程序时,都要擦除二进制文件目录并完全抽取已更新的 EAR 文件的内容。

如果未指定此属性,那么将在节点中逐个地对已更新的 EAR 文件中的每个已更改文件进行更新和同步。对于大型应用程序,如果更改了许多文件,那么此过程可能相当耗时。

com.ibm.websphere.management.application.fullupdate 属性设置为:
  • true,指定在更新任何应用程序时,都要擦除二进制文件目录并完全抽取已更新的 EAR 文件的内容。
  • false,指定在更新任何应用程序时,您只想在节点上更新该 EAR 文件中的已更改文件,然后进行同步。
避免故障 避免故障:
  • 如果您只想针对特定应用程序而不是所有应用程序执行完全替换,请使用 com.ibm.websphere.management.application.fullupdateapplication_name 属性。
  • 您必须在 Deployment Manager JVM 中定义此属性。
gotcha

com.ibm.websphere.management.application.fullupdate.application_name

使用此属性来指定,在更新指定的应用程序时,要擦除该应用程序的二进制文件目录并完全抽取已更新的 EAR 文件的内容。

如果未指定此属性,那么将在节点中逐个地对所指定应用程序的已更新 EAR 文件中的每个已更改文件进行更新和同步。对于大型应用程序,如果更改了许多文件,那么此过程可能相当耗时。

com.ibm.websphere.management.application.fullupdate.application_name 属性设置为:
  • true,指定在更新指定的应用程序时,要擦除二进制文件目录并完全抽取已更新的 EAR 文件的内容。
  • false,指定在更新指定的应用程序时,您只想在节点上对已更改的文件进行更新,然后进行同步。
避免故障 避免故障:
  • 如果更新任何应用程序时都要擦除二进制文件目录并完全抽取已更新的 EAR 文件的内容,请使用 com.ibm.websphere.management.application.fullupdate 属性。
  • 您必须在 Deployment Manager JVM 中定义此属性。
gotcha

com.ibm.websphere.management.application.keepExistingSharedLibraries

使用此属性来指定应用程序更新期间处理共享库映射的方式。

此属性设置为 false 时,应用程序更新操作期间指定的共享库应替换原始共享库设置。false 是缺省设置。

当此属性设置为 true 时,在更新应用程序后,应用程序和模块配置除了包括更新操作期间指定的共享库设置之外,还包括原始共享库设置。

com.ibm.websphere.management.application.persistWebContext

使用此属性来指定 Web 模块的上下文根和虚拟主机信息是否保留在 deployment.xml 文件中。如果未指定此属性,那么应用程序部署必须依赖注释处理才能读取上下文根和虚拟主机信息,这将影响应用程序部署的性能。

当此属性设置为 true 时,Web 模块的上下文根和虚拟主机信息将持久保存在 deployment.xml 文件中,持久保存的数据用于验证应用程序部署,这将提高应用程序部署的性能。

缺省值为 false,这意味着 Web 模块的上下文根和虚拟主机信息不会持久保存在 deployment.xml 文件中。

com.ibm.websphere.management.application.sync.recycleappasv5

使用此属性来指定要让应用程序重新启动行为与产品的 V6.x 之前的版本中的此行为相同。

在版本 6.x 和更高版本中,在执行应用程序更新或编辑操作后,根据所修改文件的不同,该应用程序或者它的模块将自动地重新启动。对于所有应用程序配置文件更改以及所有非静态文件更改,都将执行这个重新启动过程。

然而,在产品的 V6.x 之前的版本中,仅当企业归档 (EAR) 文件本身已更新或二进制文件 URL 属性更改时,应用程序才会重新启动。更改应用程序配置文件时,应用程序不会重新启动。

将 com.ibm.websphere.management.application.sync.recycleappasv5 属性设置为:
  • true,以指定要让应用程序重新启动行为与产品的 V6.x 之前的版本中的此行为相同。
  • false,以指定要让应用程序重新启动行为按版本 6.x 和更高版本的行为模式进行。

缺省值为 false

避免故障 避免故障: 必须在 Node Agent JVM 中定义此属性。但是,定义此属性时,如果要将设置应用于特定单元中的所有节点,那么可以指定单元作用域。如果同时在单元级别和 Node Agent 级别设置此属性,那么对于该特定 Node Agent,Node Agent 设置优先。gotcha

com.ibm.websphere.management.application.updateClusterTask.serverStopWaitTimeout

使用此属性来指定 Deployment Manager 在 $AdminTask updateAppOnCluster 任务中等待服务器完全停止时的耗用时间(以秒计)。缺省情况下,Deployment Manager 将等待 60 秒。对此属性指定的时间长度应大于在集群中停止服务器所需的最长时间。

仅当使用 V7.0.0.1 或更高版本时,才能指定此属性。

避免故障 避免故障: 仅当对 Deployment Manager 指定此属性时,此属性才有效。gotcha

com.ibm.websphere.management.application.updatesync.appExpansionTimeout

使用此属性来指定 Deployment Manager 在应用程序更新后等待启动应用程序服务器时的耗用时间。此等待时间确保在更新过程完成后,能够将应用程序的二进制文件展开到他们的目录中。对此属性指定的时间长度应该是节点中任何应用程序完全展开其二进制文件所需的最长时间。

缺省情况下,对于更新一个或多个应用程序之后发生的每次应用程序展开操作,推广更新功能都将等待 60 秒。由于推广功能可用于同时更新多个应用程序,因此,此属性的缺省值是 n x 60 秒,其中 n 是所更新的应用程序数。

对于较大型的应用程序而言,缺省等待时间可能并不足够。在更新应用程序之后,如果其中的一个或多个应用程序未在服务器启动时启动,那么您可能必须延长推广更新功能在启动服务器之前的等待时间。

避免故障 避免故障: 仅当对 Deployment Manager 指定此属性时,此属性才有效。gotcha

com.ibm.websphere.management.configservice.getServerLogRootFromTemplate

使用此属性可指定在创建应用程序服务器或集群成员时,是应使用对服务器模板中定义的 SERVER_ROOT 变量指定的值还是使用 {LOG_ROOT}/serverName 的值。

当创建应用程序服务器或集群成员时,将始终使用 {LOG_ROOT}/serverName 值,而不使用在现有服务器模板中定义的 SERVER_ROOT 变量的值。如果创建应用程序服务器或集群成员时要使用服务器模板中定义的 SERVER_ROOT 变量的值,请将此属性设置为 true

如果使用此定制属性,那么必须为 Deployment Manger 设置此属性。

当在已连接方式中使用 wsadmin 时,请使用 AdminTask.setJVMSystemProperties 命令在 Deployment Manger 级别设置此属性。

当在 LOCAL 方式 (conntype=none) 中使用 wsadmin 时,可以将此属性作为 javaoption 传递:
wsadmin -conntype none -javaoption
"-Dcom.ibm.websphere.management.configservice.getServerLogRootFromTemplate=true"

com.ibm.websphere.management.configservice.sessionIdUniqueness

使用此属性来防止生成重复的配置会话或工作空间标识。如果不同进程在同一毫秒内创建随机生成的配置会话或工作空间标识,那么标识可能相同。

要防止生成重复的配置会话或工作空间标识,请将此属性添加到应用程序服务器设置中并将其设为 true

可以使用 wsadmin 命令 AdminTask.setJVMSystemProperties 或者使用管理控制台来指定此定制属性。

如果应用程序服务器是某个联合单元的一部分,那么在保存更改之后,必须同步该节点并重新启动每个服务器,然后此配置更改才会生效。

如果您决定使用此定制属性,那么可以将其指定为 Deployment Manger 或应用程序服务器 JVM 定制属性。

com.ibm.websphere.management.configservice.validatePropNames

使用此属性来指定是否对定制属性名以及 wsadmin 命令中 Property 和 J2EEResourceProperty 配置对象的名称值强制进行字符限制。

可以使用下列其中一种方法来关闭对定制属性名以及 wsadmin 命令中 Property 和 J2EEResourceProperty 配置对象的名称值进行字符验证。
  • 在 Deployment Manager 服务器的 Java 虚拟机 (JVM) 中将 com.ibm.websphere.management.configservice.validatePropNames Java 系统属性设置为 false
  • 以本地方式使用 wsadmin 工具时,请使用 -javaoption 参数来设置 com.ibm.websphere.management.configservice.validatePropNames 属性。
    wsadmin -conntype none -javaoption 
    "-Dcom.ibm.websphere.management.configservice.validatePropNames=false"
[z/OS]

com.ibm.websphere.management.jmx.random

使用此属性使控制器能够随机地从服务方池中选择初始服务方以处理 Java 管理扩展 (JMX) 连接器请求,而不是自动地将该请求分配给当前服务方。

缺省情况下,如果启用了多个服务方,并且应用程序服务器接收到 JMX 连接请求,那么应用程序服务器会将该请求分配给第一个服务方(也称为当前服务方)。此策略可以最大程度地降低该请求被分配给已换出的服务方这一风险。但是,如果第一个服务方的工作负载较重,那么对该服务方发出的请求最终将失败。因此,使用随机算法的优点是,指定的服务方可能尚未处理许多其他请求。使用随机算法的缺点是,所选服务方可能被换出,必须再次换入才能处理该请求。

将 com.ibm.websphere.management.jmx.random 属性设置为:
  • true,指定控制器将随机地从服务方池中选择初始服务方来处理 JMX 连接器请求。
  • false,指定控制器将所有 JMX 连接器请求分配给当前服务方。

如果您决定使用此定制属性,那么必须将其指定为控制器的 JVM 定制属性。

com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool

使用此属性可控制在新创建的线程池中可以包括的线程数。会创建一个专用线程来启动每个应用程序服务器 Java 虚拟机 (JVM)。在此线程池中带有专用线程的 JVM 是在 Node Agent 启动时并行启动的 JVM。

可以指定 0 - 5 之间的整数作为此属性的值。如果您指定的值大于 0,那么创建的线程池会使用该值作为在此新创建的线程池中可以包括的最大线程数。下表列示了此定制属性所支持的值及其影响。

表 1. com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 支持的值. 此表包括定制属性值以及此定制属性的影响。
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 影响
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 属性设置为 0,或者未指定此属性的值。 Node Agent 将并行启动最多达 5 个 JVM。
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 属性设置为 1 Node Agent 将按顺序启动 JVM。
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 属性设置为 25 之间的整数值。 Node Agent 将并行启动的 JVM 的数目与所指定值相同。

例如,假设 Node Agent 具有 10 个设置为运行状态的 JVM,此状态表示这些 JVM 将在 Node Agent 启动时启动。如果您为此属性指定 3,只要您停止并启动 Node Agent,那么在 Node Agent 启动时,10 个 JVM 中将仅有 3 个会并行启动。

避免故障 避免故障:
  • 如果您使用管理控制台,并指定 com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool 作为 Node Agent 的新 JVM 定制属性的名称,那么必须在此新定制属性的字段中指定一个值。如果未指定值,那么会接收到错误消息。
  • 如果通过命令行向该属性传递了一个空值,那么该值将视为非法值,并且将恢复 Node Agent 的缺省行为。
gotcha

缺省情况下,未指定此属性。如果您决定使用此定制属性,那么必须将其指定为 Node Agent JVM 定制属性。

com.ibm.websphere.management.nodesync.skipWebServerTarget

使用此属性来控制是否将应用程序二进制文件分发到其中的应用程序只面向 Web 服务器的目标节点。

缺省情况下,此定制属性值设为 false,这使应用程序服务器将应用程序二进制文件分发到目标节点。如果将此属性设置为 true,那么应用程序服务器不会将应用程序二进制文件分发到只包含 Web 服务器目标的目标节点。

要点: 系统行为不受此定制属性值影响。并且,既是节点同步更改导致包含应用程序服务器目标的目标节点的此定制属性值发生更改,也不会影响系统行为。无论该节点是否包含 Web 服务器目标,这些陈述都是正确的。
以下是 isAppReady 的样本输出,这是此定制属性设置为 true 时对于只包含 Web 服务器的目标节点生成的输出:
wsadmin>$AdminApp isAppReady SuperApp 
ADMA5071I: Distribution status check started for application SuperApp. 
WebSphere:cell=IBMCell10,node=IBMNode30,distribution=true,expansion=skipped 
ADMA5011I: The cleanup of the temp directory for application SuperApp is complete. 
ADMA5072I: Distribution status check completed for application SuperApp. 
true
可以对 Deployment Manager 设置此定制属性,但不能对应用程序服务器或 Node Agent 设置此属性。您可以使用管理控制台,也可以通过命令行完成下列步骤:
  1. profile_root/bin 目录中启动 wsadmin 脚本编制工具。您需要启动该目录中的 .wsadmin.bat 或 wsadmin.sh 命令。
  2. 运行下列其中一个命令:
    使用 Jacl
    $AdminTask setJVMSystemProperties {-serverName server_name -nodeName node_name -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true}
    使用 Jython 字符串
    AdminTask.setJVMSystemProperties('[-serverName server_name -nodeName node_name -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true]')
    使用 Jython 列表
    AdminTask.setJVMSystemProperties (['-serverName', 'server_name', '-nodeName', 'node_name' '-propertyName', 'com.ibm.websphere.management.nodesync.skipWebServerTarget', '-propertyValue', 'true'])

    其中,server_namenode_name 变量特定于您的环境。

  3. 重新启动 Deployment Manager。

com.ibm.websphere.management.processEmbeddedConfigGlobal

使用此属性以全局方式允许或禁止在部署期间处理增强型应用程序企业归档 (EAR) 文件的嵌入式配置。导出已安装的应用程序时将生成增强型 EAR 文件。

此定制属性以全局方式覆盖处理嵌入式配置 (-processEmbededConfig) 选项的缺省设置。缺省情况下,对于增强型 EAR 文件,处理嵌入式配置设为 true(选中),对于所有其他 EAR 文件,它设为 false(未选中)。处理嵌入式配置设置确定产品在增强型 EAR 文件的部署期间要将该增强型 EAR 文件展开到的目录。如果应用程序是从除当前单元以外的单元中导出的,并且最初安装该应用程序时未对应用程序安装目录指定 $(CELL) 变量,那么在增强型 EAR 文件的部署期间将处理嵌入式配置设为 false 将在 app_server_root/profiles/installedApps/current_cell_name 目录中抽取该增强型 EAR 文件。否则,如果处理嵌入式配置设为 true,那么将在 app_server_root/profiles/installedApps/original_cell_name 目录中展开增强型 EAR 文件,其中 original_cell_name 是应用程序最初所安装在的单元。如果最初安装该应用程序时对应用程序安装目录指定了 $(CELL) 变量,那么安装版本将在 app_server_root/profiles/installedApps/current_cell_name 目录中展开增强型 EAR 文件。

如果 processEmbeddedConfigGlobal 定制属性设置为 false,那么产品在部署期间不会处理任何应用程序(包括增强型 EAR 文件)的嵌入式配置。将 processEmbeddedConfigGlobal 设为 false 之后,产品不会处理增强型 EAR 文件的嵌入式配置。但是,在部署单个增强型 EAR 文件时,您可以通过显式地将处理嵌入式配置设为 true 来覆盖此 false 设置。

如果 processEmbeddedConfigGlobal 定制属性设置为 true,那么产品将处理增强型 EAR 文件的嵌入式配置。

无论 processEmbeddedConfigGlobal 定制属性是设为 true 还是 false,产品都将正常地部署未包含嵌入式配置的应用程序。此设置对部署没有影响。

避免故障 避免故障: 如果您决定使用此定制属性,那么必须同时将此属性及其值指定为控制器和服务方的 JVM 定制属性,或者将此属性添加到 wsadmin.properties 文件中。gotcha
避免故障 避免故障: 如果您决定使用此定制属性,那么必须将此属性指定为 Deployment Manager 的 JVM 定制属性,或者将此属性添加到 wsadmin.properties 文件中。gotcha
[z/OS]

com.ibm.websphere.management.registerServerIORWithLSD

使用此属性来控制联合服务器是否向位置服务守护程序 (LSD) 注册。通常,联合服务器需要 Node Agent 才能运行。要指示服务器不向 LSD 注册,并使其不依赖于活动 Node Agent,必须将 JVM 定制属性 com.ibm.websphere.management.registerServerIORWithLSD 设为 false,并且必须将 ORB_LISTENER_ADDRESS 设置为大于 0 的值,以便 ORB 侦听固定端口。如果将 ORB_LISTENER_ADDRESS 属性设置为 0(零)或者未指定该属性,那么此属性的设置将被忽略,并且联合服务器将向 LSD 注册。

如果您希望服务器在即使 Node Agent 未在运行的情况下也将运行,请将此属性设置为 false。如果将此属性设置为 true,那么联合服务器将向 LSD 注册。缺省值为 true

避免故障 避免故障: 此属性已存在于 ORB 服务定制属性列表中。要更改此定制属性的设置,在管理控制台中,单击服务器 > 应用程序服务器 > server_name > 会话管理 > 容器服务 > ORB 服务 > 定制属性 > com.ibm.websphere.management.registerServerIORWithLSD gotcha

在更改此定制属性的值后,必须执行完全同步,然后才会在节点上的 server.xml 文件中反映出此更改。如果无法启动服务器的 Node Agent,那么必须手动编辑 server.xml 文件,以将此定制属性的值从 true 更改为 false

如果将 com.ibm.websphere.management.registerServerIORWithLSD 属性设置为 false,那么服务器在动态分配 ORB_LISTENER_ADDRESS 端口时不会通知 Node Agent。另外,不存在任何可由 Node Agent 对服务器解析的间接互操作对象引用 (IOR)。所有这些 IOR 都将成为直接引用,这意味着只有将静态 ORB_LISTENER_ADDRESS 分配给服务器,Node Agent 才能与该服务器联系。

避免故障 避免故障: 如果将 com.ibm.websphere.management.registerServerIORWithLSD 属性设置为 false,并且您未打算使用高可用性管理器 (HAManager) 服务和 Node Agent 进程,那么应该创建静态路由表以启用静态路由。启用静态路由将确保工作负载管理 (WLM) 继续正常工作。您可以使用 com.ibm.websphere.management.registerServerIORWithLSD 来避免 针对应用程序服务器所提供的任何服务返回间接 IOR(从而使 Node Agent 将这些间接 IOR 映射至直接 IOR)。
使用 Node Agent 将在服务器端建立一个已知端口,当应用程序服务器的端口未知时,客户机可以向该已知端口发送请求。创建静态路由表并启用静态路由将为应用程序服务器提供静态端口并使这些端口可供使用。借助静态端口,就不必进行 Node Agent 处理。
注: 使用动态应用程序服务器端口时,不能使用静态路由表。动态应用程序服务器端口要求进行 Node Agent 处理,这是因为客户机需要在服务器重新启动时获取新的端口信息。

设置 com.ibm.websphere.management.registerServerIORWithLSD 属性不会影响动态或静态端口的使用,也不会影响 WLM 对请求进行的路由。但是,这将使 HAManager 的 Node Agent 所提供的潜在故障转移级别降低。

对请求进行加权发射时,仍将进行 WLM 处理。

gotcha

com.ibm.websphere.management.soapSocketConnectionTimeout

使用此属性可指定 JMX SOAP 连接器套接字应该保持打开状态的时间长度(以秒计)。如果不为此属性指定值,那么 JMX SOAP 连接器套接字连接将无限期地保持打开。

com.ibm.websphere.management.useUpdatedPropertyFiles

使用此属性通过更新后的属性文件模板来创建新的邮件会话。

将此属性设置为 true,以使用更新后的属性文件配置模板来创建新的邮件会话。将使用更新后的属性文件配置模板,而不使用原始属性文件配置模板。

最佳实践 最佳实践: 除非您使用了原始属性文件模板将 WebSphere Application Server 配置对象抽取到属性文件中,否则应当启用 com.ibm.websphere.management.useUpdatedPropertyFiles。bprac

设置此系统属性之后,保存更改。如果应用程序服务器是联合单元的一部分,那么使节点同步以传播更改。请重新启动每个服务器以使更改生效。

缺省情况下,未启用此属性。

com.ibm.websphere.metadata.ignoreDuplicateRefBindingsInWebModules

使用此属性来控制 JVM 对于 Java 2 Platform, Enterprise Edition (J2EE) V1.3 应用程序中的 Web 模块,是否忽略其 DTD 文件中的重复引用绑定实例。通常情况下,如果 Java 2 Platform, Enterprise Edition (J2EE) V1.3 应用程序中某个 Web 模块的 DTD 文件包含重复的引用,那么将发生 MetaDataException。

Web 模块的 DTD 文件标准明确指出,引用绑定必须具有唯一的名称字段。因此,如果应用程序中包含的 Web 模块包含重复的引用绑定,那么该应用程序在技术上未遵从标准。

虽然 Web 模块的 DTD 文件标准禁止用户定义重复的引用绑定,但 V7.0 以前的产品版本中的 JVM 却允许定义重复的引用绑定。如果 Java 2 Platform, Enterprise Edition (J2EE) V1.3 应用程序中的 Web 模块的 DTD 文件包含重复的引用绑定,那么您可以移除重复的引用,也可以对 JVM 配置设置添加此属性并将其设为 true

com.ibm.websphere.network.useMultiHome

[AIX Solaris HP-UX Linux Windows][IBM i]在多地址环境中,使用此属性来指示应用程序服务器所侦听的 IP 地址。在多地址环境中,通常有一个特定的 IP 地址,应用程序服务器被限制为只能侦听此 IP 地址以获取发现和 SOAP 消息。将 com.ibm.websphere.network.useMultiHome 属性设置为:
  • true,指定产品将侦听主机上的所有 IP 地址以获取发现和 SOAP 消息。
  • false,指定产品将只侦听已配置的主机名以获取发现和 SOAP 消息。如果将此属性设置为 false,那么应该对产品配置将会解析为特定 IP 地址的主机名。
  • null,指定产品将只侦听缺省 IP 地址。
[z/OS]在产品被限制为只侦听特定 IP 地址以获取发现和 SOAP 消息的多址环境中,请对 Deployment Manager、所有应用程序服务器和所有 Node Agent 将此属性设置为 false。缺省情况下,此属性的值为 true,即,应用程序服务器将侦听主机上的所有 IP 地址以获得发现和 SOAP 消息。如果此属性设置为 false,那么产品将只侦听已配置的主机名以获取发现和 SOAP 消息。如果将此属性设置为 false,那么还必须:
  • 对产品配置一个将解析为特定 IP 地址的主机名。
  • 确保 Deployment Manager、所有应用程序服务器和所有 Node Agent 的端点属性都设置为此主机名。对于 Deployment Manager 而言,必须设置的端点是 CELL_DISCOVERY_ADDRESS 和 SOAP_CONNECTOR_ADDRESS。对于 Node Agent 和应用程序服务器而言,只须设置 SOAP_CONNECTOR_ADDRESS 端点。
您可以通过管理控制台来更改此值。请通过对服务器、Deployment Manager 和 Node Agent 设置值来修改缺省值。要使这些更改生效,必须重新启动服务器。

如果您无法访问服务器,请检查 com.ibm.websphere.network.useMultihome 的设置以确保它正确。您可以通过管理控制台来更改此值。请通过对服务器、Deployment Manager 和 Node Agent 设置值来修改缺省值。必须重新启动服务器才能使更改生效。

com.ibm.websphere.perf.tuning.disableRPARepositoryCache

使用此属性来防止在禁用 RPA 的情况下高速缓存服务器配置详细信息。

RPA 使用存储库高速缓存来存储服务器的配置详细信息。会初始化此高速缓存并存储配置详细信息,即使已禁用 RPA 和 PMI,也是如此。对于非常大型的安装(例如,具有超过 3000 个数据源的安装),存储库高速缓存可能会变得非常大。如果您遇到由于此存储库高速缓存过大而导致的性能问题,并且已禁用 RPA,那么向 JVM 配置设置添加此属性并将其设置为 true。如果已启用 RPA,或者您未遇到由于此存储库高速缓存过大而导致的性能问题,那么不应使用此定制属性。

避免故障 避免故障: 如果已启用 RPA,或者您未遇到由于此存储库高速缓存过大而导致的性能问题,那么不应使用此定制属性。gotcha

此属性的缺省值为 false。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.resource.xmlConfigMaxLineLength

使用此属性来指定 XML 配置文档的首选最大行长度。

位于 server.xml 文件开头的行的长度通常超过 2048 个字符。在某些操作系统上(例如,z/OS),常见的文本编辑工具无法处理长度超过 2048 个字符的行。因此,当您编辑并保存包含长度超过 2048 个字符的行的文件时,太长的行会被截断。截断之后会使配置文件不可用,从而导致服务器无法启动。

如果您为此属性指定值,那么当您编辑并保存 XML 配置文档时,在行中的字符数达到所指定的最大允许字符数之后,就很有可能发生行被截断的情况。在逻辑断点处也有可能会发生行被截断,这就是行长度可能仍然超过所指定的最大值的原因。因此,您为此属性指定的值应考虑可能会超过所指定最大值的字符数,以确保文档中的任何行都不超过 2048 个字符。

如果您不为此属性指定值,那么允许每一行为任意长度。

此属性接受 80 到 2046 范围内(包括 80 和 2046)的整数值。

此属性没有缺省值。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.sib.webservices.useTypeSoapArray

可以通过覆盖 JAX-RPC 客户机绑定名称空间和端点地址将消息直接传递至总线目标。但是:
  • 所生成的缺省 RPC 编码 Web Service 字符串数组消息可能无法成功地与某些目标服务提供程序进行互操作。
  • 所生成的字符串数组消息并非与能够成功地进行互操作的标准 JAX-RPC 消息完全相同。
下面是两条不同消息的示例:
  • 服务集成总线消息:
    <partname env:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/ xsi:type='ns1:ArrayOf_xsd_string'>
      <item xsi:type='xsd:anySimpleType'>namevalue</item>
    </partname>
  • JAX-RPC 客户机消息:
    <partname xsi:type="soapenc:Array" soapenc:arrayType="xsd:string[1]">
      <item>namevalue</item>
    </partname>

将此属性设置为 true,以修改缺省行为并发送与标准 JAX-RPC 完全兼容的字符串数组消息。设置此属性将修改所有从服务集成总线发送的出站 JMS Web Service 调用的缺省行为。

com.ibm.websphere.webservices.attachment.tempfile.expiration

使用此属性来指示 JAX-WS 或服务组件体系结构 (SCA) 客户机或服务上附件的到期时间(以秒计)。如果在超过此到期时间的时间段内未访问某个附件,那么将允许 Web Service 运行时删除该附件。

JAX-RPC 编程模型允许从入局 Web Service 消息中访问附件。可以立即访问该附件,也可以存储该附件以便稍后进行处理。因此,与该附件相关联的内存的持久存储时间可能超过 Web Service 交互的生存期。这是因为,无法准确地确定 Web Service 运行时在多长时间之后才可以安全地释放该附件。

对于较小的附件,内存最终由 Java 垃圾回收器进行释放。

对于较大的附件,JAX-RPC 运行时会将附件数据存储在临时文件中,因此,该运行时可以在不消耗内存的情况下处理非常大的附件。如果应用程序未访问该附件,或者应用程序未充分地关闭与该附件相关联的数据处理程序,那么将不会释放较大的临时文件。如果没有对这些临时附件文件指定到期时间,那么这些文件可能会随时间而在文件系统上堆积起来。

最佳实践 最佳实践: 如果需要对这些附件指定到期时间,建议将到期时间设置为 600 秒。此定制属性的缺省设置是 0 秒,它指示这些附件没有到期时间。bprac

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.attachements.maxMemCacheSize

使用此属性来指定 JAX-RPC 客户机或服务上可以写入内存的附件的最大大小(以千字节计)。例如,如果 Web Service 需要发送 20 MB 的附件,请将此属性设置为 20480。

确定此属性的值时,请记住,最大高速缓存大小越大,对性能的影响以及对 Java 堆的潜在影响也越大。

如果未对此属性指定值,那么用于对附件进行高速缓存的最大内存量是 32 KB,这就是此属性的缺省值。

支持的配置 支持的配置: 要指定 JAX-RPC 客户机或服务上附件的最大大小,请参阅 com.ibm.ws.websvcs.attachments.sizethreshold 定制属性。sptcfg

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.DisableIBMJAXWSEngine

使用此属性在服务器级别关闭 Web Service 注释扫描功能。缺省情况下,Web Service 注释扫描功能在服务器级别处于启用状态。

要在应用程序级别关闭注释扫描功能,请在 WAR 文件或 EJB 模块的 META-INF/MANIFEST.MF 中将 DisableIBMJAXWSEngine 属性设置为 true。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.http.OneWayConnectionRecycleTime

使用此属性来指定重复使用单向连接之前 Web Service 引擎应等待的时间(以秒计)。太快地复用单向连接时,Web Service 操作可能会因为超时问题(例如,SocketTimeoutException)在客户机上失败。

对此属性指定值时,直到经过指定秒数(从发送请求时算起),单向连接才会重置。

缺省情况下,不会设置此属性,单向连接在请求发送后立即重置。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.http.waitingThreadsThreshold

使用此属性来指定在释放软连接之前,允许多少个连接请求处于等待状态。软连接是指,客户机引擎在连接关闭后为某些主机维护连接对象。缺省情况下,在 5 个线程等待连接后,客户机引擎将释放软连接。

注: 如果所有连接都在使用中,那么此定制属性不会产生任何影响。在这种情况下,您可以增大最大连接数限制和/或最大线程数。

此定制属性的缺省值是 5

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.jaxrpc.client.publishwsdl

指定是否为客户机 Web 模块发布 WSDL 文件。此属性设置为 true 时,如果应用程序包含客户机 Web 模块,那么可能会为该客户机发布 WSDL 文件。如果您不想为客户机应用程序发布 WSDL 文件,请将此属性设置为 false

缺省值为 true

避免故障 避免故障:
  • WSDL 文件发布功能不适用于只包含客户机的 JAX-RPC 应用程序。
  • 此属性不能用于 JAX-WS 应用程序。
gotcha

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.management.connector.http.header.includeProductVersion

将此属性的值设置为 true,以将服务器版本信息包括在 SOAP 端口 HTTP 响应头中。缺省值为 false

com.ibm.websphere.webservices.jaxws.setLinkValuePrecedence

使用此属性来指定 JAX-WS 运行时环境中的链接值的优先顺序。

当此属性设置为 true 时,部署描述符链接值将优先于注释链接值。

缺省值为 false

com.ibm.websphere.webservices.soap.enable.legacy.get.behavior

WebSphere Application Server V8 开始,如果消息中没有相应的元素,那么 SOAPMessage.getSOAPHeadergetSOAPBody 方法会抛出 SOAPException。提供了一个系统属性 com.ibm.websphere.webservices.soap.IBMSOAPMessage.ENABLE_LEGACY_GETSOAP_BEHAVIOR,可将行为恢复为返回 NULL 而不抛出异常。此系统属性是使用 JVM 定制属性 com.ibm.websphere.webservices.soap.enable.legacy.get.behavior 进行设置。此 JVM 定制属性的缺省值为 false。如果将此 JVM 属性设置为 true,那么将还原为先前的行为,即在没有相应消息时,对 SOAPMessage.getSOAPHeader 和 getSOAPBody 方法返回空值。
注: 先前返回空值的行为不符合规范。

com.ibm.websphere.webservices.tempAttachDir

使用此属性来指定存储设备上的一个位置,Web Service 运行时将在该位置对任何作为 SOAP 消息组成部分进行发送或接收并大于 32KB 的附件高速缓存一个副本。

为了提高性能,Web Service 运行时将对任何大于 32KB 的 SOAP 消息附件高速缓存一个临时副本。如果未对此属性指定值,那么高速缓存的附件副本通常被发送到操作系统的缺省临时目录。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.transport.jms.messageType

使用此属性来控制 Web Service 引擎在发送请求和响应消息时用于 JMS 组件上的 SOAP 的 JMS 消息类型。要指定 JMS BytesMessage (javax.jms.BytesMessage) 对象,请将此属性设置为 BYTES 以指示消息体是二进制数据。要指定 JMS TextMessage (javax.jms.TextMessage) 对象,请将此属性设置为 TEXT 以指示消息体是字符串数据。

此定制属性的缺省值是 BYTES

要进一步了解 SOAP over JMS 消息类型,请参阅“配置 SOAP over JMS 消息类型”信息。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS

在 V8 之前,WebSphere Application Server 的 JAX-WS 客户机应用程序可能会在 SOAP 消息中发送 SAVE_CONNECTION HTTP 头。这个附加的头确保主管 JAX-WS Web Service 的应用程序服务器执行正确的处理。然而,如果客户机的应用程序服务器以及 Web Service 的应用程序服务器主机都在使用 WebSphere Application Server V7.0 FP3 或更高版本,那么这个 SAVE_CONNECTION 头以及附加处理并非是必需的。

可以将 com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS 定制属性设置为 false 来启用 SAVE_CONNECTION 头,以确保更低级别的应用程序服务器进行正确的处理。缺省情况下,此定制属性设置为 true,这将禁止 JAX-WS 客户机发送 SAVE_CONNECTION 头。如果需要更改此缺省行为,请在主管 JAX-WS 客户机应用程序的应用程序服务器上将此定制属性设置为 false
要点: 您必须验证客户机的应用程序服务器以及 Web Service 的应用程序服务器主机是否都在使用 V7.0 FP3 或更高版本。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.transport.ssl.loadFromPolicyBinding

使用此属性来控制当客户机是受管客户机并且客户机和服务器位于不同应用程序服务器中时,JAX-WS 应用程序是使用 SSL 传输绑定还是使用系统缺省设置。

创建 SSL 绑定时,此属性将自动添加到绑定文件并设置为 true。当客户机是受管客户机并且客户机和服务器位于不同应用程序服务器中时,此设置允许将 SSL 传输绑定用于 JAX-WS 应用程序。如果未将任何绑定连接至您的 JAX-WS 应用程序,请将此属性设置为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.UseWSFEP61ScanPolicy

使用此属性来控制产品是否在 WAR 2.4 和更低版本模块中扫描 JAXWS 组件和半受管服务客户机。缺省情况下,将只在这些旧 WAR 模块中扫描半受管服务客户机。

缺省值为 false

对于每个要求对缺省值进行更改的服务器或管理服务器,必须将此属性设置为 true

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.webservices.WSDL_Generation_Extra_ClassPath

使用此属性来设置共享类文件的位置。wsgen 命令行工具将生成一些必要的工件,Java API for XML Web Services (JAX-WS) 应用程序从 Java 代码中启动时需要这些工件。然而,wsgen 命令行工具可能找不到必要的类文件并将以下错误消息追加到日志文件中:
Caused by: java.lang.NoClassDefFoundError
...
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.wsgen(WASWSDLGenerator.java:521)
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.generateWsdl(WASWSDLGenerator.java:183)
使用此属性来提供丢失的类文件的标准位置。使用此定制属性时,您应该提供多个 Java 归档 (JAR) 和目录的标准路径,并使用分号 (;) 将这些路径分隔开。[z/OS]为避免麻烦,请将此属性设置为所有 JVM 进程,包括 Deployment Manager、Node Agent 和应用程序服务器。
要点: 如果 WebSphere Application Server 的基本操作系统是 AIX®、Linux 或 UNIX,那么使用冒号 (:) 来分隔多个 Java 归档 (JAR) 和目录。

示例:D:\sharedlibs;D:\libs\WSBean.jar

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

[z/OS]切记: 为控制器和服务方设置此属性。可以按如下所示为服务方设置此属性:
[z/OS]避免故障: 如果要在 z/OS 上设置此属性,那么必须在管理控制台中同时为“控制”和“服务方”JVM 定制属性都设置该属性:
  • 应用程序服务器>[SERVER_NAME]>进程定义>服务方>Java 虚拟机器>定制属性
  • 应用程序服务器>[SERVER_NAME]>进程定义>控制>Java 虚拟机器>定制属性

com.ibm.websphere.websvcs.EJBPostInvokeCallOnException

在 Web Service 调用的 Enterprise JavaBeans (EJB) 中发生异常之后,使用此属性来清除状态和事务。

在安装使用 JAX-WS Web Service 的 WebSphere Application Server 时,如果作为 Web Service 一部分调用的 EJB 中发生异常,那么事务在线程中可能会保持活动状态,从而阻止继续处理与当前 XA 事务相关联的事务。将此属性设置为 True 以确保完全清除状态和事务。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.websphere.workspace.decodeclustervariable

对于在集群作用域中定义的变量,当它们出现在管理控制台中定义的日志文件路径中时,使用此属性来确保它们已展开。

如果未设置此属性,并且使用了作用域仅限于集群的变量来定义日志文件路径,那么 Deployment Manager 可能无法检索所请求的日志文件。因此,如果日志文件路径中包括作用域仅限于集群的变量,那么应将此属性添加至 Deployment Manager JVM 设置。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为 Deployment Manager JVM 定制属性。将此属性设置为 true 之后,必须重新启动 Deployment Manager 之后才能使此更改生效。

com.ibm.websphere.wsrm.MaxSequenceBacklog

使用此属性可配置出站 WS-RM 序列中的最大消息数。

已达到所定义的限制时,WS-RM 将通过抛出 javax.xml.ws.WebServiceException 异常来拒绝任何新消息,直到积压减少到低于该限制为止。接收异常的客户机应该重试请求。

未设置任何缺省值。如果未定义任何值,那么积压限制将无限。

com.ibm.websphere.wsrm.MessageContextCacheSize

使用此属性可将内存中高速缓存的最大大小设置为正整数值。

未设置任何缺省值。高速缓存的大小是无限大。

com.ibm.websphere.wsrm.pollingInterval

使用此属性可指定对序列发送 MakeConnection 请求的频率。

该值以毫秒为单位指定时间间隔。当未设置该属性时,缺省行为是 3000 毫秒。

com.ibm.websphere.wsrm.retransmissionInterval

使用此属性可指定当先前尝试传输消息失败时,WS-RM 重新传输应用程序消息的频率。

该值以毫秒为单位指定时间间隔。当未设置该属性时,缺省行为是 15000 毫秒。

[z/OS]

com.ibm.websphere.zos.userdir.useRacfSettings

当此属性设置为 false 时,WebSphere Application Server 代码会将 user.dir 设置为 ${USER_INSTALL_ROOT},即配置文件系统路径在 /profiles/ 目录之前的部分。

当此属性设置为 true 时,user.dir 不由 WebSphere Application Server 代码设置。而是,将通过允许 USS 设置生效(user.dir == OMVS 段主目录)来设置 user.dir

因为 WebSphere Application Server 不设置该属性,所以您可以在服务方 JVM 定制属性中将 user.dir 定义为您选择的值。当您定义 user.dir 后,Java 代码将通过选项文件 servant.jvm.options 来设置该目录。

注: 更改 user.dir 将仅更改该属性的值。它不会更改 JVM 的当前工作目录,此目录在引导时设置。

com.ibm.ws.amm.require.produces.annotation.for.cdi

除非 CDI Bean 上存在 @Produces 注释,否则 WebSphere Application Server 会错误地忽略下列注释:@EJB、@WebServiceRef、@PersistenceContext、@PersistenceUnit 和 @Resource。由于 Java EE 不要求存在 @Produces 注释,因此,该行为不正确。由于现有应用程序依赖于此错误行为,因此“规范不正确”行为将保持缺省行为。提供此定制属性以允许您通过将此属性设置为 false 来获取“规范正确”行为。

将此属性设置为 false,以在符合下列所有情况时获取“规范正确”行为:
  • 应用程序包含 CDI Bean
  • CDI Bean 包含下列任何注释:@EJB、@WebServiceRef、@PersistenceContext、@PersistenceUnit 和 @Resource
  • CDI Bean 不包含 @Produces 注释

com.ibm.ws.amm.scan.context.filter.archives

使用此属性来提供未包含注释的归档或实用程序 JAR 文件的列表。系统不会在您对此属性指定的归档或实用程序 JAR 文件中扫描注释。

在部署或更新 Java Platform, Enterprise Edition (Java EE) 5 或 6 应用程序时,注释元数据管理器 (AMM) 设施将扫描所有注释元数据。此扫描过程可能会导致部署应用程序所需的时间延长。如果应用程序中的某些归档或实用程序未包含注释,那么您可以列示这些归档和实用程序作为此属性的值。如果应用程序中的某些 Java 包未包含注释,那么您可以列示这些包作为 Ignore-Scanning-Packages 属性的值。

对这些属性指定的值区分大小写并且必须表示成单一字符串,而且必须使用后跟空格的逗号来分隔归档或实用程序 JAR 文件的名称。不允许使用通配符和 REGEX 表达式。

作为使用此定制属性的替代方法,您可以在下列其中一个文件或模块中添加 Ignore-Scanning-Archives 属性并指定不想扫描的归档和实用程序作为该属性的值:
  • was_home/properties 目录中的 amm.filter.properties 文件。
  • profile_home/properties 目录中的 amm.filter.properties 文件。
  • 应用程序的清单文件 META-INF/MANIFEST.MF。
  • 应用程序中的 Web 模块或 Enterprise JavaBeans (EJB) 模块的清单

amm.filter.properties 文件中指定的值将与此定制属性中的值合并,以构成具有服务器作用域的过滤器集合。这个合并而成的过滤器集合将应用于所有部署在该服务器上的应用程序。

应用程序的清单文件中指定的值将与具有服务器作用域的过滤器集合进行合并以构成具有模块作用域的超集,这个超集将应用于该应用程序中的所有模块。

Web 模块或 Enterprise JavaBeans (EJB) 模块的清单文件中指定的值将与具有模块作用域的过滤器集合进行合并。这个合并而成的过滤器集合将只应用于该模块。

避免故障 避免故障: 在更新清单文件时,务必十分谨慎。清单文件具有行长度限制以及其他必须遵循的约束。gotcha
示例:
Ignore-Scanning-Archives : ant.jar,  avalon-framework-4.2.0.jar, axis.jar, CICS.jar, xerces.jar

com.ibm.ws.amm.scan.context.filter.disable.unifyTrue

仅当您需要通过注释元数据管理器 (AMM) 在扫描注释时过滤某些 JAR 文件,但是您希望由可扩展类扫描程序 (ECS) 层对文件进行扫描时,才使用此属性。要启用此属性,请将值设置为 true

缺省值为 false

com.ibm.ws.amm.scan.context.filter.packages.

使用此属性来提供未包含注释的 Java 包的列表。系统将不会在您对此属性指定的 Java 类中扫描注释。

在部署或更新 Java Platform, Enterprise Edition (Java EE) 5 或 6 应用程序时,注释元数据管理器 (AMM) 设施将扫描所有注释元数据。此扫描过程将导致部署应用程序所需的时间延长。如果应用程序中的某些 Java 包未包含注释,那么您可以列示这些包作为此属性的值。如果应用程序中的某些归档或实用程序未包含注释,那么您可以列示这些包作为 Ignore-Scanning-Archives 属性的值。

对此属性指定的值区分大小写并且必须表示成单一字符串,而且必须使用后跟空格的逗号来分隔 Java 包的名称。不允许使用通配符和 REGEX 表达式。

作为使用此定制属性的替代方法,您可以在下列其中一个文件或模块中添加 Ignore-Scanning-Packages 属性并指定不想扫描的归档和实用程序作为该属性的值:
  • was_home/properties 目录中的 amm.filter.properties 文件。
  • profile_home/properties 目录中的 amm.filter.properties 文件。
  • 应用程序的清单文件 META-INF/MANIFEST.MF。
  • 应用程序中的 Web 模块或 Enterprise JavaBeans (EJB) 模块的清单

amm.filter.properties 文件中指定的值将与此定制属性中的值合并,以构成具有服务器作用域的过滤器集合。这个合并而成的过滤器集合将应用于所有部署在该服务器上的应用程序。

应用程序清单文件中指定的值将与具有服务器作用域的过滤器集合进行合并,以构成具有模块作用域的超集,这个超集将应用于该应用程序中的所有模块。

Web 模块或 Enterprise JavaBeans (EJB) 模块的清单文件中指定的值将与具有模块作用域的过滤器集合进行合并。这个合并而成的过滤器集合将只应用于该模块。

避免故障 避免故障: 以下示例以属性文件为中心,不能按原样用于清单文件。清单文件的行长度限制为 72 个字节,并且还有其他必须遵守的约束。gotcha
示例:
Ignore-Scanning-Packages : org.apache.avalon, org.apache.batik, org.apache.commons

com.ibm.ws.application.enhancedScanning

使用此属性来禁用多个用于减少部署和启动企业应用程序所需的时间的优化。这些优化主要涉及启用了 Java Platform, Enterprise Edition (Java EE 5) 的应用程序。如果将此属性设置为 false,那么将禁用下列更新:
  • 用于模块文件的新高速缓存
  • 用于装入模块类的新高速缓存
  • 用于注释处理的备用代码路径。
如果将此属性设置为 false,那么性能可能会下降。缺省值为 true

com.ibm.ws.cache.CacheConfig.alwaysSetSurrogateControlHdr

使用此属性来强制对响应始终设置动态高速缓存服务中的代理控制头。代理控制头包含元数据,Edge Side Include (ESI) 处理需要使用这些元数据在 ESI 高速缓存中正确地生成内容以及使高速缓存的内容失效。

缺省值为 false,这表示可能不会对响应设置代理控制头。

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.cache.CacheConfig.cascadeCachespecProperties

使用此属性使子页面或片段能够继承其父页面或片段中的 save-attributes 和 store-cookies 属性的级联。缺省值为 false

动态高速缓存服务的缺省行为是,如果子页面或片段的请求属性在高速缓存规范中未被显式覆盖,那么存储这些属性。如果这些请求属性过大,那么应用程序服务器可能会发生内存不足情况。如果缺省情况下保存的属性不可序列化,那么对这些高速缓存条目执行的磁盘卸载可能会导致 java.io.NotSerializableExceptions。

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.cache.CacheConfig.filteredStatusCodes

使用此属性来指示一些错误情况,您不希望动态高速缓存服务在这些情况下对 Servlet 输出进行高速缓存。

对此属性指定的值是一列以空格定界的 HTTP 响应错误码。如果高速缓存不命中所返回的状态码与列示的某个响应错误码匹配,那么动态高速缓存服务将不会对响应 HTTP 请求时获得的数据进行高速缓存。

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior

使用此属性来返回图中包含的映射的集合视图。

当定义了 com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior 并且设为 true 时,DistributedMap.entrySet() 方法将返回图中包含的映射的集合视图。

可以在以下位置将此定制属性设置为 JVM 定制属性:服务器 > 应用程序服务器 > <server name> > 进程定义 > Java 虚拟机 > 定制属性

定义此 JVM 定制属性会影响所有高速缓存实例。在应用程序服务器级别指定此属性。

com.ibm.ws.cache.CacheConfig.useServerClassLoader

使用此属性来指定 JVM 在反序列化 InvalidationEvent 时应该使用的类装入器。如果将此属性设置为 true,那么将使用服务器类装入器来反序列化 InvalidationEvent。如果将此属性设置为 false,那么将使用应用程序类装入器来反序列化 InvalidationEvent。缺省值为 false

反序列化 InvalidationEvent 时使用适合的类装入器可以帮助提高性能。

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations

使用此属性来确保触发命令失效操作,而不考虑 skipCache 属性。

当请求对象包含 <previewRequest> 属性时,动态高速缓存会将 skipCache 属性设置为 true。如果 skipCache 属性为 true,那么并非始终会使命令失效。将 com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations 定制属性设置为 true 可确保触发命令失效操作,而不考虑 skipCache 属性。如果设置了此定制属性,那么它将影响所有高速缓存实例。缺省值为 false

您只能在应用程序服务器级别设置此定制属性。

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.cdi.immediate.ejb.start

使用此属性可确保在应用程序启动时,上下文和依赖关系注入 (CDI) 容器及其生命周期将针对所有 EJB 模块开始。

如果此属性设置为 true 值,那么在应用程序启动时,CDI 容器及其生命周期将针对所有 EJB 模块开始。此属性的缺省值是 false

com.ibm.ws.classloader.allowDisposedClassLoad

使用此属性来指定 JVM 在应用程序停止时是否应该完全移除应用程序类装入器。如果 JVM 未完全移除应用程序类装入器,那么仍然可以从该类装入器装入类。

如果此属性的值设为 true,那么 JVM 在应用程序停止时不会完全移除应用程序类装入器。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.classloader.encodeResourceURLs

使用此属性可指定应用程序类装入器(例如,EAR)、Web 模块和共享库装入器是否对资源 URL 中的空格进行编码。如果将此属性设置为 true,那么在 URL 中空格将编码为“%20”,这是 getResource 或 getResources 调用的返回结果。

缺省值为 true 如果此属性设置为 false,那么日志中会显示警告消息 WSVR0333W。此消息表明不推荐将此属性设置为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.classloader.strict

使用此属性以使 WebSphere Application Server 应用程序类装入器能够通过 getResources 调用来访问 META-INF 目录,即使 META-INF 目录路径未包含尾随斜杠也是如此

缺省情况下,除非在 META-INF 目录路径的末尾指定了尾随斜杠,否则 WebSphere Application Server 应用程序类装入器无法通过 getResources 调用来访问 META-INF 目录。如果希望 WebSphere Application Server 应用程序类装入器能够通过 getResources 调用来访问 META-INF 目录(包括未在 META-INF 目录路径的末尾指定尾随斜杠的情况),请将此属性设置为 true

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.classloader.zipFileCacheSize

使用此属性来指定可以处于打开状态以便装入资源和类的应用程序 JAR 文件最大数目。如果减少了必须打开 JAR 文件的次数,那么将提高经常装入资源或类的应用程序的性能。

当达到已打开 JAR 文件数的指定限制时,类装入器将开始关闭并根据访问 JAR 文件的最新时间来移除 JAR 文件。最近访问的 JAR 文件将保持打开状态。对此属性指定的值应该以经常访问的应用程序 JAR 文件的总数为依据。

此属性的缺省值为 8。指定值 0 将禁用高速缓存并阻止应用程序 JAR 文件处于打开状态。

避免故障 避免故障: 避免引起麻烦:如果您对此属性指定非零值,请勿使用 Microsoft Windows 热部署功能。gotcha

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.cscope.HighlyAvailableIORsEnabled

此属性允许管理员配置补偿服务,以便为分布式业务活动 CORBA 对象生成高度可用的 IOR,这些 IOR 将启用在对等恢复期间未能完成的分布式下级业务活动。在 Node Agent 未运行时,此属性还允许新的业务活动。

此属性的缺省值是 false。指定值 true 将启用此属性。应该对集群中的每个应用程序服务器都设置此属性。

com.ibm.ws.el.reuseEvaluationContext

使用此属性来指示可以在每个线程基础中复用同一个 EvaluationContext 对象。

通常情况下,统一 EL 代码将在表达式求值期间为完成的每个调用创建一个新的 org.apache.el.lang.EvaluationContext 对象。因为以后将对这些对象进行垃圾回收,所以当创建的对象数增加时,内存消耗和垃圾回收量也会增加。如果将 com.ibm.ws.el.reuseEvaluationContext 属性设置为 true,那么可以在每个线程中复用同一个 EvaluationContext 对象,从而减少内存消耗和需要进行的垃圾回收数量。

缺省值为 false

com.ibm.ws.http.ConnectionIOTimeout

使用此属性来延长 SOAP 端口在建立连接与从客户机开始传输数据这两个时间之间的超时。缺省值为 5 秒(在 Liberty 上,为 15 秒)。如果 SOAP 服务器或客户机 JVM 很忙,或者 SSL 握手所需时间较长,那么可能需要增大此值。如果发生此超时,那么可能会从 SOAP 服务器接收到 HTTP 408 消息。

[z/OS]

com.ibm.ws.iiop.channel.disableOnewayLocateRequiredMessage

使用此属性来控制当对于某个对象的单向 GIOP 请求需要执行进一步的“向前定位”寻址时,是否显示 CWZGB0005I 消息。如果此属性设置为 false,那么将显示 CWZGB0005I 消息。如果此属性设置为 true,那么不会显示 CWZGB0005I 消息。

缺省值为 false

com.ibm.ws.jsf.allow.interpolator.per.app

JSF 容器已更新为允许定义 MessageInterpolator 且允许将该 MessageInterpolator 用于每个应用程序,并且它不在应用程序之间进行共享。此属性必须设置为 true,才能启用新的行为:

com.ibm.ws.jsf.call.publishevent.with.sourceclass

使用此属性来确保在调用 javax.faces.Application.publishEvent 时使用正确的源类。缺省情况下,调用 javax.faces.Application.publishEvent 时,始终将使用 UIComponent.class,而不使用实际的源类。但是,sourceBaseType 参数应指示源事件,必须使用该源事件来查找必须将此事件发布至的侦听器。如果此参数为空,那么必须使用 source.getClass() 的返回值作为 sourceBaseType。

缺省值为 false

com.ibm.ws.jsp.enhance_el_support

使用此属性来控制表达式的处理方式。在评估表达式期间,会基于 Expression Language Specification V2.1 的 1.8.2 节强制对此值使用预期类型。这种强制可能导致出现非预期结果,因为表达式值可能不是预期类型。请将此属性设置为 true 以阻止这种强制。

缺省值为 false

com.ibm.ws.management.application.task.AppTypeDeploymentTask.isLongRunningApp

列示此属性仅供参考。将自动创建此属性,它用于自动配置,不应该对其进行更改。

缺省值为 true

com.ibm.ws.management.connector.soap.logClientInfo

使用此属性来指示是否要记录 SOAP 客户机请求的主机、端口和用户名。此属性设置为 true 时,将在 SystemOut.log 中记录 SOAP 客户机详细信息。如果 SOAP 连接器的跟踪级别设为 all,那么还会将这些详细信息添加到 trace.log。

缺省值为 false

[Windows]

com.ibm.ws.management.connector.soap.waitBeforeCloseTime

使用此属性来更改对服务器 SOAP 连接超时指定的时间长度。在 Microsoft Windows 操作系统上使用本地主机适配器时,服务器 SOAP 连接超时(缺省为 10 毫秒)允许按顺序不间断传送大量数据。

如果对此属性指定的时间长度太短,那么按顺序传送大量数据时,在连接的服务器端可能发生 SOAPException(表示流提前结束)。

指定值 0 将禁用该超时。

com.ibm.ws.management.event.max_polling_interval

使用此属性来指定服务器在请求或获取来自客户机的通知之前等待的最长时间。缺省轮询时间间隔为 1000 毫秒(1 秒)。如果未指定属性值,那么将使用缺省值。

如果使用 SOAP 或 IPC 连接器,可以使用此属性来调整该连接器,以便服务器等待来自客户机的轮询通知的时间与使用 RMI 连接器时服务器等待的时间间隔匹配。

如果将此属性值设置为 -1,那么客户机将基于内置自适应算法轮询通知,该算法基于客户机接收到的通知数更改轮询时间间隔。在接收到第一个通知之前,两次轮询之间的时间间隔可以是 3 至 20 秒。

对于转换用户 对于转换用户: 在 V8.0 之前,如果没有为 com.ibm.ws.management.event.max_polling_interval 属性指定值,那么客户机将基于内置的自适应算法轮询通知,该算法将根据客户机接收到的通知数来更改轮询时间间隔。trns

必须为客户机端 JVM 指定此属性。

com.ibm.ws.management.event.pull_notification_timeout

使用此属性可指定客户机轮询来自服务器的通知之前等待的时间。缺省超时为 60000 毫秒(60 秒或 1 分钟)。如果未指定属性值,那么将使用缺省值。

如果将该属性值设置为 0(零)或负数(例如,-1),那么即使没有可用通知,服务器也会立即返回给客户机。

对于转换用户 对于转换用户: 在 V8.0 之前,如果没有为 com.ibm.ws.management.event.pull_notification_timeout 属性指定值,那么即使没有可用通知,服务器也会立即返回给客户机。trns

必须为服务器端 JVM 指定此属性。

com.ibm.ws.management.repository.tempFileKeepTimeMinutes

使用此属性来指定在配置库临时目录中保留文件的时间长度(以分钟计),在这段时间过后,配置库临时目录清除任务将可以从该目录中删除该文件。此属性的缺省值是 1440 分钟,即 24 小时。在产品的先前版本中,文件保留 60 分钟。

通常,缺省值足以确保执行所需的清除操作而不会删除使用中的文件。但是,在某些情况下,您可能需要指定更大或更小的值。对于此属性,可以指定的最小值为 60 分钟。但是,建议您指定相当于若干小时的值,以便顾及对非常大的文件进行传输或同步的情况或者由于网络速度较慢而导致文件传输操作相当耗时的情况。在这些情况下,如果指定的时间段过短,那么可能会导致文件在传输完毕前被删除。

如果将 com.ibm.ws.management.repository.tempFileSweepIntervalMinutes 属性设置为 0,那么清除功能将处于禁用状态,任何由于服务器进程发生故障而遗留的文件都将保留在配置库临时目录中,直到您手动地将其移除或者启用清除功能为止。

避免故障 避免故障: 如果对此属性指定的值无效,那么将使用缺省值。gotcha

com.ibm.ws.management.repository.tempFileSweepIntervalMinutes

使用此属性来指定配置库临时目录清除任务的运行频率(以分钟计)。此任务用于从配置库临时目录中移除由于服务器进程发生故障而未能正确移除的文件。

服务器启动时始终会运行清除任务,然后在您对此属性指定的时间长度过后再次运行该任务。此属性的缺省值是 720 分钟,即 12 小时。此时间长度通常足以确保配置库临时目录清除任务成功地完成清除过程。您可以通过将此属性设置为 0 来禁用此清除功能。

在本产品的先前版本中,清除任务在服务器启动时运行,然后每 30 分钟运行一次。

避免故障 避免故障: 如果对此属性指定的值无效,那么将使用缺省值。gotcha

com.ibm.ws.management.suppressPortScan

请将此属性设置为值 true,以防止 Deployment Manager 在创建新的服务器时检查端口活动。当设置为 true 时,在服务器配置中使用新端口之前,Deployment Manager 将不会尝试绑定至或连接至该端口。如果其他应用程序具有活动端口,那么禁止检查端口活动会导致端口冲突。缺省值为 false

com.ibm.ws.management.taskcommandtimeoutsec

如果当执行长时间运行的应用程序更新时,发生来自 TaskCommandSessionMgr 的 SessionTimeoutException,那么将此属性设置为以秒为单位的值。缺省值为 1200 秒(20 分钟)。

com.ibm.ws.odr.plugincfg.config.ASDisableNagle

使用此属性可指定是否要为插件和代理服务器之间的连接禁用 Nagle 算法。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值为 false,这表示为插件和代理服务器之间的连接启用 Nagle 算法。

com.ibm.ws.odr.plugincfg.config.AcceptAllContent

使用此属性可指定当请求头中包含 Content-Length 或 Transfer-encoding 头时,是否可以在 POST、PUT、GET 和 HEAD 请求中包括内容。您可以为此属性指定下列某个值:
  • true:所有请求都需要内容并且要读取内容。
  • false:仅 POST 和 PUT 请求需要内容并且要读取内容。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.config.AppServerPortPreference

使用此属性可指定用于为 sendRedirect 构建 URI 的端口号。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值是 HostHeader

com.ibm.ws.odr.plugincfg.config.ChunkedResponse

使用此属性可指定当响应中出现“ Transfer-Encoding : Chunked”响应头时,插件是否会将发送到客户机的响应分组。

您可以为此属性指定下列某个值:
  • true:当响应中出现“Transfer-Encoding : Chunked”响应头时,插件会将发送到客户机的响应分块。
  • false:不对响应分块。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.config.IISDisableNagle

使用此属性可指定是否要禁用 Nagle 算法。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.config.IISPluginPriority

使用此属性可指定 Web 服务器装入插件的优先级。您可以为此属性指定下列某个值:

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值是

com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures

使用此属性可指定插件在启动时是否要忽略配置中的 DNS 故障。

将此属性设置为 true 时,如果每个 ServerCluster 中至少有一个服务器可解析主机名,那么插件将忽略配置中的 DNS 故障并成功启动。主机名无法解析的所有服务器在配置生存期内均标记为“不可用”。在以后路由请求期间不会再解析主机名。如果发生 DNS 故障,那么系统会向插件日志文件写入一条日志消息,并且插件将继续初始化,而不是 Web 服务器不启动。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.config.RefreshInterval

使用此属性可指定插件应检查配置文件有无更新或更改的频率(以秒计)。插件会检查自装入插件配置以来,该文件是否发生过任何修改。

在开发环境中会频繁发生更改,请将该时间间隔设置为小于 60 秒。

在生产环境中,应设置高于缺省值的一个值,因为不会频繁发生对配置的更新。

如果插件重新装入未成功,那么插件日志文件将包含一条错误消息,并且在成功重新装入插件配置文件之间,将使用先前配置。如果发生错误,请参阅插件日志文件,以获取更多信息。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值是 60

com.ibm.ws.odr.plugincfg.config.ResponseChunkSize

使用此属性可指定当读取响应主体时插件应使用的最大块大小(以千字节计)。例如,Config ResponseChunkSize="N",其中 N 等于块大小。

缺省情况下,插件以 64k 大小的块读取响应主体,直到读完所有响应数据为止。如果响应主体包含大量数据,那么此过程可能影响请求的性能。如果响应主体的内容长度未知,那么会分配大小为 N 千字节的缓冲区,并且会以 N 千字节大小的块读取主体,直到读完整个主体为止。如果内容长度已知,那么会使用大小为内容长度或 N 的缓冲区来读取响应主体。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值是 64

com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat

使用此属性可指定插件是否应使用端口号进行虚拟主机匹配。可以指定以下值:
  • true:通过使用接收到请求的端口号进行物理匹配。
  • false:通过使用在主机头中包含的端口号进行逻辑匹配。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.config.TrustedProxyEnable

使用此属性可指定插件是否允许包括可信代理。可以指定以下值:
  • true:您希望允许包括可信代理。
  • false:您不希望允许包括可信代理。

可信代理是通过定义的可信安全代理收集的。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Config 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.log.Name

使用此属性可指定插件用于写入错误消息的日志文件的标准路径。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Log 元素。

缺省值是 profileRoot/logs/http_plugin.log

com.ibm.ws.odr.plugincfg.log.LogLevel

使用此属性可指定插件向日志写入的日志消息的详细级别。您可以为此属性指定下列某个值:
  • 跟踪。详细记录请求过程中的所有步骤。
  • 统计信息。记录为每个请求选择的服务器和与请求处理相关的其他负载均衡信息。
  • 警告。记录异常请求处理产生的警告和错误消息。
  • 错误。仅记录异常请求处理产生的错误消息。
  • 调试。记录处理请求时执行的所有关键步骤。
  • 详细信息。记录关于请求和响应的所有信息。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Log 元素。

缺省值是错误

避免故障 避免故障: 在跟踪级别会记录大量消息,这可能导致文件系统很快被填满。决不能在正常运行的环境中使用跟踪设置,因为它会对性能造成负面影响。gotcha

com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange

使用此属性可向插件指示可以使用加号字符 (+) 作为克隆分隔符。

某些普及型设备无法处理用于分隔具有会话亲缘关系的克隆标识的冒号字符 (:)。

避免故障 避免故障: 如果使用此定制属性,那么必须更改代理服务器配置,以便代理服务器不使用冒号字符而改用加号字符来分隔克隆标识。gotcha

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 ServerCluster 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.cluster.LoadBalance

使用此属性可指定适当的负载均衡选项:循环法随机.

循环法实现具有随机起始点。第一个代理服务器是随机检取的。然后,使用循环法从该点向前捡取代理服务器。此实现可确保在基于多进程的 Web 服务器中,并非所有进程都通过将第一个请求发送到同一代理服务器来启动。

随机实现也具有一个随机起始点。但是,对于此实现,所有后续代理服务器也是随机选择的。因此,可能重复选择了同一代理服务器,而其他代理服务器则保持空闲状态。

缺省值是循环法

com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit

使用此属性可指定插件允许尝试发送给服务器的请求内容的最大字节数(以字节计)。如果接收到的请求大于指定值,那么插件会结束该请求。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 ServerCluster 元素。

缺省值是 -1,这表示不限制请求大小。

com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders

使用此属性可指示插件在将请求转发给服务器之前是否向请求添加特殊头。这些头存储关于应用程序将要使用的请求的信息。缺省情况下,插件在添加所需头时,会从入局请求中移除这些头。

如果将此属性设置为 false,那么会从未移除的入局请求中引入潜在的安全隐患头。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 ServerCluster 元素。

缺省值为 true

com.ibm.ws.odr.plugincfg.cluster.RetryInterval

使用此属性可指定在代理服务器标记为关闭和插件重新尝试进行连接之间经过的时间(以秒计)。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 ServerCluster 元素。

缺省值是 60

com.ibm.ws.odr.plugincfg.odrIncludeStopped

使用此属性可指定插件是否允许包括已停止的代理服务器。可以指定以下值:
  • true:您希望允许包括已停止的代理服务器。
  • false:您不希望允许包括已停止的代理服务器。

此属性仅对于代理服务器有效。

缺省值为 false

com.ibm.ws.odr.plugincfg.server.ConnectTimeout

使用此属性可指定插件等待成功连接的时间(以秒计)。

对此属性指定值将使插件能够执行与代理服务器的非阻塞连接。当插件无法联系目标以确定端口是否可用时,此类连接是有益的。

如果指定的值大于 0,并且在经过该时间间隔后未发生连接,那么插件会将代理服务器标记为不可用,并使用集群中定义的其他一个代理服务器继续处理。

如果没有为此属性指定值,那么插件将执行阻塞连接,在此连接中插件会一直等待,直到操作系统超时并允许插件将代理服务器标记为不可用。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Server 元素。

缺省值是 0

com.ibm.ws.odr.plugincfg.server.ExtendedHandShake

使用此属性可向插件指示在向代理服务器发送请求之前它必须确保该代理服务器的可用性。

通常,当 connect() 结束时,插件会将代理服务器标记为已停止。但是,当插件和代理服务器之间存在代理防火墙时,即使后端代理服务器已停止,connect() 也会成功。此情形会导致插件无法正确地故障转移到其他代理服务器。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Server 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.server.MaxConnections

使用此属性可指定在任意时间点可流经 Web 服务器进程的代理服务器暂挂连接的最大数量。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Server 元素。

缺省值是 -1,这表示对于在任意时间点可流经 Web 服务器进程的代理服务器暂挂连接的数量,没有最大数量。

com.ibm.ws.odr.plugincfg.cluster.WaitForContinue

使用此属性可指定在向代理服务器发送请求内容之前,是否使用 HTTP 1.1“100 Continue”支持。

通常,插件在发送请求内容之前,不会等待来自代理服务器的“100 Continue”响应。将插件配置为与特定类型的代理防火墙配合使用时,应使用 HTTP 1.1“100 Continue”支持。

对于 POST 请求会忽略此属性,以防止当代理服务器由于超时而关闭连接时发生故障。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Server 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.property.ESIEnable

使用此属性可启用或禁用 Edge Side Include (ESI) 处理器。如果禁用了 ESI 处理器,那么将忽略文件中的其他 ESI 元素。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Property 元素。

缺省值为 true

com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize

使用此属性来指定高速缓存的最大大小(以 1 KB 为单位)。高速缓存的缺省最大大小为 1024 KB(也就是 1 兆字节)。如果高速缓存已满,那么要从高速缓存逐出的第一个条目是最接近其截止时间的条目。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Property 元素。

缺省值是 1024

com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor

使用此属性可指定 ESI 处理器是否从代理服务器接收失效通知。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Property 元素。

缺省值为 false

com.ibm.ws.odr.plugincfg.property.https.keyring

使用此属性可指定当传输协议设置为 HTTPS 时,SAF 密钥环的目录位置。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Property 元素。

缺省值是 profileRoot/etc/plugin-key.kdb

com.ibm.ws.odr.plugincfg.property.https.stashfile

使用此属性可指定隐藏文件的位置。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Property 元素。

缺省值是 profileRoot/node/etc/plugin-key.sth

com.ibm.ws.odr.plugincfg.property.PluginInstallRoot

使用此属性可指定插件的安装路径。

必须将此属性设置为插件安装根目录的标准路径。如果使用缺省值,那么在 plugin-cfg.xml 文件中将不显示该属性。

此属性仅对代理服务器有效,且适用于代理服务器自动生成的 plugin-cfg.xml 文件中的 Property 元素。

缺省值是 ""

com.ibm.ws.pm.checkingDBconnection

使用此属性来指定,持久性管理器是否继续检查先前被标记为不可用的数据库的可用性并一直持续到成功地与该数据库建立连接为止。

如果数据库服务在持久性管理器尝试与该数据库建立连接时关闭,那么该数据库将被标记为不可用。通常,持久性管理器不会在数据库被标记为不可用之后再次尝试建立连接。如果将此属性设置为 true,那么持久性管理器将继续检查数据库的可用性,直到它能够成功地与该数据库建立连接为止。

缺省值为 false

com.ibm.ws.policyset.exportEncodedPasswords

将该属性设置为 true,以使包含已加密的密码的 WS-Security 策略集绑定能够改为使用 XOR 编码密码导出。

有效值为 truefalse

缺省值为 false

com.ibm.ws.recoverylog.disableNonHARegistration

如果应用程序服务器不是启用了事务日志恢复故障转移的集群的成员,那么恢复日志服务无需向 HA 管理器注册。

但是,如果稍后启用了故障转移,并且仅部分集群重新启动,请将此定制属性设置为 true,以便恢复日志服务不会向 HA 管理器注册。

有效值为 truefalse

缺省值为 false

com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles

使用此属性,在事务日志相对于应用程序服务器为本地日志的情况下,可提高事务日志文件的内存映射的性能。

但是,如果在远程文件系统上定义了事务日志(这在启用高可用性 (HA) 支持的情况下普遍存在),那么可忽略任何提高的性能。此外,日志处理更为复杂。由于存在此复杂性,应该在 HA 环境内存中,禁用事务日志的映射。

要禁用内存映射文件,请在访问恢复日志文件的任何服务器上将 JVM 定制属性 com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles 设置为 true。缺省值为 false
切记: 缺省情况下,在 HA 环境中,在 z/OS 操作系统和 Windows 操作系统上已禁用事务日志的内存映射。

com.ibm.ws.runtime.component.ResourceMgr.postBindNotify

使用此属性来使连接工厂 MBean 在资源适配器启动时可用。通常情况下,当资源适配器启动时,没有任何连接工厂 MBean 可以供资源适配器进行查询。但是,某些资源适配器(例如,IMS™ DB 资源适配器)需要此功能进行初始化。

如果您使用的资源适配器不要求初始化时连接工厂 MBean 可用,请将此属性添加到 JVM 设置并将值设为 false

缺省值为 true

com.ibm.ws.runtime.dumpShutdown

在一些不同情况中,在服务器关闭期间线程转储很有用。以下是一些示例
  • 因为 Node Agent 停止了挂起的服务器,所以服务器关闭。
  • 当通过在服务器中运行的应用程序代码调用了 System.exit() 时,服务器关闭。
  • 偶发服务器关闭。
com.ibm.ws.runtime.dumpShutdown diagnostic 定制属性允许您在服务器关闭期间触发 Java 核心线程。如果要在服务器关闭期间触发 Java 核心线程,请将此属性设置为 true缺省值为 false

[AIX][Windows][Linux][z/OS]对于使用 IBM 软件开发工具包的平台(AIX、Windows、Linux 和 z/OS),将在应用程序服务器的工作目录中生成 Java 核心线程转储。

[Solaris][HP-UX]对于其他平台(Solaris 和 HP-UX),Java 核心线程转储将写入到应用程序服务器的 native_stdout.log 文件中。

除 Java 核心线程转储外,还会在应用程序服务器的 SystemErr.log 文件中记录处理关闭操作的当前线程的堆栈跟踪。

[AIX Solaris HP-UX Linux Windows][IBM i]

com.ibm.ws.runtime.logThreadPoolGrowth

允许增长的线程池被配置为最大大小,但允许增长至超过此最大大小。但是,在缺省情况下,不会发出任何消息来指示超过最大大小。

如果希望允许增长的线程池增长至超过其已配置最大大小时服务器向日志文件发送消息,请将此属性设置为 true

com.ibm.ws.scripting.apptimeout

使用此属性来指定应用程序安装或更新操作发生超时前可以耗用的时间(以秒计)。缺省值是 86400,即 24 小时。

通过对此属性指定合理的值,可以防止安装或更新过程在发生导致安装或更新脚本无法完成的情况时无限期继续。例如,用于更新 EAR 文件的 JACL 脚本可能会由于该脚本所连接到的 Deployment Manager 停止而无法完成。

com.ibm.ws.sib.webservices.useSOAPJMSTextMessages

缺省情况下,在 WebSphere Application Server V6 或更高版本上,Web Service 网关所发送的 SOAP over JMS Web Service 消息将作为 JmsBytesMessage 发送。

将此属性设置为 true 可修改缺省行为并发送兼容的 JmsTextMessage。设置此属性将修改所有从服务集成总线发送的出站 JMS Web Service 调用的缺省行为。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.soap.handleRST

如果您希望 Web 服务器能够识别读取 SOAP 消息的时间,并将 RequestSecurityToken (RST) 元素视为 FIN 消息类型,请使用此属性。

在某些情况下,当连接复位时,Web 服务器将在禁用安全性的情况下启动。但是,因为接收到 RST,而不是正常 FIN/文件结束,所以管理控制台中会出现一条错误消息,指出 Web 服务器未能启动,即使 Web 服务器确实已启动并且在运行。刷新 Web 服务器控制台页面会显示正确的运行状态。

如果您将 com.ibm.ws.soap.handleRST 定制属性设置为 true,那么读取了完整 SOAP 消息时,Web 服务器将识别,并将 RST 视为 FIN,并且在接收到 RST 时您将不会接收到错误消息。

com.ibm.ws.use602RequiredAttrCompatibility

使用 com.ibm.ws.use602RequiredAttrCompatibility 定制属性来指定 <required> 属性是否在 cachespec.xml 文件中的其他属性之前进行求值。

在 V6.0.2 中,如果您将 <required> 属性设置为 false,那么 cachespec.xml 文件中的所有其他属性都将被忽略,并且会生成高速缓存标识。

对于转换用户 对于转换用户: 在比 V6.0.2 更高的版本中,缺省情况下,<required> 属性将与所有其他属性一起进行求值,以确定是否生成了高速缓存标识。trns
注: 如果将 com.ibm.ws.use602RequiredAttrCompatibility 定制属性设置为 true,那么 cachespec.xml 文件的行为将恢复为 V6.0.2 中的行为。<required> 属性将在 cachespec.xml 文件中的其他属性之前进行求值。缺省值为 false. 设置这个仅应用于应用程序服务器级别的 JVM 定制属性后,它将影响所有动态高速缓存用户。

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webcontainer.allowDefaultErrorPage

如果 web.xml 文件中包含遵从 Servlet 3.0 规范的错误页定义,那么使用此属性。Servlet 3.0 规范指出只有 <location> 参数是必需参数。<error-code> 和 <exception-type> 参数是可选参数。但是,如果您不将此属性添加至 JVM 设置,并将此属性设置为 true,那么会忽略只是使用 <location> 参数定义的错误页。

缺省值为 false

如果您使用此属性,那么必须在应用程序服务器级别设置此属性。

com.ibm.ws.webservices.allowNoSOAPActionHeader

使用此属性以使 Web Service 引擎容许包含 SOAPAction 头的入局 Web Service 请求。必须在应用程序服务器级别设置此属性。

SOAP 规范表明,如果在相应的 WSDL 描述中,soapbind:operation 的 soapAction 不存在,或者存在但其值为空字符串,那么 HTTP 请求消息必须包含一个其值为用引号引起的空字符串的 SOAPAction HTTP 头字段。然而,如果您希望 Web Service 引擎处理不包含 SOAPACTION 头的请求,请将此属性添加到应用程序服务器设置中并将其设为 true

未指定此属性或者未将其设置为 true 时,如果入局 SOAP 请求消息不包含 SOAPAction 头,那么将对客户机返回 SOAP 故障

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.allowStatusCode202OneWay

使用此属性可允许 JAX-RPC 单向服务不发送 200 状态码而改为发送 202 状态码。

部署在 WebSphere Application Server 上的 JAX-RPC 单向服务通常会返回 HTTP 状态码 200。某些 JAX-RPC 实现不容许状态码 200,而希望改为状态码 202。根据 Basic Profile V1.1,200 和202 都是单向服务的有效状态码。

如果该属性设置为 true,那么 JAX-RPC 单向服务将返回 202 状态码。

缺省值为 false

此属性仅适用应用程序服务器 JVM。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.appendRootCauseToWSF

如果您是 JAX-RPC 用户,请使用此属性指定是否希望在响应返回的异常的“故障”详细信息中包含有关原始异常的信息

通常,在响应返回的异常的“故障”详细信息中仅包含有关最近异常的信息。该信息不包含有关原始异常的信息(原始异常通常不是最近的异常)。“故障”详细信息在响应中返回之前,一个异常经常会触发其他异常。如果最终用户无权访问来自服务提供程序的日志,那么这种不一致会增加最终用户确定问题的难度。

如果最终用户需要能够看到与问题关联的所有异常的异常详细信息,那么应为服务提供程序的应用程序服务器上的 JVM 将此定制属性设置为 true。当在服务提供程序的应用程序服务器上将此定制属性设置为 true 时,应用程序服务器会循环检查所有异常原因,并将每个属性的详细信息连接并放入在响应中返回的“故障”详细信息中。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器的 JVM 定制属性。

[z/OS]

com.ibm.ws.webservices.cacheEngineList

在使用 JAX-RPC Web Service 的 WebSphere Application Server for z/OS 配置中,使用此属性来禁用客户机 Web Service 引擎高速缓存。

如果某个应用程序重新启动了多次,那么客户机引擎高速缓存可能会填满本地系统存储器,从而导致“内存不足”错误。当此属性设置为 true 时,便启用了引擎高速缓存。当发生此“内存不足”错误时,请将此属性设置为 false 以禁用引擎高速缓存。

缺省值为 true

com.ibm.ws.webservices.contentTransferEncoding

使用此属性来指定要对其禁用 .XML 编码的位范围。通常,任何大于 127 的整数都将进行 XML 编码。如果指定了此属性:
  • Web Service 将对所指定范围内的整数禁用编码。
  • HTTP 传输消息包含 ContentTransferEncoding 头,该头设置为您对此定制属性指定的值。

如果您只想对大于 127 的整数进行编码,请指定 7bit。如果要对大于 255 的整数进行编码,请指定 8bit。如果要对所有整数禁用编码,请指定 binary

缺省值是 7bit

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.disableSOAPElementLazyParse

使用此属性来禁止对 SOAPElement 进行延迟解析。延迟解析针对客户机未解析 SOAPElement 的情况而设计。如果客户机正在使用 SAAJ 来解析 SOAPElement,那么最好不要让 Web Service 组件进行延迟解析。

您可以在服务器级别或客户机级别将此属性设置为 JVM 定制属性。在服务器级别或客户机级别设置此属性后,此设置将应用于 JVM 中的所有应用程序。缺省值为 false

如果要对特定服务器逐个应用程序地禁止对 SOAPElement 进行延迟解析,而不是对 Deployment Manager 所管理的所有服务器进行此禁用,那么还可以使用应用程序组装工具将此属性指定为端口组件绑定的新 Web Service 描述绑定条目。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.engine.transport.jms.propagateOneWaySystemExceptions

使用此属性以便能够将处理单向 JMS Web Service 期间发生的异常传播回 EJB 容器。此传播使常规错误恢复成为可能。

如果此属性设置为 false,那么异常将包装在 WebServicesFault 消息中并传送回客户机。因为 Web Service 不知道该异常,所以不会尝试进行恢复。

缺省值为 false

避免故障 避免故障: 此属性不适用于单向 HTTP Web Service,也不适应于双向 JMS 请求。gotcha

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.forceLegacyDispatchFromSOAPConnection

使用此属性来指定 JAX-RPC 引擎(而不是 JAX-WS 引擎)将用来为 SOAP with Attachments API for Java (SAAJ) 客户机处理外发请求。

此属性不适用于使用 JAX-RPC 或 JAX-WS API 来调用 Web Service 的 Web Service 客户机。当使用 JAX-WS 引擎来处理客户机请求时,结果可能与使用 JAX-RPC 引擎时的结果不同。例如,某些 SAAJ 客户机使用 SAAJ API 将 SOAPAction 头设置为 MIME 头。当使用 JAX-RPC 引擎来处理此类请求时,将在请求中发送此 SOAPAction 头及其用户设置的值。但是,如果使用 JAX-WS 引擎来处理同一请求,那么将在请求中发送空 SOAPAction 头。如果您习惯使用 JAX-RPC 引擎来处理 SAAJ 客户机请求并希望保留此行为,请将此属性添加至 JVM 设置并将其设为 true

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.HttpRedirectWithProxy

将此属性设置为 true 可允许 HTTP 将请求重定向为通过代理服务器发送。将此属性设置为 true 后,可更改通过 JAX-RPC 运行时发送的所有出站 HTTP 重定向请求的缺省行为。将此属性设置为 false 后,即使配置了代理服务器,也会重定向请求直接发送至远程服务器。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为代理服务器 JVM 定制属性。

com.ibm.ws.webservices.ignoreUnknownElements

使用此属性来控制客户机能否忽略文字 SOAP 操作响应有时包含的额外 XML 元素。

将此属性设置为 true 使您能够灵活地更新服务器代码以包括更多响应信息,而不必立即更新客户机代码以处理此附加信息。但是,启用此功能后,根据期望的消息结构检查 SOAP 消息要比此属性设置为 false 时的情况宽松。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.jaxrpc.parse.tolerate.invalid.namespace

使用此属性使 JAX-RPC 引擎在确定是否接受入局 JAX-RPC 消息时能够使用更宽松的算法。

通常,如果入局 JAX-RPC 消息将无效的名称空间用于某个主体元素,那么 JAX-RPC 引擎将拒绝该消息。如果将此属性设置为 true,那么 JAX-RPC 引擎将使用更宽松的算法以忽略名称空间不匹配情况。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.resolveXMLSchemaDTD

使用此定制属性将使 JAX-RPC 应用程序能够正常启动,即使 _AbsoluteImportResolver 类中指定的模式或 WSDL 文件也引用 http://www.w3.org/2001/XMLSchema.dtd DTD 亦如此。

在未连接到因特网的主机上运行时,使用 _AbsoluteImportResolver 类打包的 JAX-RPC 应用程序可能无法正常启动。日志文件可能包含以下错误:
WSDDPort      W com.ibm.ws.webservices.engine.deployment.wsdd.WSDDPort expand 
WSWS3114E: Error: Internal error.
java.net.UnknownHostException: www.w3.org

如果将此定制属性设置为 true,那么将使 JAX-RPC 应用程序 能够正常启动,即使 _AbsoluteImportResolver 类中指定的模式或 WSDL 文件也引用 http://www.w3.org/2001/XMLSchema.dtd DTD 亦如此。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.searchForAppServer

使用此属性来控制是否将 DualMetaDataLoaderImpl E loadWebContainerPorts could not find any http or https ports 消息发送到系统日志中。

根据系统配置不同,如果 Web Service 应用程序同时安装在 Web 服务器和应用程序服务器上,那么系统可能会发出此消息以表明发生错误,即使此配置有效。因此,如果将任何 Web Service 应用程序同时安装在 Web 服务器和应用程序服务器上,那么您可能不想将这些消息发送到系统日志中。

如果将 com.ibm.ws.webservices.searchForAppServer 属性设置为 true,那么不会将发出的任何 DualMetaDataLoaderImpl E loadWebContainerPorts could not find any http or https ports 消息发送到系统日志中。如果未指定此属性或者将其设为 false,那么这些消息将发送到系统日志。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.serialize.2DimArray.asArrays

使用此属性可使 JAX-RPC 运行时将二维 XML 数组序列化为一系列数组。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

缺省值为 false

以下消息片段说明了一系列元素,这是代表二维 XML 数组的有效格式(此时,此属性设置为 false)。

<p565:sayHelloResponse xmlns:p565="http://ibm.com">
    <sayHelloReturn xsi:type="soapenc:Array" 
soapenc:arrayType="xsd:string[2,3]">
      <item xsi:type="xsd:string">array1 element1</item>
      <item xsi:type="xsd:string">array1 element2</item>
      <item xsi:type="xsd:string">array1 element3</item>
      <item xsi:type="xsd:string">array2 element1</item>
      <item xsi:type="xsd:string">array2 element2</item>
      <item xsi:type="xsd:string">array2 element3</item>
    </sayHelloReturn>
  </p565:sayHelloResponse>

以下消息片段说明了一个包含两个数组的数组,其中每个数组包含三个元素,这是代表二维 XML 数组的有效格式(此时,此属性设置为 true)。

<p565:sayHelloResponse xmlns:p565="http://ibm.com">
    <sayHelloReturn xsi:type="soapenc:Array" 
soapenc:arrayType="xsd:string[][2]">
      <item soapenc:arrayType="xsd:string[3]">
         <item>array1 element1</item>
         <item>array1 element2</item>
         <item>array1 element3</item>
      </item>
      <item soapenc:arrayType="xsd:string[3]">
         <item>array2 element1</item>
         <item>array2 element2</item>
         <item>array2 element3</item>
      </item>
    </sayHelloReturn>
  </p565:sayHelloResponse>

com.ibm.ws.webservices.serializeDetailElementUsingDefaultNamespace

使用此属性来指定应用程序服务器是使用实际前缀名称来查找用于定义“故障”详细信息的名称空间还是使用缺省名称空间来定义“故障”详细信息。

JAX-RPC Web Service 响应 SOAP 故障时,通常会使用实际前缀名称来查找定义故障详细信息内容的名称空间。以下是应用程序服务器通常在此情况下发出的消息的示例:

<soapenv:Fault                                      
      xmlns:soapenv=
      "http://schemas.xmlsoap.org/soap/envelope/">      
  <faultcode xmlns="http://sample">       
     sampleFault                          
  </faultcode>                                              
  <faultstring>sample text</faultstring>                      
  <detail encodingStyle="">                                
    <sampleFault                        
      xmlns="http://sample"> 
      ...
    </sampleFault>
  </detail>
<soapenv:Fault>   

如果应用程序服务器需要与 .Net 客户机通信,并且这些 .Net 客户机需要使用缺省名称空间来定义故障详细信息的内容,请将此属性设置为 true。当此属性设置为 true 时,应用程序服务器发出的消息与从 V6.x 之前的版本的应用程序服务器中发出的消息类似。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.webservices.suppressHTTPRequestPortSuffix

使用此属性来控制是否可以在发送 SOAP 消息的 HTTP POST 请求中保留端口号。

某些 Web Service 实现无法适当地容许发送 SOAP 消息的 HTTP POST 请求中存在端口号。如果 Web Service 客户机需要与 Web Service 进行互操作,但是该 Web Service 无法容许发送 SOAP 消息的 HTTP POST 请求中存在端口号,那么将此定制属性设置为 true

将此属性设置为 true 后,将从 HTTP POST 请求中移除端口号,然后再发送该请求。

避免故障 避免故障: 必须重新启动服务器才能使此配置设置生效。gotcha

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.websvcs.attachments.sizethreshold

使用此属性来指定 JAX-WS 客户机或服务上可以写入内存的附件的最大大小(以字节计)。缺省情况下,最大附件大小设置为 11 MB。使用此值时,如果附件超过 11 MB,那么会将它高速缓存到文件系统,而不是将它写入内存。使用此定制属性时,随着您将最大高速缓存大小增大,对性能的影响以及对 Java 堆的可能影响也会更大。

注: 要指定 JAX-RPC 客户机或服务上附件的最大大小,请参阅 com.ibm.websphere.webservices.attachements.maxMemCacheSize 定制属性。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.websvcs.getJAXBContext.cacheClassList

使用此属性对包中所包含的 Java XML 绑定体系结构 (JAXB) 类的列表进行高速缓存。

通常,当构建 JAXBContext 时,如果包中不包含 ObjectFactory 或 package-info 类文件,那么会搜索包中所有可能的 JAXB 类。此搜索过程会很耗时,且会由于 JAR 文件锁定而延迟。将此属性设置为 true,以对每个包的类列表进行高速缓存,以后就不需要搜索同一个包。稍后,JAXBContext 创建操作会请求检索高速缓存中的类列表版本,而不是启动新的搜索。

因为类列表高速缓存是使用 SoftReference 创建的,所以在可用内存太少时可以释放高速缓存。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.websvcs.getJAXBContext.cacheClassList.persist

使用此属性来创建包中所包含的 Java XML 绑定体系结构 (JAXB) 类的磁盘高速缓存。

通常,当构建 JAXBContext 时,如果包中不包含 ObjectFactory 或 package-info 类文件,那么会搜索包中所有可能的 JAXB 类。此搜索过程会很耗时,且会由于 JAR 文件锁定而延迟。将此属性设置为 true,以创建每个包的类列表的磁盘高速缓存,以后就不需要搜索同一个包。稍后,JAXBContext 创建操作会请求检索高速缓存中的类列表版本,而不是启动新的搜索。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.websvcs.logOperationExceptionAsDebug

SOAP 故障异常始终通过 log.error 写入,后者将写入 SystemOut.log 和 Trace.log。使用此属性来确保启用跟踪时 SOAP 故障异常仅记录到 Trace.log,而不记录到 SystemOut.log。此属性不会区分 SystemOut.log 中记录的 SOAP 故障异常的类型。

注: 当 Web Service 跟踪开启并且 com.ibm.ws.websvcs.logOperationExceptionAsDebug=true 时,SOAP 故障异常仅显示在 Trace.log 中。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.websvcs.suppressHTTPRequestPortSuffix

使用此属性以阻止 JAX-WS 运行时将端口号追加到请求的 HTTP Host 头值中。

JAX-WS 客户机可能会在响应某个请求时接收到 java.io.IOException,尤其是在该客户机与它正在尝试调用的 Web Service 之间存在非 IBM 的 Web 服务器时。因为 JAX-WS 运行时已将端口号追加到 HTTP Host 头值中,所以此中间服务器可能不知道要将该请求路由到何处。例如,JAX-WS 运行时可能已将头值从端点 URL lilygirl.austin.mycompany.com 更改为 URL lilygirl.austin.mycompany.com:80,此 URL 包含端口号。

要阻止 JAX-WS 运行时将端口号追加到 HTTP Host 头值中,请将此定制属性添加到 JVM 设置中并将其设为 true。当此属性设置为 true 时,Host 头仅包含端点 URL 的主机名;例如,Host: lilygirl.austin.mycompany.com

此属性的缺省值是 false,这表示端口号将追加到 Host 头值中。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.websvcs.transport.enableProxyTunnel

将此属性设置为 true 可使 Web Service 客户机能够通过 Web 代理服务器访问资源。此属性的缺省设置是 false,这表示在代理的 Web Service 传输层中不使用隧道传送。
示例: 如果保留缺省设置 false,对于尝试通过 HTTPS 调用远程 Web Service 的 JAX-WS Web Service 客户机,如果该调用通过配置为转发代理的 HTTP Server 定向,那么该客户机将发生异常。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为代理服务器 JVM 定制属性。

com.ibm.ws.websvcs.relaxClientPolsetMatching

使用此属性可允许在客户机代码跨多个归档文件时,通过管理控制台在服务级别或较低级别应用 JAX-WS 客户机端策略集。

缺省值为 false

com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse

使用此属性可指定是否将 JMS 策略集基本授权用户标识和密码应用于 JMS 响应消息。缺省情况下,不会对 JMS 响应消息应用 JMS 策略集基本授权用户标识和密码。

如果您将此属性添加到 JVM 设置,并指定 true 作为此属性的值,那么将对 JMS 响应消息应用 JMS 策略集基本授权用户标识和密码。如果此属性设置为 false,那么将不会应用用户标识和密码。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.websvcs.unifyServiceMessage

将此属性设置为 true,以便在浏览器中输入服务 URL 时,JAX-WS 应用程序在浏览器窗口中显示 JAX-RPC 消息“您好,这是 Web Service!”,而不是显示特定于 JAX-WS 的消息“您好,这是 Axis2 Web Service!”。

缺省值为 false

com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri

您可以希望将非受管 JAX-WS 客户机服务所发出的请求发送到管理控制台上被覆盖的端点 URL 字段中指定的端点 URL。此受管字段的值在 Web Service 客户端口配置中进行设置,它将覆盖 WSDL 文件中指定的端点。有关此字段的更多信息,请参阅“Web Service 客户机端口”。

避免故障 避免故障: 如果您只使用受管客户机或者同时使用受管客户机和非受管客户机,那么可以在管理控制台中编辑被覆盖的端点 URL 字段。但是,如果您没有任何受管客户机,那么无法编辑此字段。gotcha

通常,您不希望非受管 JAX-WS 客户机服务访问此受管客户机服务功能。但是,您可能依赖于访问此 URL 的非受管 JAX-WS 客户机服务。缺省情况下,com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri 定制属性设置为 false,以便允许非受管 JAX-WS 客户机服务访问覆盖了 WSDL 文件中的端点的端点 URL。

请在 JAX-WS 客户机所安装在的应用程序服务器级别或者 Java EE 客户机所在的应用程序服务器级别(如果您运行 launchClient)设置此定制属性。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.ws.wsba.protocolmessages.twoway

使用此属性来提高正在处理 Web Service 业务活动 (WS-BA) 请求的应用程序服务器的性能。对此定制属性指定 true 将提高在两个应用程序服务器之间发送 WS-BA 协议消息时的应用程序服务器性能。缺省值为 true

避免故障 避免故障: 如果您决定使用此定制属性,那么必须对发起这些请求的应用程序服务器设置此属性。不必对接收这些请求的应用程序服务器设置此属性。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

gotcha
[z/OS]

com.ibm.ws390.SystemOutErrCodepage

使用此定制属性可指定使用 System.out 和 System.err 发出的消息的编码模式为使用 println、print 和 write 方法,而不使用 EBCDIC。如果未指定编码模式,那么将为这些消息使用缺省编码模式 EBCDIC。

为此属性指定的值必须为字符串格式。

如果您决定使用此定制属性,那么必须将其指定为服务方的 JVM 定制属性。

com.ibm.wsspi.amm.merge.ignoreValidationExceptions

使用此定制属性可指示 JVM 应忽略在 EJB 处理期间可能出现的验证异常。当在 EJB 处理期间将应用程序配置为带有在共享库中定义的必需类时,可能生成不完整的信息。因此,可能发生验证异常,并且可能出现以下异常消息:
AnnotativeMetadataManagerImpl merge caught exception while merging com.ibm.wsspi.amm.validate.ValidationException: 
the interface com.xyz.app.myappRemote does not define a
valid remote business interface; the method mygetMethod does not
conform to RMI rules.

如果希望 JVM 忽略验证异常,请将此属性设置为 true

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器的 JVM 定制属性。

com.ibm.wsspi.wssecurity.dsig.enableEnvelopedSignatureProperty

使用此定制属性向 JVM 指示您希望 WS-Security 运行时采用它在 V7.0.0.21 和更低版本以及 V8.0.0.3 和更低版本中采用的相同方式来验证 XML 数字签名。

避免故障 避免故障: 仅当您所在环境中存在一个具有不同修订包级别的应用程序服务器的单元,并且您遇到兼容性问题时,才应将此属性设置为 truegotcha
在 V7.0.0.21 和更低版本以及 V8.0.0.3 和更低版本中,当 WS-Security 验证一个使用 http://www.w3.org/2000/09/xmldsig#enveloped-signature 变换算法的 XML 数字签名,并且已签名的元素存在具有名称空间前缀的属性时,可能会产生与以下错误消息相似的 Digest value mismatch 错误消息:
SAML Assertion signature is verified.Core validity=false
Signed info validity=true Signed info
message='null'(validity=false message='Digest value mismatch:
calculated: KCuNwlUAk5+G2PYb8fZ+Y1hTMtw='
uri='#Assertion-1234' type='null')

如果要签名的元素包含一个具有名称空间前缀的属性,那么要在 WS-Security 运行时将此元素规范化之后才会计算摘要值。

在此版本的产品、V7.0.0.23 和更高版本以及 V8.0.0.4 和更高版本中,WS-Security 运行时将正确处理具有名称空间前缀的元素属性。

避免故障 避免故障:
  • 如果您将此属性设置为 true,那么还必须将下列 WS-Security 定制属性指定为 WS-Security 策略集绑定的“入站”定制属性、“出站”定制属性或者“入站和出站”定制属性:
    com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
  • 如果您将此属性设置为 true,并且要使用 SAMLTokenFactory 来创建 SAML 令牌,请将以下属性添加至 SAMLIssuerConfig.properties 文件:
    com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
gotcha

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器的 JVM 定制属性。

com.ibm.xml.xlxp.jaxb.opti.level

使用 com.ibm.xml.xlxp.jaxb.opti.level 定制属性来控制是否对 Java XML 绑定体系结构 (JAXB) 反编组(反序列化)和编组(序列化)启用优化方法。下表列示了此定制属性所支持的值及其对应用程序和 Web Service 的影响。
表 2. 此定制属性所支持的值. 此表包括定制属性值以及这些定制属性在应用程序和 Web Service 上的效果。
定制属性值 影响
com.ibm.xml.xlxp.jaxb.opti.level=0 不启用优化方法。
com.ibm.xml.xlxp.jaxb.opti.level=1 只启用反编组优化方法。
com.ibm.xml.xlxp.jaxb.opti.level=2 只启用编组优化方法。
com.ibm.xml.xlxp.jaxb.opti.level=3 同时启用反编组和编组优化方法,这是缺省值。

为了达到最佳性能,请将此定制属性的值设置为 3。此值将提高直接使用 JAXB 的 Web Service 和应用程序的吞吐量。如果您设置此值后遇到优化问题,作为临时的变通方法,请将值更改为 0。

只能在应用程序服务器级别设置此定制属性。

com.ibm.xml.xlxp2.api.util.encoding.DataSourceFactory.bufferLength

使用 64KB 缓冲区时(缺省设置),如果输入流仅部分填充了缓冲区,那么将此 JVM 定制属性设置为更小的值(例如,2048)可能会减少内存使用量。会在 XML 解析器 com/ibm/xml/xlxp2/api/wssec/WSSXMLStreamReader 中高速缓存这些缓冲区。减少内存使用量也会减少与每个解析器对象相关的总内存。

com.ibm.xml.xlxp2.api.util.Pool.STRONG_REFERENCE_POOL_MAXIMUM_SIZE

此系统属性的值是一个整数,设置了此系统属性时,它会限制使用强引用高速缓存的 XMLStreamReader 和 XMLStreamWriter 数。

为了避免 OutOfMemoryError,请将此系统属性设置为 0。这将强制使用 SoftReference 来高速缓存所有 XMLStreamReader,并使垃圾收集器能够在任何时候回收它们在高速缓存中占用的内存。

未设置此系统属性时,其缺省值为 10

config_consistency_check

使用此属性以便有选择地关闭缺省工作空间一致性进程。Deployment Manager 为整个单元维护一个主配置存储库。缺省情况下,当该配置更改时,产品会将工作空间中的配置与主存储库进行比较以保持工作空间的一致性。然而,一致性验证过程会导致增加保存配置更改或部署大量应用程序所需的时间。以下因素影响所需的时间:
  • 单元中定义的应用程序服务器或集群越多,保存配置更改所需的时间就越长。
  • 单元中部署的应用程序服务器越多,保存配置更改所需的时间就越长。

如果您对更改配置所需的时间量不满意,那么可以将 config_consistency_check 定制属性添加到 JVM 设置中并将此属性的值设置为 false。

支持的配置 支持的配置: config_consistency_check 定制属性仅影响 Deployment Manager 进程。它不会影响其他进程,包括 Node Agent 进程和应用程序服务器进程。不会对这些进程执行一致性检查。然而,在这些进程的 SystemOut.log 文件中,您可能会看到一个表示禁用了一致性检查的注释。对于非 Deployment Manager 的进程,您可以忽略此消息。sptcfg

deactivateWildCardURIMapping

使用此属性以使 plugin-cfg.xml 文件生成器能够识别 Web 应用程序的 ibm-web-ext.xmi 文件中 file.serving.patterns.allow 属性上指定的 URI 模式。

如果该 ibm-web-ext.xmi 文件中的 FileServingEnabled 属性设置为 true,那么 plugin-cfg.xml 文件生成器仅识别 file.serving.patterns.allow 属性上指定的 URI 模式。然而,当 FileServingEnabled 属性设置为 true 时,plugin-cfg.xml 文件生成器会自动将通配符 URI 映射 /* 添加到 plugin-cfg.xml 文件,这将使定义唯一文件服务模式失去作用。

如果将 deactivateWildCardURIMapping 属性设置为 true,那么可以阻止 plugin-cfg.xml 文件生成器将 /* 添加到 plugin-cfg.xml 文件,并且使 plugin-cfg.xml 文件生成器能够识别 file.serving.patterns.allow 属性上指定的 URI 模式。如果未将此属性添加到 JVM 设置,或者将其设置为 false,那么会自动将 /* 添加到 plugin-cfg.xml 文件。

将在 Deployment Manager 级别设置此属性。

DISABLE_LOCAL_COMM_WHEN_SSL_REQUIRED

指定当在客户机或服务器端支持传输级别 SSL,且在另一端上需要 SSL 时,应使用 localComm 还是 SSL。

当客户机或服务器端支持传输级别 SSL,且另一端需要 SSL 时,应使用 localComm 还是 SSL。在此情况下,应将此定制属性设置为 true,以确保不使用 localComm 而改用 SSL。

此属性的缺省值为 false,这表示将使用 localComm。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

当您为应用程序服务器指定此属性时:
  • CSIv2 入站传输设置必须设置为“支持 SSL”或“需要 SSL”。请参阅《配置入站传输设置》主题,以获取有关这些设置的更多信息。
  • 在客户机端上,必须将 sas.client.props 文件中的 com.ibm.CORBA.loginSource 属性设置为 none
  • 在客户机端上必须存在以下一个设置:
    • com.ibm.CSI.performTransportAssocSSLTLSRequired=true
    • com.ibm.CSI.performTransportAssocSSLTLSSupported=true

    否则,如果 WebSphere 服务器充当客户机,那么该服务器上的 CSIv2 入站传输设置必须设置为“支持 SSL”或者“需要 SSL”。

disableWSAddressCaching

使用此属性对 Web Service 禁用地址高速缓存。如果系统通常运行大量客户机线程,并且 wsAddrCache 高速缓存中存在锁定争用情况,那么可以将此定制属性设置为 true 以防止对 Web Service 数据进行高速缓存。

如果您对 networkaddress.cache.ttl 指定值 0 或者任何其他正整数,那么必须将此属性设置为 true,以避免高速缓存 Web Service 引擎中的 IP 地址。Networkaddress.cache.ttl 用来指出高速缓存成功查询所耗用的秒数。

缺省值为 false

DRS_BATCH_INTERVAL_SIZE

指定在数据复制服务 (DRS) 复制的一个批次的 HTTP 会话数据中可以包括的最大对象数。如果所复制的 HTTP 会话数据中的对象数少于指定数量,那么会在一个批次中复制所有会话数据。

缺省情况下,DRS 每批复制 50 个 HTTP 会话数据对象。因为序列化大型消息会导致发生超出内存状况,所以您可能想要在每个批次中包括较少数量的对象,特别是如果所具有的应用程序服务器加入已建立的完全填充的复制域。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

DRS_THREADPOOL_MINSIZE

指定数据复制服务 (DRS) 线程池中允许的最小线程数。

应用程序服务器启动时,最初未将线程分配给线程池。当分配给应用程序服务器的工作负载需要线程时,才会将线程添加到线程池,直到池中的线程数等于此定制属性所指定的线程数为止。此时间点后,当工作负载更改时会添加和移除其他线程。但是,即使某些线程空闲,池中的线程数永远不会降至低于此定制属性所指定的数字。

此定制属性的缺省值是 40 个线程。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

DRS_THREADPOOL_MAXSIZE

指定要在 DRS 线程池中维护的最大线程数。

此定制属性的缺省值是 100 个线程。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

DRS_THREADPOOL_ISGROWABLE

指定线程数是否可以增加到超过为 DRS 线程池配置的最大大小。

可以创建的最大线程数仅受 Java 虚拟机和操作系统限制。当允许增长的线程池超过最大大小后,不会复用其他线程,并且在处理完使用这些线程的工作项后,就会从池中废弃这些线程。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

dynacache.jms.cacheInstance

当动态高速缓存服务多单元和多核心组失效功能处于启用状态时,请使用此属性来指定用于处理失效情况的高速缓存实例。将此属性设置为“*”将致使对所有高速缓存实例处理失效标识。应该对服务集成总线服务器设置此属性。

缺省情况下,将使用 baseCache 高速缓存实例。您可以使用管理控制台来确定对系统定义的高速缓存实例的名称。

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

dynacache.jms.connRetryInterval

当动态高速缓存服务多单元和多核心组失效功能处于启用状态时,请使用此属性来指定集群成员在尝试重新连接到服务集成总线服务器之前等待的秒数。

此属性的缺省值是 30

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

dynacache.jms.invProcessingDelay

当动态高速缓存服务多单元和多核心组失效功能处于启用状态时,请使用此属性来指定服务集成总线服务器在处理失效标识前使其进行排队的秒数。

此属性的缺省值是 20

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

dynacache.jms.numStoredInvalidations

当动态高速缓存服务多单元和多核心组失效功能处于启用状态时,请使用此属性来指定集群成员在等待服务集成总线服务器变为可用时可以存储的失效标识的最大数目。达到阈值后,添加新的失效标识时,将移除最旧的标识。

此属性的缺省值是 10000

如果您决定使用此定制属性,除非在特定任务的上下文有指示,否则请将其指定为应用程序服务器 JVM 定制属性。

[z/OS]

invocationCacheSize

使用此属性来控制调用高速缓存的大小。调用高速缓存存放用于将请求 URL 映射至 Servlet 资源的信息。将为每个可用于处理请求的工作程序线程创建所请求大小的高速缓存。调用高速缓存的缺省大小是 50。如果当前正在使用 50 个以上的唯一 URL(每个 JavaServer Page 都是唯一的 URL),那么应该增大调用高速缓存大小。

高速缓存越大,使用的 Java 堆内存量就越大,因此还可能需要增大最大 Java 堆大小。例如,如果每个高速缓存条目需要 2 KB,最大线程大小设为 25,并且 URL 调用高速缓存大小是 100,那么需要 5MB 的 Java 堆。

可以指定任何大于 0 的数值来作为高速缓存大小。如果将值设置为零,那么将禁用调用高速缓存。

[AIX Solaris HP-UX Linux Windows][IBM i]

java.net.preferIPv4Stack

使用此属性来禁用 IPv6 支持。在支持 IPv6 的操作系统中,产品使用的底层本机套接字是 IPv6 套接字。在支持 IPv4 映射地址的 IPv6 网络堆栈中,可以使用 IPv6 套接字来连接到 IPv4 和 IPv6 主机以及接受来自这些主机的连接。

将此属性设置为 true 将禁用 JVM 中的双方式支持,这可能会导致产品的正常功能中断。因此,在使用此属性前,了解此属性的影响十分重要。通常,建议您不要设置此属性。

此定制属性的缺省值为 false,但是在 Microsoft Windows 操作系统上除外(在此操作系统上,此定制属性的缺省值为 true)。

[AIX Solaris HP-UX Linux Windows][IBM i]

java.net.preferIPv6Addresses

使用此属性来禁用 IPv4 支持。将此属性设置为 true 将禁用 JVM 中的双方式支持,这可能会导致产品的正常功能中断。因此,在使用此属性前,了解此属性的影响十分重要。通常,建议您不要设置此属性。

此定制属性的缺省值为 false,但是在 Windows 操作系统上除外(在此操作系统上,此定制属性的缺省值为 true)。

java.util.logging.configureByLoggingPropertiesFile

使用此定制属性来指定 JVM 是否使用 logging.properties 文件来配置 JSR-47 日志记录。

如果未将此属性添加到 JVM 配置设置中,或者将其设为 false,那么 logging.properties 文件中包含的配置设置不会生效,这是因为产品会使用 java.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager 系统属性设置来覆盖基本的 JSR47 日志记录配置。在这种情况下,只能修改可以通过编程方式更改的日志记录设置,例如,添加处理程序和格式化程序。

将此属性设置为 true 时,JVM 仍然会将 WsLogManager 配置为 LogManager,但在服务器启动期间,将根据 logging.properties 文件中的设置对使用 JSR-47 日志记录的应用程序的日志记录配置进行初始化。请参阅 Java 实用程序日志记录 API 文档,以了解可以在 logging.properties 配置文件中指定的有效日志记录属性和格式。
避免故障 避免故障: 请勿对任何记录器指定 java.util.logging.ConsoleHandler,这是因为这样做可能会导致无限循环。gotcha

[AIX Solaris HP-UX Linux Windows][IBM i]logging.properties 文件位于 <<WAS_install>>/java/jre/lib/logging.properties 目录中,并且可以根据需要进行定制。

[z/OS]logging.properties 文件位于 <<WAS_install>>/java/J*/lib/logging.properties 目录中,并且可以根据需要进行定制。

缺省值为 false

jaxws.asyncClient.maxThreadPoolSize

使用此属性来限制 JAX-WS 异步客户机请求的同时执行的线程数。

缺省情况下,不限制线程数。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.handler.reducecaching

使用此属性来确保 JAX-WS 处理程序正确更新 SOAP 消息。

对于由 JAX-WS 处理程序更新的 SOAP 消息,当其转储在此处理程序中时显示正确,但是在发送消息时,会失去更改。如果您的处理程序多次调用 getMessage(),并且丢失了消息,那么将此属性设置为 true

避免故障 避免故障: 此属性与直接通过 JAX-WS 消息上下文属性来修改 SOAP 头不兼容。同时使用这两种类型的消息修改方法可能会导致信息丢失。gotcha

缺省值为 false

jaxws.ignore.extraWSDLOps

如果在 WSDL 中的操作多于构建到客户机中的操作,那么应使用此属性。

缺省客户机行为是根据 WSDL 中的操作验证构建到客户机中的操作,并且如果这些操作不匹配将会失败。如果在 WSDL 中的操作多于构建到客户机中的操作,将此属性设置为可使 WSDL 验证成功并可以调用客户机。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.ignoreMetadataComplete

即使在模块上设置了 metadata-complete,也将此 JVM 属性设置为 true 以执行 Web Service 注释扫描。缺省值为 false

在缺省情况下,当 metadata-complete 设为 true 时,不会检测 JAX-WS Web Service。

避免故障 避免故障: 必须对 WebSphere Application Server 单元中的每个 JVM 设置此 JVM 属性。gotcha

jaxws.JAXBContext.permStoreCostThresholdMsec

对于所需要的构造时间超过所指定时间量的 JAXBContext 对象,使用此属性来启用对这些对象进行高速缓存。

构造要处理数百个类的 JAXBContext 对象时,JAX-WS Web Service 或客户机在执行期间可能会遇到延迟。对比较耗费时间的 JAXBContext 对象进行高速缓存可以加速执行 Web Service 和客户机,因为每次使用 JAXBContext 对象时不需要重新构造。

请将此属性设置为大于 0 的值(按毫秒计),以对所需要的构造时间超过所指定时间量的 JAXBContext 对象启用高速缓存。高速缓存将持久保存到 JVM 重新启动为止。建议值为大于或等于 5000 毫秒。

缺省值为 0,这种情况下将不启用高速缓存。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.JAXBContext.permStoreMaxSize

请将此属性设置为整数值,以指定 JAXBContext 高速缓存中的最大条目数。如果此高速缓存变得已满,那么会先替换旧的条目,接下来替换具有最短构造时间的条目。

缺省值为 32

注: 此属性将修改由 jaxws.JAXBContext.permStoreCostThresholdMsec 属性创建的高速缓存

jaxws.JAXBContext.permStoreStaleThresholdHours

请将此属性设置为一个小时值,经过此小时数之后,就会认为 JAXBContext 高速缓存中的尚未访问的条目是旧条目。 如果高速缓存变得已满,那么会先替换旧的条目。

缺省值为 24 小时。

注: 此属性将修改由 jaxws.JAXBContext.permStoreCostThresholdMsec 属性创建的高速缓存

jaxws.payload.highFidelity

使用此属性来启用无损变换。当此属性设置为 true 时,Web Service 运行时将保证入局消息和 SOAPHandler 边界上的消息相同。

通常情况下,JAX-WS SOAPHandler 接收到的 SOAP 消息不会与入站 SOAP 消息完全相同。例如,JAX-WS SOAPHandler 接收到的消息可能使用与原始入站消息不同的 xml 前缀。这些细微更改不会影响消息的逻辑解释。然而,如果 SOAPHandler 边界上的消息必须与入局消息完全相同,那么必须将此属性添加到 JVM 设置中并将其设置为 true。例如,“规范化规范”(C14N) 要求保留前缀名称。

最佳实践 最佳实践: 仅当 SOAP 请求访问 SOAPHandlers 中的 soapenv:Body 元素的内容时,才应该使用此属性。将此属性设置为 true 可能会降低 Web Service 运行时的性能。bprac

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.provider.interpretNullAsOneway

如果您的某个 JAX-WS Web Service 使用 javax.xml.ws.Provider 注释定义了基于提供程序的端点并且未指定 WSDL 文件,那么您可以使用此定制属性来控制 JAX-WS 运行时环境在提供程序从 invoke() 方法返回空值时的行为。缺省情况下,运行时环境将发送回一个响应,该响应由一个包含空的 SOAPBody 元素的 SOAPEnvelope 组成。

如果将此属性设置为 true,那么当提供程序实现返回空值并且未定义 WSDL 文件时,运行时环境会将提供程序实现返回的空值解释为“只请求”操作,以便不会返回响应。如同所有“只请求”操作一样,某些服务质量(例如,WS-Transactions)将不可用。

如果 javax.xml.ws.WebServiceProvider 注释指定了 WSDL 值并且 WSDL 定义了请求和响应操作,那么无论此属性的设置如何,JAX-WS 运行时环境将始终返回一个响应,该响应由包含空的 SOAPBody 的 SOAPEnvelope 组成。

缺省值为 false

对于每个要求对缺省值进行更改的服务器,必须将此属性设置为 true

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.runtime.inheritedImplMethodsAccessible

使用此属性来修改 Web Service 运行时,以允许调用所继承的方法。通过将此属性设置为 true 来启用此行为更改。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.runtime.restrictStaticWebmethod

使用此属性来阻止显示静态操作。当此属性设置为 true 时,JAX-WS 运行时将阻止显示静态操作。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.share.dynamic.ports.enable

使用此属性来指定动态端口对于不同 JAX-WS Web Service 的可视性。

缺省情况下,动态端口仅对于创建该端口的服务的实例可视。将此属性设置为 true,以在不同 Web Service 之间共享动态端口。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.soapfault.local.exceptions.disable

使用 jaxws.soapfault.local.exceptions.disable 属性来阻止将 JAX-WS 客户机上本地发生的异常作为 SOAPFault 进行处理。缺省情况下,如果 JAX-WS 客户机遇到本地异常,那么将为该异常创建一个 SOAPFault。由无效主机或端口导致的 ConnectException 是本地异常的一个示例。将使用该 SOAPFault 来调用相应的 JAX-WS 应用程序处理程序 handleFault 方法,然后通过 JAX-WS 客户机调用的方法抛回 SOAPFaultException

通过将此属性设置为 true,本地异常将创建空消息。将使用该空消息来调用相应的 JAX-WS 应用程序处理程序 handleMessage 方法,然后通过 JAX-WS 客户机调用的方法抛回 WebServiceException。这是前发行版中的行为。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

jaxws.useSafeIPC

在 Web 容器中将 enableInProcessConnections 属性设置为 true 时,如果 JAX-WS Web Service 中发生错误,请在应用程序服务器上将此属性设置为 true。当相互调用的 Web Service 应用程序之间无法安全地共享单个线程时,可能就会发生这种情况。将此属性设置为 true 会导致应用程序在不同的线程中运行。

缺省值为 false。

jdk.corba.allowOutputStreamSubclass

将此属性设置为 true,以确保可对 org.omg.CORBA_2_3.portable.OutputStream 建立子类。

使用安全管理器运行的应用程序可能会遇到由于进行其他安全性检查而导致性能下降,当安装了安全管理器时,现在会执行这些安全性检查以保护缺省构造函数 org.omg.CORBA_2_3.portable.OutputStream。其他这些安全性检查可能会导致与现有应用程序部署不兼容。向 JVM 设置添加此属性并将其设置为 true 可防止产生这些不兼容。

可以在应用程序服务器、Node Agent 或者 Deployment Manager 级别设置此属性,但通常是在应用程序服务器级别指定此属性。

ODCClearMessageAge

使用此属性来指定一个时间长度(以毫秒计),在此时间过后,将从公告牌中移除 ODC 消息,即使接收方尚未确认此消息亦如此。对此属性指定值有助于防止由于某种原因未被确认的消息发生积压。

您可以指定任何正整数作为此属性的值,但建议使用 300000(5 分钟)或更大的值以避免过早移除消息。

缺省值是 300000 毫秒。

ODCInit.disabled

如果要禁用随需应变配置 (ODC) 组件的进程之间的通信以及用于所有本地 ODC 处理的通信,请将此属性设置为 true

当部署基于 Web Service 的应用程序以及使用 WebSphere Application Server 代理服务器来处理请求时,将使用随需应变配置组件。将在单元范围内启用或禁用随需应变配置组件。因此,如果您的拓扑包含任何代理服务器或任何基于 Web Service 的应用程序,那么您不应该禁用随需应变配置服务。

如果您正在大型拓扑环境中运行,其中未部署基于 Web Service 的应用程序,也未使用 WebSphere Application Server 代理服务器来处理请求,那么将不会使用随需应变配置组件,所以您可以将此属性设置为 true。将此属性设置为 true 将禁用随需应变配置组件,这将降低网络带宽和 CPU 利用率。

缺省值为 false

org.apache.aries.blueprint.header.mandatory

设置为 true 时,带有蓝图的捆绑软件必须具有蓝图标题。当没有蓝图标题时,这允许 apache aries 以避免高成本扫描。

org.apache.axiom.attachments.tempfile.expiration

如果 AxisXXXXXX.att 形式的临时文件累积过多,请将此属性设置为一个值(以秒计),经过此秒数之后,JAX-WS 运行时会删除这些用于存储 MTOM 附件的临时文件。

缺省值为 0。当 JVM 退出时会删除这些文件。

org.apache.el.parser.SKIP_IDENTIFIER_CHECK

使用此属性来放宽对 EL 变量标识的检查。放宽的检查行为等价于低于 V8.0 的 WebSphere Application Server 版本中观察到的行为。

从 V8.0 开始,对 EL 变量标识的检查将更严格。现在,检查过程会检查 Java 保留关键字以及保留 EL 关键字。在 V8.0 之前,检查过程将仅检查保留 EL 关键字。

如果 JSTL/EL 脚本中所使用的任何变量标识中包括任何保留 JSP 关键字,那么该变量标识将无法转换,从而导致异常。处理这种异常的首选方法是修改 JSTL/EL 代码,以便不使用保留关键字作为变量名称。但是,如果无法这样做或者这样做不可行,那么将此属性设置为 true 以放宽检查级别,即放宽至低于 V8.0 的版本级别的检查级别。

可以在以下网址找到保留 JSP 关键字的列表:http://docs.oracle.com/javaee/5/tutorial/doc/bnahq.html#bnail

org.eclipse.jst.j2ee.commonarchivecore.disableZip

使用此定制属性可允许将 ZIP 归档作为简单文件处理。

将此属性设置为 true 可在扫描已部署应用程序的文件时允许将 ZIP 归档作为简单文件处理。

缺省值为 false

必须将此属性设置为 IBM WebSphere Application Server 进程的定制属性,该进程在运行要忽略其 ZIP 文件的应用程序。

org.eclipse.jst.j2ee.commonarchivecore.ignore.ejb.in.war

如果满足下列所有条件,请使用此属性:
  • 您有一个 Java EE 5 应用程序。
  • 此应用程序在 WAR 文件中包含 EJB。
  • 该应用程序成功部署至运行 WebSphere Application Server V7.x 的独立服务器。
  • 当您尝试将该应用程序从运行 WebSphere Application Server V8.0 或更高版本 的 Deployment Manager 部署至运行 V7.x 的节点时,部署失败。

如果满足上述所有条件,那么部署可能会失败,因为在部署期间,应用程序会提升到 Java EE 6 级别。WebSphere Application Server V7.x 实现了 Java EE 5。直到 Java EE 6 之后,才会在 WAR 文件中引入 EJB。WebSphere Application Server V8.0 或更高版本 在 WAR 文件中找到 EJB 后,它会将该 WAR 提升到 V3.0 并将该应用程序提升到 Java EE 6。发生这种情况时,无法将该应用程序部署到运行 WebSphere Application Server V7.x 的节点。

要忽略 WAR 文件中的 EJB 并防止升级应用程序版本,请在 Deployment Manager 上将此属性设置为 true。缺省值为 false

设置此定制属性会将设置应用于所有应用程序。要将此设置应用于特定应用程序,请编辑 META-INF/MANIFEST.MF 文件并添加下面这一行:
Ignore-Ejb-In-War-Annotation: true
避免故障 避免故障: 更新应用程序清单时,遵循清单的行长度限制和其他约束。gotcha

org.eclipse.jst.j2ee.commonarchivecore.FILTERBINARIES

使用此定制属性来防止在运行时处理期间列示某些应用程序文件。

由于新 JavaEE5 注释处理要求,在运行时处理期间列示的应用程序文件多于在产品的先前版本中列示的文件。更多的列示操作可能导致从产品先前版本迁移的应用程序启动更慢,因为列示应用程序文件花费了更多时间。

缺省值是不设置。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 JVM 定制属性。

org.eclipse.jst.j2ee.commonarchivecore.ignore.jee6.annotation

如果满足下列所有条件,请使用此属性:
  • 您有一个 Java EE 5 应用程序。
  • 该应用程序包含 Java EE 6 注释。
  • 该应用程序成功部署至运行 WebSphere Application Server V7.x 的独立服务器。
  • 当您尝试将该应用程序从运行 WebSphere Application Server V8.0 或更高版本 的 Deployment Manager 部署至运行 WebSphere Application Server V7.x 的节点时,部署失败。

如果满足上述所有条件,那么部署可能会失败,因为在部署期间,应用程序会提升到 Java EE 6 级别。WebSphere Application Server V7.x 实现 Java EE 5,并将忽略 Java EE 6 注释。WebSphere Application Server V8.0 或更高版本 实现了 Java EE 6,因此会处理 Java EE 6 注释。这将导致其中包含 Java EE 6 注释的 Java EE 5 应用程序提升到 Java EE 6 级别。提升该应用程序后,WebSphere Application Server V8.0 或更高版本 不会将该应用程序部署至运行 WebSphere Application Server V7.x 的节点。

要忽略 Java EE 6 注释以及防止应用程序版本升级,请在 Deployment Manager 上将该属性设置为 true。缺省值为 false

设置该定制属性会将设置应用于所有应用程序。要将此设置应用于特定应用程序,请编辑 META-INF/MANIFEST.MF 文件并添加下面这一行:
Ignore-JEE6-Annotation: true
避免故障 避免故障: 更新应用程序清单时,遵循清单的行长度限制和其他约束。gotcha

org.eclipse.jst.j2ee.commonarchivecore.ignore.jee7.annotation

如果满足下列所有条件,请使用此属性:
  • 您有一个 Java EE 5 或 Java EE 6 应用程序。
  • 该应用程序包含 Java EE 7 注释。
  • 该应用程序成功部署至运行 WebSphere Application Server V7.x 或 V8.x 的独立服务器。
  • 当您尝试将该应用程序从运行 WebSphere Application Server V9.x 的 Deployment Manager 部署至运行 WebSphere Application Server V7.x 或 V8.x 的节点时,部署失败。

如果满足上述所有条件,那么部署可能会失败,因为在部署期间,应用程序会提升到 Java EE 7 级别。WebSphere Application Server V7.x 和 V8.x 分别实现了 Java EE 5 和 Java EE 6。WebSphere Application Server V9.x 实现了 Java EE 7,因此会处理 Java EE 7 注释。这将导致包含 Java EE 7 注释的 Java EE 5 或 Java EE 6 应用程序提升到 Java EE 7 级别。提升该应用程序后,WebSphere Application Server V9.x 不会将该应用程序部署至运行 V7.x 或 V8.x 的节点。

要忽略 Java EE 7 注释并防止升级应用程序版本,请在 Deployment Manager 上将此属性设置为 true。缺省值为 false

设置该定制属性会将设置应用于所有应用程序。要将此设置应用于特定应用程序,请编辑 META-INF/MANIFEST.MF 文件并添加下面这一行:
Ignore-JEE7-Annotation: true
避免故障 避免故障: 更新应用程序清单时,请遵循该清单的行长度限制和其他约束。gotcha

org.eclipse.jst.j2ee.commonarchivecore.ignore.web.fragment

如果满足下列所有条件,请使用此属性:
  • 您有一个 Java EE 5 应用程序。
  • 此应用程序包含具有 Web 片段的 WAR 文件。
  • 该应用程序成功部署至运行 WebSphere Application Server V7.x 的独立服务器。
  • 当您尝试将该应用程序从运行 WebSphere Application Server V8.0 或更高版本 的 Deployment Manager 部署至运行 V7.x 的节点时,部署失败。

如果满足上述所有条件,那么部署可能会失败,因为在部署期间,应用程序会提升到 Java EE 6 级别。WebSphere Application Server V7.x 实现了 Java EE 5。直到 Java EE 6 之后才会在 WAR 文件中引入 Web 片段。当 WebSphere Application Server V8.0 或更高版本 找到 Web 片段时,它会将该 WAR 提升到 V3.0 并将该应用程序提升到 Java EE 6。发生这种情况时,无法将该应用程序部署到运行 WebSphere Application Server V7.x 的节点。

要忽略 Web 片段并防止升级应用程序版本,请在 Deployment Manager 上将该属性设置为 true。缺省值为 false

设置此定制属性会将设置应用于所有应用程序。要将此设置应用于特定应用程序,请编辑 META-INF/MANIFEST.MF 文件并添加下面这一行:
Ignore-Web-Fragment: true
避免故障 避免故障: 更新应用程序清单时,遵循清单的行长度限制和其他约束。gotcha

org.eclipse.jst.j2ee.commonarchivecore.openAllArchivesTrue

使用此定制属性来设置服务器以扩展所有归档。

为了能够在部署期间扩展非标准归档,请对涉及到部署的 Application Server 进程设置此属性。如果您正在使用 Deployment Manager,请对 Deployment Manager 进程设置此属性。

要通过 earExpander 脚本来启用扩展,请编辑 earExpander 脚本,将此属性设置为 Java 定制属性。

缺省值为 false。

注: 此属性不适用于 JAR 中的 JAR。即使将此属性设置为 true,JAR 中的 JAR 也不会扩展。EAR 文件中的所有 JAR 以及 RAR 文件中的所有 JAR 都处于活动状态。此定制属性不会影响 EAR 文件中的 JAR 以及 RAR 文件中的 JAR 的处理。

org.eclipse.jst.j2ee.commonarchivecore.PM62467.Disabled

使用此定制属性来指定在归档条目路径中包含不允许的值时发生的行为。

当应用程序部署在 WebSphere Application Server 中时,应用程序归档文件和模块文件的内容将通过使用这些文件的归档条目路径来抽取到应用程序服务器概要文件的 installedApps 目录中。必须将应用程序文件抽取到 installedApps 目录中;但是,如果文件的归档条目路径中包含值 ../,那么可以将归档文件抽取到另一个目录中。如果此定制属性的值为 False,并且归档条目路径中包含值 ../,那么会发生 ArchiveRuntimeException,并且将停止处理归档。将此属性设置为 true,以记录警告消息并继续部署此应用程序。

缺省值为 false

如果您决定使用此定制属性,那么在 Deployment Manager 节点和应用程序服务器上必须将其指定为 JVM 定制属性。

overrideAutoProp

使用此定制属性将 plugin-cfg.xml 传播到远程节点存储库和远程 Web 服务器位置。

当此属性设置为 true 并使用手动传播时,plugin-cfg.xml 将传播到远程节点存储库和远程 Web 服务器位置。当此属性设置为 false 并使用手动传播时,plugin-cfg.xml 将仅传播到远程节点存储库,而不会传播到 Web 服务器位置。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为节点 JVM 定制属性。

为节点设置此属性后,必须将更改同步到该节点。设置此属性需要停止并启动节点来使设置生效。

plugin.syncdisabled

使用此定制属性来禁用由 Web 服务器插件配置传播所调用的节点同步。

当此属性设置为 true 时,Web 服务器插件配置更改在节点中不会自动同步。这意味着在您执行手动同步之前,不会将您进行的任何 Web 服务器插件配置更改传播到 Web 服务器。

缺省值为 false

如果您决定使用此定制属性,那么必须将其指定为节点 JVM 定制属性。

threadpool.maxsize

使用此属性可控制在新创建的线程池中可以包括的线程数。会创建一个专用线程来启动每个应用程序服务器 Java 虚拟机 (JVM)。在此线程池中带有专用线程的 JVM 是在 Node Agent 启动时并行启动的 JVM。

可以指定 0 - 5 之间的整数作为此属性的值。如果您指定的值大于 0,那么创建的线程池会使用该值作为在此新创建的线程池中可以包括的最大线程数。下表列示了此定制属性所支持的值及其影响。

表 3. threadpool.maxsize 所支持的值. 此表包括定制属性值以及此定制属性的影响。
threadpool.maxsize 值 影响
threadpool.maxsize 属性设置为 0,或者未指定此属性的值。 Node Agent 将并行启动最多达 5 个 JVM。
threadpool.maxsize 属性设置为 1 Node Agent 将按顺序启动 JVM。
threadpool.maxsize 属性设置为 25 之间的整数值。 Node Agent 将并行启动的 JVM 的数目与所指定值相同。

例如,假设 Node Agent 具有 10 个设置为运行状态的 JVM,此状态表示这些 JVM 将在 Node Agent 启动时启动。如果您为此属性指定 3,只要您停止并启动 Node Agent,那么在 Node Agent 启动时,10 个 JVM 中将仅有 3 个会并行启动。

避免故障 避免故障:
  • 如果您使用管理控制台,并指定 threadpool.maxsize 作为 Node Agent 的新 JVM 定制属性的名称,那么必须在此新定制属性的字段中指定一个值。如果未指定值,那么会接收到错误消息。
  • 如果通过命令行向该属性传递了一个空值,那么该值将视为非法值,并且将恢复 Node Agent 的缺省行为。
gotcha

缺省情况下,未指定此属性。如果您决定使用此定制属性,那么必须将其指定为 Node Agent JVM 定制属性。

[z/OS]

was.xcfmonitor.enabled

使用此属性来允许使用 z/OS 跨系统耦合设施 (XCF) 监视应用程序服务器状态。如果将此属性设置为 true,那么 Node Agent 可以使用 XCF 来监视其应用程序服务器,应用程序服务器可以使用 XCF 来监视其 Node Agent,并且管理代理程序可以使用 XCF 来监视已向其注册的应用程序服务器。如果此属性设置为 false,那么将使用 TCP/IP Ping 方法来监视应用程序服务器和 Node Agent 状态。

缺省值为 false

webservices.unify.faults

使用 webservices.unify.faults 属性来启用 JAX-WS 和 JAX-RPC 的 SOAP 故障统一。缺省情况下,Web Service 运行时环境(JAX-WS 和 JAX-RPC)将运行时环境生成的所有故障统一成单一类型的故障,其故障代码服务器故障字符串内部错误。这些故障不包含任何其他用于标识故障实际原因的信息。故障统一会使系统更安全,并会阻止将有关入站消息处理为何失败的详细信息返回到消息发送方。

此属性的缺省值是 true,这将导致要统一故障。如果应用程序需要故障详细信息,那么您可以将此属性设置为 false 以禁用故障统一,从而允许在故障中返回详细信息。注意,无论此属性的设置如何,都不会统一 WSDL 中定义并由服务提供程序方法实现抛出的已校验的异常。此外,如果启用了跟踪,那么无论此属性的设置如何,都会记录有关故障原因的详细信息。

wink.client.readTimeout

使用此属性来指定 RestClient 对象在超时之前等待对请求的响应的时间(以毫秒计)。零 (0) 值表示客户机将无限期地等待并且不会超时。

缺省值为 60,000 毫秒。

wink.client.connectTimeout

在尝试连接至目标资源时,使用此属性来指定 RestClient 对象在超时之前等待的时间(以毫秒计)。零 (0) 值表示客户机将无限期地等待并且不会超时。

缺省值为 60,000 毫秒。


指示主题类型的图标 参考主题



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