サーバー設定構成スクリプト
スクリプト・ライブラリーは、アプリケーション・サーバーの構成を自動化するための複数のスクリプト・プロシージャーを提供します。アプリケーション・サーバーのスクリプトを使用して、クラス・ローダー、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 を指定します。 分離アプリケーションを防止して、アプリケーション・サーバーが単一のアプリケーション・クラス・ローダーを使用してシステム内のすべての EJB モジュール、共有ライブラリー、および依存関係 Java アーカイブ (JAR) ファイルをロードするように構成するには、SINGLE を指定します。 アプリケーションを分離して、それぞれのアプリケーションに、EJB モジュール、共有ライブラリー、および依存関係 JAR ファイルをロードするための独自のクラス・ローダーを提供するには、MULTIPLE を指定します。 |
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 内で動作し、 キャッシュ可能なオブジェクトの呼び出しをインターセプトします。 例えば、動的キャッシュ・サービスは、サーブレットの service メソッドやコマンドの execute メソッドを介した呼び出しをインターセプトし、 オブジェクトの出力をキャッシュに格納するか、オブジェクトのコンテンツを動的キャッシュから取得して提供します。
引数 | 説明 |
---|---|
nodeName | 対象のノードの名前を指定します。 |
serverName | 対象のサーバーの名前を指定します。 |
defaultPriority | キャッシュ・エントリーのデフォルト優先順位を指定します。 これにより、キャッシュがフル・キャッシュに存在する時間が決まります。1 から 255 までの範囲内の整数を指定します。 |
cacheSize | キャッシュが保持する最大エントリー数の値として正の整数を指定します。 このフィールドに、キャッシュ・サイズ値を 100 から 200000 の範囲で入力します。 |
externalCacheGroupName | 外部キャッシュ・グループ名は、サーブレットまたは JavaServer Pages (JSP) ファイルの cachespec.xml ファイルで定義されている ExternalCache プロパティーと一致する必要があります。外部キャッシュが使用可能な場合、キャッシュはページを Universal Resource Identifier (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
このスクリプトは、アプリケーション・サーバー用のファイル転送サービスを構成します。 ファイル転送サービスは、ファイルをデプロイメント・マネージャーから個別のリモート・ノードに転送します。
引数 | 説明 |
---|---|
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 Messaging Service (JMS) 機能に対する拡張機能です。このサービスにより、1 つ以上の JMS リスナーの制御とモニターを行うリスナー・マネージャーが提供されます。 JMS リスナーはそれぞれ、デプロイされるメッセージ駆動型 Bean に代わって、JMS 宛先をモニターします。
引数 | 説明 |
---|---|
nodeName | 対象のノードの名前を指定します。 |
serverName | 対象のサーバーの名前を指定します。 |
listenerPortName | 管理目的でリスナー・ポートを使用する際の名前。 |
connectionFactoryJNDIName | リスナー・ポートで使用される JMS 接続ファクトリーの JNDI 名。 例えば、jms/connFactory1。 |
destinationJNDIName | リスナー・ポートで使用される宛先の JNDI 名。 例えば、jms/destn1。 |
maxMessages | リスナーが、1 つのトランザクションで処理できるメッセージの最大数。 キューが空の場合、リスナーは、メッセージを受け取ると、各メッセージを処理します。 各メッセージは、個別のトランザクション内で処理されます。 |
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 Messaging Service (JMS) 機能に対する拡張機能です。このサービスにより、1 つ以上の 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 プロセスの 1 つなので、 サーバー上の Java アプリケーションを稼働およびサポートするには JVM が必要です。
引数 | 説明 |
---|---|
javaVirtualMachineConfigID | 変更を加える Java 仮想マシンの構成 ID を指定します。 |
debugMode | JVM をデバッグ・モードで実行するかどうかを指定します。 デフォルトでは、デバッグ・モード・サポートは使用可能ではありません。debugMode 引数を true に設定した場合は、デバッグ引数を指定する必要があります。 |
debugArgs | アプリケーション・サーバー・プロセスを開始する JVM コードに渡すデバッグ引数を指定します。 同じノード上の複数のアプリケーション・サーバーでデバッグを有効にする場合は、これらの各サーバーで異なる address 引数 (デバッグ用のポートを指定する) を使用していることを確認してください。例えば、2 つのサーバーでデバッグを使用可能にし、 それぞれのサーバーのデフォルトのデバッグ・ポートを 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) は、 Internet InterORB Protocol (IIOP) を使用して、クライアントとサーバーの間の対話を管理します。 ORB によって、クライアントはネットワーク分散環境でサーバーに対して 要求を行い、応答を受け取ることができます。
引数 | 説明 |
---|---|
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 で「最大パーセント」メトリックが常に 2 桁であることが示される場合は、「最大サイズ」を大きくすることを検討してください。「最大パーセント」メトリックは、構成済みのスレッドが使用される時間を示します。 |
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 Services アトミック・トランザクション (WS-AT) パートナーが応答する前に、構成済みの非同期応答タイムアウトの有効期限が切れた場合です。 |
heuristicRetryWait | リソース・マネージャーまたはリモート・パートナーからの一時的な例外の後、コミットまたはロールバックなどの完了シグナルを再試行する前に、アプリケーション・サーバーが待機する秒数を指定します。 |
propogatedOrBMTTranLifetimeTimeout | トランザクションが非活動状態になってからロールバックされるまでの時間を秒単位で指定します。 |
asyncResponseTimeout | サーバーが前の WS-AT プロトコル・メッセージを再送するまでにインバウンドの Web Services アトミック・トランザクション (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 引数 (デバッグ用のポートを指定する) を使用していることを確認してください。例えば、2 つのサーバーでデバッグを使用可能にし、 それぞれのサーバーのデフォルトのデバッグ・ポートを 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 引数 (デバッグ用のポートを指定する) を使用していることを確認してください。例えば、2 つのサーバーでデバッグを使用可能にし、 それぞれのサーバーのデフォルトのデバッグ・ポートを address=7777 のままにしておくと、 サーバーは正常に始動できない場合があります。 |
構文
AdminServerManagement.setJVMProperties(nodeName, serverName, traceSpecification)
使用例
AdminServerManagement.setTraceSpecification(myNode, myServer, "com.ibm.ws.management.*=all")
configureCookieForServer
このスクリプトは、アプリケーション・サーバー構成内に Cookie を構成します。 セッションを追跡するように Cookie を構成します。
引数 | 説明 |
---|---|
nodeName | 対象のノードの名前を指定します。 |
serverName | 対象のサーバーの名前を指定します。 |
cookieName | セッション管理 Cookie の固有名を指定します。 サーブレット仕様には、JSESSIONID という名前が必要です。 ただし、柔軟性を持たせるためにこの値は構成可能になっています。 |
domain | セッション・トラッキング Cookie のドメイン・フィールドを指定します。 この値は、ブラウザーが特定のサーバーに Cookie を送信するかどうかを制御します。 例えば、特定のドメインを指定すると、 セッション Cookie は、そのドメインのホストに送信されます。 デフォルトのドメインはサーバーです。 |
maximumAge | Cookie がクライアント・ブラウザーで存続する時間を指定します。 Cookie が、現行のブラウザー・セッションの間だけ、あるいは最大経過時間まで存続するように指定します。 最大経過時間のオプションを選択する場合は、経過時間を秒単位で指定します。 この値は、Cookie 仕様に記述されている存続時間 (TTL) 値に対応しています。 デフォルトは現在のブラウザー・セッションであり、これは値を -1 に設定するのと同じことです。 |
secure | セッション Cookie にセキュア・フィールドを組み込むように指定します。 このフィーチャーを使用可能にすると、Cookie の交換は HTTPS セッションだけに制限されます。 |
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 プラグインとアプリケーション・サーバーの間の接続で使用する Secure Sockets Layer (SSL) 設定タイプを指定します。 オプションには、セキュリティー・センターで定義される SSL 設定 (DefaultSSLSettings、ORBSSLSettings、LDAPSSLSettings など) が 1 つ以上含まれています。 |
sslEnabled | WebSphere Application Server プラグインとアプリケーション・サーバー間の接続を Secure Sockets Layer (SSL) を使用して保護するかどうかを指定します。 デフォルトでは、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 コンテナーは、サーブレット、JavaServer Pages (JSP) ファイル、 およびサーバー・サイド・コードを含むその他のタイプのファイルに対する要求を処理します。Web コンテナーは、サーブレット・インスタンスを作成し、サーブレットをロードおよびアンロードし、 リクエスト・オブジェクトおよびレスポンス・オブジェクトを作成、管理し、その他のサーブレット管理用タスクを実行します。
引数 | 説明 |
---|---|
nodeName | 対象のノードの名前を指定します。 |
serverName | 対象のサーバーの名前を指定します。 |
webContainerName | 対象の Web コンテナーの名前を指定します。 |
defaultVirtualHostName | 単一のホスト・マシンを複数のホスト・マシンに見せかけることを可能にする仮想ホストを指定します。
ある仮想ホストに関連付けられたリソースと、他の仮想ホストに関連付けられたリソースとは、それらの仮想ホストが物理的に同じマシンを共有している場合でも、データを共有することはできません。 有効な値には、次のものが含まれます。
|
enableServletCaching | サーブレットを一度呼び出して、キャッシュする出力を生成した場合に、 出力だけでなく、呼び出しの副次効果を含むキャッシュ項目を作成するかどうかを指定します。 これらの副次効果には、他のサーブレットまたは JavaServer Pages (JSP) ファイルへの呼び出し、 およびタイムアウトと項目優先順位の情報などの、項目に関するメタデータが含まれる場合があります。 ポートレット・フラグメントのキャッシュでは、 サーブレットのキャッシュが使用可能にされている必要があります。すなわち、 ポートレット・フラグメントのキャッシュを使用可能にすると、 サーブレットのキャッシュが自動的に使用可能になります。サーブレットのキャッシュを使用不可にすると、 ポートレット・フラグメントのキャッシュは自動的に使用不可になります。 |
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 ログは、JVM の System.out および System.err ストリームを独立したログ・ファイルにリダイレクトすることで作成されます。
引数 | 説明 |
---|---|
javaProcessDefConfigID | 対象の Java プロセス定義の構成 ID を指定します。 |
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
このスクリプトは、構成内に Performance Monitoring Infrastructure (PMI) を構成します。 PMI により、サーバーは、さまざまな製品コンポーネントからパフォーマンス・データを収集することができます。PMI は、システム・リソースの平均使用統計に関する情報を提供します。異なるコンポーネントにまたがるデータ間での相関はありません。
引数 | 説明 |
---|---|
nodeName | 対象のノードの名前を指定します。 |
serverName | 対象のサーバーの名前を指定します。 |
enable | アプリケーション・サーバーが Performance Monitoring Infrastructure (PMI) を使用可能にしようとするかどうかを指定します。PMI が使用不可であるときに アプリケーション・サーバーを始動する場合、PMI を使用可能にするためにサーバーを再始動する必要があります。 |
initialSpecLevel | サーバー内のすべてのコンポーネントについて、Performance Monitoring Infrastructure (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"]])