Java 虚拟机定制属性

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

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

要设置定制属性,请连接到管理控制台并浏览至相应的 Java 虚拟机定制属性页面。

应用程序服务器

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

如果定制属性在已定义的定制属性列表中不存在,请创建新属性。 然后,在 "名称" 字段中输入属性名称,并在 "值" 字段中输入有效值。 重新启动服务器以完成更改。

您可以使用 "定制属性" 页面来定义以下属性,以供 Java 虚拟机使用。

adminconsole.certLogin

配置管理控制台以支持证书登录时,请将此属性设置为 true

当此属性设置为 true 并且发生登录错误时,管理控制台将显示不包含用户名和密码字段的错误页面。 此属性的值区分大小写。 此属性的缺省值为 false

有关更多信息,请参阅 证书登录

[9.0.5.18 或更高版本]

adminconsole.ssoLogin

当此属性设置为 true 并且发生登录错误时,管理控制台将显示不包含用户名和密码字段的错误页面。 如果在控制台中命中 logon.jsp 文件,请检查显示的消息以获取登录 URL。 此消息通知您正在使用备用登录形式,要访问控制台,请使用 https://host_name:port_number/ibm/console URL。 此属性的值不区分大小写。 此属性的缺省值为 false

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

ArchiveUtil.allowWtpToUseSystemTemp

在 Deployment Manager 上设置此属性以在 Deployment Manager 启动期间减少由 Java 系统属性 java.io.tmpdir定义的系统临时目录中的磁盘空间使用。 仅当没有为系统临时目录分配足够的空间时,才需要此设置。 所需的空间量至少是扩展形式的最大已安装应用程序的大小。 Setting this property to false redirects application expansion to the <WAS_PROFILE_HOME>/wstemp/wtptmp directory.

缺省值为 true
  • 如果值为 true ,那么在 Deployment Manager 启动期间,应用程序将展开到 Java 系统属性 java.io.tmpdir定义的系统临时目录。
  • 如果在 Deployment Manager 启动期间值为 false ,那么会将应用程序展开到 <WAS_PROFILE_HOME>/wstemp/wtptmp 目录。

com.ibm.cacheLocalHost

将此属性设置为 true 以指示 IBM SDK for Java 在 JVM 生命周期内高速缓存从 java/net/InetAddress.getLocalHost 返回的 IP 地址。 如果进程的本地主机地址在运行时未更改,那么建议对所有进程使用此属性作为性能增强。

避免麻烦: 使用 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

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

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

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

com.ibm.config.eclipse.wtp.enablejemtrim

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

避免麻烦: 此属性的设置应该与 com.ibm.config.eclipse.wtp.enablexmltrim 定制属性的设置相匹配。 将这两个属性都保留为未设置,将这两个属性都设置为 false或将这两个属性都设置为 true

缺省值为 false

com.ibm.config.eclipse.wtp.enablexmltrim

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

避免麻烦: 此属性的设置应该与 com.ibm.config.eclipse.wtp.enablejemtrim 定制属性的设置相匹配。 将这两个属性都保留为未设置,将这两个属性都设置为 false或将这两个属性都设置为 true

缺省值为 false

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

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

避免麻烦: 此属性可能会影响性能。 因此,仅当在对应用程序进行元数据的 XML 解析后修剪中间 DOM 节点期间发生问题时,才应指定此属性,并且您需要获取其他信息以诊断该问题的原因。

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

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

避免麻烦: 此属性可能会影响性能。 因此,仅当共享 JavaClass 实例时发生问题,或者使用扩展的 JavaClass 和 JavaMethod 对象后将其转换为轻量级代理时,才应指定此属性,并且您需要获取其他信息以诊断该问题的原因。

com.ibm.disableCommonsElCache

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

缺省值为 false。

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

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 定制日志记录,以写入 SystemOut 流而不使用 WebSphere® Application Server格式。 WebSphere Application Server 的格式包含信息,例如时间戳记,线程标识和其他一些信息。 应用程序可能不想在 SystemOut 流中显示此信息(或者也许首选以其他格式显示该信息)。 要禁用 WebSphere Application Server的格式,请将此定制属性设置为 true

com.ibm.ejs.sm.server.quiesceInactiveRequestTime

使用此定制属性来指定可以接收和处理通过对象请求代理 (ORB) 发出的 IIOP 请求的速度(以毫秒计)。 例如,如果对此属性指定值 5000,那么服务器在入局请求至少间隔 5 秒后才会尝试进行关闭。 如果对此属性指定的值太大,那么从管理控制台停止应用程序服务器时,可能会发出以下错误消息:
An error occurred while stopping Server1. Check the error logs for more information.

缺省值是 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.collective.utility.autoAcceptCertificates

要自动信任 SSL (安全套接字层) 证书,请将此属性设置为 true

com.ibm.websphere.deletejspclasses

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

com.ibm.websphere.deletejspclasses.delete

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

com.ibm.websphere.deletejspclasses.update

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

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 ,而不是返回 TransactionRolledback异常 (即使此函数违反 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

避免麻烦: 除非迂到单项 TypeMapping注册表受到污染的情况,否则不应使用此定制属性。 启用此属性可能会使多个线程上依赖于对同一 JAX-RPC 存根的访问的应用程序回退。

com.ibm.websphere.jaxrs.server.DisableIBMJAXRS20Engine

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

com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine

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

com.ibm.websphere.logging.useJULThreadID

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

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

缺省值为 false

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

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

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

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

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

如果在启用了 com.ibm.websphere.management.application.client.EnvEntry_processBindings 的情况下部署应用程序,然后导出该应用程序以在版本低于 8.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 定制属性。
避免麻烦: 如果您的环境包含版本低于 8.0 的节点,并且应用程序以版本低于 8.0 的节点为目标,那么如果您在应用程序中定义了环境条目,并且将在部署期间提供或更改环境条目值 (包括安装,编辑或更新) ,请将此属性的值设置为 false。 否则,应用程序部署将失败。

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 中定义此属性。

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 中定义此属性。

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

避免麻烦: 如果使用 Application Edition Manager 执行转出,请勿设置此属性。

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

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

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

避免麻烦: 仅当为 Deployment Manager 指定此属性时,此属性才有效。

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

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

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

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

避免麻烦: 仅当为 Deployment Manager 指定此属性时,此属性才有效。

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

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

要防止生成重复的配置会话或工作空间标识,请将此属性添加到应用程序服务器设置并将其设置为 random。 下面是设置此定制属性的示例:
javaoption command switch:
wsadmin -javaoption 
"-Dcom.ibm.websphere.management.configservice.sessionIdUniqueness=random"

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

在保存更改后,必须重新启动该服务器,然后此配置更改才会生效。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 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"

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 个设置为 running 状态的 JVM ,这表示只要 Node Agent 启动就会启动这些 JVM。 如果为此属性指定 3 ,那么每当停止并启动 Node Agent 时,只有 10 个 JVM 中的 3 个在 Node Agent 启动时并行启动。

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

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

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,产品都将正常地部署未包含嵌入式配置的应用程序。 此设置对部署没有影响。

[AIX Solaris HP-UX Linux Windows][IBM i]避免麻烦: 如果您决定使用此定制属性,那么可以将此属性指定为应用程序服务器的 JVM 定制属性,或者将此属性添加到 wsadmin.properties 文件中。

com.ibm.websphere.management.soapSocketConnectionTimeout

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

com.ibm.websphere.management.useUpdatedPropertyFiles

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

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

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

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

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

com.ibm.websphere.metadata.ignoreDuplicateRefBindingsInWebModules

使用此属性来控制 JVM 是否忽略 Java 2 Platform Enterprise Edition (J2EE) V 1.3 应用程序中 Web 模块的 DTD 文件中重复引用绑定的实例。 通常,如果 Java 2 Platform , Enterprise Edition (J2EE) V 1.3 应用程序中 Web 模块的 DTD 文件包含重复引用,那么会发生 MetaData异常。

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

虽然 Web 模块的 DTD 文件标准禁止用户定义重复的引用绑定,但 V7.0 以前的产品版本中的 JVM 却允许定义重复的引用绑定。 如果您在 Java 2 Platform , Enterprise Edition (J2EE) V 1.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 地址。

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

com.ibm.websphere.perf.tuning.disableRPARepositoryCache

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

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

避免麻烦: 如果启用了 RPA ,或者由于此存储库高速缓存的大小而未迂到性能问题,那么不应使用此定制属性。

此属性的缺省值为 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

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

JAX-RPC 编程模型允许访问入局 Web Service 消息中的附件。 可以立即访问该附件,也可以存储该附件以便稍后进行处理。 因此,与该附件关联的内存可能比 Web Service 交互的生存期要长得多,因为没有精确的时间长度,在此时间之后, Web Service 运行时可以安全地释放该附件。

对于小型附件,内存最终由 Java 垃圾收集器释放。

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

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

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

com.ibm.websphere.webservices.attachements.maxMemCacheSize

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

确定此属性的值时,请记住,最大高速缓存大小越大,对性能的影响就越大,并且可能对 Java 堆产生影响。

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

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

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 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 应用程序。

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 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 V 8 开始,如果消息中没有相应的元素,那么 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 方法返回空值。
避免麻烦: 先前返回 null 的行为不符合规范。

com.ibm.websphere.webservices.tempAttachDir

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

出于性能原因, Web Service 运行时将高速缓存大于 32 KB 的任何 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

在 V 8 之前, WebSphere Application Server 的 JAX-WS 客户机应用程序可能会在 SOAP 消息中发送 SAVE_CONNECTION HTTP 头。 这个附加的头确保主管 JAX-WS Web Service 的应用程序服务器执行正确的处理。 但是,如果客户机的应用程序服务器和 Web Service 的应用程序服务器主机都在使用 WebSphere Application Server V 7.0 修订包 3 或更高版本,那么不需要此 SAVE_CONNECTION 头和其他处理。

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

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器 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) 的标准路径,并使用分号 (;) 分隔这些路径。
重要信息: 如果 WebSphere Application Server 的基本操作系统是 AIX®, Linux®或 UNIX ,请使用 冒号 (:) 来分隔多个 Java 归档 (JAR) 和目录。

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

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

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

使用此属性可配置出站 Web Service 可靠消息传递 (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 毫秒。

[9.0.5.6 或更高版本]

com.ibm.websvcs.client.serializeSecurityContext

当 JAX-WS 客户机在应用程序服务器上运行时,服务调用在启用了基本安全性时可能会比未启用基本安全性时速度更慢。 要调整服务调用速度,可以使用 com.ibm.websvcs.client.serializeSecurityContext 属性。 当此属性在 JVM 级别设置为 false 时,不会将 WebSphere® 安全上下文序列化为所有 JAX-WS Web Service 客户机请求的 Web Service 消息上下文。

您可以将此属性设置为 false ,以在序列化期间迂到错误时禁用安全上下文序列化。 例如,当安全上下文上存在不可序列化的对象或者无法验证 LTPA 令牌时,可能会发生这些错误。

com.ibm.websvcs.client.serializeSecurityContext 属性的缺省设置为 true
注: 如果服务器上的任何应用程序使用可靠消息传递策略集,请勿在 JVM 级别将此属性设置为 false 。 如果执行此操作,那么会显示消息 CWSKA0112E: WS-ReliableMessaging 服务质量 managedPersistent 与值为 false 的 BindingProvider 属性 com.ibm.websvcs.client.serializeSecurityContext 之间存在冲突。
[9.0.5.1 或更高版本]

com.ibm.ws.amm.discriminator.enablePH11818

将此选项设置为 true 以防止仅因为类实现了 java.util.EventListener 接口而扫描类以获取注释。

例如,作为 Spring 注释的注释 (例如 @Resource ) 将被视为 Java EE 注释,因为其类实现了 java.util.EventListener 接口。 要更正此问题,请将此定制属性设置为 true

值为 false时,将在应用程序部署期间扫描实现 java.util.EventListener 接口的类以获取注释。 该值缺省为 false ,以避免影响部署期间依赖于注释扫描的现有应用程序。

还可以通过将以下行添加到 EAR 文件或 WAR 文件的 /META-INF/MANIFEST.MF 文件,为特定 EAR 文件或 WAR 文件启用此属性:
IBM-ENABLE-PH11818 : true
避免麻烦: MANIFEST.MF 文件具有格式化规则。 例如,文件必须以换行符或回车符结尾。 如果文件的最后一行未以换行符或回车符结束,那么不会正确解析该文件的最后一行。

com.ibm.ws.amm.reduce.warning.messages

将此选项设置为 true 以减少注释扫描期间发出的警告消息数。

注释扫描必须处理所有应用程序类的类引用。 在部署应用程序时以及在启动应用程序时执行扫描。 注释扫描针对未解析的类引用发出警告消息。 在服务器日志中显示类似于以下内容的警告:
[17/04/06 9:46:59:211 JST] 000000b7 注释 W 
com.ibm.ws.amm.scan.context.ScannerContextImpl getInputDataFor类 
Failed to open resource [ org/apache/struts2/views/jsp/ui/ActionErrorTag.class ] from module [ <module_name>.war ]

在许多情况下,该警告指示应用程序中缺少类,这是一个严重问题。 在其他情况下,类引用发生在应用程序未使用的代码中,而未能解析引用是无害的。 当类引用无法解析但故障无害时,您可以减少发出的警告消息数。

缺省行为为 false。 当选项的值为 false时,将在服务器日志中显示注释扫描期间发出的警告消息。

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) 模块的清单文件中指定的值将与具有模块作用域的过滤器集合并。 这个合并而成的过滤器集合将只应用于该模块。

避免麻烦: 如果更新清单文件,请谨慎操作。 清单文件具有行长度限制以及其他必须遵循的约束。
示例:
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 个字节,并且还有其他必须遵守的约束。
示例:
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.createCacheAtServerStartup

使用此属性可在应用程序服务器启动时创建高速缓存实例。 直到使用定义的高速缓存实例之后,才会创建这些实例。 在启动时创建高速缓存实例可确保高速缓存立即可供应用程序使用,并且高速缓存复制 (如果已启用) 已初始化。

缺省值为 false,这意味着直到应用程序使用高速缓存实例之后才会创建高速缓存实例。

可以在高速缓存实例级别设置此定制属性。

com.ibm.ws.cache.CacheConfig.filterLRUInvalidation

使用此属性来指示不会将最近最少使用的 (LRU) 失效传播到复制域中的其他应用程序服务器。 减少传播到复制域中其他应用程序服务器的失效数有助于防止复制基础结构以不必要的复制流量重载并提高性能。

缺省值为 false,这意味着 LRU 失效将传播到其他应用程序服务器。

此定制属性可以设置为影响所有高速缓存实例的应用程序服务器 JVM 定制属性,也可以设置为仅影响特定高速缓存实例的高速缓存实例定制属性。

com.ibm.ws.cache.CacheConfig.filteredStatusCodes

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

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

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

com.ibm.ws.cache.CacheConfig.filterInactivityInvalidation

使用此属性来指示不活动失效不会传播到复制域中的其他应用程序服务器。 减少传播到复制域中其他应用程序服务器的失效数有助于防止复制基础结构以不必要的复制流量重载并提高性能。

缺省值为 false,这意味着不活动失效将传播到其他应用程序服务器。

此定制属性可以设置为影响所有高速缓存实例的应用程序服务器 JVM 定制属性,也可以设置为仅影响特定高速缓存实例的高速缓存实例定制属性。

com.ibm.ws.cache.CacheConfig.filterTimeOutInvalidation

使用此属性可指示超时失效,这些失效不会传播到复制域中的其他应用程序服务器。 减少传播到复制域中其他应用程序服务器的失效数有助于防止复制基础结构以不必要的复制流量重载并提高性能。

缺省值为 false,这表示将超时失效传播到其他应用程序服务器。

此定制属性可以设置为影响所有高速缓存实例的应用程序服务器 JVM 定制属性,也可以设置为仅影响特定高速缓存实例的高速缓存实例定制属性。

com.ibm.ws.cache.CacheConfig.ignoreValueInInvalidationEvent

使用此属性可从发送到高速缓存失效侦听器的失效事件中除去高速缓存值。 如果高速缓存失效侦听器不需要已失效的高速缓存条目的值,那么将此属性设置为 true 可通过减少堆消耗和 CPU 利用率来帮助提高性能。

缺省值为 false,这表示高速缓存值包含在发送到高速缓存失效侦听器的失效事件中。

此定制属性可以设置为影响所有高速缓存实例的应用程序服务器 JVM 定制属性,也可以设置为仅影响特定高速缓存实例的高速缓存实例定制属性。

com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior

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

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

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

定义此 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 定制属性。

要点: 确保使用不以正斜杠 (/) 开头的资源。 WebSphere Application Server 类装入器通过使用此属性与 Java Underclassman 保持一致,这将禁止以正斜杠 (/) 开头的 getResource 调用。

com.ibm.ws.classloader.zipFileCacheSize

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

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

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

[Windows]避免故障: 避免故障: 如果为此属性指定了除 0 以外的值,请勿使用 Microsoft Windows 热部署函数。

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

com.ibm.ws.console.test_connection_monitor

当此属性设置为 true时,将在具有监视员角色的任何用户的数据源详细信息页面上显示 测试连接 按钮。 然后,这些用户可以完成数据源的测试连接操作。

缺省情况下,此属性设置为 false。 每当此属性设置为 false时,都不允许仅具有监视员角色的用户在控制台上完成操作,并且没有可供他们使用的 测试连接 按钮。

具有管理员或配置员角色的用户可以完成数据源的测试连接操作,无论此属性是否设置为 truefalse

警告:
通常不允许监视员角色完成操作。

com.ibm.ws.cscope.HighlyAvailableIORsEnabled

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

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

com.ibm.ws.eba.bla.MapRolesToUsersStep.SkipValidation

使用此属性在将角色映射到 OSGi (Open Services Gateway 计划) 应用程序的用户时禁用用户和组的验证。 指示 MapRolesToUsers步骤选项是否针对用户注册表验证指定的用户或组。

缺省值为 false。 指定 true 以禁用验证。 使用此定制属性时,请将该定制属性指定为应用程序服务器 JVM 定制属性。

com.ibm.ws.ecs.force.context.classloader

使用此属性可避免或激活步骤,以确保共享库可用于 servlet 容器初始化方法测试。

缺省值为 unsetfalse。 可能的值为 unsetfalsetrue。 将该值设置为 unsetfalse 以避免执行确保共享库可用于 servlet 容器初始化方法测试的步骤。 将值设置为 true 以执行步骤来确保 servlet 容器初始化方法测试在用于测试的类路径中包含共享库。

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 握手所需时间段要延长,那么可能需要增大此值。 :NONE.HTTP 408如果发生此超时,那么可能会从 SOAP 服务器接收消息。

com.ibm.ws.jbatch.disable

使用此属性可禁用服务器中的 IBM 内置 Batch Applications for Java Platform 1.0 (JSR 352) 实现。 要禁用 JSR 352 实现,请将此属性设置为 true。 该属性缺省为 false,这意味着缺省情况下已启用 IBM 实现。

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 以阻止这种强制。

缺省值为 true

[9.0.5.11 或更高版本]

com.ibm.ws.logging.iso.date.format

使用此定制属性来指定日志中的日期和时间格式是使用特定于语言环境的格式还是使用 ISO-8601 格式。 有效值为truefalse。 缺省值为 false

如果指定值 true,那么将在 SystemOut.logSystemErr.log 文件, trace.log 文件, FFDC 日志和 HPEL 文本日志输出中使用 ISO-8601 格式。 格式为 yyyy-MM-dd'T'HH:mm:ss.SSSZ

如果指定值 false,那么将根据系统中设置的缺省语言环境来格式化日期和时间。 如果找不到缺省语言环境,那么格式为 dd/MMM/yyyy HH:mm:ss:SSS z

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 操作系统上使用 localhost 适配器时,服务器 SOAP 连接超时 (缺省为 10 毫秒) 允许以流方式传输大量数据而不中断。

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

指定值 0 将禁用该超时。

com.ibm.ws.management.event.max_polling_interval

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

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

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

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

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

com.ibm.ws.management.event.pull_notification_timeout

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

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

对于转换用户: 在版本 8.0之前的版本中,如果未对 com.ibm.ws.management.event.pull_notification_timeout 属性指定值,那么即使没有可用的通知,服务器也会立即返回到客户机。

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

com.ibm.ws.management.repository.tempFileKeepTimeMinutes

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

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

如果 com.ibm.ws.management.repository.tempFileSweepIntervalMinutes 属性设置为 0,那么将禁用清除功能,并且在服务器进程失败后保留的任何文件都将保留在配置库临时目录中,直到手动除去这些文件或启用清除功能为止。

避免麻烦: 如果为此属性指定了无效值,那么将使用缺省值。

com.ibm.ws.management.repository.tempFileSweepIntervalMinutes

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

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

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

避免麻烦: 如果为此属性指定了无效值,那么将使用缺省值。

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 元素。

缺省值为 High

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 元素。

缺省值为 Error

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

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

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

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

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

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

缺省值为 false

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

使用此属性来指定相应的负载均衡选项: Round RobinRandom

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

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

缺省值为 Round Robin

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

[9.0.5.15 或更高版本]

com.ibm.ws.pmi.maxUniquePmiMetricCount

当为无界 URL 启用性能监控基础结构 (PMI) URL 统计信息计数器时,您可能会迂到 CPU 使用率高的问题。 com.ibm.ws.pmi.maxUniquePmiMetricCount 定制属性定义在发出建议禁用特定 URL 计数器的警告消息之前跟踪的单个 URL 度量的最大数量。 以下示例显示了警告消息。

CWPMI0109W: 正在针对 {1}PMI 模块 {2} 标识 {3}跟踪超过 {0} 个统计信息。 
通过跟踪大量 PMI 度量值,可能发生性能问题。 
在管理控制台中禁用 {1}PMI 模块 {2} 标识 {3} 。

此属性采用整数值。 缺省值为 500

com.ibm.ws.policyset.exportEncodedPasswords

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

有效值为truefalse

缺省值为 false

com.ibm.ws.readSystemLocale

如果代码需要使用消息中指定的编码以外的编码来处理 JAX-WS SOAP 消息,或者如果未指定编码,那么代码需要使用 Unicode 变换格式 8 位编码格式 (UTF-8) 来处理消息,请将此属性设置为 true 。 如果此属性设置为 true,那么使用的编码是由 file.encoding JVM 属性指定的编码。 缺省值为 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
请记住: 缺省情况下,在 z/OS 操作系统上以及在 HA 环境中的 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 诊断定制属性允许您在服务器关闭期间触发 Java 核心线程转储。 如果要在服务器关闭期间触发 Java 核心线程转储,请将此属性设置为 true缺省值为 false

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

[HP-UX][Solaris]对于其他平台 (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.runtime.suppressClasspathWarnings

启用后,此属性将禁止将 JVM 类路径条目添加到服务器时显示的 WSVR0322W 警告消息。 此警告会提醒用户,他们的配置会使他们面临类装入问题的风险。 禁止警告消息允许了解和接受这些风险的用户除去警告消息,而不是忽略其存在。 这两个属性值都不会对服务器产生任何功能影响。 消息 (以及缺少消息) 完全是参考消息。

缺省值为 false

com.ibm.ws.scripting.apptimeout

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

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

com.ibm.ws.sib.dumpWSRMMessageContext

将此属性设置为 true 可使服务集成总线 (SIB) 转储包括存储在持久 WS-RM 序列中的反序列化应用程序消息。

此属性的缺省值为 false

com.ibm.ws.sib.webservices.useSOAPJMSTextMessages

缺省情况下,在 WebSphere Application Server V 6 或更高版本上,由 Web Services Gateway 发送的 SOAP over JMS Web Service 消息将作为 JmsBytes消息发送。

将此属性设为 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 文件中的所有其他属性都将被忽略,并且将生成高速缓存标识。

对于转换用户: 在 6.0.2之后的版本中,缺省情况下,将对 <required> 属性以及所有其他属性进行求值,以确定是否生成了高速缓存标识。
避免麻烦: 如果将 com.ibm.ws.use602RequiredAttrCompatibility 定制属性设置为 true ,那么 cachespec.xml 文件的行为将还原为 V 6.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> 参数是可选参数。 However, if you do not add this property to your JVM settings and set it to true, an error page defined with just the <location> parameter is ignored.

缺省值为 false

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

[9.0.5.3 或更高版本]

com.ibm.ws.webcontainer.servlet30compatibility

使用此属性可部署具有映射到同一 URL的多个 Servlet 的应用程序。 由于 servlet 3.1 规范中的说明,因此在 V 9.0 中部署此类应用程序失败。 提供此定制属性是为了允许与较早版本兼容。 备用解决方案是修订应用程序中的 servlet 映射,因为 URL 只能提供一个 servlet。

缺省值为 false

将该值设置为 true 以部署具有映射到同一 URL的多个 Servlet 的应用程序。

要点: 此 JVM 定制属性允许部署具有映射到同一 URL的多个 Servlet 的应用程序。 要启动应用程序,请使用相应的 Web 容器定制属性。 有关更多信息,请参阅 com.ibm.ws.webcontainer.servlet30compatibility

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 单向服务通常返回 200 HTTP 状态码。 某些 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 定制属性。

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 请求。

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

com.ibm.ws.webservices.forceLegacyDispatchFromSOAPConnection

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

此属性不适用于使用 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 应用程序能够正确启动,即使 _AbsoluteImport解析器类中表示的模式或 WSDL 文件也引用 https://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 请求中移除端口号,然后再发送该请求。

避免麻烦: 必须在此配置设置生效之前重新启动服务器。

缺省值为 false

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

com.ibm.ws.websvcs.AppendAcceptHeader

使用此属性来指定要附加到 JAX-WS Web Service 请求发送的 HTTP Accept 头的字符串。 缺省值为空。

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.dynamic.ssl.proxy

配置以下内容时,可能会在 Web Service 的连接信息中错误地显示主机或端口信息:
  • TLS 端点在代理设置中配置 (https.proxyHost https.proxyPort)
  • TLS 端点配置为动态出站设置。
当连接由 JAX-WS 提供服务时,连接信息与动态出站设置不匹配。

将此属性设置为 true for JAX-WS 允许 WebSphere Application Server 正确更新连接信息。

缺省值为 false

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 时,才会在 Trace.log 中看到 SOAP 故障异常。

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

com.ibm.ws.websvcs.saaj.converter.defaultReturnEncoding

使用此属性来转换 JAX-WS 处理程序的数据,以使用与 JVM 缺省值不同的编码。 例如,-Dcom.ibm.ws.websvcs.saaj.converter.defaultReturnEncoding=UTF-8。 缺省值为 unset。

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 服务器进行调用时迂到异常。

缺省值为 false

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

com.ibm.ws.websvcs.relaxClientPolsetMatching

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

缺省值为 false

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

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

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

缺省值为 false

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

com.ibm.ws.websvcs.unifyServiceMessage

将此属性设置为 true 以让 JAX-WS 应用程序显示 JAX-RPC 消息。Hi there, this is a Web service!,在浏览器窗口而不是特定于 JAX-WS 的消息中Hello! This is an Axis2 Web Service!

缺省值为 false

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

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

避免麻烦: 如果您具有所有受管客户机或同时具有受管客户机和非受管客户机,那么可以在管理控制台中编辑 覆盖端点 URL 字段。 但是,如果您没有任何受管客户机,那么无法编辑此字段。

通常,您不希望非受管 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 定制属性。

com.ibm.ws.wspolicy.ignoreWSP12inPackagedWSDL

使用此属性并将其设置为值 true ,以便将忽略不属于 WS-Policy 1.5 名称空间的任何 WS-Policy 断言,并且不会导致发出消息 CWPOL0040E 。 在这种情况下,将继续处理客户机代理的 WSDL 中的 WS-Policy ,以便将 WS-Addressing 的任何有效 WS-Policy 1.5 断言应用于 JAX-WS 1.5 断言应用于 JAX-WS 客户机代理。

com.ibm.ws.wspolicy.v7migration.disableClientWSDLWSPolicyProcessing

使用此属性可禁用 WS-Addressing 策略的 JAX-WS 客户机的打包 Web Service 描述语言 (WSDL) 文件的处理。 当此属性设置为 false时,将针对 WS-Addressing 策略处理客户机的 WSDL 文件。 当此属性设置为 true时,将不处理客户机的 WSDL 文件。 缺省值为 FALSE

com.ibm.ws.wssecurity.useInboundBodyOptimization

使用此定制属性向 JVM 指示您希望 WS-Security 运行时强制使用密钥加密。 要强制密钥加密,请将此属性设置为 false

com.ibm.ws.wtp.package.loads

此定制属性支持为归档类装入器装入的类创建包对象。

有效值为 truefalse

缺省值为 false

将此属性设置为 true 以允许为归档类装入器装入的类创建包对象。 要防止为归档类装入器装入的类创建包对象,请将此属性设置为 false

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 数字签名。

避免麻烦: 仅当您的环境包含具有不同修订包级别的应用程序服务器的单元,并且您迂到兼容性问题时,才应将此属性设置为 true
在 V 7.0.0.21 和更低版本以及 8.0.0.3 和更低版本中,当 WS-Security 验证使用 https://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

如果您决定使用此定制属性,那么必须将其指定为应用程序服务器的 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

如果将此 JVM 定制属性设置为较小的值 (例如 2048) ,那么当 64 KB 缓冲区 (缺省值) 仅在使用时由 InputStream 部分填充时,可以减少内存使用量。 会在 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 的进程,您可以忽略此消息。

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 文件。

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。

disable.prejavaee5.application.library

使用此定制属性来控制具有Java EE 5 应用程序部署描述符之前的应用程序是否使用应用程序库文件夹。

WebSphere Application Server v9.0 及更高版本中,当应用程序包含使用 pre-JavaEE5 规范的部署描述符时,将使用缺省值 lib 作为应用程序库文件夹名称。 在较早版本中,当应用程序包含使用 pre-JavaEE5 规范的部署描述符时,已禁用应用程序库文件夹。 当此定制属性设置为 true时,将复原此先前行为,并且将对使用Java EE 5 之前的部署描述符的应用程序禁用应用程序库文件夹。 缺省值为 false

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 定制属性。

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

java.net.preferIPv4Stack

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

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

此定制属性的缺省值是 false

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

java.net.preferIPv6Addresses

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

此定制属性的缺省值是 false

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 分配给任何记录器,因为此分配可能会导致无限循环。

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

缺省值为 false

jaxws.asyncClient.maxThreadPoolSize

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

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

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

jaxws.handler.reducecaching

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

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

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

缺省值为 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 属性。

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 运行时的性能。

缺省值为 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 级别设置此属性,但通常是在应用程序服务器级别指定此属性。

localWebServerUseNodeSync

当 Web 服务器和插件与 Deployment Manager 位于同一系统上时,通常通过简单文件系统从一个目录复制到另一个目录来传播 Web 服务器插件配置文件 plugin-cfg.xml。 如果同一系统 (本地受管节点) 上存在 Node Agent ,那么可以强制 Deployment Manager 将插件配置传播到 Node Agent。 使用节点同步而不是缺省文件系统复制方法。

通过选择 系统管理 > Deployment Manager > Java 和进程管理 > 进程定义 > Java 虚拟机 > 定制属性,转至 Deployment Manager JVM 进程的定制属性。 添加 localWebServerUseNodeSync 属性。

要用于此属性的正确值是与 Web 服务器定义相关联的本地节点的名称,如以下示例中所示:
localWebServerUseNodeSync = wasNode01
如果多个 Web 服务器定义与 Deployment Manager 所在系统上的多个本地节点相关联,请指定多个节点名 (以分号作为它们之间的定界符) ,如以下示例中所示:
localWebServerUseNodeSync = wasNode01;wasNode02

重新启动 Deployment Manager 以使该属性生效。

现在,每当传播 Web 服务器插件时, Deployment Manager 都会同步节点以将 plugin-cfg.xml 文件复制到本地节点代理程序。 然后, Node Agent 将该文件复制到 plugins/config/webservername 目录。 此方法与传播到远程受管节点相同。

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 的版本级别的检查级别。

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

org.apache.taglibs.standard.xml.accessExternalEntity

设置此属性以允许在使用 <x:parse><x:transform> 标记时访问 JSP 文件中的外部实体。

此属性采用诸如以下值的值:
  • all
  • http
  • jar:file,file
  • http,file

分配要授予外部访问权的所有 URI 方案,并使用逗号进行分隔。 使用值 all 来授予对任何 URI 方案的外部访问权。

org.eclipse.jst.j2ee.commonarchivecore.disableZip

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

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

缺省值为 false

还可以通过将以下行添加到 EAR 或 WAR 的 /META-INF/MANIFEST.MF 文件,为特定 EAR 或 WAR 启用此属性:
IBM-Enable-File-List-Include-Filter : true

将此属性添加到 MANIFEST.MF 文件以允许应用程序更快启动,而不考虑系统设置。

避免麻烦: MANIFEST.MF 文件具有格式化规则。 例如,文件必须以换行符或回车符结尾。 如果文件的最后一行未以换行符或回车符结束,那么不会正确解析该文件的最后一行。
[9.0.5.1 或更高版本]

org.eclipse.jst.j2ee.commonarchivecore.EnableFilesListIncludeFilter

使用此定制属性可缩短应用程序启动时间,并在应用程序启动时减少内存使用量。

此属性对于包含许多文件的应用程序很有用。

如果此属性设置为 false,那么应用程序服务器将构建一个列表,其中包含 WAR 文件中每个文件的文件对象。 当应用程序具有许多文件时,列表可能构建速度较慢,并且可以使用大量内存。 将该值设置为 true 以指示应用程序服务器通过仅包含与 Java EE相关的文件来减小其应用程序文件列表大小。 它会排除启动应用程序不需要的文件。

缺省值为 false

还可以通过将以下行添加到 EAR 文件或 WAR 文件的 /META-INF/MANIFEST.MF 文件,为特定 EAR 文件或 WAR 文件启用此属性:
IBM-Enable-File-List-Include-Filter : true

将此属性添加到应用程序的 MANIFEST.MF 文件,以使其能够更快启动,而不考虑系统设置。

避免麻烦: MANIFEST.MF 文件具有格式化规则。 例如,文件必须以换行符或回车符结尾。 如果文件的最后一行未以换行符或回车符结束,那么不会正确解析该文件的最后一行。

org.eclipse.jst.j2ee.commonarchivecore.ibm_webinflib_comparator

此属性是可用于定义 WEB-INF/lib 目录中 JAR 文件的类路径顺序的两个属性之一。 另一个是 org.eclipse.jst.j2ee.commonarchivecore.ibm_webinflib_order

使用此属性来指定实现 java.util.Comparator 接口的类。 比较器类确定 JAR 文件名的排序顺序。 您必须将比较器类放在 <WAS_HOME>/lib/ext 文件夹中。

Java EE 未定义 WEB-INF/lib JAR 文件在类路径中的显示顺序。 缺省顺序是从操作系统返回 JAR 文件列表的顺序。 因此,订单依赖于操作系统。

您的应用程序最好没有对订单的依赖关系。 设置此属性可能会影响服务器上也依赖于类路径顺序的其他应用程序。 因此,最好直接在应用程序中设置 META-INF/MANIFEST.MF 属性,而不是设置此 JVM 定制属性。

要在应用程序中定义 WEB-INF/lib 类路径顺序,请将以下属性添加到应用程序或 Web 模块的 MANIFEST.MF 文件。

属性名称(N): IBM_WEBINFLIB_COMPARATOR

值: fully qualified class name of your custom Comparator class

例如:

IBM_WEBINFLIB_COMPARATOR: my.custom.comparators.CustomComparator

提供了内置的字母比较器。 要将类路径顺序设置为字母顺序,请将 alpha 指定为 IBM_WEBINFLIB_COMPARATOR的值。

例如:

IBM_WEBINFLIB_COMPARATOR: alpha

要定义服务器上所有应用程序的类路径顺序,请设置 JVM 定制属性。 由于此配置可能会影响在服务器上运行的其他应用程序,因此建议仅作为快速且方便的测试。

例如:

org.eclipse.jst.j2ee.commonarchivecore.ibm_webinflib_comparator = my.custom.comparators.CustomComparator

org.eclipse.jst.j2ee.commonarchivecore.ibm_webinflib_order

此属性是可用于定义 WEB-INF/lib 目录中 JAR 文件的类路径顺序的两个属性之一。 另一个是 org.eclipse.jst.j2ee.commonarchivecore.ibm_webinflib_comparator

Java EE 未定义 WEB-INF/lib JAR 文件在类路径中的显示顺序。 缺省顺序是从操作系统返回 JAR 文件列表的顺序。 因此,订单依赖于操作系统。

您的应用程序最好没有对订单的依赖关系。 设置此属性可能会影响服务器上也依赖于类路径顺序的其他应用程序。 因此,最好直接在应用程序中设置 META-INF/MANIFEST.MF 属性,而不是设置此 JVM 定制属性。

要在应用程序中定义 WEB-INF/lib 类路径顺序,请将以下属性添加到应用程序或 Web 模块的 MANIFEST.MF 文件。 您只需要指定具有顺序依赖关系的 JAR 文件名。

属性名称(N): IBM_WEBINFLIB_ORDER

值: comma-separated list of JAR file names

例如:

IBM_WEBINFLIB_ORDER: First.jar, Second.jar, Third.jar

要定义服务器上所有应用程序的类路径顺序,请设置 JVM 定制属性。 由于此配置可能会影响在服务器上运行的其他应用程序,因此建议仅作为快速且方便的测试。

例如:

org.eclipse.jst.j2ee.commonarchivecore.ibm_webinflib_order = First.jar, Second.jar

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

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

如果所有先前条件均为 true ,那么部署可能会失败,因为在部署期间会将应用程序提升到 Java EE 6 级别。 7.x 实现 Java EE 5。 直到 Java EE 6 之后,才会在 WAR 文件中引入 EJB Bean。 当 WebSphere Application Server V 8.0 或更高版本 在 WAR 文件中找到 EJB 时,它会将 WAR 文件提升到 V 3.0 ,并将应用程序提升到 Java EE 6。 发生此情况时,无法将应用程序部署到正在运行 V 7.x的节点。

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

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

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 V 7.x的独立服务器。
  • 尝试从正在运行 WebSphere Application Server V 8.0 或更高版本 的 Deployment Manager 部署到正在运行 WebSphere Application Server V 7.x 的节点时,应用程序部署失败

如果所有先前条件都为 true ,那么部署可能会失败,因为在部署期间会将应用程序提升到 Java EE 6 级别。 WebSphere Application Server V 7.x 实现 Java EE 5 并忽略 Java EE 6 注释。 WebSphere Application Server V 8.0 或更高版本 实现 Java EE 6 ,因此将处理 Java EE 6 注释。 这将导致包含 Java EE 6 注释的 Java EE 5 应用程序提升到 Java EE 6 级别。 提升应用程序后, WebSphere Application Server V 8.0 或更高版本 不会将应用程序部署到运行 WebSphere Application Server V 7.x的节点。

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

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

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

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

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

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

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

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

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

如果所有先前条件均为 true ,那么部署可能会失败,因为在部署期间会将应用程序提升到 Java EE 6 级别。 WebSphere Application Server 7.x 实现 Java EE 5。 直到 Java EE 6 之后,才会在 WAR 文件中引入 Web 片段。 当 WebSphere Application Server Version 8.0 或更高版本 找到 Web 片段时,它会将 WAR 提升到 V 3.0 ,并将应用程序提升到 Java EE 6。 发生这种情况时,无法将应用程序部署到正在运行 WebSphere Application Server V 7.x的节点。

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

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

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 ,并且归档条目路径包含值 ../,那么将发生 ArchiveRuntime异常,并且归档处理将停止。 将此属性设为 true,以记录警告消息并继续部署此应用程序。

缺省值为 false

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

org.eclipse.jst.j2ee.commonarchivecore.unresolvedEjbRefsAreLocal

将此属性设置为 true 会导致应用程序服务器在应用程序部署期间生成合并的 EJB 部署描述符 (例如 ejb-jar_merged.xml ) 时将未解析的 EJB 引用视为本地引用。 缺省行为 false 会导致应用程序服务器将未解析的 EJB 引用视为远程引用。

您可能会发现在部署后,在 ejb-jar_merged.xml 文件中错误地生成了 EJB 引用作为远程引用。 在这种情况下,请先尝试使用以下方法解决问题,然后再设置此定制属性。
  • 将 EJB 绑定文件添加到应用程序,这是解决问题的最安全方法。 有关更多信息,请参阅有关 EJB 3.0 和 EJB 3.1 应用程序绑定的概述主题。
  • 仅当 EJB 模块已元数据完成时, EJB 运行时才使用 ejb-jar_merged.xml 文件。 即使是元数据完成时,仅当不存在绑定时, EJB 模块才会使用该引用。 如果在 EJB 模块中将 metadata-complete 设置为 false ,那么将忽略 ejb-jar_merged.xml 文件,并且 EJB 运行时将正确解析 EJB 引用。 有关更多信息,请参阅有关模块设置的元数据的主题。

如果这两种方法都不可行,请使用此定制属性,以便应用程序服务器在应用程序部署期间将未解析的 EJB 引用视为本地引用。 将此属性设置为 true时请务必谨慎,因为这可能会导致相反的问题。 如果部署包含远程 EJB 引用的应用程序,那么这些远程引用 (如果未解析) 可能会在 ejb-jar_merged.xml 文件中设置为本地引用。 因此,请仅在受影响的应用程序上而不是在服务器上设置此属性。

要在应用程序上设置属性,请将以下行添加到应用程序的 MANIFEST.MF 文件:
IBM-UNRESOLVED-EJB-REFS-ARE-LOCAL-PI68735: true

此属性仅在应用程序部署期间有效。 它不会影响已部署的应用程序。

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 个设置为 running 状态的 JVM ,这表示只要 Node Agent 启动就会启动这些 JVM。 如果为此属性指定 3 ,那么每当停止并启动 Node Agent 时,只有 10 个 JVM 中的 3 个在 Node Agent 启动时并行启动。

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

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

webservices.unify.faults

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

此属性的缺省值是 true,这将导致要统一故障。 如果应用程序需要故障详细信息,那么您可以将此属性设为 false 以禁用故障统一,从而允许在故障中返回详细信息。
避免麻烦:
无论属性设置如何,都可能出现以下情况:
  • 如果 SOAP 请求格式不正确,那么javax.xml.stream.XMLStreamException错误消息不统一。
  • 如果在 WSDL 文件中定义了已检查的异常并由服务提供者方法实现抛出,那么这些异常不会统一。
  • 如果启用了跟踪,那么将记录有关故障原因的详细信息。

wink.client.readTimeout

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

缺省值为 60,000 毫秒。

wink.client.connectTimeout

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

缺省值为 60,000 毫秒。

WSFP_DISABLE_CACHE

将此属性设置为 true 以在部署期间 (例如,当 Web Service 高速缓存已损坏或无法正确构建时) 缓解不正确的 Web Service 高速缓存生成。 高速缓存损坏的症状包括无法检索生成的 WSDL 或其他错误,例如 SRVE0201E 或 WSWS3142E。

在正常情况下不需要此属性,设置此属性会降低应用程序启动速度。

缺省值为 false