WebSphere Virtual Enterprise, Version 6.1.1
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows


アプリケーション・エディション管理の管理用タスク

Jacl または Jython スクリプト言語を使用して、アプリケーション・エディションを管理することができます。また、AdminApp オブジェクトを使用して、特定エディションのアプリケーションを管理することもできます。

以下のコマンドは、アプリケーション・エディションのアクティブ化、非アクティブ化、ロールアウトの実行、妥当性検査、リスト表示、および検証に使用します。また、既存の動的クラスターを複製して異なるノード・グループに使用すること、およびアプリケーション・エディションに対する妥当性検査モードを取り消すことができます。
wsadmin の AdminApp オブジェクトを使用すれば、以下の操作を実行し、エディションの設定されたアプリケーションを管理することができます。 AdminApp オブジェクトを使用して実行できる操作の詳細なリストについては、『AdminApp オブジェクトのコマンド』を参照してください。

activateEdition

activateEdition コマンドは、エディションをアクティブ化します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)
-edition
アプリケーション・エディションの名前を指定します。 (ストリング)

戻り値

コマンドの戻り値:
  • true: 成功
  • false: 失敗

バッチ・モードの使用例

対話モードの使用例

deactivateEdition

deactivateEdition コマンドは、エディションを非アクティブ化します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)
-edition
アプリケーション・エディションの名前を指定します。 (ストリング)

戻り値

コマンドの戻り値:
  • true: 成功
  • false: 失敗

バッチ・モードの使用例

対話モードの使用例

rolloutEdition

rolloutEdition コマンドは、エディションをロールアウトし、グループ・サイズを指定します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)
-edition
カスタム・プロパティーの値を指定します。 (ストリング)
-params
ロールアウト構成の値を指定します。(ストリング)
rollout strategy
  • グループ: 同じアプリケーションの現行エディションの代わりに、アプリケーション・クラスターのデプロイ先のクラスター全体にわたって、 一度に groupSize キーワードで指定された N 個のサーバーで、指定されたアプリケーションをアクティブ化します。デフォルト・グループ・サイズは 1 です。 アプリケーションのどちらのエディションも、ロールアウト中に要求を処理できます。新規エディションの ロールアウトの開始時に、1 つ以上のクラスター・メンバーが旧エディションを 提供するように、グループ番号は必ずクラスター・サイズより少なくとも 1 つ 小さく設定してください。
  • アトミック: 同じアプリケーションの現行エディションの代わりに、アプリケーション・クラスターのデプロイ先のクラスター全体にわたって、どの時点においてもアプリケーションの 1 つのエディションだけが要求を処理するように、一度にクラスターの半分のサーバーで、指定されたアプリケーションをアクティブ化します。
reset strategy
ロールアウト操作中にアプリケーション・エディションのインスタンスを始動する方法を指定します。
  • hard: アプリケーション・サーバーを停止または再始動します。
  • soft: アプリケーション・サーバーは実行させたまま、アプリケーション・インスタンスを停止または再始動します。
group size for group rollout
rolloutStrategy をグループ化したときに更新するサーバーの数を指定します。
  • 整数
drainage interval
セッションが完了できるよう、ロールアウト中にアプリケーション・エディションの インスタンスを停止する前に待機する秒数を指定します。デフォルトは 30 秒です。
  • 整数
セッション開始プロトコル (Session Initiation Protocol (SIP)) アプリケーション・ロールアウトに以下のプロパティーを指定します。
quiesce strategy
クラスター・メンバーおよびサーバーを、すべてのアクティブなダイアログおよびセッションが完了した後に静止させるか、 または指定した間隔の後に静止させるかを指定します。

デフォルト: クラスター・メンバーおよびサーバーは、アクティブなダイアログおよびセッションが完了すると静止します。

INTERVAL: クラスター・メンバーおよびサーバーは、指定された間隔の後に静止します。 また、quiesceInterval も、秒数を表す整数で指定する必要があります。

戻り値

コマンドの戻り値:
  • true: 成功
  • false: 失敗

バッチ・モードの使用例

対話モードの使用例

validateEdition

validateEdition コマンドは、エディションを検証します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)
-edition
アプリケーション・エディションの名前を指定します。 (ストリング)
-params
妥当性検査中に複製されるクラスターのサイズを設定するパラメーターを指定します。パラメーターを指定しない場合、 デフォルトで元のクラスターのサイズが使用されます。
  • 動的クラスター:
    dynClusterMaxSize
    動的クラスターの最大サイズを指定します。
    dynClusterMinSize
    動的クラスターの最小サイズを指定します。
  • 静的クラスター:
    staticClusterSize
    静的クラスターのサイズを指定します。staticClusterSize の値は、複製される静的クラスターのサイズを超えることはできません。

戻り値

コマンドの戻り値:
  • true: 成功
  • false: 失敗

バッチ・モードの使用例

対話モードの使用例

listEditions

listEditions コマンドは、アプリケーションのすべてのインストール済みのエディションのリストを戻します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)

戻り値

コマンドは、アプリケーションのすべてのインストール済みのエディションのストリング配列を戻します。

バッチ・モードの使用例

対話モードの使用例

isEditionExists

isEditionExists コマンドは、特定のアプリケーションについて、指定したエディションが存在するか検査します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)
-edition
アプリケーション・エディションの名前を指定します。 (ストリング)

戻り値

コマンドの戻り値:
  • true: 成功
  • false: 失敗

バッチ・モードの使用例

対話モードの使用例

cloneDynamicCluster

cloneDynamicCluster コマンドは、異なるノード・グループを使用するための動的クラスターを複製します。

ターゲット・オブジェクト

なし。

パラメーター

-clusterName
オリジナルの動的クラスターの名前を指定します。 (ストリング)
-newClusterName
複製した動的クラスターの名前を指定します。 (ストリング)
-nodeGroupName
複製した動的クラスターを配置するノード・グループの名前を指定します。このパラメーターを指定しない場合、 名前はデフォルトで現行のノード・グループに指定されます。 (ストリング)
-opMode
複製した動的クラスターの動作モードを指定します。このパラメーターを指定しない場合、 デフォルトでオリジナルの動的クラスターのモードが使用されます。値は、automaticmanual、または、supervised に設定します。 (ストリング)

動作モードの詳細については、動的クラスター を参照してください。

-templateName
既存のテンプレートの名前を指定します。その際の形式は、cell_name/node_name/server_name です。 このテンプレートは、クローン・クラスターのサーバー・インスタンスを作成するために使用されます。

バッチ・モードの使用例

対話モードの使用例

cancelValidation

cancelValidation コマンドは、アプリケーション・エディションに対する妥当性検査モードを取り消します。

getEditionState コマンドは、アプリケーション・エディションの状態を返します。既存のエディションの状態として可能なのは、ACTIVE、INACTIVE、または VALIDATE のいずれかです。存在しないアプリケーションまたはエディションの場合、メソッドはヌルを返します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)
-edition
アプリケーション・エディションの名前を指定します。 (ストリング)

戻り値

コマンドの戻り値:
  • true: 妥当性検査の取り消しが成功しました。
  • false: 妥当性検査の取り消しが失敗しました。

バッチ・モードの使用例

対話モードの使用例

getEditionState [Version 6.1.1 and later]

getEditionState コマンドは、アプリケーション・エディションの状態を返します。既存のエディションの状態として可能なのは、ACTIVE、INACTIVE、または VALIDATE のいずれかです。存在しないアプリケーションまたはエディションの場合、メソッドはヌルを返します。

ターゲット・オブジェクト

なし。

パラメーター

-appName
アプリケーションの名前を指定します。 (ストリング)
-edition
アプリケーション・エディションの名前を指定します。 (ストリング)

戻り値

コマンドの戻り値:
  • ACTIVE
  • INACTIVE
  • VALIDATE

バッチ・モードの使用例

対話モードの使用例

エディションの設定されたアプリケーションのインストール

エディションの設定されたアプリケーションをインストールするには、AdminApp install コマンドを使用します。エディション ID を指定するには、-edition パラメーターを渡す必要があります。

以下の wsadmin の例を使用すれば、エディション 1.0 のアプリケーション BeenThere をインストールできます。
  • Jacl を使用:
    $AdminApp install /tmp/BeenThere1.0.ear {-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*¥.dll=755#.*¥.so=755#.*¥.a=755#.*¥.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude -MapModulesToServers {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml WebSphere:cell=TestCell,cluster=TestClusterB} {"BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:cell=TestCell,cluster=TestClusterB}}}  
  • Jython の使用:
    AdminApp.install("/tmp/BeenThere1.0.ear", '[-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall off -processEmbeddedConfig -filepermission .*¥.dll=755#.*¥.so=755#.*¥.a=755#.*¥.sl=755 -buildVersion Unknown -noallowDispatchRemoteInclude -noallowServiceRemoteInclude -MapModulesToServers [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml WebSphere:cell=TestCell,cluster=TestClusterB] ["BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:cell=TestCell,cluster=TestClusterB]]]') 

エディションの設定されたアプリケーションの更新

エディションの設定されたアプリケーションを更新するには、AdminApp update コマンドを使用します。エディションを指定する場合は、完全アプリケーション名 (アプリケーションおよびエディション名) を渡します。

以下の wsadmin の例を使用すれば、アプリケーション BeenThere のエディション 1.0BeenThereE1-update.ear ファイルで更新できます。
  • Jacl を使用:
    $AdminApp update BeenThere-edition1.0 app {-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*¥.dll=755#.*¥.so=755#.*¥.a=755#.*¥.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude}  
  • Jython の使用:
    AdminApp.update('BeenThere-edition1.0', 'app', '[-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*¥.dll=755#.*¥.so=755#.*¥.a=755#.*¥.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude]') 

エディションの設定されたアプリケーションの編集

エディションの設定されたアプリケーションを編集するには、AdminApp edit コマンドを使用します。エディションを指定する場合は、完全アプリケーション名 (アプリケーションおよびエディション名) を渡します。

以下の wsadmin の例を使用すれば、アプリケーション BeenThere のエディション 1.0 を編集して、Web モジュールのコンテキスト・ルートを /beenthere に変更できます。
  • Jacl を使用:
    $AdminApp edit BeenThere-edition1.0 {-CtxRootForWebMod {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere}}} 
  • Jython の使用:
    AdminApp.edit('BeenThere-edition1.0', '[-CtxRootForWebMod [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere]]]')

エディションの設定されたアプリケーションのアンインストール

エディションの設定されたアプリケーションをアンインストールするには、AdminApp uninstall コマンドを使用します。エディションを指定する場合は、完全アプリケーション名 (アプリケーションおよびエディション名) を渡します。

以下の wsadmin の例を使用すれば、アプリケーション BeenThere のエディション 1.0 をアンインストールできます。
  • Jacl を使用:
    $AdminApp uninstall BeenThere-edition1.0 
  • Jython の使用:
    AdminApp.uninstall('BeenThere-edition1.0')



関連概念
アプリケーション・エディション・マネージャー
関連タスク
サービスの損失がないアプリケーション・エディションのデプロイと管理
エディションのロールアウトの実行
アプリケーションの妥当性検査の取り消し
エディションのインストール
参照トピック    

ご利用条件 | フィードバック

最終更新: 2009/09/17 16時33分25秒EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/reference/radtaskapped.html