WebLogic Server 9.1 アプリケーションのデプロイメント
weblogic.Deployer は、対話形式でコマンドライン ベースのデプロイメント処理を実行する管理者および開発者を対象としています。
weblogic.Deployer ユーティリティについて説明します。
PATH で使用可能になっていることを確認します。setWLSEnv.sh または setWLSEnv.cmd スクリプト (WebLogic Server インストール ディレクトリの server/bin サブディレクトリにある) を使用して、環境を設定できます。
weblogic.Deployer を実行するマシンで SSL をコンフィグレーションする必要もあります。SSL をコンフィグレーションする手順については、『WebLogic Server のセキュリティ』の「SSL のコンフィグレーション」を参照してください。
[ユーザ資格の引数] COMMAND-NAME command-options
[共通の引数]
weblogic.Deployer コマンドを使用するための詳細な構文と例については、「コマンド リファレンス」を参照してください。
-Dweblogic.security.TrustKeyStore=DemoTrust ]
[ -Dweblogic.security.JavaStandardTrustKeystorePassPhrase=password ]
[ -Dweblogic.security.CustomTrustKeyStoreFileName=filename
-Dweblogic.security.TrustKeystoreType=CustomTrust
[-Dweblogic.security.CustomTrustKeystorePassPhrase=password ]
]
[ -Dweblogic.security.SSL.hostnameVerifier=classname ]
[ -Dweblogic.security.SSL.ignoreHostnameVerification=true ]
weblogic.Deployer
[ ユーザ資格の引数 ]
COMMAND-NAME command-arguments
weblogic.Deployer を呼び出すときに SSL の引数を含める必要があります。表 7-1 では、weblogic.Deployer ユーティリティのすべての SSL の引数について説明します。
|
|
|
|
-Dweblogic.security.
TrustKeyStore=
DemoTrust
|
weblogic.Deployer で、デモ用信頼キーストア (WL_HOME\server\lib\DemoTrust.jks) の CA 証明書を信頼するようにする。
weblogic.Deployer は、Java 標準信頼キーストア (SDK_HOME\jre\lib\security\cacerts) の CA 証明書のみを信頼する。
|
|
-Dweblogic.security.
JavaStandardTrustKeysto
rePassPhrase=password
|
|
|
-Dweblogic.security.
CustomTrustKeyStoreFileNa
me=filename
-Dweblogic.security.Trust
KeystoreType=CustomTrust
|
weblogic.Deployer で、filename にあるカスタム キーストアの CA 証明書を信頼するようにする。カスタム キーストアを信頼するには、両方の引数を使用する必要がある。
|
|
-Dweblogic.security.Custo
mTrustKeystorePassPhrase=
password
|
|
|
-Dweblogic.security.SSL.
hostnameVerifier=
classname
|
weblogic.security.SSL.HostnameVerifier インタフェースを実装する必要がある。
|
|
-Dweblogic.security.SSL.
ignoreHostnameVerificat
ion=true
|
|
[-adminurl protocol://listen_address:port_number]
[ユーザ資格の引数] COMMAND-NAME command-options [共通の引数]
weblogic.Deployer コマンドでは、管理サーバ インスタンスに接続するために、表 7-2 で説明する -adminurl 引数を指定する必要があります。
|
|
|
|
-adminurl [protocol://]Admin-Server-listen-address:listen-port
|
-adminurl の値には管理サーバのリスン アドレスとリスン ポートを指定しなければならない。
-adminurl [protocol]Admin-Server-listen-address:port。有効なプロトコルは t3、http、iiop、および iiops。
-adminurl secure-protocol://Admin-Server-listen-address:port。有効なセキュア プロトコルは t3s および https。
-adminurl secure-protocol://Admin-Server-listen-address:domain-wide-admin-port
|
[ { -username username [-password password] } |
[ -userconfigfile config-file [-userkeyfile admin-key] ] ]
COMMAND-NAME command-options [共通の引数]
weblogic.Deployer コマンドでは、WebLogic Server 管理者のユーザ資格を指定するために、表 7-3 の引数を指定する必要があります。
|
|
|
|
-username username
|
-username オプションを指定しても対応する -password オプションを指定しないと、weblogic.Deployer はパスワードを要求する。
|
|
-password password
|
|
|
-userconfigfile config-file
|
ps などのプロセスレベルのユーティリティでパスワードを表示したくない状況で、-user および -password オプションの代わりに使用する。-userconfigfile オプションを指定する前に、「weblogic.Admin コマンドライン リファレンス (非推奨)」の「STOREUSERCONFIG」の説明に従って weblogic.Admin STOREUSERCONFIG コマンドを使用してファイルを生成する必要がある。
|
|
-userkeyfile admin-key
|
-userconfigfile オプション) に格納されたユーザ名とパスワードの情報を暗号化および復号化するために使用するユーザ キー ファイルの位置を指定する。-userkeyfile オプションを指定する前に、「weblogic.Admin コマンドライン リファレンス (非推奨)」の「STOREUSERCONFIG」の説明に従って weblogic.Admin STOREUSERCONFIG コマンドを使用してキー ファイルを生成する必要がある。
|
|
|
|
|
-advanced
|
weblogic.Deployer のすべてのアクションとオプションについて、詳細なコマンドライン ヘルプ テキストを出力する。
|
|
-debug
|
|
|
-examples
|
|
|
-help
|
weblogic.Deployer のアクションとオプションについて、コマンドライン ヘルプ テキストを出力する。
|
|
|
weblogic.Deployer は System.exit(1) を呼び出す。表示される終了値は、デプロイメント処理中に発生した障害の番号を示す。
-noexit オプションはバッチ処理の場合にこの動作をオーバーライドする。
|
|
-noversion
|
weblogic.Deployer が管理サーバにあるバージョン関連のすべてのコード パスを無視することを指定する。この動作は、デプロイメント ソース ファイルが (管理サーバではなく) 管理対象サーバにあり、external_stage ステージング モードを使用する場合に便利。
|
|
-nowait
|
weblogic.Deployer はタスク ID を出力し、アクションの完了を待たずに終了する。このオプションは複数のタスクを開始し、-list アクションを使用して後でモニタするために用いる。
|
|
-output <raw | formatted>
|
raw または formatted を指定して、weblogic.Deployer の出力メッセージの表示方法を制御する。両方の出力タイプに含まれる情報は同じだが、raw 出力では埋め込みタブが使われない。デフォルトでは、weblogic.Deployer の表示は raw 出力になる。
|
|
|
weblogic.Deployer が廃止されたデプロイメント タスクをフラッシュすることを指定する。
|
|
-remote
|
weblogic.Deployer が管理サーバと同じマシンで動作していないこと、およびコマンドに指定するソース パスが管理サーバ マシン自体に対して有効であることを示す。-remote オプションを使用しない場合、weblogic.Deployer はすべてのソース パスをローカル マシン上の有効なパスと想定する。
|
|
-timeout seconds
|
weblogic.Deployer はデプロイメントの現在のステータスを出力して終了する。
|
|
-verbose
|
|
|
-version
|
weblogic.Deployer のバージョン情報を出力する。
|
weblogic.Deployer コマンドとコマンド オプションについて説明します。
weblogic.Deployer コマンドは太字で示します。
接続の引数 [ユーザ資格の引数]
-cancel task_id
[共通の引数]
|
|
|
|
task_id
|
id オプションを使用して指定できる。
|
myDeployment を指定します。
-username weblogic -password weblogic
-deploy ./myapp.ear -id myDeployment
-username weblogic -password weblogic
-cancel myDeployment
-ACTIVATE コマンドは非推奨になりました。
接続の引数 [ユーザ資格の引数]
-deploy [[-name] deployment_name] [-source] file
[-plan file] [-targets target_list] [-submoduletargets target_list]
[-upload]
[-stage | -nostage | -external_stage]
[-retiretimeout seconds]
[-library [-libspecver version] [-libimplver version]]
[-altappdd file] [-altwlsappdd file]
[-securityModel] [-enableSecurityValidation]
[-id task_id]
[共通の引数]
|
|
|
|
-name deployment_name
|
-name オプションと deployment_name 引数は両方とも省略可能。-deploy コマンドでデプロイメント名を明示的に指定しない場合、名前は、指定されたデプロイメント ファイルまたはディレクトリから次のように派生する。
|
|
-source file
|
-source オプションを省略して、デプロイするファイルまたはディレクトリのみを指定できる。
|
|
-plan file
|
weblogic.Deployer は利用可能なデプロイメント プランを使用しない。
|
|
-targets target_list
|
target_list 引数は、対象サーバ、クラスタ、または仮想ホストのカンマ区切りのリスト。各対象を J2EE モジュール名で修飾できる (<module1>@<server1>)。こうすると、エンタープライズ アプリケーションの別々のモジュールを別々のサーバまたはクラスタにデプロイできる。
|
|
-submoduletargets target_list
|
|
|
-upload
|
|
|
-stage | -nostage | -external_stage
|
|
|
-retiretimeout seconds
|
|
|
-library
|
-library オプションを含める必要がある。「共有 J2EE ライブラリおよびそれに依存するアプリケーションのデプロイ」を参照。
|
|
-libspecver version
|
-libversion は -library と一緒にしか使用できない。「WebLogic Server でのライブラリの登録」を参照。
|
|
-libimplver version
|
-libimplversion は -library と一緒にしか使用できない。「WebLogic Server でのライブラリの登録」を参照。
|
|
-usenonexclusivelock
|
|
|
-altappdd file
|
application.xml) の名前を指定する。
|
|
-altwlsappdd file
|
weblogic-application.xml) の名前を指定する。
|
|
-securityModel
[ DDOnly | CustomRoles |
CustomRolesAndPolicy |
Advanced ]
|
|
|
-enableSecurityValidation
|
|
|
-id task_id
|
|
接続の引数 [ユーザ資格の引数]
-distribute [[-name] deployment_name] [-source] file
[-plan file] [-targets target_list] [-submoduletargets target_list]
[-upload]
[-stage | -nostage | -external_stage]
[-library [-libspecver version] [-libimplver version]]
[-altappdd file] [-altwlsappdd file]
[-securityModel] [-enableSecurityValidation]
[-id task_id]
[共通の引数]
|
|
|
|
-name deployment_name
|
-name オプションと deployment_name 引数は両方とも省略可能。デプロイメント名を明示的に指定しない場合、名前は、指定されたデプロイメント ファイルまたはディレクトリから次のように派生する。
|
|
-source file
|
-source オプションを省略して、ファイルまたはディレクトリのみを指定できる。
|
|
-plan file
|
|
|
-targets target_list
|
target_list 引数は、対象サーバ、クラスタ、または仮想ホストのカンマ区切りのリスト。各対象を J2EE モジュール名で修飾できる (<module1>@<server1>)。こうすると、エンタープライズ アプリケーションの別々のモジュールを別々のサーバまたはクラスタに分散できる。
|
|
-submoduletargets target_list
|
|
|
-upload
|
|
|
-stage | -nostage | -external_stage
|
|
|
-library
|
-library オプションを含める必要がある。「共有 J2EE ライブラリおよびそれに依存するアプリケーションのデプロイ」を参照。
|
|
-libspecver version
|
-libversion は -library と一緒にしか使用できない。「WebLogic Server でのライブラリの登録」を参照。
|
|
-libimplver version
|
-libimplversion は -library と一緒にしか使用できない。「WebLogic Server でのライブラリの登録」を参照。
|
|
-altappdd file
|
application.xml) の名前を指定する。
|
|
-altwlsappdd file
|
weblogic-application.xml) の名前を指定する。
|
|
-securityModel
[ DDOnly |
CustomRoles |
CustomRolesAndPolicy |
Advanced ]
|
|
|
-enableSecurityValidation
|
|
|
-id task_id
|
|
Deploy コマンドの例に関するリンクを参照してください。
接続の引数 [ユーザ資格の引数]
-listapps
[共通の引数]
[ユーザ資格の引数] <-list | -listtask> [task_id]
[共通の引数]
|
|
|
|
task_id
|
-id 引数を使用して指定できる。
|
接続の引数 [ユーザ資格の引数]
-redeploy [[-name] deployment_name] {-source file | filelist}
[-plan file] [-targets target_list] [-submoduletargets target_list]
[-upload]
[-delete_files]
[-retiretimeout seconds] [-id task_id]
[共通の引数]
|
|
|
|
-name deployment_name
|
-name オプションは省略できる。省略した場合は、-source file 引数から名前が取られる。
|
|
-source file
|
redeploy コマンドと一緒に使用する場合、-source オプションでは、再デプロイする新しいデプロイメント ファイルの場所を指定する (アプリケーションを新しいバージョンに更新する場合など)。
-source オプションを省略して filelist のみを指定する。
file または filelist の指定は、J2EE モジュール内の静的ファイルを再デプロイする場合にのみ使用する。エンタープライズ アプリケーション内の J2EE モジュール全体を再デプロイするには、モジュール対象指定構文 -targets module@target を使用する (「J2EE モジュールを更新するための部分的な再デプロイメントの使用」を参照)。
|
|
filelist
|
filelist で複数のファイルを指定すると、再デプロイメントは指定されたファイルの部分的な再デプロイメントとして扱われる。
file または filelist の指定は、J2EE モジュール内の静的ファイルを再デプロイする場合にのみ使用する。エンタープライズ アプリケーション内の J2EE モジュール全体を再デプロイするには、モジュール対象指定構文 -targets module@target を使用する (「J2EE モジュールを更新するための部分的な再デプロイメントの使用」を参照)。
-redeploy module-uri の使用は非推奨になった。代わりに、プロダクション再デプロイメントを使用するか、または -targets module@target 構文を使用してモジュールを再デプロイすること。
|
|
-plan file
|
-plan オプションを使用すると、再デプロイメント時に使用する更新済みのコンフィグレーションを指定できる。改訂されたデプロイメント プランにリソース バインディングの変更が含まれている場合、WebLogic Server は古いバージョンと並行して、アプリケーションの新しいバージョンを再デプロイしようとする。「アプリケーションのデプロイメント コンフィグレーションの更新」を参照。
|
|
-targets target_list
|
target_list 引数は、対象サーバ、クラスタ、または仮想ホストのカンマ区切りのリスト。各対象を J2EE モジュール名で修飾できる (<module1>@<server1>)。こうすると、エンタープライズ アプリケーションの別々のモジュールを別々のサーバまたはクラスタに再デプロイできる。
|
|
-submoduletargets target_list
|
|
|
-upload
|
REDEPLOY コマンドと一緒に -upload オプションを使用する。
|
|
-delete_files
|
delete_files は、アーカイブされていないデプロイメント、および -stage モードを使用してデプロイされたアプリケーションでのみ有効。このオプションを使用するときには、次の例のように対象サーバを指定する必要がある。
java weblogic.Deployer -adminurl http://myserver:7001 -username weblogic
-password weblogic -name myapp
-targets myapp@myserver -redeploy
-delete_files myapp/tempindex.html
delete_files は、デプロイメント時にステージング領域にコピーされたファイルのみを削除する。-nostage または -external_stage モードを使用してデプロイされたアプリケーションで delete_files オプションを使用した場合、ファイルは削除されない。
delete_files は、-redeploy コマンドと一緒にしか使用できない。
|
|
-retiretimeout seconds
|
|
|
-id task_id
|
|
-adminmode オプションを指定してアプリケーションを管理モードで起動すると、アプリケーションはコンフィグレーション済みの管理チャネル経由でのみ使用できるようになります。-start コマンドを発行するには、それ以前に -deploy または -distribute コマンドを通じて、ファイルが既に使用可能になっている必要があります。
-activate コマンドは非推奨になりました。
接続の引数 [ユーザ資格の引数]
-start [-adminmode] [-name] deployment_name
[-appversion version] [-planversion version]
[-targets target_list] [-submoduletargets target_list]
[-retiretimeout seconds]
[-id task_id]
[共通の引数]
|
|
|
|
|
|
|
-name deployment_name
|
-name オプションは省略できる。省略した場合は、deployment_name から直接名前が取られる (deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生する)。
|
|
-appversion version
|
|
|
-planversion version
|
|
|
-targets target_list
|
DISTRIBUTE (分散)、DEPLOY (デプロイ)、REDEPLOY (再デプロイ)、または START (起動) する対象を指定する。
target_list 引数は、対象サーバ、クラスタ、または仮想ホストのカンマ区切りのリスト。各対象を J2EE モジュール名で修飾できる (<module1>@<server1>)。こうすると、エンタープライズ アプリケーションの別々のモジュールを別々のサーバまたはクラスタにデプロイできる。
|
|
-submoduletargets target_list
|
|
|
-retiretimeout seconds
|
|
|
-id task_id
|
|
接続の引数 [ユーザ資格の引数]
-stop [-adminmode] [-name] deployment_name
[-appversion version] [-planversion version]
[-targets target_list] [-submoduletargets target_list]
[-ignoresessions] [-graceful]
[-id task_id]
[共通の引数]
|
|
|
|
|
|
|
-name deployment_name
|
-name オプションは省略できる。省略した場合は、deployment_name から直接名前が取られる (deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生する)。
|
|
-appversion version
|
|
|
-planversion version
|
|
|
-targets target_list
|
target_list 引数は、対象サーバ、クラスタ、または仮想ホストのカンマ区切りのリスト。各対象を J2EE モジュール名で修飾できる (<module1>@<server1>)。こうすると、エンタープライズ アプリケーションの別々のモジュールを別々のサーバまたはクラスタにデプロイできる。
|
|
-submoduletargets target_list
|
|
|
|
-graceful オプションを指定しない場合、WebLogic Server はアプリケーションまたはモジュールを直ちに停止する。「プロダクション アプリケーションのオフライン化」を参照。
|
|
-ignoresessions
|
|
|
-id task_id
|
|
-REMOVE コマンドは非推奨になりました。
接続の引数 [ユーザ資格の引数]
-undeploy [-name] deployment_name
[-appversion version] [-planversion version]
[-targets target_list] [-submoduletargets target_list]
[-graceful] [-ignoresessions]
[-id task_id]
[共通の引数]
|
|
|
|
-name deployment_name
|
-name オプションは省略できる。省略した場合は、deployment_name から直接名前が取られる (deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生する)。
|
|
-appversion version
|
|
|
-planversion version
|
|
|
-targets target_list
|
target_list 引数は、対象サーバ、クラスタ、または仮想ホストのカンマ区切りのリスト。各対象を J2EE モジュール名で修飾できる (<module1>@<server1>)。こうすると、エンタープライズ アプリケーションの別々のモジュールを別々のサーバまたはクラスタにデプロイできる。
|
|
-submoduletargets target_list
|
|
|
-graceful
|
-graceful オプションを指定しない場合、WebLogic Server はアプリケーションまたはモジュールを直ちに停止する。「プロダクション アプリケーションのオフライン化」を参照。
|
|
-ignoresessions
|
|
|
-id task_id
|
|
接続の引数 [ユーザ資格の引数]
-update -plan deployment_plan [-name] deployment_name
[-appversion version] [-planversion version]
[-targets target_list] [-submoduletargets target_list]
[-upload] [-id task_id]
[共通の引数]
|
|
|
|
-plan deployment_plan
|
|
|
-name deployment_name
|
-name オプションは省略できる。省略した場合は、deployment_name から直接名前が取られる (deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生する)。
|
|
-appversion version
|
|
|
-planversion version
|
|
|
-targets target_list
|
target_list 引数は、対象サーバ、クラスタ、または仮想ホストのカンマ区切りのリスト。各対象を J2EE モジュール名で修飾できる (<module1>@<server1>)。こうすると、エンタープライズ アプリケーションの別々のモジュールを別々のサーバまたはクラスタにデプロイできる。
|
|
-submoduletargets target_list
|
|
|
-upload
|
|
|
-id task_id
|
|
config.xml ファイルと、アプリケーションをデプロイするための対応する weblogic.Deployer コマンドを例示します。
mycluster はクラスタ名D1C2S1 と D1C2S2 はサーバ名RemoteJMSServer1 と RemoteJMSServer2 は JMS サーバ名
config.xml には次の内容が含まれます。
Name="dd-remote-cluster"
SourcePath="./udd-debug-deployment-on-remote-cluster-jms.xml"
Targets="mycluster">
<SubDeployment Name="RemoteCluster" Targets="mycluster"/>
<SubDeployment Name="D1C2S2" Targets="D1C2S2"/>
<SubDeployment Name="RemoteClusterServers" Targets="D1C2S1,D1C2S2"/>
<SubDeployment Name="RemoteClusterJMSServers"
Targets="RemoteJMSServer1,RemoteJMSServer2"/>
<SubDeployment Name="RemoteQueue1" Targets="RemoteJMSServer1"/>
</AppDeployment>
weblogic.Deployer -deploy コマンドは次のようになります。
-password system -name dd-remote-cluster
-deploy "config\jms\udd-debug-deployment-on-remote-cluster-jms.xml"
-targets mycluster -submoduletargets RemoteCluster@mycluster,
D1C2S2@D1C2S2, RemoteClusterServers@D1C2S1,
RemoteClusterServers@D1C2S2, RemoteClusterJMSServers@RemoteJMSServer1,
RemoteClusterJMSServers@RemoteJMSServer2, RemoteQueue1@RemoteJMSServer1
