注意
注意事項については、「1.4.2 配備時の注意事項」を参照してください。
形式
deploy [--contextroot context_root] [--force[=true|=false]] [--precompilejsp[=true|=false]] [--name component_name] [--retrieve local_dirpath] [--enabled[=true|=false]] [--libraries jar_file[,jar_file]...] [--target target] filepath
機能説明
配備モジュールを配備します。
asadminコマンドの利用方法・注意事項については、「10.1 asadmin」も参照してください。
また共通オプションについては、「10.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
|---|---|---|
--contextroot | なし | context-rootを指定します。 配備対象がディレクトリの場合は、配備対象のディレクトリ名が使用されます。 |
--force | なし | 同一のモジュールが配備済みの場合に、再配備を行うか否かを指定します。 |
--precompilejsp | なし | JSPアプリケーションを配備時にコンパイルするか否かを指定します。 省略値は「false」です。 本オプションを有効にして、JSPの事前コンパイルでエラーが発生した場合は、メッセージを出力して処理を中断します。 |
--name | なし | アプリケーション名を指定します。 アプリケーション名に指定可能な文字は以下です。
|
--retrieve | なし | クライアントスタブJARファイルを取り出します。 |
--enabled | なし | 配備後にアプリケーションを有効にするか否かを指定します。 |
--libraries | なし | アプリケーションから参照するライブラリ(JARファイル)を絶対パスで指定します。複数指定する場合は、カンマ区切りで指定します。
|
--target | なし | 展開先のInterstage Java EE 7 DASサービスのインスタンス名(server)/IJServerクラスタ名を指定します。省略値は「server」です。 |
セッションリカバリ機能のみ使用可能なオプション
オプション名 | 簡略名 | 説明 |
|---|---|---|
--virtualservers | なし | セッションリカバリ機能使用時、配備先の仮想サーバーを選択します。
以下の形式で指定してください。 本オプションは、asadminコマンドでのみ指定可能です。 |
--availabilityenabled | なし | セッションリカバリ機能使用時、配備するユーザアプリケーションをセッションリカバリ機能の対象にする場合、「true」を指定します。デフォルト値は「false」です。 以下の形式で指定してください。 本オプションは、asadminコマンドでのみ指定可能です。 |
具体的な設定例については、「4.23.3 Session Registry Clientの設定」を参照してください。
オペランド
オペランド名 | 省略 | 説明 |
|---|---|---|
filepath | 不可 | 配備対象ファイルまたはディレクトリを指定します。 ディレクトリに指定可能な文字は以下です。
配備対象ディレクトリの上位ディレクトリを指定してディレクトリ配備を行った場合、上位ディレクトリをエンタープライズアプリケーションの展開ディレクトリと判断し配備に成功する場合があります。この場合、アプリケーションが正常に動作しない可能性があるため、必ず配備対象のディレクトリを指定して配備してください。 配備対象ファイルまたはディレクトリとして、UNC形式や、ネットワークドライブ上のパスを指定することはできません。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
DASおよびIJServerクラスタが異なる場合であっても、すでに存在するアプリケーション名は指定できません。また英文字は、大文字・小文字を区別しないため、例えば、「app1」が存在する場合、「APP1」は指定できません。
通常業務中のHotDeploy機能の利用(ターゲットを起動している状態での配備操作)は推奨しません。HotDeploy機能はリクエストがない状況で利用してください。詳細は、「HotDeploy機能使用時の注意事項」を参照してください。
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」（または「オペランド」）に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
配備対象がディレクトリで以下の場合、IJServerクラスタの起動処理時、またはアプリケーションの実行時に例外が発生します。
IJServerクラスタまたはJava EE 7 DASサービスが配備対象ディレクトリを参照できない場合
再配備時にディレクトリにJava EE 7 DASサービスが参照しているファイルが存在しないか、ファイル名が変更されている場合
また、アプリケーション、IJServerクラスタ、サーバーインスタンスがディレクトリにアクセス可能である必要があります。
使用例
以下のように実行します。
C:\Interstage\F3FMisje7\glassfish\bin\asadmin deploy --target IJServer001 sample.ear |
/opt/FJSVisje7/glassfish/bin/asadmin deploy --target IJServer001 sample.ear |
形式
get-client-stubs --appname application_name local_directory_path
機能説明
配備されているアプリケーションから、EJBアプリケーションのクライアントアプリケーションで使用するスタブファイルおよびJava EEアプリケーションクライアントの実行に必要なファイルを内包するディレクトリを取得します。
クライアントスタブJARファイルおよびJava EEアプリケーションクライアントの実行に必要なファイルを内包するディレクトリの構成については、「4.9.2 Java EEアプリケーションクライアントの運用操作」の「4. クライアントスタブJARファイルをダウンロード」を参照してください。
asadminコマンドの利用方法・注意事項については、「10.1 asadmin」も参照してください。
また共通オプションについては「10.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
|---|---|---|
--appname | なし | スタブを取得する対象のアプリケーション名を指定します。 |
オペランド
オペランド名 | 省略 | 説明 |
|---|---|---|
local_directory_path | 不可 | スタブファイルを格納するローカルディレクトリのパスを指定します。 |
戻り値
0: 正常終了
1: 異常終了
使用例
以下のように実行します。
C:\Interstage\F3FMisje7\glassfish\bin\asadmin get-client-stubs --appname sample C:\temp |
/opt/FJSVisje7/glassfish/bin/asadmin get-client-stubs --appname sample /temp |
形式
undeploy [--cascade[=true|=false]] [--target target] component_name
機能説明
配備済みアプリケーションを配備解除します。
asadminコマンドの利用方法・注意事項については、「10.1 asadmin」も参照してください。
また共通オプションについては、「10.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
|---|---|---|
--cascade | なし | リソースアダプタと関係するコネクタ接続プール、コネクタリソース、管理オブジェクトリソース、およびリソースアダプタの定義情報を削除するか否かを指定します。 |
--target | なし | 展開先のInterstage Java EE 7 DASサービスのインスタンス名(server)/IJServerクラスタ名を指定します。省略値は「server」です。 展開先のIJServerクラスタを削除している場合、ドメイン(domain)を指定します。 |
オペランド
オペランド名 | 省略 | 説明 |
|---|---|---|
component-name | 不可 | 配備解除対象のアプリケーション名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
アプリケーション配備済みのままIJServerクラスタを削除した場合、--targetオプションにドメイン(domain)を指定してアプリケーションを配備解除してください。
以下の条件を満たした場合、配備解除後にファイルおよびディレクトリが残存し、削除できない場合があります。この場合、Interstage Java EE 7 DASサービスまたはIJServerクラスタを停止後、手動でファイルおよびディレクトリを削除してください。
javax.servlet.ServletContext#getResource(String path)を呼び出した。かつ、
引数pathがWEB-INF/libディレクトリ配下の存在するjarファイル(例:"/WEB-INF/lib/foo.jar")
配備解除後も、配備時に--librariesオプションで指定したjarファイルが削除できない場合があります。この場合、Interstage Java EE 7 DASサービスおよびIJServerクラスタを停止後、ファイルを削除してください。
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」（または「オペランド」）に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje7\glassfish\bin\asadmin undeploy --target IJServer001 sample |
/opt/FJSVisje7/glassfish/bin/asadmin undeploy --target IJServer001 sample |
形式
enable [--target target] component_name
機能説明
ターゲットへ配備されているアプリケーションを有効にします。
asadminコマンドの利用方法・注意事項については、「10.1 asadmin」も参照してください。
また共通オプションについては、「10.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
|---|---|---|
--target | なし | 対象のInterstage Java EE 7 DASサービスのインスタンス名(server)/IJServerクラスタ名、サーバーインスタンス名を指定します。省略値は「server」です。 |
オペランド
オペランド名 | 省略 | 説明 |
|---|---|---|
component_name | 不可 | 対象のアプリケーション名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」（または「オペランド」）に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje7\glassfish\bin\asadmin enable --target IJServer001 sample |
/opt/FJSVisje7/glassfish/bin/asadmin enable --target IJServer001 sample |
形式
disable [--target target] component_name
機能説明
ターゲットへ配備されているアプリケーションを無効にします。
asadminコマンドの利用方法・注意事項については、「10.1 asadmin」も参照してください。
また共通オプションについては、「10.1.2 asadminコマンドの共通オプション」を参照してください。
オプション
オプション名 | 簡略名 | 説明 |
|---|---|---|
--target | なし | 対象のInterstage Java EE 7 DASサービスのインスタンス名(server)/IJServerクラスタ名、サーバーインスタンス名を指定します。省略値は「server」です。 |
オペランド
オペランド名 | 省略 | 説明 |
|---|---|---|
component_name | 不可 | 対象のアプリケーション名を指定します。 |
戻り値
0: 正常終了
1: 異常終了
注意事項
本サブコマンドを実行すると、以下の同期化対象に対して、定義項目の更新(同期化)処理が行われます。
「target」（または「オペランド」）に指定したサーバーインスタンスまたは指定したIJServerクラスタに属するすべてのサーバーインスタンス
このため、サーバーインスタンスまたはIJServerクラスタに属するすべてのサーバーインスタンスに対する実行結果が出力されます。実行結果の詳細は「asadminコマンドの注意事項」を参照してください。
使用例
以下のように実行します。
C:\Interstage\F3FMisje7\glassfish\bin\asadmin disable --target IJServer001 sample |
/opt/FJSVisje7/glassfish/bin/asadmin disable --target IJServer001 sample |
