Oracle® Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ 11g リリース1(10.3.4) B60988-02 |
|
前 |
次 |
weblogic.Deployer
は、管理者や開発者がデプロイメント操作をコマンド・ラインで実行するためのJavaベースのデプロイメント・ツールです。
注意: WebLogic Scripting Tool (WLST)を使用したデプロイメント処理の実行の詳細は、WebLogic Scripting Toolコマンド・リファレンスを参照してください。 |
次の項では、weblogic.Deployer
ユーティリティについて説明します。
weblogic.Deployer
ユーティリティを使用するために環境を設定するには:
『Oracle Fusion Middleware Oracle WebLogic Serverインストール・ガイド』の説明にしたがって、WebLogic Serverソフトウェアをインストールおよび構成します。
CLASSPATH
環境変数にWebLogic Serverクラスを追加し、適切なJDKバイナリがPATH
で使用可能になっていることを確認します。WebLogic Serverインストール・ディレクトリのserver/bin
サブディレクトリにあるsetWLSEnv.sh
またはsetWLSEnv.cmd
スクリプトを使用して、環境を設定できます。
構成済みの管理チャネルを介して管理サーバーに接続する場合は、weblogic.Deployer
を実行するマシンでSSLを構成する必要があります。SSLを構成する手順は、『Oracle WebLogic Serverの保護』のSSLの構成に関する項を参照してください。
java [SSL Arguments] weblogic.Deployer [Connection Arguments] [User Credentials Arguments] COMMAND-NAME command-options [Common Arguments]
コマンド名とオプションでは大文字と小文字は区別されません。weblogic.Deployer
コマンドを使用するための詳細な構文と例については、「コマンドとオプション」を参照してください。
警告: weblogic.Deployer コマンドを使用し、コマンド・ウィンドウまたはスクリプトで暗号化していないパスワードを入力すると、他人にのぞかれる恐れがあり、セキュリティ上危険です。安全にパスワードを入力する方法は、『Oracle WebLogic Server本番環境の保護』のWebLogic Serverホストの保護に関する項を参照してください。 |
java [ -Dweblogic.security.TrustKeyStore=DemoTrust ] [ -Dweblogic.security.JavaStandardTrustKeyStorePassPhrase=password ] [ -Dweblogic.security.CustomTrustKeyStoreFileName=filename -Dweblogic.security.TrustKeystoreType=jks [-Dweblogic.security.CustomTrustKeyStorePassPhrase=password ] ] [ -Dweblogic.security.SSL.hostnameVerifier=classname ] [ -Dweblogic.security.SSL.ignoreHostnameVerification=true ] weblogic.Deployer [ User Credentials Arguments ] COMMAND-NAME command-arguments
ドメイン全体の管理ポートを有効にしている場合、またはSSLで保護された他のリスニング・ポートを使用して管理リクエストを保護する場合は、weblogic.Deployer
を呼び出すときにSSLの引数を含める必要があります。表A-1では、weblogic.Deployer
ユーティリティのすべてのSSLの引数について説明します。
表A-1 SSLの引数
引数 | 定義 |
---|---|
-Dweblogic.security.TrustKeyStore=DemoTrust |
この引数は、接続先のサーバー・インスタンスがデモ用のIDと証明書を使用する場合には必須。 デフォルトでは、 |
-Dweblogic.security.JavaStandardTrustKeyStorePassPhrase=password
|
Java標準信頼キーストアの保護に使用されたパスワード。 Java標準信頼キーストアがパスワードで保護されており、そのCA証明書を信頼する場合には、この引数を使用する必要があります。 デフォルトでは、Java標準信頼キーストアはパスワードで保護されていません。 |
-Dweblogic.security.CustomTrustKeyStoreFileName=filename
-Dweblogic.security.TrustKeystoreType=jks
|
|
-Dweblogic.security.CustomTrustKeyStorePassPhrase=password
|
カスタム・キーストアの保護に使用されたパスワード。 カスタム・キーストアがパスワードで保護されている場合にのみ、この引数を使用する必要があります。 |
-Dweblogic.security.SSL.hostnameVerifier=classname
|
カスタム・ホスト名検証クラスの名前。このクラスは |
-Dweblogic.security.SSL.ignoreHostnameVerification=true |
ホスト名検証を無効にします。 |
java [SSL Arguments] weblogic.Deployer [-adminurl protocol://listen_address:port_number] [User Credentials Arguments] COMMAND-NAME command-options [Common Arguments]
ほとんどのweblogic.Deployer
コマンドでは、管理サーバー・インスタンスに接続するために、表A-2で説明する-adminurl
引数を指定する必要があります。
表A-2 接続引数
引数 | 定義 |
---|---|
-adminurl [protocol://]Admin-Server-listen-address:listen-port |
管理サーバーのリスニング・アドレスとリスニング・ポート。 SSLで保護されていないポートを使用する場合の形式は HTTPプロトコルでadminurlを使用するには、管理コンソールでHTTPトンネリングのオプションを有効にする必要があります。詳細は、『Oracle WebLogic Serverサーバー環境の構成』のHTTPトンネリングのためのWebLogic Serverの設定に関する項を参照してください。管理コンソールでHTTPトンネリングを有効にする方法は、Oracle WebLogic Server管理コンソール・ヘルプの「HTTPプロトコルの構成」を参照してください。 SSLで保護されているポートを使用する場合の形式は 構成済みの管理チャネルを介して管理サーバーに接続するには、有効な管理ポートを次のように指定する必要があります。 この引数のデフォルト値はありません。 |
java [ SSL Arguments ] weblogic.Deployer [Connection Arguments] [ { -username username [-password password] } | [ -userconfigfile config-file [-userkeyfile admin-key] ] ] COMMAND-NAME command-options [Common Arguments]
ほとんどのweblogic.Deployer
コマンドでは、WebLogic Server管理者のユーザー資格証明を指定する必要があります。
表A-3 ユーザー資格証明の引数
引数 | 定義 |
---|---|
-username username
|
管理者のユーザー名。 |
-password password
|
管理者ユーザーのパスワード。
デフォルト・ファイル以外で特定の構成ファイルおよびキー・ファイルを使用するには、 |
-userconfigfile config-file
|
管理ユーザー名およびパスワード用に使用するユーザー構成ファイルのロケーションです。自動スクリプトまたは画面上にパスワードが表示させたくない場合、さらに |
-userkeyfile admin-key
|
ユーザー構成ファイル( |
java [ SSL Arguments ] weblogic.Deployer [Connection Arguments] [ { -username username [-password password] } | [ -userconfigfile config-file [-userkeyfile admin-key] ] ] COMMAND-NAME command-options [Common Arguments]
表A-4に示す共通の引数は、「コマンドとオプション」で説明するどのコマンドでも使用できます。
表A-4 weblogic.Deployerの共通の引数
引数名 | 説明 |
---|---|
-advanced |
|
-debug |
標準出力にデバッグ・メッセージを表示します。 |
-examples |
一般的なタスクのコマンド・ラインの例を表示します。 |
-help |
よく使用する |
-noexit |
デフォルトでは、コマンドの処理中に例外が発生した場合、
|
-noversion |
このオプションを使用する場合、バージョン指定されたアプリケーションは使用できません。 |
-nowait |
|
-output <raw | formatted> |
非推奨。 |
-purgetasks |
|
-remote |
|
-timeout seconds |
デプロイメント・タスクの完了までの最長待機時間(秒単位)。時間の経過後、 |
-verbose |
追加の進行状況メッセージ(デプロイメントの準備フェーズとアクティブ化フェーズについての詳細など)。 |
-version |
|
次の項では、WebLogic Serverでデプロイメント・タスクを実行するために使用するweblogic.Deployer
コマンドとコマンド・オプションについて説明します。
注意: コマンド・オプションと区別するため、weblogic.Deployer コマンドは太字で示します。 |
デプロイメント・タスクの実行を取り消そうとします。
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -cancel task_id [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
task_id |
取り消すデプロイメント・タスクの識別子。識別子は、deploy、distribute、update、undeploy、redeploy、stop、およびstartコマンドでid オプションを使用して指定します。 |
以下のコマンドでは、デプロイメント処理を開始し、タスク識別子myDeployment
を指定します。
java weblogic.Deployer -adminurl http://localhost:7001
-username weblogic -password weblogic
-deploy ./myapp.ear -id myDeployment
デプロイメント・タスクがまだ完了していない場合、以下のコマンドはデプロイメント処理を取り消そうとします。
java weblogic.Deployer -adminurl http://localhost:7001
-username weblogic -password weblogic
-cancel -id myDeployment
アプリケーションまたはモジュールをデプロイまたは再デプロイします。
注意: deployの別名である-ACTIVATE コマンドは非推奨になりました。 |
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -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] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
-name deployment_name
|
新たにデプロイしたアプリケーションまたはスタンドアロン・モジュールに割り当てるデプロイメント名。
「構文」で示すように、
|
-source file
|
デプロイするアーカイブ・ファイルまたは展開されたアーカイブ・ディレクトリ。-source オプションを省略して、デプロイするファイルまたはディレクトリのみを指定できます。 |
-plan file
|
アプリケーションまたはモジュールをデプロイするときに使用するデプロイメント・プラン。デフォルトでは、プランが格納されているアプリケーションのルート・ディレクトリからデプロイする場合でも、weblogic.Deployer は利用可能なデプロイメント・プランを使用しません。 |
-targets target_list
|
アプリケーションまたはモジュールをデプロイする対象。
deployコマンドで対象リストを指定しない場合、対象のデフォルトは次のようになります。
|
-submoduletargets target_list
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲットです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理を参照してください。 |
-upload |
指定されたデプロイメント・ファイル(デプロイメント・プランと代替デプロイメント記述子も含む)を管理サーバーに転送します。このオプションは、リモート・マシンで作業している場合で、他の手段でデプロイメント・ファイルを管理サーバーにコピーできない場合に使用します。アプリケーション・ファイルは、配布およびデプロイメントの前にWebLogic Server管理サーバーのアップロード・ディレクトリにアップロードされます。 |
-stage | -nostage | -external_stage |
アプリケーションをデプロイまたは配布するときに使用するステージング・モード。
「ステージング・モードによるデプロイメント・ファイルのコピーの制御」を参照してください。 |
-retiretimeout seconds
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンを廃止するまでの秒数。「アプリケーションの新しいバージョンの再デプロイ」を参照してください。 |
-library |
デプロイメントを共有J2EEライブラリまたはオプション・パッケージとして指定します。J2EEライブラリまたはオプション・パッケージをデプロイまたは配布する場合は-library オプションを含める必要があります。「共有Java EEライブラリおよびそれに依存するアプリケーションのデプロイ」を参照してください。 |
-libspecver version
|
J2EEライブラリまたはオプション・パッケージの仕様のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに仕様のバージョンが含まれていない場合にのみ使用できます。-libversion は-library と一緒にしか使用できません。「WebLogic Serverでのライブラリの登録」を参照してください。 |
-libimplver version
|
J2EEライブラリまたはオプション・パッケージの実装のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに実装のバージョンが含まれていない場合にのみ使用できます。-libimplversion は-library と一緒にしか使用できません。「WebLogic Serverでのライブラリの登録」を参照してください。 |
-usenonexclusivelock |
同じユーザーがドメインですでに取得している既存のロックを、デプロイメント処理で使用することを指定します。複数のデプロイメント・ツールを同時に使用していて、いずれかのツールでドメイン構成のロックをすでに取得している場合に便利。 |
-altappdd file
|
非推奨。デプロイメントに使用する代替J2EEデプロイメント記述子(application.xml )の名前。 |
-altwlsappdd file
|
非推奨。デプロイメントに使用する代替WebLogic Serverデプロイメント記述子(weblogic-application.xml )の名前。 |
-securityModel [ DDOnly | CustomRoles | CustomRolesAndPolicy | Advanced ] |
このデプロイメントで使用するセキュリティ・モデル。 |
-enableSecurityValidation |
セキュリティ・データの検証を有効にします。 |
-id task_id
|
実行中のデプロイメント・タスクのタスク識別子。distribute 、deploy 、redeploy 、start 、またはundeploy コマンドで識別子を指定できます。その後で、cancel またはlist コマンドの引数として使用できます。識別子が実行中の他のデプロイメント・タスクすべてを通して一意でることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
デプロイメント・ファイルをターゲット・サーバーにコピーして検証することで、デプロイメント用に準備します。
配布されたアプリケーションは、Startコマンドを使用して素早く起動できます。アプリケーションは、管理モードで起動することも、管理およびクライアント・リクエストに対応可能にすることもできます。管理モードの間、アプリケーションは、構成済みの管理ポート経由で内部クライアントからのみアクセスできます。外部クライアントはアプリケーションにアクセスできなくなります。
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -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] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
-name deployment_name
|
配布されるアプリケーションまたはモジュールに割り当てるデプロイメント名。
「構文」で示すように、
|
-source file
|
配布するアーカイブ・ファイルまたは展開されたアーカイブ・ディレクトリ。-source オプションを省略して、ファイルまたはディレクトリのみを指定できます。 |
-plan file
|
アプリケーションまたはモジュールと一緒に配布するデプロイメント・プラン(アプリケーションの構成に使用するプラン)。 |
-targets target_list
|
アプリケーションまたはモジュールを配布する対象。
distributeコマンドで対象リストを指定しない場合、対象のデフォルトは次のようになります。
|
-submoduletargets target_list
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲットです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理を参照してください。 |
-upload |
配布の前に指定したデプロイメント・プランを含め、指定したデプロイメント・ファイルを管理サーバーに転送します。このオプションは、リモート・マシンで作業している場合で、他の手段でデプロイメント・ファイルを管理サーバーにコピーできない場合に使用します。配布の前にアプリケーション・ファイルは、WebLogic Server管理サーバーのアップロード・ディレクトリにアップロードされます。 |
-stage | -nostage | -external_stage |
アプリケーションをデプロイまたは配布するときに使用するステージング・モード。
「ステージング・モードによるデプロイメント・ファイルのコピーの制御」を参照してください。 |
-library |
デプロイメントを共有J2EEライブラリまたはオプション・パッケージとして指定します。J2EEライブラリまたはオプション・パッケージをデプロイまたは配布する場合は-library オプションを含める必要があります。「共有Java EEライブラリおよびそれに依存するアプリケーションのデプロイ」を参照してください。 |
-libspecver version
|
J2EEライブラリまたはオプション・パッケージの仕様のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに仕様のバージョンが含まれていない場合にのみ使用できます。-libversion は-library と一緒にしか使用できません。「WebLogic Serverでのライブラリの登録」を参照してください。 |
-libimplver version
|
J2EEライブラリまたはオプション・パッケージの実装のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに実装のバージョンが含まれていない場合にのみ使用できます。-libimplversion は-library と一緒にしか使用できません。「WebLogic Serverでのライブラリの登録」を参照してください。 |
-altappdd file
|
非推奨。デプロイメントまたは配布に使用する代替J2EEデプロイメント記述子(application.xml )の名前。 |
-altwlsappdd file
|
非推奨。デプロイメントまたは配布に使用する代替WebLogic Serverデプロイメント記述子(weblogic-application.xml )の名前。 |
-securityModel [ DDOnly | CustomRoles | CustomRolesAndPolicy | Advanced ] |
このアプリケーションで使用されるセキュリティ・モデル。 |
-enableSecurityValidation |
セキュリティ・データの検証を有効にします。 |
-id task_id
|
実行中のデプロイメント・タスクのタスク識別子。distribute 、deploy 、redeploy 、start 、またはundeploy コマンドで識別子を指定できます。その後で、cancel またはlist コマンドの引数として使用できます。識別子が実行中の他のデプロイメント・タスクすべてを通して一意でることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
distribute
コマンドはdeploy
と同じように動作しますが、WebLogic Serverはターゲット・サーバー上でアプリケーションまたはモジュールを起動しません。詳細は、Deployコマンドの例に関するリンクを参照してください。
ドメインにデプロイ、配布、またはインストールされているアプリケーションおよびスタンドアロン・モジュールのデプロイメント名をリストします。
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -listapps [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
-listapps
|
ドメインにデプロイ、配布、またはインストールされているアプリケーションおよびスタンドアロン・モジュールのデプロイメント名をリストします。 |
ドメインで現在実行中のデプロイメント・タスクのステータスを表示します。
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] <-list | -listtask> [task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
task_id
|
表示するデプロイメント・タスクの識別子。 |
実行中のアプリケーションまたは実行中のアプリケーションの一部を再デプロイします。
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -redeploy [[-name] deployment_name] {-source file | filelist} [-plan file] [-targets target_list] [-submoduletargets target_list] [-upload] [-delete_files] [-retiretimeout seconds] [-id task_id] [-rmiGracePeriod seconds] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
-name deployment_name
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。-name オプションは省略可能です。省略した場合、-source file 引数から名前が取られます。 |
-source file
|
配布、デプロイ、または再デプロイするアーカイブ・ファイルまたは展開されたアーカイブ・ディレクトリ。
部分的な再デプロイメント用に複数のファイルを指定するには、 注意: エンタープライズ・アプリケーション内のJ2EEモジュール全体を再デプロイするには、「J2EEモジュール更新のための部分的な再デプロイメントの使用」で説明しているモジュール・ターゲット指定構文 |
filelist
|
再デプロイする1つまたは複数のファイル。filelist で複数のファイルを指定すると、再デプロイメントは指定されたファイルの部分的な再デプロイメントとして扱われます。
注意:
|
-plan file
|
配布、デプロイ、または再デプロイ時に使用するデプロイメント・プラン。
アプリケーションを再デプロイするときに、 |
-targets target_list
|
アプリケーションまたはモジュールを再デプロイする対象。
redeployコマンドで対象リストを指定しない場合、対象のデフォルトは次のようになります。
redeployコマンドと一緒に対象リストを指定しない場合、アプリケーションは現在のすべてのターゲット・サーバーに再デプロイされます。 |
-submoduletargets target_list
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲットです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理を参照してください。 |
-upload |
指定されたデプロイメント・ファイル(デプロイメント・プランと代替デプロイメント記述子も含む)を管理サーバーに転送します。このオプションは、リモート・マシンで作業している場合で、他の手段でデプロイメント・ファイルを管理サーバーにコピーできない場合に使用します。アプリケーション・ファイルは、配布およびデプロイメントの前にWebLogic Server管理サーバーのアップロード・ディレクトリにアップロードされます。 |
-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
注意 :
|
-retiretimeout seconds
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンを廃止するまでの秒数。「アプリケーションの新しいバージョンの再デプロイ」を参照してください。 |
-rmiGracePeriod seconds
|
正常停止または廃止の際にRMIの猶予期間内でRMIリクエストの受信がなくなるまで、ワーク・マネージャがRMI呼出しを受け付けてスケジューリングする時間(秒単位)。
|
-id task_id
|
実行中のデプロイメント・タスクのタスク識別子。deploy、redeploy、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中の他のデプロイメント・タスクすべてを通して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
ターゲット・サーバーで停止している(非アクティブな)アプリケーションをクライアントから使用できるようにします。start
コマンドでは、デプロイメント・ファイルをターゲット・サーバーに再配布しません。adminmode
オプションを指定してアプリケーションを管理モードで起動すると、アプリケーションは構成済みの管理チャネル経由でのみ使用できるようになります。start
コマンドを発行するには、それ以前にdeploy
またはdistribute
コマンドを通じて、ファイルがすでに使用可能になっている必要があります。
注意: start の別名であるactivate コマンドは非推奨になりました。 |
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -start [-adminmode] [-name] deployment_name [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-retiretimeout seconds] [-id task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
-adminmode |
アプリケーションを本番モード(デフォルト)ではなく管理モードで起動します。 |
-name deployment_name
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。name オプションは省略できます。省略した場合は、deployment_name から直接名前が取られます。(deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生します。) |
-appversion version
|
起動するアプリケーションのバージョン。 |
-planversion version
|
アプリケーションの起動時に使用するデプロイメント・プランのバージョン。 |
-targets target_list
|
アプリケーションまたはモジュールを起動する対象。
startコマンドで対象リストを指定しない場合、対象のデフォルトは次のようになります。
startコマンドで対象リストを指定しない場合は、アプリケーションの現在のすべての対象でコマンドが実行されます。 |
-submoduletargets target_list
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲットです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理を参照してください。 |
-retiretimeout seconds
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンを廃止するまでの秒数。「アプリケーションの新しいバージョンの再デプロイ」を参照してください。 |
-id task_id
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、start、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子は、実行中の他のデプロイメント・タスクすべてを通して一意でなければならない。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
アプリケーションを非アクティブにして、管理およびクライアント・リクエストに対応できないようにします。アプリケーションのステージングされたファイルはすべて、ターゲット・サーバー上で以降のstart
、deploy
、redeploy
、またはundeploy
の各アクションに使用できる状態になっています。必要に応じ、adminmode
オプションでアプリケーションを管理モードにして、クライアント・リクエストでアプリケーションを使用できなくすることもできます。管理モードの間、アプリケーションは構成済みの管理チャネル経由でのみアクセス可能になります。
注意: stop の別名であるdeactivate コマンドは非推奨になりました。 |
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -stop [-adminmode] [-name] deployment_name [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-ignoresessions] [-graceful] [-rmiGracePeriod seconds] [-id task_id] [Common Arguments]
引数またはオプション | 定義 |
---|---|
-adminmode |
実行中のアプリケーションを管理モードに切り替えて、構成済みの管理チャネル経由で管理リクエストのみを受け付けることを指定します。このオプションを指定しない場合、実行中のアプリケーションは停止されて、再起動するまで管理リクエストもクライアント・リクエストも受け付けなくなります。 |
-name deployment_name
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。name オプションは省略できます。省略した場合は、deployment_name から直接名前が取られます。(deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生します。) |
-appversion version
|
デプロイされているアプリケーションのバージョン識別子。 |
-planversion version
|
デプロイメント・プランのバージョン識別子。 |
-targets target_list
|
アプリケーションまたはモジュールを停止する対象。
stopコマンドで対象リストを指定しない場合、対象のデフォルトは次のようになります。
stopコマンドで対象リストを指定しない場合は、アプリケーションの現在のすべての対象でコマンドが実行されます。 |
-submoduletargets target_list
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲットです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理を参照してください。 |
-graceful |
既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。-graceful オプションを指定しない場合、WebLogic Serverはアプリケーションまたはモジュールをただちに停止します。「本番アプリケーションのオフライン」を参照してください。 |
-rmiGracePeriod seconds
|
正常停止または廃止の際にRMIの猶予期間内でRMIリクエストの受信がなくなるまで、ワーク・マネージャがRMI呼出しを受け付けてスケジューリングする時間(秒単位)。
|
-ignoresessions |
現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに管理モードにします。 |
-id task_id
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、start、stop、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中の他のデプロイメント・タスクすべてを通して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
デプロイメント・ユニットを停止して、ステージングされているファイルをターゲット・サーバーから削除します。
注意: undeploy の別名であるREMOVE コマンドは非推奨になりました。 |
警告: アプリケーション・スコープのリソースを含むアプリケーションをアンデプロイすると、そのリソースはアプリケーションと一緒に削除されます。そのため、JMS送り先の削除が原因で、トランザクションが破棄されたり、メッセージが失われたりする可能性があります。詳細は、『Oracle WebLogic Server JTAのプログラミング』のリソース登録解除の猶予期間に関する項を参照してください。完全に削除するつもりのアプリケーションのみをアンデプロイするようにしてください。アプリケーションへのクライアント・アクセスを一時的に停止する場合は、かわりに |
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -undeploy [-name] deployment_name [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-graceful] [-ignoresessions] [-rmiGracePeriod seconds] [-id task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
-name deployment_name
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。name オプションは省略できます。省略した場合は、deployment_name から直接名前が取られます。(deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生します。) |
-appversion version
|
デプロイされているアプリケーションのバージョン識別子。 |
-planversion version
|
デプロイメント・プランのバージョン識別子。 |
-targets target_list
|
アプリケーションまたはモジュールをアンデプロイする対象。
注意 :対象リストに含まれていない対象は削除されません。
|
-submoduletargets target_list
|
アンデプロイするJMSリソース。
注意 :対象リストに含まれていないサブモジュール対象は削除されません。 『Oroacle WebLogic JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用およびWLSTを使用してJMSサーバーとJMSシステム・リソースの管理を参照してください。 |
-graceful |
既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。-gracefulオプションを指定しない場合、WebLogic Serverはアプリケーションまたはモジュールをただちに停止します。「本番アプリケーションのオフライン」を参照してください。
モジュールは停止後にアンデプロイされます。 |
-rmiGracePeriod seconds
|
正常停止または廃止の際にRMIの猶予期間内でRMIリクエストの受信がなくなるまで、ワーク・マネージャがRMI呼出しを受け付けてスケジューリングする時間(秒単位)。
|
-ignoresessions |
現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに停止してアンデプロイします。 |
-id task_id
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、start、stop、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中の他のデプロイメント・タスクすべてを通して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
プラン・ファイルを再配布して、新しいプランの内容に基づいてアプリケーションを再構成することで、アプリケーションのデプロイメント・プランを更新します。
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -update -plan deployment_plan [-name] deployment_name [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-upload] [-id task_id] [Common Arguments]
引数またはオプション | 定義 |
---|---|
-plan deployment_plan
|
アプリケーションの構成の更新に使用するデプロイメント・プラン。指定されたデプロイメント・プランはアプリケーションのターゲット・サーバーで有効でなければなりません。たとえば、リソースが関連する記述子で以前に定義されていない限り、プランでは必要なリソースにnullの変数を指定できません。
更新処理では、デプロイメント・プランで変更されている(nullではない)値に対応する記述子のみを更新します。更新処理に使用されるプランにnull変数が含まれている場合、対応する記述子の現在の値は更新されません。 |
-name deployment_name
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。name オプションは省略できます。省略した場合は、deployment_name から直接名前が取られます。(deployment_name でファイル名またはディレクトリ名を指定している場合、デプロイメント名は指定されているファイル名から派生します。) |
-appversion version
|
デプロイされているアプリケーションのバージョン識別子。 |
-planversion version
|
デプロイメント・プランのバージョン識別子。 |
-targets target_list
|
アプリケーションまたはモジュールを更新する対象。
updateコマンドで対象リストを指定しない場合、対象のデフォルトは次のようになります。
updateコマンドで対象リストを指定しない場合は、アプリケーションの現在のすべての対象でコマンドが実行されます。 |
-submoduletargets target_list
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲットです。『Oracle WebLogic Server JMSの構成と管理』のJMSアプリケーション・モジュールにおけるサブモジュール・ターゲット指定の使用およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理を参照してください。 |
-upload |
アプリケーションを更新する前に、新しいデプロイメント・プランを管理サーバーにアップロードします。 |
-id task_id
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、update、start、stop、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中の他のデプロイメント・タスクすべてを通して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
この項では、アプリケーションのconfig.xml
ファイルと、アプリケーションをデプロイするための対応するweblogic.Deployer
コマンドを例示します。
次のように想定した場合、
mycluster
はクラスタ名
D1C2S1
とD1C2S2
はサーバー名
RemoteJMSServer1
とRemoteJMSServer2
はJMSサーバー名
アプリケーションのconfig.xml
ファイルには次の内容が含まれます。
<AppDeployment 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
コマンドは次のようになります。
java weblogic.Deployer -adminurl t3://MySystem:10000 -username system -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