Jython スクリプト・ライブラリー: サーバー設定構成スクリプト

configureAdminService

このスクリプトは、AdminService インターフェースの設定を構成します。 AdminService インターフェースは、アプリケーション・サーバーの管理機能を操作するためのサーバー・サイドのインターフェースです。

表 1. configureAdminサービス引数の説明。ノード名、サーバー名、ローカル接続プロトコル、およびリモート接続プロトコルを指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`localAdminプロトコル`	AdminService インターフェースをローカル接続用のアプリケーション・サーバーに接続するために使用するコネクターのタイプを指定します。
`remoteAdminプロトコル`	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`	対象のサーバーの名前を指定します。
`ポリシー`	アプリケーション・クラス・ローダーのポリシーとして、SINGLE または MULTIPLE を指定します。分離アプリケーションを回避するには SINGLE 値を指定し、単一のアプリケーション・クラス・ローダーを使用してシステム内のすべての EJB モジュール、共有ライブラリー、および依存関係 Java アーカイブ (JAR) ファイルをロードするようにアプリケーション・サーバーを構成します。アプリケーションを分離して、それぞれのアプリケーションに、EJB モジュール、共有ライブラリー、および依存関係 JAR ファイルをロードするための独自のクラス・ローダーを提供するには、MULTIPLE を指定します。
`モード`	クラス・ローダー・モードとして、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 メソッドを介した呼び出しをインターセプトし、オブジェクトの出力をキャッシュに格納するか、オブジェクトのコンテンツを動的キャッシュから取得して提供します。

表 3. configureDynamicCache 引数の説明。ノード名、サーバー名、デフォルトの優先順位、キャッシュ・サイズ、外部キャッシュ・グループ名、および外部キャッシュ・グループ・タイプの引数を指定して、このスクリプトを実行します。
引数	説明
`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 内のユーザー作成のビジネス・ロジックとアプリケーション・サーバー環境の残りの部分との間の仲介プログラム役として機能します。

表 4. configureEJBContainer 引数の説明。ノード名、サーバー名、非活性化ディレクトリー、およびデフォルト・データ・ソースの Java Naming and Directory Interface (JNDI) 名の引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`passivationDirectory`	コンテナーによって、非活性化したステートフル・セッション Bean のパーシスタント状態が保存されるディレクトリーを指定します。あらかじめこのディレクトリーが存在している必要があります。自動的には作成されません。
`defaultDatasourceJNDIName`	アプリケーションのデプロイメント時にデータ・ソースが指定されていない場合に使用するデータ・ソースの JNDI 名を指定します。この設定は、EJB 2.x に準拠するコンテナー管理パーシスタンス Bean には適用できません。

構文

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

使用例

AdminServerManagement.configureEJBContainer(myNode, myServer, C:\temp\myDir, jndi1)

AdminServerManagement.configureEJBContainer(myNode, myServer, /temp/myDir, jndi1)

configureFileTransferService

このスクリプトは、アプリケーション・サーバー用のファイル転送サービスを構成します。ファイル転送サービスは、ファイルをデプロイメント・マネージャーから個別のリモート・ノードに転送します。

表 5. configureFileTransferService 引数の説明ノード名、サーバー名、ファイル転送の再試行回数、およびファイル転送を再試行するまでの待機時間を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`retriesCount`	通信障害の発生後に、ファイル転送サービスがファイルの送受信を再試行する回数を指定します。デフォルト値は 3 です。
`retryWait時間`	ファイル転送サービスが、失敗したファイル転送を再試行する前に待機する秒数を指定します。デフォルト値は 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 宛先をモニターします。

表 6. configureListenerPortForMessageListenerサービス引数の説明。ノード名、サーバー名、リスナー・ポート名、接続ファクトリーの JNDI 名、宛先の JNDI 名、メッセージの最大数、再試行の最大回数、およびセッションの最大数の引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`listenerPort名前`	管理目的でリスナー・ポートを使用する際の名前。
`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 宛先をモニターします。

表 7. configureMessageListenerService 引数の説明。ノード名、サーバー名、メッセージ・リスナーの最大再試行回数、リスナーのリカバリー間隔、プーリングしきい値、プーリング・タイムアウトの引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`maxListener再試行`	このサービスによって管理されるリスナー・ポートが障害からのリカバリーを試行する最大回数を指定します。この回数に達すると、リカバリーの試行を断念して停止します。停止すると、関連したリスナー・ポートが停止状態に変更されます。
`listenerRecovery間隔`	リスナー・ポートが障害からのリカバリーを再試行する間隔を秒単位で指定します。
`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. configureState管理可能引数の説明。ノード名、サーバー名、親タイプ、および初期状態の引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`parentType`	変更するコンポーネントのタイプを指定します。
`initialState`	サーバー・プロセスが開始されるときの、コンポーネントの要求状態を指定します。有効な値は、START および STOP です。

構文

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

使用例

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

configureCustomProperty

このスクリプトは、アプリケーション・サーバー構成内にカスタム・プロパティーを構成します。内部システム・プロパティーの構成にカスタム・プロパティーを使用することができます。一部のコンポーネントはこれらを Web コンテナーへの情報の受け渡しなどに使用します。

表 9. configureCustomプロパティー引数の説明。ノード名、サーバー名、親タイプ、プロパティー名、およびプロパティー値の引数を指定して、このスクリプトを実行します。
引数	説明
`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. configureCustomサービス引数の説明。ノード名、サーバー名、および優先コネクター・タイプを指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`classname`	サービス実装のクラス名を指定します。このクラスは、カスタム・サービス・インターフェースを実装する必要があります。
`displayname`	サービスの名前を指定します。
`classpath`	このサービスのクラスと JAR ファイルを見つけるために使用されるクラスパスを指定します。
`otherAttributeList`	オプションで、追加の属性を次のフォーマットで指定します: [[description, test custom service], [enable, true]]

構文

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

使用例

AdminServerManagement.configureCustomService(myNode, myServer, myClass, myName, C:\temp\boo.jar,
     [[description, test custom service], [enable, true]])

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 プロセスの 1 つなので、サーバー上の Java アプリケーションを稼働およびサポートするには JVM が必要です。

表 12. configureJavaVirtualMachine 引数の説明。対象の JVM の構成 ID、デバッグ・モードを有効にするかどうか、および追加のデバッグ引数を指定して、このスクリプトを実行します。
引数	説明
`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 によって、クライアントはネットワーク分散環境でサーバーに対して要求を行い、応答を受け取ることができます。

表 13. configureORBService 引数の説明。ノード名、サーバー名、要求のタイムアウト、要求の再試行回数、要求の再試行遅延、最大接続キャッシュ、最小接続キャッシュ、および位置指定要求タイムアウトの引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`requestTimeout`	要求メッセージについてタイムアウトとなるまでに待機する秒数を指定します。
`requestRetriesカウント`	サーバーに障害が発生した場合に ORB が要求の送信を試行する回数を指定します。再試行によって、一時的なネットワーク障害からリカバリーできることもあります。このフィールドは、 z/OS® プラットフォームでは無視されます。
`requestRetries遅延`	要求の再試行間隔をミリ秒単位で指定します。このフィールドは、z/OS プラットフォームでは無視されます。
`connectionCache最大`	ORB がキャッシュからの非アクティブ接続の除去を開始する前に ORB 接続キャッシュを占有できるエントリーの最大数を指定します。このフィールドは、z/OS プラットフォームでは無視されます。キャッシュ内の活動接続の数が一時的にこのしきい値を超える可能性があります。必要な場合、ORB は、使用可能なリソースがある限り、接続を追加し続けます。
`connectionCache最小`	ORB 接続キャッシュ内のエントリーの最小数を指定します。このフィールドは、z/OS プラットフォームでは無視されます。 ORB は、エントリー数がこの値より小さくなると、非アクティブの接続を除去しなくなります。
`locateRequestタイムアウト`	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. configureProcess定義引数の説明。ノード名、サーバー名、および必要に応じた追加パラメーターを指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`otherParamリスト`	プロセス定義構成の追加パラメーターを次の形式で指定します: [[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")

configureThreadPool

このスクリプトは、サーバー構成内にスレッド・プールを構成します。スレッド・プールを使用すると、サーバーのコンポーネントがスレッドを再使用できるため、実行時に新しいスレッドを作成する必要がなくなります。新規スレッドの作成は、時間とリソースを消費します。

表 16. configureThreadプール引数の説明。ノード名、サーバー名、親タイプ、スレッド・プール名、最大サイズ、最小サイズ、およびタイムアウトが発生するまでの時間を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`parentType`	構成するコンポーネントのタイプを指定します。
`threadPool名`	対象のスレッド・プールの名前を指定します。
`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

このスクリプトは、アプリケーション・サーバー用のトランザクション・サービスを構成します。アプリケーションでトランザクションを使用すると、リソースに対する複数の更新をアトミック単位 (不可分の作業単位) として調整できます。その結果として、すべての更新が永続的になるか、どの更新も永続的になりません。

表 17. configureTransactionサービス引数の説明。ノード名、サーバー名、合計トランザクション存続時間タイムアウト、クライアント非活動タイムアウト、最大トランザクション・タイムアウト、ヒューリスティックな再試行制限、ヒューリスティックな再試行待ち、伝搬または BMT トランザクション存続期間タイムアウト、および非同期応答タイムアウトの引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバー名を指定します。
`totalTranLifetimeTimeout`	このサーバー上でトランザクションが開始されてから、トランザクション・サービスがタイムアウト完了処理を開始するまでの、デフォルトの最大許容時間を秒単位で指定します。このタイムアウトが発生するまでに完了処理を開始しないトランザクションは、すべてロールバックされます。このタイムアウトは、アプリケーション・コンポーネントがその独自のトランザクション・タイムアウトを設定しない場合にのみ使用されます。トランザクション合計存続時間タイムアウトと最大トランザクション・タイムアウトにのみ猶予期間があります。 DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD カスタム・プロパティーを使用して猶予期間を使用不可にすることができます。
`clientInactivityTimeout`	リモート・クライアントからの各トランザクション要求間の最大所要時間 (秒単位) を指定します。クライアントの非活動時間がこのタイムアウトを超過すると、このアプリケーション・サーバーでトランザクションがロールバックされます。この値を 0 に設定した場合、タイムアウト制限はありません。
`maximumTransactionタイムアウト`	このサーバーで実行するトランザクションのトランザクション・タイムアウトの上限 (秒単位) を指定します。この値は、合計トランザクション・タイムアウト以上である必要があります。このタイムアウトは、その他のすべてのトランザクション・タイムアウトの上限を制限します。
`heuristicRetry制限`	アプリケーション・サーバーがコミットまたはロールバックなどの完了シグナルを再試行する回数を指定します。再試行が行われるのは、リソース・マネージャーまたはリモート・パートナーからの一時的な例外の後、または、すべての Web Services アトミック・トランザクション (WS-AT) パートナーが応答する前に、構成済みの非同期応答タイムアウトの有効期限が切れた場合です。
`heuristicRetryWait`	リソース・マネージャーまたはリモート・パートナーからの一時的な例外の後、コミットまたはロールバックなどの完了シグナルを再試行する前に、アプリケーション・サーバーが待機する秒数を指定します。
`propogatedOrBMTTranLifetimeTimeout`	トランザクションが非活動状態になってからロールバックされるまでの時間を秒単位で指定します。
`asyncResponseタイムアウト`	サーバーが前の 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 構成用の追加のプロパティーを設定します。

表 18. setJVMProperties 引数の説明。ノード名、サーバー名、クラスパス、ブート・クラスパス、初期ヒープ・サイズ、最大ヒープ・サイズ、デバッグ・モードを有効にするかどうか、およびデバッグの引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`classPath`	オプションで、Java 仮想マシン・コードがクラスを検索する標準クラスパスを指定します。
`bootClasspath`	オプションで、JVM コード用のブートストラップ・クラスおよびリソースを指定します。このオプションは、ブートストラップ・クラスおよびリソースをサポートする JVM 命令でのみ使用可能です。
`initialHeapサイズ`	オプションで、JVM コードで使用できる初期ヒープ・サイズをメガバイト単位で指定します。最小ヒープ・サイズを増やすと、始動時間が短縮されます。ガーベッジ・コレクションの実行回数が減少するため、パフォーマンスが 10% 向上します。 Java ヒープのサイズを増やすと、一般的に、ヒープが物理メモリーに常駐しなくなるまでのスループットが向上します。ヒープがディスクへのスワップを開始すると、Java のパフォーマンスが大幅に低下します。
`maxHeapサイズ`	オプションで、JVM コードで使用できる最大ヒープ・サイズをメガバイト単位で指定します。ヒープ・サイズを増やすと、始動時間が短縮されます。ヒープ・サイズを増やすことによって、ガーベッジ・コレクションの実行回数が減少するので、パフォーマンスを 10% 向上させることができます。
`debugMode`	オプションで、JVM をデバッグ・モードで実行するかどうかを指定します。デフォルトでは、デバッグ・モード・サポートは使用可能ではありません。 debugMode 引数を true に設定した場合は、デバッグ引数を指定する必要があります。
`debugArgs`	オプションで、アプリケーション・サーバー・プロセスを開始する JVM コードに渡すデバッグ引数を指定します。同じノード上の複数のアプリケーション・サーバーでデバッグを有効にする場合は、これらの各サーバーで異なる address 引数 (デバッグ用のポートを指定する) を使用していることを確認してください。例えば、2 つのサーバーでデバッグを使用可能にし、それぞれのサーバーのデフォルトのデバッグ・ポートを address=7777 のままにしておくと、サーバーは正常に始動できない場合があります。

構文

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

使用例

AdminServerManagement.setJVMProperties(myNode, myServer, "c:\a.jar", "", "”, "", "", "")

AdminServerManagement.setJVMProperties(myNode, myServer, "/a.jar", "", "”, "", "", "")

setTraceSpecification

このスクリプトは、構成用のトレース仕様を設定します。

表 19. setTrace仕様の引数の説明。ノード名、サーバー名、およびトレース仕様の引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`traceSpecification`	アプリケーション・サーバー・プロセスを開始する JVM コードに渡すデバッグ引数を指定します。同じノード上の複数のアプリケーション・サーバーでデバッグを有効にする場合は、これらの各サーバーで異なる address 引数 (デバッグ用のポートを指定する) を使用していることを確認してください。例えば、2 つのサーバーでデバッグを使用可能にし、それぞれのサーバーのデフォルトのデバッグ・ポートを address=7777 のままにしておくと、サーバーは正常に始動できない場合があります。
`パーシスト (persist)`	オプションで、トレース仕様の存続期間を指定します。デフォルトは `-persist false` で、JVM の実行時にのみ適用されます。 JVM が再始動されると、トレース仕様は自動的に削除されます。 JVM の再始動時でもトレース仕様を続行する場合は、 `-persist true`を指定します。

構文

AdminServerManagement.setTraceSpecification(nodeName, serverName, traceSpecification, persist)

使用例

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

persist を使用した使用例

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

configureCookieForServer

このスクリプトは、アプリケーション・サーバー構成内に Cookie を構成します。セッションを追跡するように Cookie を構成します。

表 20. configureCookieForServer 引数の説明。ノード名、サーバー名、Cookie 名、ドメイン、Cookie の最大経過時間、および Cookie を保護するかどうかを指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`cookieName`	セッション管理 Cookie の固有名を指定します。サーブレット仕様には、JSESSIONID という名前が必要です。ただし、柔軟性を持たせるためにこの値は構成可能になっています。
`domain`	セッション・トラッキング Cookie のドメイン・フィールドを指定します。この値は、ブラウザーが特定のサーバーに Cookie を送信するかどうかを制御します。例えば、特定のドメインを指定すると、セッション Cookie は、そのドメインのホストに送信されます。デフォルトのドメインはサーバーです。
`maximumAge`	Cookie がクライアント・ブラウザーで存続する時間を指定します。 Cookie が、現行のブラウザー・セッションの間だけ、あるいは最大経過時間まで存続するように指定します。最大経過時間のオプションを選択する場合は、経過時間を秒単位で指定します。この値は、Cookie 仕様に記述されている存続時間 (TTL) 値に対応しています。デフォルトは現在のブラウザー・セッションであり、これは値を -1 に設定するのと同じことです。
`セキュア`	セッション 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 コンテナーに渡されます。

表 21. configureHTTPTransportForWebコンテナーの引数の説明。ノード名、サーバー名、ポートを調整するかどうか、HTTP トランスポートを外部として設定するかどうか、使用する Secure Sockets Layer (SSL) 構成、および SSL を有効にするかどうかを指定して、このスクリプトを実行します。
引数	説明
`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 コンテナー内で稼働するアプリケーションは、セッションを利用して個々のユーザーを追跡します。

表 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 コンテナーは、サーブレット、JavaServer Pages (JSP) ファイル、およびサーバー・サイド・コードを含むその他のタイプのファイルに対する要求を処理します。 Web コンテナーは、サーブレット・インスタンスを作成し、サーブレットをロードおよびアンロードし、リクエスト・オブジェクトおよびレスポンス・オブジェクトを作成、管理し、その他のサーブレット管理用タスクを実行します。

表 23. configureWebコンテナー引数の説明。ノード名、サーバー名、デフォルトの仮想ホスト名、およびサーブレット・キャッシュを有効にするかどうかを指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`webContainer名`	対象の Web コンテナーの名前を指定します。
`defaultVirtualHostName`	単一のホスト・マシンを複数のホスト・マシンに見せかけることを可能にする仮想ホストを指定します。ある仮想ホストに関連付けられたリソースと、他の仮想ホストに関連付けられたリソースとは、それらの仮想ホストが物理的に同じマシンを共有している場合でも、データを共有することはできません。有効な値には、次のものが含まれます。 default_host この製品は、デフォルトで、いくつかの一般的な別名 (マシンの IP アドレス、短縮ホスト名、完全修飾ホスト名など) をもつ仮想ホストを用意しています。別名は、サーブレットなどのリソースにアクセスするためのパスの最初の部分です。例えば、要求 http://localhost:9080/myServlet では localhost:9080 です。 admin_host これはアプリケーション・サーバーの別名であり、基本インストールでは server1 とも呼ばれます。このプロセスでは、管理コンソールの使用がサポートされます。 proxy_host proxy_host という仮想ホストには、デフォルトのポート定義、ポート 80 と 443 が含まれ、これらのポートは、通常プロキシー・サーバーの初期化の一部として初期化されます。必要に応じて、プロキシー・サーバーに関連付けられたルーティング・ルールでこのプロキシー・ホストを使用します。
`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 ストリームを独立したログ・ファイルにリダイレクトすることで作成されます。

表 24. configureJavaProcessLogs 引数の説明。対象の Java プロセス定義とプロセス・ログのルート・ディレクトリーを指定して、このスクリプトを実行します。
引数	説明
`javaProcessDefConfigID`	対象の Java プロセス定義の構成 ID を指定します。
`processLogルート`	プロセス・ログのルート・ディレクトリーを指定します。
`otherAttributeList`	オプションで、名前と値のペアの形式 [[stdinFilename, /temp/mystdin.log]] を使用して追加属性を指定します。

構文

AdminServerManagement.configureJavaProcessLogs(javaProcessDefConfigID, processLogRoot,
 otherAttributeList)

使用例

AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
   C:\temp\myJavaLog, [[stdinFilename, c:\temp\mystdin.log]])

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 は、システム・リソースの平均使用統計に関する情報を提供します。異なるコンポーネントにまたがるデータ間での相関はありません。

表 25. configurePerformanceMonitoringService 引数の説明。ノード名、サーバー名、PMI を使用可能にするかどうか、および初期仕様レベルの引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`使用可能にする`	アプリケーション・サーバーが Performance Monitoring Infrastructure (PMI) を使用可能にしようとするかどうかを指定します。 PMI が使用不可であるときにアプリケーション・サーバーを始動する場合、PMI を使用可能にするためにサーバーを再始動する必要があります。
`initialSpecレベル`	サーバー内のすべてのコンポーネントについて、Performance Monitoring Infrastructure (PMI) 統計の定義済みセットを指定します。なしすべての統計を使用不可にします。基本アプリケーション・サーバーのリソースおよびアプリケーションの基本モニターを提供します。これには Java Platform Enterprise Edition (Java EE) コンポーネント、HTTP セッション情報、CPU 使用率情報、および上位 38 の統計情報が含まれます。これはデフォルト設定です。拡張基本レベルのモニター、ワークロード・モニター、パフォーマンス・アドバイザー、および Tivoli リソース・モデルを含む拡張モニターを提供します。 Extended は、頻繁に使用される 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 引数の説明。要求メトリックを有効にするかどうか、およびトレース・レベルを指定して、このスクリプトを実行します。
引数	説明
`使用可能にする`	要求メトリック機能を有効にするかどうかを指定します。無効にすると、要求メトリック機能は使用できなくなります。
`traceLevel`	特定のトランザクションについて、どのくらいのトレース・データを累積するのかを指定します。「トレース・レベル」と「計測対象コンポーネント」の組み合わせにより、要求が計測されるかどうかを制御します。 NONE 計測なし HOPS プロセス境界のみに関する計測情報 (例: ブラウザーまたは Web サーバーから受信したサーブレット要求やデータベースに送信される JDBC 要求) を生成します。 PERFORMANCE_DEBUG ホップ・レベルのデータ、およびプロセス内サーブレットと Enterprise JavaBeans (EJB) 呼び出しの第 1 レベルのデータを生成します (例えば、インバウンド・サーブレットがサーブレットに転送され、インバウンド 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"]])

configureRASLoggingService

このスクリプトは、アプリケーション・サーバー構成内に RAS ロギングを構成します。

表 27. configureRASLoggingサービス引数の説明。ノード名、サーバー名、および RAS ログ用のルート・ディレクトリーを指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`serviceLogルート`	RAS ロギング・サービスのログ用のルート・ディレクトリーを指定します。
`otherAttributeList`	オプションで、追加の属性を次の名前/値ペアのフォーマットを使用して指定します: [[enabled, true], [size, 500]]

構文

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

使用例

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

configureServerLogs

このスクリプトは、対象のアプリケーション・サーバー用のサーバー・ログを構成します。

表 28. configureServer引数の説明をログに記録します。ノード名、サーバー名、およびサーバー・ログ用のルート・ディレクトリーを指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`serverLogルート`	サーバー・ログのルート・ディレクトリーを指定します。
`otherAttributeList`	オプションで、名前と値のペアのフォーマット [[formatWrites, true], [messageFormatKind, BASIC], [rolloverType, BOTH]] を使用して追加属性を指定します。

構文

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

使用例

AdminServerManagement.configureServerLogs(myNode, myServer, C:\temp\mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])

AdminServerManagement.configureServerLogs(myNode, myServer, /temp/mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])

configureTraceService

このスクリプトは、アプリケーション・サーバー用のトレース設定を構成します。トレースを構成することで、アプリケーション・サーバーの実行に関する詳細情報を取得できます。

表 29. configureTraceサービス引数の説明。ノード名、サーバー名、トレース仕様、および出力タイプの引数を指定して、このスクリプトを実行します。
引数	説明
`nodeName`	対象のノードの名前を指定します。
`serverName`	対象のサーバーの名前を指定します。
`startupTrace仕様`	対象のコンポーネントに対して有効にするトレース仕様を指定します。例えば、com.ibm.ws.webservices.trace.MessageTrace=all というトレース仕様は、SOAP メッセージの内容 (バイナリー添付データを含む) をトレースします。
`traceOutputタイプ`	トレース出力の書き込み先を指定します。トレース出力は、出力ファイルに直接書き込むことも、メモリーに保管することもできます。
`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"]])