服务器设置配置脚本
该脚本编制库提供多个脚本过程来自动完成应用程序服务器配置。使用应用程序服务器脚本来配置类装入器、Java™ 虚拟机 (JVM) 设置、Enterprise JavaBeans (EJB) 容器、性能监视和动态高速缓存等。可以分别运行每个脚本,也可将过程组合在一起来为环境创建定制自动执行脚本。
所有服务器管理脚本过程都位于 app_server_root/scriptLibraries/servers/V70 目录中。
configureAdminService
此脚本为 AdminService 接口配置设置。AdminService 接口是应用程序服务器管理功能的服务器端接口。
自变量 | 描述 |
---|---|
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
此脚本为应用程序服务器配置类装入器。类装入器允许应用程序服务器上部署的应用程序访问可用类和资源的存储库。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
policy | 将应用程序类装入器策略指定为 SINGLE 或 MULTIPLE。指定 SINGLE 值来防止隔离应用程序和配置应用程序服务器以使用单个应用程序类装入器在系统中装入所有 EJB 模块、共享库和依赖项 Java 归档 (JAR) 文件。指定 MULTIPLE 值来隔离应用程序并为每个应用程序提供其自己的类装入器以装入 EJB 模块、共享库和依赖项 JAR 文件。 |
mode | 将类装入器方式指定为 PARENT_FIRST 或 APPLICATION_FIRST。PARENT_FIRST 选项使类装入器先将类的装入委托给它的父类装入器进行,然后再尝试从它的本地类路径中装入类。APPLICATION_FIRST 选项使类装入器在将类装入委托给它的父代前,尝试从它的本地类路径装入类。使用此策略,应用程序类装入器可覆盖并提供存在于父类装入器中的其自己版本的类。 |
libraryName | 指定相关共享库的名称。 |
语法
AdminServerManagement.configureApplicationServerClassloader(nodeName, serverName,
policy, mode, libraryName)
用法示例
AdminServerManagement.configureApplicationServerClassloader("myNode", "myServer", "MULTIPLE", "PARENT_FIRST",
“myLibraryReference”)
configureDynamicCache
此脚本在服务器配置中配置动态高速缓存服务。动态高速缓存服务在应用程序服务器 JVM 中工作,从而拦截对可高速缓存对象的调用。例如,动态高速缓存服务通过 Servlet 服务方法或命令执行方法拦截调用,以及将对象的输出存储到高速缓存或服务于来自动态高速缓存的对象内容。
自变量 | 描述 |
---|---|
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 中用户编写的业务逻辑与应用程序环境中其他方面之间的中介。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
passivationDirectory | 指定一个目录,容器将在该目录中保存已钝化的有状态会话 Bean 的持久状态。此目录必须已存在。不会自动创建此目录。 |
defaultDatasourceJNDIName | 指定当应用程序部署期间未指定数据源时要使用的数据源的 JNDI 名称。此设置不适用于符合 EJB 2.x 的容器管理的持久性 Bean。 |
语法
AdminServerManagement.configureEJBContainer(nodeName, serverName,
passivationDir, defaultDatasourceJNDIName)
用法示例
![[Windows]](../images/windows.gif)
AdminServerManagement.configureEJBContainer(myNode, myServer, C:\temp\myDir, jndi1)
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureEJBContainer(myNode, myServer, /temp/myDir, jndi1)
configureFileTransferService
此脚本配置应用程序服务器的文件传输服务。文件传输服务将文件从 Deployment Manager 传送到各个远程节点。
自变量 | 描述 |
---|---|
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 目标。
自变量 | 描述 |
---|---|
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 目标。
自变量 | 描述 |
---|---|
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
此脚本配置应用程序服务器的初始状态。该初始状态指的是服务器进程启动时组件的正常状态。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
parentType | 指定要修改的组件的类型。 |
initialState | 指定当服务器进程启动时期望的组件状态。有效值为 START 和 STOP。 |
语法
AdminServerManagement.configureStateManageable(nodeName, serverName,
parentType, initialState)
用法示例
AdminServerManagement.configureStateManageable(myNode, myServer, "Server", "START")
configureCustomProperty
此脚本在应用程序服务器配置中配置定制属性。可以将定制属性用于配置一些组件使用的内部系统属性(例如,用来将信息传递至 Web 容器)。
自变量 | 描述 |
---|---|
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 接口。在创建定制服务后,应使用管理控制台来对应用程序服务器配置该定制服务。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
classname | 指定服务实现的类名。此类必须实现定制服务接口。 |
displayname | 指定服务的名称。 |
classpath | 指定用于查找此服务的类和 JAR 文件的类路径。 |
otherAttributeList | (可选)使用以下格式指定其他属性:[[“description”, “test custom service”], [“enable”, “true”]] |
语法
AdminServerManagement.configureCustomService(nodeName, serverName, classname, displayname, classpath, otherAttributeList)
用法示例
![[Windows]](../images/windows.gif)
AdminServerManagement.configureCustomService(“myNode”, “myServer”, “myClass”, “myName”, “C:\temp\boo.jar”,
[[“description”, “test custom service”], [“enable”, “true”]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureCustomService(“myNode”, “myServer”, “myClass”, “myName”, “/temp/boo.jar”,
[[“description”, “test custom service”], [“enable”, “true”]])
configureEndPointsHost
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
hostName | 指定相关主机的名称。 |
语法
AdminServerManagement.configureEndPointsHost(nodeName, serverName, hostName)
用法示例
AdminServerManagement.configureEndPointsHost(myNode, AppServer01, myHostname)
configureJavaVirtualMachine
此脚本配置 Java 虚拟机 (JVM)。由于应用程序服务器是一个 Java 进程,因此需要 JVM,才能运行应用程序服务器以及支持在该 JVM 上运行的 Java 应用程序。
自变量 | 描述 |
---|---|
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) 来管理客户机与服务器之间的交互。在分布式网络环境中,它支持客户机发出请求并从服务器接收响应。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
requestTimeout | 指定请求消息超时之前要等待的秒数。 |
|
|
|
|
|
|
|
|
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
此脚本配置服务器进程定义。通过定义用于启动或初始化应用程序服务器进程的命令行信息,来增强应用程序服务器的操作。进程定义设置定义运行时属性,例如要运行的程序、用于运行程序的参数以及工作目录。
自变量 | 描述 |
---|---|
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
此脚本配置服务器配置的事务服务。事务服务是服务器运行时组件,可以协调对多个资源管理器进行的更新以确保进行原子数据更新。由应用程序或部署应用程序的容器开始和结束事务。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
totalTranLifetimeTimeout | 指定缺省最大时长(以秒计),允许在事务服务触发超时完成之前在此服务器上启动的事务。将回滚任何未在此超时发生之前开始完成处理的事务。 |
clientInactivityTimeout | 指定来自远程客户机的事务请求之间的最大持续时间(以秒计)。任何超出此超时值的客户机不活动时间段都将导致在此应用程序服务器中回滚事务。如果将此值设置为 0,那么表示没有超时限制。 |
语法
AdminServerManagement.configureRuntimeTransactionService(nodeName, serverName,
totalTranLifetimeTimeout, clientInactivityTimeout)
用法示例
AdminServerManagement.configureRuntimeTransactionService(myNode, myServer, "600", "600")
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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
此脚本配置应用程序服务器的事务服务。可将事务与应用程序配合使用来协调作为原子单元(不可分工作单元)的资源进行多次更新,以使所有更新持久或都不持久。
自变量 | 描述 |
---|---|
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 配置设置其他属性。
自变量 | 描述 |
---|---|
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]](../images/windows.gif)
AdminServerManagement.setJVMProperties(myNode, myServer, "c:\a.jar", "", "”, "", "", "")
![[Linux]](../images/linux.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
![[IBM i]](../images/iseries.gif)
AdminServerManagement.setJVMProperties(myNode, myServer, "/a.jar", "", "”, "", "", "")
setTraceSpecification
此脚本为配置设置跟踪规范。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
traceSpecification | (可选)指定传递到启动应用程序服务器进程的 JVM 代码的调试参数。如果对同一个节点上的多个应用程序服务器启用调试,请确保服务器使用不同的地址参数,这些参数定义了用于调试的端口。例如,如果您在两个服务器上启用调试,并且让每个服务器的缺省调试端口保留为 address=7777,那么这两个服务器可能无法正确启动。 |
语法
AdminServerManagement.setJVMProperties(nodeName, serverName, traceSpecification)
用法示例
AdminServerManagement.setTraceSpecification(myNode, myServer, "com.ibm.ws.management.*=all")
configureCookieForServer
此脚本在应用程序服务器配置中配置 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 容器。
自变量 | 描述 |
---|---|
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 容器中运行的应用程序跟踪个别用户。
自变量 | 描述 |
---|---|
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 管理任务。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
webContainerName | 指定相关 Web 容器的名称。 |
defaultVirtualHostName | 指定使单个主机能够相当于多个主机的虚拟主机。即使多个虚拟主机共享同一物理机器,与一个虚拟主机相关联的资源也不能与另一虚拟主机所关联的资源共享数据。有效值包括:
|
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 日志。
自变量 | 描述 |
---|---|
javaProcessDefConfigID | 指定相关 Java 进程定义的配置标识。 |
processLogRoot | 为进程日志指定根目录。 |
otherAttributeList | (可选)使用以下名称/值对格式指定其他属性:[[“stdinFilename”, “/temp/mystdin.log”]] |
语法
AdminServerManagement.configureJavaProcessLogs(javaProcessDefConfigID, processLogRoot,
otherAttributeList)
用法示例
![[Windows]](../images/windows.gif)
AdminServerManagement.configureJavaProcessLogs
("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
C:\temp\myJavaLog, [[stdinFilename, c:\temp\mystdin.log]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureJavaProcessLogs
("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
/temp/myJavaLog, [[stdinFilename, /temp/mystdin.log]])
configurePerformanceMonitoringService
此脚本会在配置中配置性能监控基础结构 (PMI)。PMI 使服务器能够从各个产品组件收集性能数据。PMI 提供有关平均系统资源使用量统计的信息,其不同组件的数据之间没有关系。
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
enable | 指定应用程序服务器是否尝试启用性能监控基础结构 (PMI)。如果应用程序服务器在禁用 PMI 的情况下启动,那么您必须重新启动服务器以启用 PMI。 |
initialSpecLevel | 指定服务器中的所有组件的性能监控基础结构 (PMI) 统计信息的预定义集合。
|
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
自变量 | 描述 |
---|---|
enable | 指定是否打开请求度量值功能。当此选项处于禁用状态时,表示已禁用请求度量值功能。 |
traceLevel | 指定为给定事务累加多少跟踪数据。注意,跟踪级别与要检测的组件共同控制是否对某个请求进行检测。
|
otherAttributeList | (可选)使用以下名称/值对格式指定其他属性:[[“armType”, “TIVOLI_ARM”], [“enableARM”, “true”]] |
语法
AdminServerManagement.configurePMIRequestMetrics(enable, traceLevel, otherAttributeList)
用法示例
AdminServerManagement.configurePMIRequestMetrics("true", "DEBUG",
[["armType", "TIVOLI_ARM"], ["enableARM", "true"]])
![[z/OS]](../images/ngzos.gif)
configureRASLoggingService
自变量 | 描述 |
---|---|
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
自变量 | 描述 |
---|---|
nodeName | 指定相关节点的名称。 |
serverName | 指定相关服务器的名称。 |
serverLogRoot | 为服务器日志指定根目录。 |
otherAttributeList | (可选)使用以下名称/值对格式指定其他属性:[[“formatWrites”, “true”], [“messageFormatKind”, “BASIC”], [“rolloverType”, “BOTH”]] |
语法
AdminServerManagement.configureServerLogs(nodeName, serverName,
serverLogRoot, otherAttributeList)
用法示例
![[Windows]](../images/windows.gif)
AdminServerManagement.configureServerLogs(myNode, myServer, C:\temp\mylog,
[["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureServerLogs(myNode, myServer, /temp/mylog,
[["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])
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"]])