A weblogic.Deployerコマンド行リファレンス
weblogic.Deployer
ユーティリティについて学習します。これは、WebLogic Serverの管理者や開発者がデプロイメント操作をコマンド行で実行するためのJavaベースのデプロイメント・ツールです。ノート:
WebLogic Scripting Tool (WLST)を使用したデプロイメント操作の実行については、『WebLogic Server WLSTコマンド・リファレンス』を参照してください。
この付録の内容は次のとおりです。
weblogic.Deployerを呼び出すための構文
java [SSL Arguments] weblogic.Deployer [Connection Arguments] [User Credentials Arguments] COMMAND-NAME command-options [Common Arguments]
コマンド名とオプションでは大文字と小文字は区別されません。weblogic.Deployer コマンドを使用するための詳細な構文と例については、「コマンドとオプション」
を参照してください。
ノート:
weblogic.Deployer
コマンドを使用し、コマンド・ウィンドウまたはスクリプトで暗号化していないパスワードを入力すると、他人にのぞかれる恐れがあり、セキュリティ上危険です。安全にパスワードを入力する方法は、『Oracle WebLogic Server本番環境の保護』のコマンドおよびスクリプトに暗号化されていないパスワードを使用しないことに関する項を参照してください。
SSLの引数
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の引数
引数 | 定義 |
---|---|
|
この引数は、接続先のサーバー・インスタンスがデモ用のIDと証明書を使用する場合は必須です。 デフォルトでは、 |
|
Java標準信頼キーストアの保護に使用されたパスワード。 Java標準信頼キーストアがパスワードで保護されており、そのCA証明書を信頼する場合には、この引数を使用する必要があります。 デフォルトでは、Java標準信頼キーストアはパスワードで保護されていません。 |
|
|
|
カスタム・キーストアの保護に使用されたパスワード。 カスタム・キーストアがパスワードで保護されている場合にのみ、この引数を使用する必要があります。 |
|
カスタム・ホスト名検証クラスの名前。このクラスは |
|
ホスト名検証を無効にします。 |
接続引数
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 接続引数
引数 | 定義 |
---|---|
|
管理サーバーのリスニング・アドレスとリスニング・ポート。 SSLで保護されていないポートを使用する場合の形式は HTTPプロトコルでadminurlを使用するには、WebLogic Server管理コンソールでHTTPトンネリングのオプションを有効にする必要があります。『Oracle WebLogic Serverサーバー環境の管理』のHTTPトンネリングのためのWebLogic Serverの設定に関する項を参照してください。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 ユーザー資格証明の引数
引数 | 定義 |
---|---|
|
管理者のユーザー名。 |
|
管理者ユーザーのパスワード。
デフォルト・ファイル以外で特定の構成ファイルおよびキー・ファイルを使用するには、 |
|
管理ユーザー名およびパスワード用に使用するユーザー構成ファイルのロケーションです。自動スクリプトまたは画面上にパスワードが表示させたくない場合、さらに |
|
ユーザー構成ファイル( |
共通の引数
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の共通の引数
引数名 | 説明 |
---|---|
|
|
|
標準出力にデバッグ・メッセージを表示します。 |
|
一般的なタスクのコマンド行の例を表示します。 |
|
よく使用する |
|
デフォルトでは、コマンドの処理中に例外が発生した場合、
|
|
このオプションを使用する場合、バージョン指定されたアプリケーションは使用できません。 |
|
|
|
(非推奨。) |
|
|
|
デプロイメント・タスクの完了までの最長待機時間(秒単位)。時間の経過後、 |
|
追加の進行状況メッセージ(デプロイメントの準備フェーズとアクティブ化フェーズについての詳細など)。 |
|
|
コマンドとオプション
WebLogic Serverでデプロイメント・タスクを実行するために使用するweblogic.Deployer
コマンドとコマンド・オプションについて調べます。
-
ノート:
コマンド・オプションと区別するため、
weblogic.Deployer
コマンドは太字で示します。
Cancel
デプロイメント・タスクの実行を取り消そうとします。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -cancel task_id [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
task_id |
取り消すデプロイメント・タスクの識別子。識別子は、deploy、distribute、update、undeploy、redeploy、stop、およびstartコマンドで |
例
以下のコマンドでは、デプロイメント処理を開始し、タスク識別子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
アプリケーションまたはモジュールをデプロイまたは再デプロイします。
ノート:
deployの別名である-ACTIVATE
コマンドは非推奨になりました。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -deploy [[-name] deployment_name] [-source] file [-resourceGroupTemplate resource_group_template_name] [-partition partition_name] [-resourceGroup resource_group_name] [-editsession edit_session_name] [-plan file] [-targets target_list] [-submoduletargets target_list] [-upload] [-stage | -nostage | -external_stage] [-planstage | -plannostage | -planexternal_stage] [-retiretimeout seconds] [-library [-libspecver version] [-libimplver version]] [-altappdd file] [-altwlsappdd file] [-securityModel] [-enableSecurityValidation] [-id task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
|
新たにデプロイしたアプリケーションまたはスタンドアロン・モジュールに割り当てるデプロイメント名。 「構文」で示すように、
|
|
デプロイするアーカイブ・ファイルまたは展開されたアーカイブ・ディレクトリ。 |
|
アプリケーションまたはライブラリをデプロイするリソース・グループに関連付けられているパーティションの名前を指定します。 アプリケーションをリソース・グループにパーティション・レベルでデプロイする場合の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のアプリケーションのデプロイに関する項を参照してください。 |
|
アプリケーションやライブラリをデプロイするリソース・グループの名前をパーティション・レベルまたはドメイン・レベルで指定します。
サポートされる他のデプロイメント・アクションの場合、WebLogic Serverでは一意のアプリケーション名からリソース・グループを導出するため、 リソース・グループへのアプリケーションのデプロイの詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のパーティションのリソース・グループへのアプリケーションのデプロイに関する項を参照してください。 |
|
アプリケーションまたはライブラリをデプロイするリソース・グループ・テンプレートの名前を指定します。 リソース・グループ・テンプレートにアプリケーションをデプロイする詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のリソース・グループ・テンプレートを使用したアプリケーション・デプロイメントに関する項を参照してください。 |
|
このデプロイメント操作時にアクティブだった編集セッションの名前を指定します。編集セッションを指定する場合、デプロイメントは編集セッションに関連付けられるため、編集セッションがアクティブ化するまで遅延します。 |
|
アプリケーションまたはモジュールをデプロイするときに使用するデプロイメント・プラン。デフォルトでは、プランが格納されているアプリケーションのルート・ディレクトリからデプロイする場合でも、 |
|
アプリケーションまたはモジュールをデプロイするターゲット。
deployコマンドでターゲット・リストを指定しない場合、ターゲットのデフォルトは次のようになります。
|
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。『Oracle WebLogic Server JMSリソースの管理』のJMSアプリケーション・モジュールにおけるサブモジュールのターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
|
指定されたデプロイメント・ファイル(デプロイメント・プランと代替デプロイメント記述子も含む)を管理サーバーに転送します。このオプションは、リモート・マシンで作業している場合で、他の手段でデプロイメント・ファイルを管理サーバーにコピーできない場合に使用します。アプリケーション・ファイルは、配布およびデプロイメントの前にWebLogic Server管理サーバーのアップロード・ディレクトリにアップロードされます。 |
|
アプリケーションをデプロイまたは配布するときに使用するステージング・モード。
「ステージング・モードによるデプロイメント・ファイルのコピーの制御」を参照してください。 |
|
アプリケーション・アーカイブとは別にデプロイメント・プランをデプロイまたは配布するときに使用するステージング・モード。
ステージング・モードが指定されていない場合は、デフォルトとしてアプリケーションのステージングに指定された値がデプロイメント・プランに使用されます。 |
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをリタイアするまでの秒数。「アプリケーションの新しいバージョンの再デプロイ」を参照してください。 |
|
共有Java EEライブラリまたはオプション・パッケージとしてのデプロイメント。Java EEライブラリまたはオプション・パッケージをデプロイまたは配布する場合は |
|
Java EEライブラリまたはオプション・パッケージの仕様のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに仕様のバージョンが含まれていない場合にのみ使用できます。 |
|
Java EEライブラリまたはオプション・パッケージの実装のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに実装のバージョンが含まれていない場合にのみ使用できます。 |
|
同じユーザーがドメインですでに取得している既存のロックを、デプロイメント処理で使用することを指定します。複数のデプロイメント・ツールを同時に使用していて、いずれかのツールでドメイン構成のロックをすでに取得している場合に便利。 |
|
(非推奨。)デプロイメントに使用する代替Java EEデプロイメント記述子( |
|
(非推奨。)デプロイメントに使用する代替WebLogic Serverデプロイメント記述子( |
|
このデプロイメントで使用するセキュリティ・モデル。 |
|
セキュリティ・データの検証を有効にします。 |
|
実行中のデプロイメント・タスクのタスク識別子。 |
|
custom.jarファイルなどのコード・ソースをWebLogic拡張ローダー(WebLogicドメイン・ローダーとも呼ばれます)に配布します。コード・ソース・ファイルがすべてのターゲットに配布され、操作が完了すると、クラスのロードのためにjarファイルのクラスとリソースが拡張ローダーに表示されます。これは非同期操作で、即座に戻ります。 |
Distribute
デプロイメント・ファイルをターゲット・サーバーにコピーして検証することで、デプロイメント用に準備します。
配布されたアプリケーションは、Startコマンドを使用して素早く起動できます。アプリケーションは、管理モードで起動することも、管理およびクライアント・リクエストに対応可能にすることもできます。管理モードの間、アプリケーションは、構成済の管理ポート経由で内部クライアントからのみアクセスできます。外部クライアントはアプリケーションにアクセスできなくなります。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -distribute [[-name] deployment_name] [-source] file [-resourceGroupTemplate resource_group_template_name] [-partition partition_name] [-resourceGroup resource_group_name] [-editsession edit_session_name] [-plan file] [-targets target_list] [-submoduletargets target_list] [-upload] [-stage | -nostage | -external_stage] [-planstage | -plannostage | -planexternal_stage] [-library [-libspecver version] [-libimplver version]] [-altappdd file] [-altwlsappdd file] [-securityModel] [-enableSecurityValidation] [-id task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
|
配布されるアプリケーションまたはモジュールに割り当てるデプロイメント名。 「構文」で示すように、
|
|
配布するアーカイブ・ファイルまたは展開されたアーカイブ・ディレクトリ。 |
-partition partition_name |
アプリケーションまたはライブラリを分散するリソース・グループに関連付けられているパーティションの名前を指定します。 アプリケーションをリソース・グループにパーティション・レベルでデプロイする場合の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のアプリケーションのデプロイに関する項を参照してください。 |
|
アプリケーションやライブラリを分散するリソース・グループの名前をパーティション・レベルまたはドメイン・レベルで指定します。
サポートされる他のデプロイメント・アクションの場合、WebLogic Serverでは一意のアプリケーション名からリソース・グループを導出するため、 リソース・グループへのアプリケーションのデプロイの詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のパーティションのリソース・グループへのアプリケーションのデプロイに関する項を参照してください。 |
|
アプリケーションまたはライブラリを分散するリソース・グループ・テンプレートの名前を指定します。 リソース・グループ・テンプレートにアプリケーションをデプロイする詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のリソース・グループ・テンプレートを使用したアプリケーション・デプロイメントに関する項を参照してください。 |
|
このデプロイメント操作時にアクティブだった編集セッションの名前を指定します。編集セッションを指定する場合、デプロイメントは編集セッションに関連付けられるため、編集セッションがアクティブ化するまで遅延します。 |
|
アプリケーションまたはモジュールと一緒に配布するデプロイメント・プラン(アプリケーションの構成に使用するプラン)。 |
|
アプリケーションまたはモジュールを配布するターゲット。
distributeコマンドでターゲット・リストを指定しない場合、ターゲットのデフォルトは次のようになります。
|
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。『Oracle WebLogic Server JMSリソースの管理』のJMSアプリケーション・モジュールにおけるサブモジュールのターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
|
配布の前に指定したデプロイメント・プランを含め、指定したデプロイメント・ファイルを管理サーバーに転送します。このオプションは、リモート・マシンで作業している場合で、他の手段でデプロイメント・ファイルを管理サーバーにコピーできない場合に使用します。配布の前にアプリケーション・ファイルは、WebLogic Server管理サーバーのアップロード・ディレクトリにアップロードされます。 |
|
アプリケーションをデプロイまたは配布するときに使用するステージング・モード。
「ステージング・モードによるデプロイメント・ファイルのコピーの制御」を参照してください。 |
|
アプリケーション・アーカイブとは別にデプロイメント・プランをデプロイまたは配布するときに使用するステージング・モード。
ステージング・モードが指定されていない場合は、デフォルトとしてアプリケーションのステージングに指定された値がデプロイメント・プランに使用されます。 |
|
デプロイメントを共有Java EEライブラリまたはオプション・パッケージとして指定します。Java EEライブラリまたはオプション・パッケージをデプロイまたは配布する場合は |
|
Java EEライブラリまたはオプション・パッケージの仕様のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに仕様のバージョンが含まれていない場合にのみ使用できます。 |
|
Java EEライブラリまたはオプション・パッケージの実装のバージョン。このオプションは、ライブラリまたはパッケージのマニフェスト・ファイルに実装のバージョンが含まれていない場合にのみ使用できます。 |
|
(非推奨。)デプロイメントまたは配布に使用する代替Java EEデプロイメント記述子( |
|
(非推奨。)デプロイメントまたは配布に使用する代替WebLogic Serverデプロイメント記述子( |
|
このアプリケーションで使用されるセキュリティ・モデル。 |
-enableSecurityValidation |
セキュリティ・データの検証を有効にします。 |
|
実行中のデプロイメント・タスクのタスク識別子。 |
例
distribute
コマンドはdeploy
と同じように動作しますが、WebLogic Serverはターゲット・サーバー上でアプリケーションまたはモジュールを起動しません。詳細は、Deployコマンドの例に関するリンクを参照してください。
Listapps
ドメインにデプロイ、配布、またはインストールされているアプリケーションおよびスタンドアロン・モジュールのデプロイメント名をリストします。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -listapps [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
-listapps |
ドメインにデプロイ、配布、またはインストールされているアプリケーションおよびスタンドアロン・モジュールのデプロイメント名をリストします。 |
List、Listtask
ドメインで現在実行中のデプロイメント・タスクのステータスを表示します。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] <-list | -listtask> [task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
task_id |
表示するデプロイメント・タスクの識別子。 |
Purgetasks
weblogic.Deployerがリタイアされたデプロイメント・タスクをフラッシュすることを指定します。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -purgetasks
例
次のコマンドでは、weblogic.Deployerがリタイアされたデプロイメント・タスクをフラッシュすることを指定します。
java weblogic.Deployer -username weblogic -password ... -adminurl t3://localhost:7001 -purgetasks : : weblogic.Deployer invoked with options:-username weblogic -adminurl t3://localhost:7001 -purgetasks Currently there are no retired tasks.
Redeploy
実行中のアプリケーションまたは実行中のアプリケーションの一部を再デプロイします。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -redeploy [[-name] deployment_name] [-plan file] [-resourceGroupTemplate resource_group_template_name] [-partition partition_name] [-removePlanOverride] [-editsession edit_session_name] [-targets target_list] [-submoduletargets target_list] [-upload] [-delete_files] [-retiretimeout seconds] [-id task_id] [-rmiGracePeriod seconds] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。 |
|
配布、デプロイ、または再デプロイするアーカイブ・ファイルまたは展開されたアーカイブ・ディレクトリ。
ノート: 元の場所を変更した場合は、バージョン管理されていないアプリケーションまたはバージョン管理された既存のアプリケーションに対して、 部分的な再デプロイメント用に複数のファイルを指定するには、 ノート: エンタープライズ・アプリケーション内のJava EEモジュール全体を再デプロイするには、「Java EEモジュール更新のための部分的な再デプロイメントの使用」で説明しているモジュール・ターゲット指定構文 |
|
アプリケーションまたはライブラリを再デプロイするリソース・グループに関連付けられているパーティションの名前を指定します。 アプリケーションをリソース・グループにパーティション・レベルでデプロイする場合の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のアプリケーションのデプロイに関する項を参照してください。 |
|
アプリケーションまたはライブラリを再デプロイするリソース・グループ・テンプレートの名前を指定します。 リソース・グループ・テンプレートにアプリケーションをデプロイする詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のリソース・グループ・テンプレートを使用したアプリケーション・デプロイメントに関する項を参照してください。 |
|
リソース・グループにデプロイされるアプリケーションやライブラリの場合、リソース・グループが参照するリソース・グループ・テンプレートに定義されているアプリケーション構成をオーバーライドできます。アプリケーションのオーバーライドを削除するには、 アプリケーション構成のオーバーライドの詳細は、『WebLogic Server MTの使用』のアプリケーション構成のオーバーライドに関する項を参照してください。 |
|
このデプロイメント操作時にアクティブだった編集セッションの名前を指定します。編集セッションを指定する場合、デプロイメントは編集セッションに関連付けられるため、編集セッションがアクティブ化するまで遅延します。 |
|
配布、デプロイ、または再デプロイ時に使用するデプロイメント・プラン。 アプリケーションを再デプロイするときに、 |
|
アプリケーションまたはモジュールを再デプロイするターゲット。
ノート: エンタープライズ・アプリケーション内のJava EEモジュール全体を再デプロイするには、「Java EEモジュール更新のための部分的な再デプロイメントの使用」で説明しているモジュール・ターゲット指定構文 redeployコマンドでターゲット・リストを指定しない場合、ターゲットのデフォルトは次のようになります。
redeployコマンドと一緒にターゲット・リストを指定しない場合、アプリケーションは現在のすべてのターゲット・サーバーに再デプロイされます。 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。『Oracle WebLogic Server JMSリソースの管理』のJMSアプリケーション・モジュールにおけるサブモジュールのターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
|
指定されたデプロイメント・ファイル(デプロイメント・プランと代替デプロイメント記述子も含む)を管理サーバーに転送します。このオプションは、リモート・マシンで作業している場合で、他の手段でデプロイメント・ファイルを管理サーバーにコピーできない場合に使用します。アプリケーション・ファイルは、配布およびデプロイメントの前にWebLogic Server管理サーバーのアップロード・ディレクトリにアップロードされます。 |
|
サーバーのステージング・ディレクトリから静的ファイルを削除します。 java weblogic.Deployer -adminurl http://myserver:7001
-username weblogic
-password weblogic -name myapp
-targets myapp@myserver -redeploy
-delete_files myapp/tempindex.html
ノート:
|
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをリタイアするまでの秒数。「アプリケーションの新しいバージョンの再デプロイ」を参照してください。 |
|
正常停止またはリタイアの際にRMIの猶予期間内でRMIリクエストの受信がなくなるまで、ワーク・マネージャがRMI呼出しを受け付けてスケジューリングする時間(秒単位)。 |
|
実行中のデプロイメント・タスクのタスク識別子。deploy、redeploy、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
Start
ターゲット・サーバーで停止している(非アクティブな)アプリケーションをクライアントから使用できるようにします。start
コマンドでは、デプロイメント・ファイルをターゲット・サーバーに再配布しません。adminmode
オプションを指定してアプリケーションを管理モードで起動すると、アプリケーションは構成済の管理チャネル経由でのみ使用できるようになります。start
コマンドを発行するには、それ以前にdeploy
またはdistribute
コマンドを通じて、ファイルがすでに使用可能になっている必要があります。
ノート:
start
の別名であるactivate
コマンドは非推奨になりました。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -start [-adminmode] [-name] deployment_name [-partition partition_name] [-editsession edit_session_name] [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-retiretimeout seconds] [-id task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
|
アプリケーションを本番モード(デフォルト)ではなく管理モードで起動します。 |
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。 |
|
アプリケーションまたはライブラリを開始するリソース・グループに関連付けられているパーティションの名前を指定します。 アプリケーションをリソース・グループにパーティション・レベルでデプロイする場合の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のアプリケーションのデプロイに関する項を参照してください。 |
|
このデプロイメント操作時にアクティブだった編集セッションの名前を指定します。編集セッションを指定する場合、デプロイメントは編集セッションに関連付けられるため、編集セッションがアクティブ化するまで遅延します。 |
|
起動するアプリケーションのバージョン。 |
|
アプリケーションの起動時に使用するデプロイメント・プランのバージョン。 |
|
アプリケーションまたはモジュールを起動するターゲット。
startコマンドでターゲット・リストを指定しない場合、ターゲットのデフォルトは次のようになります。
startコマンドでターゲット・リストを指定しない場合は、アプリケーションの現在のすべてのターゲットでコマンドが実行されます。 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。『Oracle WebLogic Server JMSリソースの管理』のJMSアプリケーション・モジュールにおけるサブモジュールのターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
|
WebLogic Serverがこのアプリケーションまたはモジュールの現在実行中のバージョンをリタイアするまでの秒数。「アプリケーションの新しいバージョンの再デプロイ」を参照してください。 |
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、start、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
Stop
アプリケーションを非アクティブにして、管理およびクライアント・リクエストに対応できないようにします。アプリケーションのステージングされたファイルはすべて、ターゲット・サーバー上で以降のstart
、deploy
、redeploy
、またはundeploy
の各アクションに使用できる状態になっています。必要に応じ、adminmode
オプションでアプリケーションを管理モードにして、クライアント・リクエストでアプリケーションを使用できなくすることもできます。管理モードの間、アプリケーションは構成済の管理チャネル経由でのみアクセス可能になります。
ノート:
stop
の別名であるdeactivate
コマンドは非推奨になりました。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -stop [-adminmode] [-name] deployment_name [-partition partition_name] [-editsession edit_session_name] [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-ignoresessions] [-graceful] [-rmiGracePeriod seconds] [-id task_id] [Common Arguments]
引数またはオプション | 定義 |
---|---|
|
実行中のアプリケーションを管理モードに切り替えて、構成済の管理チャネル経由で管理リクエストのみを受け付けることを指定します。このオプションを指定しない場合、実行中のアプリケーションは停止されて、再起動するまで管理リクエストもクライアント・リクエストも受け付けなくなります。 |
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。 |
|
アプリケーションまたはライブラリを停止するリソース・グループに関連付けられているパーティションの名前を指定します。
アプリケーションをリソース・グループにパーティション・レベルでデプロイする場合の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のアプリケーションのデプロイに関する項を参照してください。 |
|
このデプロイメント操作時にアクティブだった編集セッションの名前を指定します。編集セッションを指定する場合、デプロイメントは編集セッションに関連付けられるため、編集セッションがアクティブ化するまで遅延します。 |
|
デプロイされているアプリケーションのバージョン識別子。 |
|
デプロイメント・プランのバージョン識別子。 |
|
アプリケーションまたはモジュールを停止するターゲット。
stopコマンドでターゲット・リストを指定しない場合、ターゲットのデフォルトは次のようになります。
stopコマンドでターゲット・リストを指定しない場合は、アプリケーションの現在のすべてのターゲットでコマンドが実行されます。 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。『Oracle WebLogic Server JMSリソースの管理』のJMSアプリケーション・モジュールにおけるサブモジュールのターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
|
既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。 |
|
正常停止またはリタイアの際にRMIの猶予期間内でRMIリクエストの受信がなくなるまで、ワーク・マネージャがRMI呼出しを受け付けてスケジューリングする時間(秒単位)。 |
|
現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに管理モードにします。 |
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、start、stop、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
Undeploy
デプロイメント・ユニットを停止して、ステージングされているファイルをターゲット・サーバーから削除します。
ノート:
undeploy
の別名であるREMOVE
コマンドは非推奨になりました。
ノート:
アプリケーション・スコープのリソースを含むアプリケーションをアンデプロイすると、そのリソースはアプリケーションと一緒に削除されます。そのため、JMS宛先の削除が原因で、トランザクションが破棄されたり、メッセージが失われたりする可能性があります。『Oracle WebLogic Server JTAアプリケーションの開発』のリソース登録解除の猶予期間に関する項を参照してください。
完全に削除するつもりのアプリケーションのみをアンデプロイするようにしてください。アプリケーションへのクライアント・アクセスを一時的に停止する場合は、かわりにstop
コマンドを使用します。詳細は、「Stop」を参照してください。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -undeploy [-name] deployment_name [-resourceGroupTemplate resource_group_template_name] [-partition partition_name] [-editsession edit_session_name] [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-graceful] [-ignoresessions] [-rmiGracePeriod seconds] [-id task_id] [Common Arguments]
コマンドまたはオプション | 定義 |
---|---|
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。 |
|
アプリケーションまたはライブラリをアンデプロイするリソース・グループに関連付けられているパーティションの名前を指定します。 partitionオプションは、パーティション管理者にはオプションです。 アプリケーションをリソース・グループにパーティション・レベルでデプロイする場合の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のアプリケーションのデプロイに関する項を参照してください。 |
|
アプリケーションまたはライブラリをアンデプロイするリソース・グループ・テンプレートの名前を指定します。 リソース・グループ・テンプレートにアプリケーションをデプロイする詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のリソース・グループ・テンプレートを使用したアプリケーション・デプロイメントに関する項を参照してください。 |
|
このデプロイメント操作時にアクティブだった編集セッションの名前を指定します。編集セッションを指定する場合、デプロイメントは編集セッションに関連付けられるため、編集セッションがアクティブ化するまで遅延します。 |
|
デプロイされているアプリケーションのバージョン識別子。 |
|
デプロイメント・プランのバージョン識別子。 |
|
アプリケーションまたはモジュールをアンデプロイするターゲット。 ノート: ターゲット・リストに含まれていないターゲットは削除されません。
|
|
アンデプロイするJMSリソース。 ノート: ターゲット・リストに含まれていないサブモジュール・ターゲットは削除されません。 『Oracle WebLogic Server JMSリソースの管理』のJMSアプリケーション・モジュールにおけるサブモジュールのターゲット指定の使用に関する項および WLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
|
既存のHTTPクライアントが作業を完了した後でアプリケーションを停止します。-gracefulオプションを指定しない場合、WebLogic Serverはアプリケーションまたはモジュールをただちに停止します。「本番アプリケーションのオフライン」を参照してください。 モジュールは停止後にアンデプロイされます。 |
|
正常停止またはリタイアの際にRMIの猶予期間内でRMIリクエストの受信がなくなるまで、ワーク・マネージャがRMI呼出しを受け付けてスケジューリングする時間(秒単位)。 |
|
現在のHTTPセッションが完了するのを待機せずに、アプリケーションをただちに停止してアンデプロイします。 |
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、start、stop、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
Update
プラン・ファイルを再配布して、新しいプランの内容に基づいてアプリケーションを再構成することで、アプリケーションのデプロイメント・プランを更新します。
ノート:
update
を使用してアプリケーションのリソース・バインドを更新することはできません。アプリケーションのリソース・バインドを更新するには、Redeployコマンドを使用する必要があります。
構文
java [SSL Arguments] weblogic.Deployer Connection Arguments [User Credentials Arguments] -update -plan deployment_plan [-name] deployment_name [-resourceGroupTemplate resource_group_template_name] [-partition partition_name] [-removePlanOverride] [-editsession edit_session_name] [-appversion version] [-planversion version] [-targets target_list] [-submoduletargets target_list] [-upload] [-id task_id] [Common Arguments]
引数またはオプション | 定義 |
---|---|
|
アプリケーションの構成の更新に使用するデプロイメント・プラン。指定されたデプロイメント・プランはアプリケーションのターゲット・サーバーで有効でなければなりません。たとえば、リソースが関連する記述子で以前に定義されていない限り、プランでは必要なリソースにnullの変数を指定できません。 更新処理では、デプロイメント・プランで変更されている(nullではない)値に対応する記述子のみを更新します。更新処理に使用されるプランにnull変数が含まれている場合、対応する記述子の現在の値は更新されません。 |
|
デプロイされるアプリケーションまたはモジュールのデプロイメント名。 |
|
アプリケーションまたはライブラリを更新するリソース・グループに関連付けられているパーティションの名前を指定します。
アプリケーションをリソース・グループにパーティション・レベルでデプロイする場合の詳細は、『Oracle Fusion Middleware WebLogic Server MTの使用』のアプリケーションのデプロイに関する項を参照してください。 |
|
アプリケーションまたはライブラリを更新するリソース・グループ・テンプレートの名前を指定します。 リソース・グループ・テンプレートにアプリケーションをデプロイする詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のリソース・グループ・テンプレートを使用したアプリケーション・デプロイメントに関する項を参照してください。 |
|
リソース・グループにデプロイされるアプリケーションやライブラリの場合、リソース・グループが参照するリソース・グループ・テンプレートに定義されているアプリケーション構成をオーバーライドできます。アプリケーションのオーバーライドを削除するには、 アプリケーション構成のオーバーライドの詳細は、『WebLogic Server MTの使用』のアプリケーション構成のオーバーライドに関する項を参照してください。 |
|
このデプロイメント操作時にアクティブだった編集セッションの名前を指定します。編集セッションを指定する場合、デプロイメントは編集セッションに関連付けられるため、編集セッションがアクティブ化するまで遅延します。 |
|
デプロイされているアプリケーションのバージョン識別子。 |
|
デプロイメント・プランのバージョン識別子。 |
|
アプリケーションまたはモジュールを更新するターゲット。
updateコマンドでターゲット・リストを指定しない場合、ターゲットのデフォルトは次のようになります。
updateコマンドでターゲット・リストを指定しない場合は、アプリケーションの現在のすべてのターゲットでコマンドが実行されます。 |
|
JMSアプリケーション・モジュール内で定義されているリソースのJMSサーバー・ターゲット。『Oracle WebLogic Server JMSリソースの管理』のJMSアプリケーション・モジュールにおけるサブモジュールのターゲット指定の使用に関する項およびWLSTを使用したJMSサーバーおよびJMSシステム・リソースの管理に関する項を参照してください。 |
|
アプリケーションを更新する前に、新しいデプロイメント・プランを管理サーバーにアップロードします。 |
|
実行中のデプロイメント・タスクのタスク識別子。distribute、deploy、redeploy、update、start、stop、またはundeployコマンドで識別子を指定できます。その後で、cancelまたはlistコマンドの引数として使用できます。識別子が実行中のほかのすべてのデプロイメント・タスクに対して一意であることを確認してください。指定しない場合、システムによって一意の識別子が自動的に生成されます。 |
終了コード
0(ゼロ)の終了コードは成功を示し、0以外の終了コードは1つ以上の失敗が検出されたことを示し、値は失敗の数です。
一般的に、コマンドが拒否されると1の終了コードが返されます。拒否は、構文エラー、無効なIDオプション、接続エラー(たとえば、管理サーバーのレスポンスなし)、ソース・エラー(たとえば、ファイルが見つからない)、または未定義のターゲットによるものです。
config.xmlファイルの例および対応するweblogic.Deployerコマンド
アプリケーションをデプロイするためのアプリケーションのconfig.xml
ファイルと、それに対応するweblogic.Deployer
コマンドを調べます。
次のように想定した場合、
-
mycluster
はクラスタ名 -
D1C2S1
とD1C2S2
はサーバー名 -
RemoteJMSServer1
とRemoteJMSServer2
はJMSサーバー名
アプリケーションのconfig.xml
ファイルには次の内容が含まれます。
<app-deployment> <name>dd-remote-cluster</name> <source-path>./udd-debug-deployment-on-remote-cluster-jms.xml</source-path> <target>mycluster</target> <subdeployment> <name>RemoteCluster</name> <target>mycluster</target> </subdeployment> <subdeployment> <name>D1C2S2</name> <target>D1C2S2</target> </subdeployment> <subdeployment> <name>RemoteClusterServers</name> <target>D1C2S1,D1C2S2</target> </subdeployment> <subdeployment> <name>RemoteClusterJMSServers</name> <target>RemoteJMSServer1,RemoteJMSServer2</target> <subdeployment> <name>RemoteQueue1</name> <target>RemoteJMSServer1</target> </app-deployment>
アプリケーションをデプロイするweblogic.Deployer
-deploy
コマンドは次のようになります。
java weblogic.Deployer -adminurl t3://MySystem:10000 -username system -password password -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