WebSphere Application Server - Express, Version 6.0.x   
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows

             目次と検索結果のパーソナライズ化

AdminApp オブジェクトのコマンド

アプリケーションのインストール、変更、および管理を行うには、AdminApp オブジェクトを使用します。

AdminApp オブジェクトは、アプリケーションによる照会および変更を行うために、 WebSphere Application Server の管理および構成サービスと対話します。 この対話には、アプリケーションのインストールおよびアンインストール、モジュールのリスト、 エクスポートなどが含まれます。

操作がローカルに限られる場合は、サーバーを実行せずにスクリプト・クライアントを開始できます。 ローカル・モードで実行するには、-conntype NONE オプションを使用して、 スクリプト・クライアントを開始します。 ローカル・モードで実行中であるというメッセージを受け取ります。 サーバーが現在使用されている場合、ローカル・モードで AdminApp オブジェクトを実行することはお勧めしません。 これは、ローカル・モードで行った構成変更は稼働サーバーの構成に反映されず、 稼働サーバーで行った構成変更はローカル・モードの構成に反映されないためです。 競合する構成を保管すると、 構成が破損するおそれがあります。

以下のコマンドは、AdminApp オブジェクトで使用可能です。

deleteUserAndGroupEntries

すべての役割に対して定義されているユーザーまたはグループを削除し、 アプリケーションに定義されているすべての RunAs 役割のユーザー ID およびパスワードを削除するには、deleteUserAndGroupEntries コマンドを使用します。

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

なし。

必須パラメーター

application name
対象のアプリケーションを指定します。

オプション・パラメーター

なし。

編集

バッチ・モードでアプリケーションまたはモジュールを編集するには、edit コマンドを使用します。 edit コマンドは、options 引数を指定してオプションを使用することにより、application name 引数で指定したアプリケーションを変更します。 edit コマンドではオプションは必要ありません。

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

なし。

必須パラメーター

application name
対象のアプリケーションを指定します。
options
アプリケーションまたはモジュール構成に適用するオプションを指定します。

オプション・パラメーター

なし。

editInteractive

対話モードでアプリケーションまたはモジュールを編集するには、editInteractive コマンドを使用します。 editInteractive コマンドは、アプリケーションのデプロイメントを変更します。 この変更は options パラメーターで指定します。 editInteractive コマンドではオプションは必要ありません。

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

なし。

必須パラメーター

application name
対象のアプリケーションを指定します。
options
アプリケーションまたはモジュール構成に適用するオプションを指定します。

オプション・パラメーター

なし。

export

application name パラメーターを file name で指定したファイルにエクスポートするには、export コマンドを使用します。

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

なし。

必須パラメーター

application name
対象のアプリケーションを指定します。
file name
application name のエクスポート先ファイル名を指定します。

オプション・パラメーター

なし。

exportDDL

データ定義言語 (DDL) を、application name パラメーターから、ディレクトリーが指定する directory name パラメーターに抽出するには、exportDDL コマンドを使用します。 オプション・パラメーターはオプショナルです。

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

なし。

必須パラメーター

application name
対象のアプリケーションを指定します。
directory name
application name のエクスポート先ディレクトリー名を指定します。

オプション・パラメーター

options
指定された application name に受け渡すオプションを指定します。

help

AdminApp オブジェクトに関する一般ヘルプ情報を表示するには、help コマンドを使用します。

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

なし。

必須パラメーター

なし。

オプション・パラメーター

operation name
このオプションを指定すると、AdminApp コマンドまたはインストール・オプションについてのヘルプが表示されます。

出力例

引数を指定しない場合は、以下の出力が返されます。
WASX7095I: The AdminApp object allows application objects to be manipulated including installing, uninstalling,
editing, and listing.
Most of the commands supported by AdminApp operate in two modes: the default mode is one
in which AdminApp communicates with the WebSphere Application Server to accomplish its tasks.
A local mode is also
possible, in which no server communication takes place.  The local mode of operation is invoked by including the
"-conntype NONE" flag in the option string supplied to the command.

The following commands are supported by AdminApp; more detailed information about each of these commands
is available by using the "help" command of AdminApp and supplying the name of the command as an argument.

edit            			Edit the properties of an application
editInteractive 			Edit the properties of an application interactively
export          			Export application to a file
exportDDL      				Extract DDL from application to a directory
help         	   			Show help information
install         			Installs an application, given a file name and an option string.
installInteractive		installInteractive		Installs an application in interactive mode, given a file name and an option string.
list            			List all installed applications
listModules     				List the modules in a specified
application options 	Shows the options available, either for a given file, or in general.
taskInfo        			Shows detailed information pertaining to a given installation task for a given file
uninstall       			Uninstalls an application, given an application name and an option string
operation name の引数として uninstall を指定すると、以下の出力が返されます。
WASX7102I: Method: uninstall
Arguments: application name, options
Description: Uninstalls application named by "application name" using the options supplied by String 2.
Method: uninstall
Arguments: application name
Description: Uninstalls the application specified by "application name" using default options.

Jacl を使用:
  • 以下の例では、引数を指定していません。
    $AdminApp help
  • 以下の例では、operation name の引数を指定しています。
    $AdminApp help uninstall
Jython を使用:
  • 以下の例では、引数を指定していません。
    print AdminApp.help()
  • 以下の例では、operation name の引数を指定しています。
    print AdminApp.help('uninstall')

install

install コマンドを使用して、完全修飾ファイル名およびインストール・オプションのストリングを指定し、非対話モードでアプリケーションをインストールします。 オプション・パラメーターはオプショナルです。

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

なし。

必須パラメーター

ear file
インストールする .ear ファイルのパスを指定します。

オプション・パラメーター

options
コマンドのインストール・オプションを指定します。

  • Jacl を使用:
    $AdminApp install c:/apps/myapp.ear
  • Jython を使用:
    print AdminApp.install('c:/apps/myapp.ear')
このコマンドには、 多くのオプションを使用可能です。 次のコマンドを使用すれば、エンタープライズ・アーカイブ (EAR) ファイルに関して有効なオプションのリストを入手できます。

Jacl を使用:

$AdminApp options myApp.ear
Jython を使用:
print AdminApp.options('myApp.ear')
次のコマンドを使用すれば、 それぞれのオブジェクトごとにヘルプの入手も可能です。

Jacl を使用:

$AdminApp help MapModulesToServers
Jython を使用:
print AdminApp.help('MapModulesToServers')

installInteractive

installInteractive コマンドを使用して、完全修飾ファイル名およびインストール・オプションのストリングを指定し、対話モードでアプリケーションをインストールします。 オプション・パラメーターはオプショナルです。

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

なし。

必須パラメーター

ear file
インストールする .ear ファイルのパスを指定します。

オプション・パラメーター

options
コマンドのインストール・オプションを指定します。

  • Jacl を使用:
    $AdminApp installInteractive c:/websphere/appserver/installableApps/jmsample.ear
  • Jython を使用:
    print AdminApp.installInteractive('c:/websphere/appserver/installableApps/jmsample.ear')

isAppReady

指定したアプリケーションが分散されており、実行の準備ができているかどうかを判別するには、isAppReady コマンドを使用します。 アプリケーションの準備ができている場合は true の値を戻し、アプリケーションの準備ができていない場合は false の値を戻します。このコマンドは、wsadmin ツールがサーバーに接続されていない場合はサポートされません。

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

なし。

必須パラメーター

application name
対象のアプリケーション名を指定します。

オプション・パラメーター

ignoreUnknownState
指定したアプリケーションが分散されており、実行の準備ができているかどうかを確認するために検査します。 ignoreUnknownState パラメーターの有効な値には truefalse があります。true の値を指定すると、不明な状態のノードおよびサーバーは最終的な ready の戻り値に含まれません。コマンドは、アプリケーションの準備ができている場合は true の値を戻し、アプリケーションの準備ができていない場合は false の値を戻します。このコマンドは、wsadmin ツールがサーバーに接続されていない場合はサポートされません。

出力例

application name パラメーターを指定すると、以下の出力例が返されます。
ADMA5071I: Distribution status check started for application DefaultApplication.WebSphere:cell=Node03Cell,
node=myNode,distribution=true
ADMA5011I: The cleanup of the temp directory for application DefaultApplication is complete.
ADMA5072I: Distribution status check completed for application DefaultApplication.true.
application name と ignoreUnknownState をパラメーターとして指定すると、以下の出力例が返されます。
ADMA5071I: Distribution status check started for application TEST.WebSphere:cell=myCell,node=myNode,distribution=unknown
ADMA5011I: The cleanup of the temp directory for application TEST is complete.
ADMA5072I: Distribution status check completed for application TEST.false

以下の例では、application name パラメーターのみを指定します。
  • Jacl を使用:
    $AdminApp isAppReady DefaultApplication
  • Jython を使用:
    print AdminApp.isAppReady('DefaultApplication')
以下の例では、application name と ignoreUnknownState をパラメーターとして指定します。
  • Jacl を使用:
    $AdminApp isAppReady TEST true
  • Jython を使用:
    print AdminApp.isAppReady('TEST', 'true')

list

構成にインストールされているアプリケーションをリストするには、list コマンドを使用します。

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

なし。

必須パラメーター

なし。

オプション・パラメーター

なし。

出力例

adminconsole
DefaultApplication
ivtApp

  • Jacl を使用:
    $AdminApp list
  • Jython を使用:
    print AdminApp.list()

listModules

listModules コマンドを使用して、アプリケーション内のモジュールをリストします。

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

なし。

必須パラメーター

application name
対象のアプリケーションを指定します。

オプション・パラメーター

options
モジュールのインストール先となるアプリケーション・サーバーのリストを指定します。 オプション・パラメーターはオプショナルです。 有効なオプションは -server です。

出力例

以下の例では、application name、#、モジュール URI、+、および DD URI を連結しています。 このストリングを、 edit および editInteractive の各 AdminApp コマンドに渡すことができます。
ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml
ivtApp#ivt_app.war+WEB-INF/web.xml

  • Jacl を使用:
    $AdminApp listModules ivtApp
  • Jython を使用:
    print AdminApp.listModules('ivtApp')

options

Enterprise Archive (EAR) ファイルのインストール用オプションのリストを表示するには、options コマンドを使用します。

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

なし。

必須パラメーター

なし。

オプション・パラメーター

EAR ファイル
対象の EAR ファイルを指定します。
application name
既存アプリケーション編集用オプションのリストを表示する対象となるアプリケーションを指定します。
application module name
既存アプリケーション内のモジュール編集用オプションのリストを表示する対象となるモジュール名を指定します。このパラメーターは、 listModules コマンドによって戻される出力と同じモジュール名フォーマットを必要とします。
file, operations
アプリケーションまたはアプリケーション・モジュール・ファイルのインストールまたは更新用オプションのリストを表示します。以下の有効な値のいずれかを指定します。
  • installapp - 指定されたファイルをインストールするには、このオプションを使用します。
  • updateapp - 指定されたファイルで既存のアプリケーションを更新するには、このオプションを使用します。
  • addmodule - 既存のアプリケーションに対して指定されたモジュール・ファイルを追加するには、このオプションを使用します。
  • updatemodule - 指定されたモジュール・ファイルでアプリケーションの既存のモジュールを更新するには、このオプションを使用します。

出力例

WASX7112I: The following options are valid for "ivtApp"
MapRolesToUsersBindJndiForEJBNonMessageBindingMapEJBRefToEJBMapWebModToVHMapModulesToServersdistributeAppnodistributeAppuseMetaDataFromBinarynouseMetaDataFromBinarycreateMBeansForResources
nocreateMBeansForResources
reloadEnablednoreloadEnabled
verboseinstalled.ear.destination
reloadInterval

以下の options コマンドのサンプルは、EAR ファイルに有効なオプションを戻します。
  • Jacl を使用:
    $AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear
  • Jython を使用:
    print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear')
以下の options コマンドのサンプルは、アプリケーションに有効なオプションを戻します。
  • Jacl を使用:
    $AdminApp options ivtApp
  • Jython を使用:
    print AdminApp.options('ivtApp')
以下の options コマンドのサンプルは、アプリケーション・モジュールに有効なオプションを戻します。
  • Jacl を使用:
    $AdminApp options ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml
  • Jython を使用:
    print AdminApp.options('ivtApp#ivtEJB.jar+META-INF/ejb-jar.xml')
以下の options コマンドのサンプルは、入力ファイルで要求されるオペレーションに有効なオプションを戻します。
  • Jacl を使用:
    $AdminApp options c:/websphere/appserver/installableApps/ivtApp.ear updateapp
  • Jython を使用:
    print AdminApp.options('c:/websphere/appserver/installableApps/ivtApp.ear', 'updateapp')

publishWSDL

publishWSDL コマンドは、application name パラメーターで指定されるアプリケーションの Web サービス記述言語 (WSDL) ファイルを、file name パラメーターで指定されるファイルに公開する場合に使用します。

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

なし。

必須パラメーター

file name
対象のファイルを指定します。
application name
対象のアプリケーションを指定します。

オプション・パラメーター

SOAP address prefixes
使用する SOAP アドレス接頭部を指定します。

出力例

publishWSDL コマンドは出力を返しません。

以下の publishWSDL コマンドの例では、application name と file name を指定しています。
  • Jacl を使用:
    $AdminApp publishWSDL JAXRPCHandlerServer c:/temp/a.zip
  • Jython を使用:
    print AdminApp.publishWSDL('JAXRPCHandlerServer', 'c:/temp/a.zip')
以下の publishWSDL コマンドの例では、application name、file name、および SOAP address prefixes パラメーターの値を指定しています。
  • Jacl を使用:
    $AdminApp publishWSDL JAXRPCHandlersServer c:/temp/a.zip {{JAXRPCHandlersServerApp.war {{http http://localhost:9080}}}}
  • Jython を使用:
    print AdminApp.publishWSDL('JAXRPCHandlersServer', 'c:/temp/a.zip', '[[JAXRPCHandlersServerApp.war [[http http://localhost:9080]]]]')

searchJNDIReferences

searchJNDIReferences コマンドは、特定のノードで Java Naming and Directory Interface (JNDI) ネームを参照するアプリケーションをリストする場合に使用します。

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

なし。

必須パラメーター

node configuration ID
対象のノードに構成 ID を指定します。

オプション・パラメーター

options
使用するオプションを指定します。

出力例

WASX7410W: This operation may take a while depending on the number of applications installed in your system.
MyApp
MapResRefToEJB :ejb-jar-ic.jar : [eis/J2CCF1]

以下の例では、インストールされたアプリケーション MyApp の JNDI 名が eis/J2CCF1 であると想定しています。
  • Jacl を使用:
    $AdminApp searchJNDIReferences $node {-JNDIName eis/J2CCF1 -verbose}
  • Jython を使用:
    print AdminApp.searchJNDIReferences(node, '[-JNDIName eis/J2CCF1 -verbose]')

taskinfo

taskinfo コマンドは、アプリケーション・ファイルの特定タスク・オプションについて情報を提供する場合に使用します。 V5.x と V6.x では、オペレーションがほとんど、あるいは完全に同じであっても、タスク名が変更されたものが多数あります。 V5.x から V6.x にマイグレーションする場合は、既存のスクリプトの更新が必要になることがあります。

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

なし。

必須パラメーター

EAR ファイル
対象の EAR ファイルを指定します。
task name
情報を要求する対象となるタスクを指定します。

オプション・パラメーター

なし。

出力例

MapWebModToVH: Selecting virtual hosts for Web modules
Specify the virtual host where you want to install the Web modules that are contained in
your application. Web modules can be installed on the same virtual host or dispersed among several hosts.
Each element of the MapWebModToVH task consists of the following three fields: "webModule," "uri," "virtualHost."
Of these fields, the following fields might be assigned new values: "virtualHost"and the following are 
required: "virtualHost"

The current contents of the task after running default bindings are:
webModule: JavaMail Sample WebApp
uri: mtcomps.war,WEB-INF/web.xml
virtualHost: default_host

  • Jacl を使用:
    $AdminApp taskInfo c:/websphere/appserver/installableApps/jmsample.ear MapWebModToVH
  • Jython を使用:
    print AdminApp.taskInfo('c:/websphere/appserver/installableApps/jmsample.ear', 'MapWebModToVH')

uninstall

uninstall コマンドを使用して、既存のアプリケーションをアンインストールします。

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

なし。

必須パラメーター

application name
アンインストールするアプリケーションの名前を指定します。

オプション・パラメーター

なし。

出力例

ADMA5017I: Uninstallation of myapp started.
ADMA5104I: Server index entry for myCellManager was updated successfully.
ADMA5102I: Deletion of config data for myapp from config repository completed successfully.
ADMA5011I: Cleanup of temp dir for app myapp done.
ADMA5106I: Application myapp uninstalled successfully.

  • Jacl を使用:
    $AdminApp uninstall myApp
  • Jython を使用:
    print AdminApp.uninstall('myApp')

updateAccessIDs

updateAccessIDs コマンドを使用して、アプリケーションで定義されるさまざまな役割に割り当てられているユーザーおよびグループのアクセス ID 情報を更新します。 システムは、アクセス ID をユーザー・レジストリーから読み取って、アプリケーション・バインディングに保管します。 このオペレーションにより、アプリケーションの実行時パフォーマンスが改善されます。 このコマンドは、アプリケーションのインストール後、またはインストールしたアプリケーションのセキュリティー役割に固有の情報を編集した後に使用します。 wsadmin ツールの -conntype オプションが NONE に設定されているとき、このメソッドを呼び出すことはできません。 このコマンドを呼び出すには、サーバーに接続していなければなりません。

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

なし。

必須パラメーター

application name
対象のアプリケーションの名前を指定します。

オプション・パラメーター

bALL
boolean パラメーター bALL は、アプリケーション・バインディング内のユーザーおよびグループの すべてのアクセス ID を検索して保管します。 アプリケーション・バインディングにおけるアクセス ID を持たないユーザーまたはグループのアクセス ID を検索する場合は、false を指定します。

出力例

ADMA5017I: Uninstallation of myapp started.
ADMA5104I: Server index entry for myCellManager was updated successfully.
ADMA5102I: Deletion of config data for myapp from config repository completed successfully.
ADMA5011I: Cleanup of temp dir for app myapp done.
ADMA5106I: Application myapp uninstalled successfully.

  • Jacl を使用:
    $AdminApp updateAccessIDs myapp true
  • Jython を使用:
    print AdminApp.updateAccessIDs('myapp', 'true')

view

application name パラメーターで指定されたアプリケーションまたはモジュールの、task name パラメーターで指定されたタスクを表示するには、view コマンドを使用します。 アプリケーションに関して有効なタスク名をリスト表示するには、 オプションとして -tasknames を使用します。 そうでない場合は、オプションとして 1 つ以上のタスク名を指定します。

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

なし。

必須パラメーター

name
表示するアプリケーションまたはモジュールの名前を指定します。

オプション・パラメーター

bALL
boolean パラメーター bALL は、アプリケーション・バインディング内のユーザーおよびグループの すべてのアクセス ID を検索して保管します。 アプリケーション・バインディングにおけるアクセス ID を持たないユーザーまたはグループのアクセス ID を検索する場合は、false を指定します。

出力例

task name パラメーターに taskoptions 値を指定すると、コマンドは以下の情報を戻します。
MapModulesToServersMapWebModToVHMapRolesToUsers
task name パラメーターに mapModulesToServers タスクを指定すると、コマンドは以下の情報を戻します。
MapModulesToServers: Selecting Application Servers
アプリケーションに含まれている
モジュールをインストールするアプリケーション・サーバーを指定します。モジュールは、同一のサーバーにインストールするか、幾つかのサーバーに分散することができます。
Module:  adminconsole
URI:  adminconsole.war,WEB-INF/web.xml
Server:  WebSphere:cell=juniartiNetwork,node=juniartiManager,server=dmgr

以下の view コマンドの例は、使用可能な各タスク名をリストします。
  • Jacl を使用:
    $AdminApp view adminconsole {-tasknames}
  • Jython を使用:
    print AdminApp.view('adminconsole', ['-tasknames'])
以下の view コマンドの例は、mapModulesToServer タスクの情報を戻します。
  • Jacl を使用:
    $AdminApp view adminconsole {-MapModulesToServers}
  • Jython を使用:
    print AdminApp.view('adminconsole', ['-MapModulesToServers'])

update

アプリケーションを非対話式モードで更新するには、update コマンドを使用します。 このコマンドによって、アプリケーション・サブコンポーネント、または アプリケーション全体の追加、除去、および更新がサポートされます。 アプリケーション名、コンテンツ・タイプ、および更新オプションを指定してください。

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

なし。

必須パラメーター

application name
更新するアプリケーションの名前を指定します。
content type
content type パラメーターを使用して、アプリケーションの一部 またはアプリケーション全体のいずれを更新するかを示します。 以下のリストで、update コマンドに有効な content type 値を示します。
  • app - アプリケーション全体を更新したいことを示します。 このオプションは、install コマンドに update オプションを指定することに相当します。 content type として app 値を使用する場合は、値として update とともに operation オプションを指定する必要があります。 contents オプションを使用して新規エンタープライズ・アーカイブ・ファイル (EAR) を提供します。 また、バインディング情報およびアプリケーション・オプションを指定することもできます。デフォルトでは、 インストール・モジュールのバインディング情報は更新済みモジュールのバインディング情報とマージされます。 このデフォルトの振る舞いを変更するには、update.ignore.old または update.ignore.new オプションを指定します。
  • file - 単一のファイルを更新したいことを示します。デプロイされたアプリケーション内の任意の有効範囲で 個々のファイルを追加、除去、または更新することができます。 content type として file 値を使用する場合、operation オプションを使用してファイルでオペレーションを実行する必要があります。オペレーションのタイプに応じて、さらなるオプションが必要です。 ファイルの追加および更新のために、contents および contenturi オプションを使用して EAR ファイルのルートに 相対するファイル内容およびファイル URI を提供する必要があります。 ファイルの削除のために、唯一必要な入力である contenturi オプションを使用して EAR ファイルのルートに相対するファイル URI を提供する必要があります。 提供したその他のオプションは無視されます。
  • modulefile - モジュールを更新したいことを示します。個々のアプリケーション・モジュールを追加、 除去、または更新することができます。 content type として modulefile 値を指定する場合は、operation オプションを使用してモジュールで実行したいオペレーションを示す必要があります。 オペレーションのタイプによって、さらなるオプションが必要です。 新規モジュールをインストールする、またはアプリケーションの既存のモジュールを更新する場合は、 contents および contenturi オプションを使用して、EAR ファイルのルートに相対するファイル内容およびファイル URI を示す必要があります。 また、新規モジュールまたは更新済みモジュールに関連するバインディング情報およびアプリケーション・オプションを指定することもできます。モジュールの更新の場合、インストール・モジュールのバインディング情報は、デフォルトで、入力モジュールのバインディング情報とマージされます。 デフォルトの振る舞いを変更するには、update.ignore.old または update.ignore.new オプションを指定します。モジュールを削除するには、EAR ファイルのルートに相対するファイル URI を示します。
  • partialapp - 一部のアプリケーションを更新したいことを示します。 ZIP ファイル・フォーマットで提供されるアプリケーション・コンポーネントのサブセットを使用して、 ファイルおよびモジュールを更新、追加、および削除することができます。 ZIP ファイルは、有効な Java 2 platform, Enterprise Edition (J2EE) アーカイブではありません。 その代わりとして、EAR ファイルに表示されるものと同じ階層構造に アプリケーション成果物があります。 一部のアプリケーション ZIP ファイルを構成する方法について詳しくは、Java API セクションを参照してください。 content type として partialapp 値を示す場合、contents オプションを使用して ZIP ファイルの場所を 指定します。 一部のアプリケーションが更新入力として提供される場合、 バインディング情報およびアプリケーション・オプションが提供されても、指定することはできず、無視されます。

オプション・パラメーター

options
update コマンドでは、多くのオプションが使用可能です。 update コマンドの有効な各オプションのリストについては、AdminApp オブジェクトの install、installInteractive、edit、editInteractive、update、および updateInteractive コマンドのオプション を参照してください。

出力例

Update of singleFile has started.
ADMA5009I: Application archive extracted at C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a1960f0¥ext
Added files from partial ear: []
performFileOperation: source=C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a1960f0¥ext,
dest=C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a1960f0¥mrg, uri= META-INF/web.xml, op= add
Copying file from C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a1960f0¥ext/META-INF/web.xml to
C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a1960f0¥mrg¥META-INF¥web.xml
Collapse list is: []
FileMergeTask completed successfully
ADMA5005I: Application singleFile configured in WebSphere repository
delFiles: []
delM: null
addM: null
Pattern for remove loose and mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
root file to be copied: META-INF/web.xml to
C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a191b4e¥workspace¥cells¥BAMBIE¥applications¥
singleFile.ear¥deployments¥singleFile/META-INF/web.xml
ADMA5005I: Application singleFile configured in WebSphere repository xmlDoc: [#document: null]
root element: [app-delta: null]
****** delta file name: C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a191b4e¥workspace¥cells¥BAMBIE¥applications¥
singleFile.ear/deltas/delta-1079548405564
ADMA5005I: Application singleFile
configured in WebSphere repository
ADMA6011I: Deleting directory tree C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a1960f0
ADMA5011I: Cleanup of temp dir for app singleFile done.
Update of singleFile has ended.

  • Jacl を使用:
    $AdminApp update myApp file {-operation add -contents c:/apps/myApp/web.xml -contenturi META-INF/web.xml}
  • Jython を使用:
    print AdminApp.update(‘myApp’, ‘file’, ‘[-operation add -contents c:/apps/myApp/web.xml -contenturi META-INF/web.xml]’)
  • Jython リストを使用:
    print AdminApp.update(‘myApp’, ‘file’, [‘-operation’, ‘add’, ‘-contents’,  ‘c:/apps/myApp/web.xml’, ‘-contenturi’,  
    ‘META-INF/web.xml’])

updateInteractive

updateInteractive コマンドを使用して、アプリケーション・サブコンポーネントまたはアプリケーション全体を追加、除去および更新します。 対話モードを使用してアプリケーション・モジュールまたはアプリケーション全体を更新する場合、 バインディング情報を構成するのに使用するステップは、installInteractive コマンドに適用するものと似ています。 ファイルまたはアプリケーションの一部を更新する場合は、バインディング情報を構成するのに使用するステップは使用不可です。 この場合、ステップは update コマンドで使用するものと同じです。

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

なし。

必須パラメーター

application name
更新するアプリケーションの名前を指定します。
content type
content type パラメーターを使用して、アプリケーションの一部 またはアプリケーション全体のいずれを更新するかを示します。 以下のリストは、updateInteractive コマンドで有効な content type 値を示しています。
  • app - アプリケーション全体を更新したいことを示します。 このオプションは、install コマンドに update オプションを指定することに相当します。 content type として app 値を使用する場合は、値として update とともに operation オプションを指定する必要があります。 contents オプションを使用して新規エンタープライズ・アーカイブ・ファイル (EAR) を提供します。 また、バインディング情報およびアプリケーション・オプションを指定することもできます。デフォルトでは、 インストール・モジュールのバインディング情報は更新済みモジュールのバインディング情報とマージされます。 このデフォルトの振る舞いを変更するには、update.ignore.old または update.ignore.new オプションを指定します。
  • file - 単一のファイルを更新したいことを示します。デプロイされたアプリケーション内の任意の有効範囲で 個々のファイルを追加、除去、または更新することができます。 content type として file 値を使用する場合、operation オプションを使用してファイルでオペレーションを実行する必要があります。オペレーションのタイプに応じて、さらなるオプションが必要です。 ファイルの追加および更新のために、contents および contenturi オプションを使用して EAR ファイルのルートに 相対するファイル内容およびファイル URI を提供する必要があります。 ファイルの削除のために、唯一必要な入力である contenturi オプションを使用して EAR ファイルのルートに相対するファイル URI を提供する必要があります。 提供したその他のオプションは無視されます。
  • modulefile - モジュールを更新したいことを示します。個々のアプリケーション・モジュールを追加、 除去、または更新することができます。 content type として modulefile 値を指定する場合は、operation オプションを使用してモジュールで実行したいオペレーションを示す必要があります。 オペレーションのタイプによって、さらなるオプションが必要です。 新規モジュールをインストールする、またはアプリケーションの既存のモジュールを更新する場合は、 contents および contenturi オプションを使用して、EAR ファイルのルートに相対するファイル内容およびファイル URI を示す必要があります。 また、新規モジュールまたは更新済みモジュールに関連するバインディング情報およびアプリケーション・オプションを指定することもできます。モジュールの更新の場合、インストール・モジュールのバインディング情報は、デフォルトで、入力モジュールのバインディング情報とマージされます。 デフォルトの振る舞いを変更するには、update.ignore.old または update.ignore.new オプションを指定します。モジュールを削除するには、EAR ファイルのルートに相対するファイル URI を示します。
  • partialapp - 一部のアプリケーションを更新したいことを示します。 ZIP ファイル・フォーマットで提供されるアプリケーション・コンポーネントのサブセットを使用して、 ファイルおよびモジュールを更新、追加、および削除することができます。 ZIP ファイルは、有効な Java 2 platform, Enterprise Edition (J2EE) アーカイブではありません。 その代わりとして、EAR ファイルに表示されるものと同じ階層構造に アプリケーション成果物があります。 一部のアプリケーション ZIP ファイルを構成する方法について詳しくは、Java API セクションを参照してください。 content type として partialapp 値を示す場合、contents オプションを使用して ZIP ファイルの場所を 指定します。 一部のアプリケーションが更新入力として提供される場合、 バインディング情報およびアプリケーション・オプションが提供されても、指定することはできず、無視されます。

オプション・パラメーター

options
updateInteractive コマンドでは、多くのオプションが使用可能です。 updateInteractive コマンドの有効な各オプションのリストについては、AdminApp オブジェクトの install、installInteractive、edit、editInteractive、update、および updateInteractive コマンドのオプション を参照してください。

出力例

Getting tasks for: myApp
WASX7266I: A was.policy file exists for this
application; would you like to display it? [No]

Task[4]: Binding enterprise beans to JNDI names
Each non message driven enterprise bean in your
application or module must be bound to a JNDI name.

EJB Module:  Increment Enterprise Java Bean
EJB:  Increment
URI:  Increment.jar,META-INF/ejb-jar.xml
JNDI Name:  [Inc]:

Task[10]: Specifying the default data source for EJB 2.x modules
Specify the default data source for
the EJB 2.x Module containing 2.x CMP beans.

WASX7349I: Possible value for resource
authorization is container or per connection factory
EJB Module:  Increment Enterprise Java Bean
URI:  Increment.jar,META-INF/ejb-jar.xml
JNDI Name:  [DefaultDatasource]:
Resource Authorization:  [Per connection factory]:

Task[12]: Specifying data sources for individual 2.x CMP beans
Specify an optional data source for each
2.x CMP bean. Mapping a specific data source to a CMP bean overrides 
the default data source for the module containing the enterprise bean.

WASX7349I: Possible value for resource
authorization is container or per connection factory
EJB Module:  Increment Enterprise Java Bean
EJB:  Increment
URI:  Increment.jar,META-INF/ejb-jar.xml
JNDI Name:  [DefaultDatasource]:
Resource Authorization:  [Per connection factory]: container
Setting "Resource Authorization" to "cmpBinding.container"

Task[14]: Selecting Application Servers
Specify the application server where you want to install modules that are contained in your application. 
Modules can be installed on the same server or
dispersed among several servers.

Module:  Increment Enterprise Java Bean
URI:  Increment.jar,META-INF/ejb-jar.xml
Server:  [WebSphere:cell=myCell,node=myNode,server=server1]:

Task[16]: Selecting method protections for unprotected methods for 2.x EJB
Specify whether you want to assign security role
to the unprotected method, add the method to
the exclude list, or mark the method as unchecked.

EJB Module:  Increment Enterprise Java Bean
URI:  Increment.jar,META-INF/ejb-jar.xml
Protection Type:  [methodProtection.uncheck]:
Task[18]: Selecting backend ID
Specify the selection for the BackendID
EJB Module:  Increment Enterprise Java Bean
URI:  Increment.jar,META-INF/ejb-jar.xml
BackendId list:  CLOUDSCAPE_V50_1
CurrentBackendId:  [CLOUDSCAPE_V50_1]:

Task[21]: Specifying application options
Specify the various options available
to prepare and install your application.

Pre-compile JSP:  [No]:
Deploy EJBs:  [No]:
Deploy WebServices:  [No]:

Task[22]: Specifying EJB deploy options
Specify the options to deploy EJB.
....EJB Deploy option is not enabled.

Task[24]: Copy WSDL files
Copy WSDL files
....This task does not require any user input

Task[25]: Specify options to deploy Web services
Specify options to deploy Web services
....Web Services deploy option is not enabled.
Update of myApp has started.

ADMA5009I: Application archive extracted at C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a48e969¥ext/Increment.jar
FileMergeTask completed successfully
ADMA5005I: Application myApp configured in WebSphere repository
delFiles: []
delM: null
addM: [Increment.jar, ]
Pattern for remove loose and mod:
Loose add pattern: META-INF/[^/]*|WEB-INF/[^/]*|.*wsdl
root file to be copied:
META-INF/application.xml to C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a487089¥workspace¥cells¥BAMBIE¥
applications¥testSM.ear¥deployments¥testSM/META-INF/application.xml
del files for full module add/update: []
ADMA6017I: Saved document C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a487089¥workspace¥cells¥BAMBIE¥
applications¥testSM.ear¥deployments¥testSM/Increment.jar¥META-INF/ejb-jar.xml
ADMA6016I: Add to workspace Increment.jar/META-INF/ejb-jar.xml
ADMA6017I: Saved document C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a487089¥workspace¥cells¥BAMBIE¥
applications¥testSM.ear¥deployments¥testSM/Increment.jar¥META-INF/MANIFEST.MF
ADMA6016I: Add to workspace Increment.jar/META-INF/MANIFEST.MF
ADMA6017I: Saved document C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a487089¥workspace¥cells¥BAMBIE¥
applications¥testSM.ear¥deployments¥testSM/Increment.jar¥META-INF/ibm-ejb-jar-bnd.xmi
ADMA6016I: Add to workspace Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi
ADMA6017I: Saved document C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a487089¥workspace¥cells¥BAMBIE¥
applications¥testSM.ear¥deployments¥testSM/Increment.jar¥META-INF/Table.ddl
ADMA6016I: Add to workspace Increment.jar/META-INF/Table.ddl
ADMA6017I: Saved document C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a487089¥workspace¥cells¥BAMBIE¥
applications¥testSM.ear¥deployments¥testSM/Increment.jar¥META-INF/ibm-ejb-jar-ext.xmi
ADMA6016I: Add to workspace Increment.jar/META-INF/ibm-ejb-jar-ext.xmi
add files for full module add/update: [Increment.jar/META-INF/ejb-jar.xml, Increment.jar/META-INF/MANIFEST.MF,
Increment.jar/META-INF/ibm-ejb-jar-bnd.xmi,
Increment.jar/META-INF/Table.ddl, Increment.jar/META-INF/ibm-ejb-jar-ext.xmi]
ADMA5005I: Application myApp configured in WebSphere repository
xmlDoc: [#document: null]
root element: [app-delta: null]
****** delta file name: C:¥asv¥b0403.04¥WebSphere¥AppServer¥wstemp¥Scriptfb5a487089¥workspace¥cells¥BAMBIE¥
applications¥testSM.ear/deltas/delta-1079551520393
ADMA5005I: Application myApp configured in WebSphere repository
ADMA6011I: Deleting directory tree C:¥DOCUME~1¥lavena¥LOCALS~1¥Temp¥app_fb5a48e969
ADMA5011I: Cleanup of temp dir for app myApp done.
Update of myApp has ended.

  • Jacl を使用:
    $AdminApp updateInteractive myApp modulefile {-operation add -contents c:/apps/myApp/Increment.jar
    -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding {{"Increment Enterprise JavaBeans" 
    Increment Increment.jar,META-INF/ejb-jar.xml Inc}}}
  • Jython を使用:
    print AdminApp.updateInteractive(‘myApp’, ‘modulefile’, ‘[-operation add -contents c:/apps/myApp/Increment.jar 
    -contenturi Increment.jar -nodeployejb -BindJndiForEJBNonMessageBinding [["Increment Enterprise JavaBeans" 
    Increment Increment.jar,META-INF/ejb-jar.xml Inc]]]’)
  • Jython リストを使用:
    bindJndiForEJBValue = [["Increment Enterprise JavaBeans", "Increment","Increment.jar,META-INF/ejb-jar.xml", "Inc"]]
    
    print AdminApp.updateInteractive(‘myApp’, ‘modulefile’, [‘-operation’, ‘add’, ‘-contents’,  ‘c:/apps/myApp/Increment.jar’, 
    ‘-contenturi’, ‘Increment.jar’, ‘-nodeployejb’, ‘-BindJndiForEJBNonMessageBinding’, bindJndiForEJBValue])



サブトピック
AdminApp オブジェクトの install、installInteractive、edit、editInteractive、update、および updateInteractive コマンドのオプション
例: AdminApp オブジェクト・コマンドのオプション情報の取得
関連タスク
スクリプト管理のための AdminApp オブジェクトの使用
参照トピック    

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

最終更新: Jan 21, 2008 11:31:28 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/rxml_adminapp.html