服务器设置配置脚本

该脚本编制库提供多个脚本过程来自动完成应用程序服务器配置。使用应用程序服务器脚本来配置类装入器、Java™ 虚拟机 (JVM) 设置、Enterprise JavaBeans (EJB) 容器、性能监视和动态高速缓存等。可以分别运行每个脚本,也可将过程组合在一起来为环境创建定制自动执行脚本。

configureAdminService

此脚本为 AdminService 接口配置设置。AdminService 接口是应用程序服务器管理功能的服务器端接口。

表 1. configureAdminService 参数描述. 以节点名称、服务器名称、本地连接协议和远程连接协议运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
localAdminProtocol 指定要用来为本地连接将 AdminService 接口连接至应用程序服务器的连接器类型。
remoteAdminProtocol 指定要用来为远程连接将 AdminService 接口连接至应用程序服务器的连接器类型。
otherAttributeList (可选)使用以下格式指定其他属性:[[“enabled”, “true”], [“pluginConfigService”, “(cells/timmieNode02Cell/nodes/timmieNode01/servers/server1|server.xml#PluginConfigService_1183122130078)”]]

语法

AdminServerManagement.configureAdminService(nodeName, serverName, localAdminProtocol, remoteAdminProtocol, otherAttributeList)

用法示例

AdminServerManagement.configureAdminService(“"myNode"”, "myServer", "IPC", "SOAP",
    [["enabled", "true"], ["pluginConfigService", 
       "(cells/timmieNode02Cell/nodes/timmieNode01/servers/server1|server.xml#PluginConfigService_1183122130078)"]])

configureApplicationServerClassloader

此脚本为应用程序服务器配置类装入器。类装入器允许应用程序服务器上部署的应用程序访问可用类和资源的存储库。

表 2. configureApplicationServerClassloader 参数描述. 以节点名称、服务器名称、策略、模式和库名称参数运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
policy 将应用程序类装入器策略指定为 SINGLEMULTIPLE。指定 SINGLE 值来防止隔离应用程序和配置应用程序服务器以使用单个应用程序类装入器在系统中装入所有 EJB 模块、共享库和依赖项 Java 归档 (JAR) 文件。指定 MULTIPLE 值来隔离应用程序并为每个应用程序提供其自己的类装入器以装入 EJB 模块、共享库和依赖项 JAR 文件。
mode 将类装入器方式指定为 PARENT_FIRSTAPPLICATION_FIRSTPARENT_FIRST 选项使类装入器先将类的装入委托给它的父类装入器进行,然后再尝试从它的本地类路径中装入类。APPLICATION_FIRST 选项使类装入器在将类装入委托给它的父代前,尝试从它的本地类路径装入类。使用此策略,应用程序类装入器可覆盖并提供存在于父类装入器中的其自己版本的类。
libraryName 指定相关共享库的名称。

语法

AdminServerManagement.configureApplicationServerClassloader(nodeName, serverName,
 policy, mode, libraryName)

用法示例

AdminServerManagement.configureApplicationServerClassloader("myNode", "myServer", "MULTIPLE", "PARENT_FIRST", 
“myLibraryReference”)

configureDynamicCache

此脚本在服务器配置中配置动态高速缓存服务。动态高速缓存服务在应用程序服务器 JVM 中工作,从而拦截对可高速缓存对象的调用。例如,动态高速缓存服务通过 Servlet 服务方法或命令执行方法拦截调用,以及将对象的输出存储到高速缓存或服务于来自动态高速缓存的对象内容。

表 3. configureDynamicCache 参数描述. 以节点名称、服务器名称、缺省优先级、高速缓存大小、外部高速缓存组名称和外部高速缓存组类型参数运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
defaultPriority 指定高速缓存条目的缺省优先级,确定高速缓存满时一个条目能保留多久。指定 1 与 255 之间的整数。
cacheSize 指定一个正整数作为高速缓存保存的最大条目数的值。在此字段中输入高速缓存大小值,范围在 100 到 200000 之间。
externalCacheGroupName 外部高速缓存组名需要与 Servlet 或 JavaServer Pages (JSP) 文件 cachespec.xml 文件中定义的 ExternalCache 属性匹配。当启用外部高速缓存时,高速缓存会将页面与其通用资源标识 (URI) 进行匹配,并将匹配的页面推入外部高速缓存。于是,可以从外部高速缓存(而不是从应用程序服务器)提供条目。
externalCacheGroupType 指定外部高速缓存组类型。
otherAttributeList (可选)使用以下格式为动态高速缓存服务指定其他配置选项:[[“cacheProvider”, “myProvider”], [“diskCacheCleanupFrequency”, 2], [“flushToDiskOnStop”, “true”]]

语法

AdminServerManagement.configureDynamicCache(nodeName, serverName, defaultPriority, 
    cacheSize, externalCacheGroupName, externalCacheGroupType,
    otherAttributeList)

用法示例

AdminServerManagement.configureDynamicCache("myNode", "myServer", 2, 5000, "EsiInvalidator",
   "SHARED", [["cacheProvider", "myProvider"], ["diskCacheCleanupFrequency", 2], ["flushToDiskOnStop","true"]])

configureEJBContainer

此脚本在服务器配置中配置 Enterprise JavaBeans (EJB) 容器。EJB 容器为应用程序服务器中的企业 Bean 提供运行时环境。容器处理应用程序服务器中企业 Bean 操作的各个方面,并充当 Bean 中用户编写的业务逻辑与应用程序环境中其他方面之间的中介。

表 4. configureEJBContainer 参数描述. 以节点名、服务器名称、钝化目录和缺省数据源 Java 命名和目录接口 (JNDI) 名称参数运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
passivationDirectory 指定一个目录,容器将在该目录中保存已钝化的有状态会话 Bean 的持久状态。此目录必须已存在。不会自动创建此目录。
defaultDatasourceJNDIName 指定当应用程序部署期间未指定数据源时要使用的数据源的 JNDI 名称。此设置不适用于符合 EJB 2.x 的容器管理的持久性 Bean。

语法

AdminServerManagement.configureEJBContainer(nodeName, serverName, 
passivationDir, defaultDatasourceJNDIName)

用法示例

[Windows]
AdminServerManagement.configureEJBContainer(myNode, myServer, C:\temp\myDir, jndi1)
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
AdminServerManagement.configureEJBContainer(myNode, myServer, /temp/myDir, jndi1)

configureFileTransferService

此脚本配置应用程序服务器的文件传输服务。文件传输服务将文件从 Deployment Manager 传送到各个远程节点。

表 5. configureFileTransferService 参数描述. 以节点名、服务器名称、重试文件传输的次数以及在重试文件传输之前等待的时间来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
retriesCount 指定您要文件传输服务在发生通信故障后重试发送或接收文件的次数。缺省值为 3
retryWaitTime 指定文件传输服务在重试传送失败的文件之前等待的秒数。缺省值为 10
otherAttributeList (可选)使用以下格式指定其他属性:[[“enable”, “true”]]

语法

AdminServerManagement.configureFileTransferService(nodeName, serverName, retriesCount, retryWaitTime, otherAttributeList)

用法示例

AdminServerManagement.configureFileTransferService(myNode, myServer, 5, 600, [["enable", "true"]])

configureListenerPortForMessageListenerService

此脚本在服务器配置中配置用于消息侦听器服务的侦听器端口。消息侦听器服务是对 JMS 提供程序的 Java 消息传递服务 (JMS) 功能的扩展。它提供了用于控制和监视一个或多个 JMS 侦听器的侦听器管理器,每个 JMS 侦听器都代替已部署的消息驱动的 bean 来监视 JMS 目标。

表 6. configureListenerPortForMessageListenerService 参数描述. 以节点名、服务器名称、侦听器端口名称、连接工厂 JNDI 名称、目标 JNDI 名称、最大消息数、最大重试次数和最大会话数参数来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
listenerPortName 标识侦听器端口的名称,供管理使用。
connectionFactoryJNDIName 侦听器端口所使用 JMS 连接工厂的 JNDI 名称;例如,jms/connFactory1
destinationJNDIName 侦听器端口所使用目标的 JNDI 名称;例如,jms/destn1
maxMessages 侦听器在一个事务中可以处理的最大消息数。如果队列为空,那么侦听器在消息达到时处理每条消息。 在独立的事务中处理每条消息。
maxRetries 在侦听器停止前,侦听器尝试发送消息的最大次数(在范围 0 到 2147483647 中)。在侦听器停止前,侦听器尝试将消息发送到消息驱动的 bean 实例的最大次数。
maxSession 指定在 JMS 服务器中侦听器可以拥有的处理消息的最大并行会话数。每个会话对应于一个单独的侦听器线程,并因此控制并行处理的消息数。当服务器未充分利用机器的可用容量,并且您不需要按特定消息顺序来处理消息时,请调整此参数。

语法

AdminServerManagement.configureListenerPortForMessageListener(nodeName, serverName,
 listenerPortName, connectionFactoryJNDIName,
     destinationJNDIName, maxMessages, maxRetries, maxSession)

用法示例

AdminServerManagement.configureListenerPortForMessageListener(myNode, myServer, myListenerPort,
 connJNDI, destJNDI, 5, 2, 3)

configureMessageListenerService

此脚本在服务器配置中配置消息侦听器服务。消息侦听器服务是对 JMS 提供程序的 Java 消息传递服务 (JMS) 功能的扩展。它提供了用于控制和监视一个或多个 JMS 侦听器的侦听器管理器,每个 JMS 侦听器都代替已部署的消息驱动的 bean 来监视 JMS 目标。

表 7. configureMessageListenerService 参数描述. 以节点名、服务器名称、最大消息侦听器重试次数、侦听器恢复时间间隔、池阈值和池超时参数来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
maxListenerRetry 指定此服务管理的侦听器端口在放弃并停止前尝试从故障恢复的最大次数。停止后,相关的侦听器端口就会转入停止状态。
listenerRecoveryInterval 指定侦听器端口在两次重试尝试从故障恢复之间的秒数。
poolingThreshold 指定池中未使用连接的最大数。缺省值为 10
poolingTimeout 指定毫秒数,在此毫秒数后将销毁池中尚未使用的连接。MQSimpleConnectionManager 根据最近使用基础分配连接,并根据最先前使用基础销毁连接。缺省情况下,如果连接有 5 分钟处于未使用状态,那么销毁它。
otherAttributeList (可选)使用以下格式指定其他消息侦听器属性:[[“description”, “test message listener”], [“isGrowable”, “true”], [“maximumSize”, 100], [“minimumSize”, 5]]

语法

AdminServerManagement.configureMessageListenerService(nodeName, serverName,
 maxListenerRetry, listenerRecoveryInterval,
     poolingThreshold, poolingTimeout, otherAttributeList)

用法示例

AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120,
 20, 600000, myProp, myValue,
      [["description", "test message listener"], ["isGrowable", "true"], ["maximumSize", 100], ["minimumSize", 5]])

configureStateManageable

此脚本配置应用程序服务器的初始状态。该初始状态指的是服务器进程启动时组件的正常状态。

表 8. configureStateManageable 参数描述. 以节点名称、服务器名称、父类型和初始状态参数运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
parentType 指定要修改的组件的类型。
initialState 指定当服务器进程启动时期望的组件状态。有效值为 STARTSTOP

语法

AdminServerManagement.configureStateManageable(nodeName, serverName,
 parentType, initialState)

用法示例

AdminServerManagement.configureStateManageable(myNode, myServer, "Server", "START")

configureCustomProperty

此脚本在应用程序服务器配置中配置定制属性。可以将定制属性用于配置一些组件使用的内部系统属性(例如,用来将信息传递至 Web 容器)。

表 9. configureCustomProperty 参数描述. 以节点名称、服务器名称、父类型、属性名称和属性值参数运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
parentType 指定要配置的组件的类型。
propertyName 指定要配置的定制属性。
propertyValue 指定要配置的定制属性的值。
otherAttributeList (可选)使用以下格式指定其他属性:[[“commTraceEnabled”, “true”], [“enable”, “true”]]

语法

AdminServerManagement.configureCustomProperty(nodeName, serverName, parentType, propertyName, propertyValue, otherAttributeList)

用法示例

AdminServerManagement.configureCustomProperty(myNode, myServer, “ThreadPool”, myProp1, myPropValue,
    [[“description”, my property test], [“required”, “false”]])

configureCustomService

此脚本在应用程序服务器配置中配置定制服务。各个定制服务都定义每当服务器启动和关闭时装入并初始化的类。这些类中的每个类都必须实现 com.ibm.websphere.runtime.CustomService 接口。在创建定制服务后,应使用管理控制台来对应用程序服务器配置该定制服务。

表 10. configureCustomService 参数描述. 以节点名称、服务器名称和首选接口类型来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
classname 指定服务实现的类名。此类必须实现定制服务接口。
displayname 指定服务的名称。
classpath 指定用于查找此服务的类和 JAR 文件的类路径。
otherAttributeList (可选)使用以下格式指定其他属性:[[“description”, “test custom service”], [“enable”, “true”]]

语法

AdminServerManagement.configureCustomService(nodeName, serverName, classname, displayname, classpath, otherAttributeList)

用法示例

[Windows]
AdminServerManagement.configureCustomService(myNode, myServer, myClass, myName, “C:\temp\boo.jar”,
     [[“description”, “test custom service”], [“enable”, “true”]])
[AIX][HP-UX][Linux][Solaris][IBM i][z/OS]
AdminServerManagement.configureCustomService(myNode, myServer, myClass, myName, “/temp/boo.jar”,
     [[“description”, “test custom service”], [“enable”, “true”]])

configureEndPointsHost

表 11. configureEndPointsHost 参数描述. 运行脚本以配置服务器端点的主机名。 指定节点名、服务器名称和主机名参数。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
hostName 指定相关主机的名称。

语法

AdminServerManagement.configureEndPointsHost(nodeName, serverName, hostName)

用法示例

AdminServerManagement.configureEndPointsHost(myNode, AppServer01, myHostname)

configureJavaVirtualMachine

此脚本配置 Java 虚拟机 (JVM)。由于应用程序服务器是一个 Java 进程,因此需要 JVM,才能运行应用程序服务器以及支持在该 JVM 上运行的 Java 应用程序。

表 12. configureJavaVirtualMachine 参数描述. 以相关 JVM 的配置标识、是否启用调试方式和其他调试参数来运行该脚本。
自变量 描述
javaVirtualMachineConfigID 指定要进行更改的 Java 虚拟机的配置标识。
debugMode 指定是否以调试方式运行 JVM。缺省情况为不启用调试方式支持。如果将 debugMode 参数设置为 true,那么必须指定调试参数。
debugArgs 指定要传递至用于启动应用程序服务器进程的 JVM 代码的调试参数。如果对同一个节点上的多个应用程序服务器启用调试,请确保服务器使用不同的地址参数,这些参数定义了用于调试的端口。例如,如果您在两个服务器上启用调试,并且让每个服务器的缺省调试端口保留为 address=7777,那么这两个服务器可能无法正确启动。
otherAttributeList (可选)使用以下名称/值对格式指定其他属性:[[“internalClassAccessMode”, “RESTRICT”], [“disableJIT”, “false”], [“verboseModeJNI”, “false”]]

语法

AdminServerManagement.configureJavaVirtualMachine(javaVirtualMachineConfigID,
 debugMode, debugArgs, otherAttributeList)

用法示例

AdminServerManagement.configureJavaVirtualMachine
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaVirtualMachine_1208188803955)", "true",
   mydebug, [["internalClassAccessMode", "RESTRICT"], ["disableJIT", "false"], ["verboseModeJNI", "false"]])

configureORBService

此脚本在服务器配置中配置对象请求代理 (ORB) 服务。对象请求代理 (ORB) 使用因特网 ORB 间协议 (IIOP) 来管理客户机与服务器之间的交互。在分布式网络环境中,它支持客户机发出请求并从服务器接收响应。

表 13. configureORBService 参数描述. 以节点名、服务器名称、请求超时、请求重试次数、请求重试延迟、最大连接高速缓存、最小连接高速缓存和定位请求超时参数来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
requestTimeout 指定请求消息超时之前要等待的秒数。

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

[AIX Solaris HP-UX Linux Windows][IBM i]指定服务器发生故障时 ORB 尝试发送请求的次数。通过进行重试,有时能从瞬态网络故障中恢复。在 z/OS® 平台上,将忽略此字段。

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

[AIX Solaris HP-UX Linux Windows][IBM i]指定请求重试之间的毫秒数。在 z/OS 平台上忽略此字段。

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

[AIX Solaris HP-UX Linux Windows][IBM i]指定可以占用 ORB 连接高速缓存的最大条目数,达到此数目后,ORB 就会开始从高速缓存中移除不活动的连接。在 z/OS 平台上,将忽略此字段。高速缓存中的活动连接数可能会暂时地超出此阈值。(如有必要)只要有资源可用,ORB 就会一直添加连接。

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

[AIX Solaris HP-UX Linux Windows][IBM i]指定 ORB 连接高速缓存中的最小条目数。在 z/OS 平台上忽略此字段。当条目数低于此值时,ORB 不会移除不活动的连接。

locateRequestTimeout 指定 LocateRequest 消息超时之前要等待的秒数。在 z/OS 平台上忽略此字段。
otherAttributeList (可选)使用以下格式指定其他属性:[[“commTraceEnabled”, “true”], [“enable”, “true”]]

语法

AdminServerManagement.configureORBService(nodeName, serverName, requestTimeout, requestRetriesCount, requestRetriesDelay,
   connectionCacheMax, connectionCacheMin, locateRequestTimeout, otherAttributeList)

用法示例

AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120, 20, 600000, 20, 300, 
[["commTraceEnabled", "true"], ["enable", "true"]])

configureProcessDefinition

此脚本配置服务器进程定义。通过定义用于启动或初始化应用程序服务器进程的命令行信息,来增强应用程序服务器的操作。进程定义设置定义运行时属性,例如要运行的程序、用于运行程序的参数以及工作目录。

要运行该脚本,请指定节点名和服务器名称参数,如下表中所定义:
表 14. configureProcessDefinition 参数描述. 以节点名称、服务器名称和其他参数(根据需要)来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
otherParamList 使用以下格式为进程定义配置指定其他参数:[[“executableName”, “value1”], [“executableArguments”, “value2”], [“workingDirectory”, “value3”]]

语法

AdminServerManagement.configureProcessDefintion(nodeName, serverName, otherParamList)

用法示例

AdminServerManagement.configureProcessDefinition(myNode, myServer,
   [[executableName, "value1"],["executableArguments"."value2"],["workingDirectory","value3"]])

configureRuntimeTransactionService

此脚本配置服务器配置的事务服务。事务服务是服务器运行时组件,可以协调对多个资源管理器进行的更新以确保进行原子数据更新。由应用程序或部署应用程序的容器开始和结束事务。

表 15. configureRuntimeTransactionService 参数描述. 以节点名称、服务器名称、总事务生存期超时和客户机非活动超时参数运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
totalTranLifetimeTimeout 指定缺省最大时长(以秒计),允许在事务服务触发超时完成之前在此服务器上启动的事务。将回滚任何未在此超时发生之前开始完成处理的事务。
clientInactivityTimeout 指定来自远程客户机的事务请求之间的最大持续时间(以秒计)。任何超出此超时值的客户机不活动时间段都将导致在此应用程序服务器中回滚事务。如果将此值设置为 0,那么表示没有超时限制。

语法

AdminServerManagement.configureRuntimeTransactionService(nodeName, serverName,
 totalTranLifetimeTimeout, clientInactivityTimeout)

用法示例

AdminServerManagement.configureRuntimeTransactionService(myNode, myServer, "600", "600")
[AIX Solaris HP-UX Linux Windows][IBM i]

configureThreadPool

此脚本在服务器配置中配置线程池。线程池使服务器的组件能够重复使用线程,从而不必在运行时创建新线程。创建新的线程将耗费时间和资源。

表 16. configureThreadPool 参数描述. 以节点名、服务器名称、父类型、线程池名称、最大大小、最小大小和超时发生之前经过的时间量来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
parentType 指定要配置的组件的类型。
threadPoolName 指定相关线程池的名称。
maximumSize 指定要在缺省线程池中维护的最大线程数。如果 Tivoli® Performance Viewer 显示最大百分比度量值以始终保持在双精度数字,那么考虑增加最大大小。最大百分比度量值表明使用已配置线程的时间量。
minimumSize 指定池中允许的最小线程数。应用程序服务器启动时,一开始未对线程池指定任何线程。线程将添加至线程池,原因是分配给应用程序服务器的工作负载需要他们,直到池中的线程数等于在“最小大小”字段中指定的数字。此时间点后,当工作负载更改时会添加和移除其他线程。但是,池中的线程数永远不会降至“最小大小”字段中指定的数字之下,即使某些线程空闲。
inactivityTimeout 指定在收回线程之前应该经过的不活动的毫秒数。值为 0 指示不等待,而负值(小于 0)意味着永远等待。
otherAttributeList 按以下格式指定其他配置属性:[[“description”, “testing thread pool”], [“isGrowable”, “true”], [“name”, “myThreadPool”]]

语法

AdminServerManagement.configureThreadPool(nodeName, serverName,
 parentType, threadPoolName, maximumSize,
 minimumSize, inactivityTimeout, otherAttributeList)

用法示例

AdminServerManagement.configureThreadPool
   ("acmeNode2", "server1", "ThreadPoolManager", "WebContainer", 15, 25, 60)

configureTransactionService

此脚本配置应用程序服务器的事务服务。可将事务与应用程序配合使用来协调作为原子单元(不可分工作单元)的资源进行多次更新,以使所有更新持久或都不持久。

表 17. configureTransactionService 参数描述. 以节点名、服务器名称、总事务生存期超时、客户机不活动超时、最大事务超时、试探重试限制、试探重试等待、传播或 BMT 事务生存期超时和异步响应超时参数来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器名称。
totalTranLifetimeTimeout

指定缺省最大时长(以秒计),允许在事务服务触发超时完成之前在此服务器上启动的事务。将回滚任何未在此超时发生之前开始完成处理的事务。仅当应用程序组件未设置自己的事务超时时,才使用此超时。

只有总事务生存期超时和最长事务超时才有宽限期。可使用 DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD 定制属性禁用宽限期。

clientInactivityTimeout 指定来自远程客户机的事务请求之间的最大持续时间(以秒计)。任何超出此超时值的客户机不活动时间段都将导致在此应用程序服务器中回滚事务。如果将此值设置为 0,那么表示没有超时限制。
maximumTransactionTimeout 指定事务超时的上限(以秒计),允许在此服务器中运行的事务在这段时间内完成。此值应该大于或等于合计事务超时值。此超时会约束所有其他事务超时的上限。
heuristicRetryLimit 指定应用程序服务器重试完成信号(如落实或回滚)的次数。资源管理器或远程伙伴发生瞬态异常后,或者配置的异步响应超时到期而所有 Web Service 原子事务 (WS-AT) 伙伴尚未响应,那么会进行重试。
heuristicRetryWait 资源管理器或远程伙伴发生瞬态异常之后,应用程序服务器在重试完成信号(如落实或回滚)之前等待的秒数。
propogatedOrBMTTranLifetimeTimeout 指定事务在回滚前保持不活动的秒数。
asyncResponseTimeout 指定时长(以秒计),服务器在这段时间内等待入站 Web Service 原子事务 (WS-AT) 协议响应,然后重新发送先前的 WS-AT 协议消息。
otherAttributeList (可选)使用以下格式指定其他属性:[[“LPSHeuristicCompletion”, “ROLLBACK”], [“WSTransactionSpecificationLevel”, “WSTX_10”], [“enable”, “true”]]

语法

AdminServerManagement.configureTransactionService(nodeName, serverName, 
totalTranLifetimeTimeout, clientInactivityTimeout,
   maximumTransactionTimeout, heuristicRetryLimit, heuristicRetryWait, 
   propogatedOrBMTTranLifetimeTimeout, asyncResponseTimeout, otherAttributeList)

用法示例

AdminServerManagement.configureTransactionService(myNode, myServer, 
    120, 60, 5, 2, 5, 300, 30, 
    [["LPSHeuristicCompletion", "ROLLBACK"], ["WSTransactionSpecificationLevel", "WSTX_10"], ["enable", "true"]])

setJVMProperties

此脚本为 JVM 配置设置其他属性。

表 18. setJVMProperties 参数描述. 以节点名、服务器名称、类路径、引导类路径、初始堆大小、最大堆大小、是否启用调试方式和调试参数来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
classPath (可选)指定 Java 虚拟机代码用来查找类的标准类路径。
bootClasspath (可选)指定 JVM 代码的引导程序类和资源。只有支持引导程序类和资源的 JVM 指令才能使用该选项。
initialHeapSize (可选)指定 JVM 代码可用的初始堆大小(以兆字节计)。增加最小堆大小可改进启动。减少发生垃圾回收的次数,并且可实现 10% 的性能增益。通常,增加 Java 堆的大小会改进吞吐量,直到堆不再保留在物理内存中。当堆开始交换到磁盘后,Java 性能会大幅下降。
maxHeapSize (可选)指定 JVM 代码可用的最大堆大小(以兆字节计)。增加堆大小可改进启动。通过增加堆大小,您可以减少发生垃圾回收的次数,并且可实现 10% 的性能增益。
debugMode (可选)指定是否以调试方式运行 JVM。缺省情况为不启用调试方式支持。如果将 debugMode 参数设置为 true,那么必须指定调试参数。
debugArgs (可选)指定传递到启动应用程序服务器进程的 JVM 代码的调试参数。如果对同一个节点上的多个应用程序服务器启用调试,请确保服务器使用不同的地址参数,这些参数定义了用于调试的端口。例如,如果您在两个服务器上启用调试,并且让每个服务器的缺省调试端口保留为 address=7777,那么这两个服务器可能无法正确启动。

语法

AdminServerManagement.setJVMProperties(nodeName, serverName, 
classPath, bootClasspath, initialHeapSize, 
maxHeapSize, debugMode, debugArgs)

用法示例

[Windows]
AdminServerManagement.setJVMProperties(myNode, myServer, "c:\a.jar", "", "”, "", "", "")
[Linux][AIX][HP-UX][Solaris][z/OS][IBM i]
AdminServerManagement.setJVMProperties(myNode, myServer, "/a.jar", "", "”, "", "", "")

setTraceSpecification

此脚本为配置设置跟踪规范。

表 19. setTraceSpecification 参数描述. 以节点名称、服务器名称和跟踪规范参数运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
traceSpecification (可选)指定传递到启动应用程序服务器进程的 JVM 代码的调试参数。如果对同一个节点上的多个应用程序服务器启用调试,请确保服务器使用不同的地址参数,这些参数定义了用于调试的端口。例如,如果您在两个服务器上启用调试,并且让每个服务器的缺省调试端口保留为 address=7777,那么这两个服务器可能无法正确启动。

语法

AdminServerManagement.setJVMProperties(nodeName, serverName, traceSpecification)

用法示例

AdminServerManagement.setTraceSpecification(myNode, myServer, "com.ibm.ws.management.*=all")

configureCookieForServer

此脚本在应用程序服务器配置中配置 Cookie。配置 Cookie 以跟踪会话。

表 20. configureCookieForServer 参数描述. 以节点名、服务器名称、Cookie 名称、域、最大 Cookie 时效以及是否保护 Cookie 来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
cookieName 为会话管理 cookie 指定一个唯一的名称。Servlet 规范要求该名称为 JSESSIONID。然而,为了灵活起见,可以配置该值。
domain 指定会话跟踪 cookie 的域字段。该值控制浏览器是否发送 cookie 到特定服务器。例如,如果指定了特定的域,就会将会话 cookie 发送到该域中的主机。缺省域为该服务器。
maximumAge 指定 Cookie 在客户机浏览器中存活的时长。指定 cookie 存活的时间仅与当前浏览器会话一样长,或者为最长时效。如果您选择最长时效选项,那么以秒为单位指定它的时效。该值对应于 Cookie 规范中描述的生存时间 (TTL) 值。缺省值为当前浏览器会话,这相当于将值设置为 -1
secure 指定会话 cookie 要包含安全字段。如果启用此功能,那么只有 HTTPS 会话才能交换 cookie。
otherAttributeList (可选)使用以下格式指定其他属性:[[“path”, “C:/temp/mycookie”]]

语法

AdminServerManagement.configureCookieForServer(nodeName, serverName, cookieName, domain, maximumAge, secure, otherAttributeList)

用法示例

AdminServerManagement.configureCookieForServer(myNode, myServer, myCookie, "uk.kingdom.com", -1, "true", [["path", "C:/temp/mycookie"]])

configureHTTPTransportForWebContainer

此脚本为 Web 容器配置 HTTP 传输方法。传输方法提供 Web 服务器的应用程序服务器插件和应用程序的 Web 模块所在的 Web 容器之间的请求队列。当您在 Web 浏览器中请求应用程序时,请求被传递到 Web 服务器,然后一直传输到 Web 容器。

表 21. configureHTTPTransportForWebContainer 参数描述. 以节点名、服务器名称、是否调整端口、是否为外部、要使用的安全套接字层 (SSL) 配置以及是否启用 SSL 来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
adjustPort 指定是否自动调整相关 Web 容器的端口。
external 指定是否将 Web 容器的 HTTP 传输方法设置为外部。
sslConfig 为 WebSphere Application Server 插件与应用程序服务器之间的连接指定安全套接字层 (SSL) 设置类型。选项包括“安全中心”中定义的一个或多个启用 SSL 的设置;例如 DefaultSSLSettings、ORBSSLSettings 或 LDAPSSLSettings。
sslEnabled 指定是否通过安全套接字层 (SSL) 来对 WebSphere Application Server 插件与应用程序服务器之间的连接进行保护。缺省值为不使用 SSL。

语法

AdminServerManagement.configureHTTPTransportForWebContainer(nodeName, serverName,
 adjustPort, external, sslConfig, sslEnabled)

用法示例

AdminServerManagement.configureHTTPTransportForWebContainer(myNode, myServer, "true", "true", “mySSLConfig”, "true")

configureSessionManagerForServer

此脚本配置应用程序服务器的会话管理器。会话允许在 Web 容器中运行的应用程序跟踪个别用户。

表 22. configureSessionManagerForServer 参数描述. 以节点名称、服务器名称和会话持久性模式来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
sessionPersistenceMode 指定会话持久性方式。有效值包括 DATABASE, DATA_REPLICATION,NONE
otherAttributeList (可选)使用以下格式指定其他属性:[[“accessSessionOnTimeout”, “true”], [“enabled”, “true”]]

语法

AdminServerManagement.configureSessionManagerForServer(nodeName, serverName, 
sessionPersistenceMode, otherAttributeList)

用法示例

AdminServerManagement.configureSessionManagerForServer(myNode, myServer, "DATABASE", 
[["accessSessionOnTimeout", "true"], ["enabled", "true"]])

configureWebContainer

此脚本在应用程序服务器配置中配置 Web 容器。Web 容器处理对 Servlet、JavaServer Pages (JSP) 文件和其他类型的包含服务器端代码的文件的请求。Web 容器创建 Servlet 实例,装入和卸装 Servlet,创建和管理请求和响应对象,以及执行其他 Servlet 管理任务。

表 23. configureWebContainer 参数描述. 以节点名、服务器名称、缺省虚拟主机名称以及是否启用 Servlet 高速缓存来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
webContainerName 指定相关 Web 容器的名称。
defaultVirtualHostName 指定使单个主机能够相当于多个主机的虚拟主机。即使多个虚拟主机共享同一物理机器,与一个虚拟主机相关联的资源也不能与另一虚拟主机所关联的资源共享数据。有效值包括:
default_host
产品提供了具有一些公共别名(例如机器的 IP 地址、短主机名称和标准主机名称)的缺省虚拟主机。别名组成用于访问资源(如 Servlet)的路径的第一部分。例如,在请求 http://localhost:9080/myServlet 中它是 localhost:9080。
admin_host
这是应用程序服务器的另一个名称;在基本安装中也称为 server1。此进程支持使用管理控制台。
proxy_host
名为 proxy_host 的虚拟主机包括缺省端口定义,即端口 80 和 443,这两个端口通常是在代理服务器初始化期间初始化的。请适当地将此代理主机与该代理服务器相关联的路由规则配合使用。
enableServletCaching

指定如果一旦调用 Servlet 并且它生成要高速缓存的输出,那么创建的高速缓存条目不但包含输出还包含调用的副作用。这些副作用可能包含对其他 Servlet 或 JavaServer Pages (JSP) 文件的调用以及有关条目的元数据(包括超时和条目优先级信息)。

Portlet 片段高速缓存要求启用 Servlet 高速缓存。因此,如果启用 portlet 片段高速缓存,就会自动启用 Servlet 高速缓存。如果禁用 Servlet 高速缓存,也将自动禁用 Portlet 片段高速缓存。

otherAttributeList (可选)使用以下格式指定其他属性:[[“allowAsyncRequestDispatching”, “true”], [“disablePooling”, “true”], [“sessionAffinityTimeout”, 20]]

语法

AdminServerManagement.configureWebContainer(nodeName, serverName, 
defaultVirtualHostName, enableServletCaching, otherAttributeList)

用法示例

AdminServerManagement.configureWebContainer(myNode, myServer, myVH.uk.kingdom.com,
 "true", 
   [["allowAsyncRequestDispatching", "true"], ["disablePooling", "true"], ["sessionAffinityTimeout", 20]])

configureJavaProcessLogs

此脚本为应用程序服务器配置 Java 进程日志。系统会通过将 JVM 的 System.out 和 System.err 流重定向到独立日志文件来创建 JVM 日志。

表 24. configureJavaProcessLogs 参数描述. 以相关 Java 进程定义以及进程日志的根目录来运行该脚本。
自变量 描述
javaProcessDefConfigID 指定相关 Java 进程定义的配置标识。
processLogRoot 为进程日志指定根目录。
otherAttributeList (可选)使用以下名称/值对格式指定其他属性:[[“stdinFilename”, “/temp/mystdin.log”]]

语法

AdminServerManagement.configureJavaProcessLogs(javaProcessDefConfigID, processLogRoot,
 otherAttributeList)

用法示例

[Windows]
AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
   C:\temp\myJavaLog, [[stdinFilename, c:\temp\mystdin.log]])
[AIX][HP-UX][Solaris][Linux][IBM i][z/OS]
AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)", 
   	/temp/myJavaLog, [[stdinFilename, /temp/mystdin.log]])

configurePerformanceMonitoringService

此脚本会在配置中配置性能监控基础结构 (PMI)。PMI 使服务器能够从各个产品组件收集性能数据。PMI 提供有关平均系统资源使用量统计的信息,其不同组件的数据之间没有关系。

表 25. configurePerformanceMonitoringService 参数描述. 以节点名称、服务器名称、是否启用 PMI 和初始规范级别参数来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
enable 指定应用程序服务器是否尝试启用性能监控基础结构 (PMI)。如果应用程序服务器在禁用 PMI 的情况下启动,那么您必须重新启动服务器以启用 PMI。
initialSpecLevel 指定服务器中的所有组件的性能监控基础结构 (PMI) 统计信息的预定义集合。
禁用所有统计信息。
基本
提供基本的应用程序服务器资源和应用程序监控功能。这包括 Java Platform, Enterprise Edition (Java EE) 组件、HTTP 会话信息、CPU 使用情况信息以及前 38 项统计信息。这是缺省设置。
扩展
提供扩展监控功能,包括基本级别的监控功能以及工作负载监视器、性能顾问程序和 Tivoli 资源模型。“扩展”提供常用 WebSphere Application Server 组件的关键统计信息。
全部
启用所有统计信息。
定制
提供细颗粒度的控制,允许启用和禁用各项统计信息。
otherAttributeList (可选)使用以下名称/值对格式指定其他属性:[[“statisticSet”, “test statistic set”], [“synchronizedUpdate”, “true”]]

语法

AdminServerManagement.configurePerformanceMonitoringService(nodeName, serverName, 
enable, initialSpecLevel, otherAttributeList)

用法示例

AdminServerManagement.configurePerformanceMonitoringService(myNode, myServer, "true", "Basic", 
[["statisticSet", "test statistic set"], ["synchronizedUpdate", "true"]])

configurePMIRequestMetrics

此脚本在配置中配置 PMI 请求度量值。请求度量值提供有关每个事务的数据,从而在各种产品组件之间使此信息关联以提供事务的端到端图片。
表 26. configurePMIRequestMetrics 参数描述. 运行脚本,然后指定是否启用请求度量值和跟踪级别。
自变量 描述
enable 指定是否打开请求度量值功能。当此选项处于禁用状态时,表示已禁用请求度量值功能。
traceLevel 指定为给定事务累加多少跟踪数据。注意,跟踪级别与要检测的组件共同控制是否对某个请求进行检测。
NONE
不进行检测。
HOPS
仅在进程边界上生成检测信息(例如,来自浏览器或 Web 服务器的 Servlet 请求或者前往数据库的 JDBC 请求)。
PERFORMANCE_DEBUG
在中继段级别以及进程内 servlet 和 Enterprise JavaBeans (EJB) 调用的第一个级别上生成数据(例如,当入站 servlet 转向 servlet 以及入站 EJB 调用另一个 EJB 时)。在此级别,不启用其他过程内调用(例如命名和服务集成总线 (SIB))。
DEBUG
提供详细的检测数据,包括所有进程内调用的响应时间。在此级别,将仅检测对 Servlet 过滤器的请求。
otherAttributeList (可选)使用以下名称/值对格式指定其他属性:[[“armType”, “TIVOLI_ARM”], [“enableARM”, “true”]]

语法

AdminServerManagement.configurePMIRequestMetrics(enable, traceLevel, otherAttributeList)

用法示例

AdminServerManagement.configurePMIRequestMetrics("true", "DEBUG", 
   [["armType", "TIVOLI_ARM"], ["enableARM", "true"]])
[z/OS]

configureRASLoggingService

此脚本在应用程序服务器配置中配置 RAS 登录。
表 27. configureRASLoggingService 参数描述. 以节点名称、服务器名称和 RAS 日志的根目录来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
serviceLogRoot 为 RAS 记录服务日志指定根目录。
otherAttributeList (可选)使用以下名称/值对格式指定其他属性:[[“enabled”, “true”], [“size”, “500”]]

语法

AdminServerManagement.configureRASLoggingService(nodeName, serverName,
 serviceLogRoot, otherAttributeList)

用法示例

AdminServerManagement.configureRASLoggingService(myNode, myServer, /temp/myRASLog, 
   [["enabled", "true"], ["size", "500"]])

configureServerLogs

此脚本为相关应用程序服务器配置服务器日志。
表 28. configureServerLogs 参数描述. 以节点名称、服务器名称和服务器日志的根目录来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
serverLogRoot 为服务器日志指定根目录。
otherAttributeList (可选)使用以下名称/值对格式指定其他属性:[[“formatWrites”, “true”], [“messageFormatKind”, “BASIC”], [“rolloverType”, “BOTH”]]

语法

AdminServerManagement.configureServerLogs(nodeName, serverName, 
serverLogRoot, otherAttributeList)

用法示例

[Windows]
AdminServerManagement.configureServerLogs(myNode, myServer, C:\temp\mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])
[AIX][HP-UX][Solaris][Linux][IBM i][z/OS]
AdminServerManagement.configureServerLogs(myNode, myServer, /temp/mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])

configureTraceService

此脚本为应用程序服务器配置跟踪设置。请配置跟踪以获取有关运行应用程序服务器的详细信息。
表 29. configureTraceService 参数描述. 以节点名称、服务器名称、跟踪规范和输出类型参数来运行该脚本。
自变量 描述
nodeName 指定相关节点的名称。
serverName 指定相关服务器的名称。
startupTraceSpecification 指定要为相关组件启用的跟踪规范。例如,com.ibm.ws.webservices.trace.MessageTrace=all 跟踪规范跟踪 SOAP 消息的内容,其中包括二进制附件数据。
traceOutputType 指定应该将跟踪输出写入何处。跟踪输出可以直接写入输出文件,或者存储在内存中。
otherAttributeList (可选)使用以下名称/值对格式为跟踪服务指定其他属性:[[“enable”, “true”], [“traceFormat”, “LOG_ANALYZER”]]

语法

AdminServerManagement.configureTraceService(nodeName, serverName, 
traceString, outputType, otherAttributeList)

用法示例

AdminServerManagement.configureTraceService(myNode, myServer, "com.ibm.ws.management.*=all=enabled", 
   SPECIFIED_FILE, [["enable", "true"], ["traceFormat", "LOG_ANALYZER"]])

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



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