cjexportapp(J2EEアプリケーションのエクスポート)
形式
cjexportapp [<サーバ名称>] [-nameserver <プロバイダURL>] -f <EARファイルのパス> -name <J2EEアプリケーション名> [-raw|-normal]
機能
J2EEサーバ上のJ2EEアプリケーションをEARファイルに出力します。実行時情報をEARファイルに含めることができます。
インポートしたJ2EEアプリケーションにcosminexus.xmlが含まれている場合,cosminexus.xmlを含んだ状態でエクスポートします。
インポートしたJ2EEアプリケーションにapplication.xmlが含まれていない場合は,application.xmlを含まない状態でエクスポートします。ただし,cjsetapppropコマンドまたはcjrenameappコマンドの実行でapplication.xmlが作成された場合は,application.xmlを含んだ状態でエクスポートします。application.xmlが作成される場合の説明については,cjsetapppropコマンドまたはcjrenameappコマンドを参照してください。
引数
- <サーバ名称>
-
接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは,ホスト名称がサーバ名称として使用されます。
- -nameserver <プロバイダURL>
-
CORBAネーミングサービスへのアクセスプロトコル,CORBAネーミングサービスが稼働しているホスト名,およびそれが使用しているポート番号を次に示す形式で指定します。
<プロトコル名称>::<ホスト名称>:<ポート番号>
指定内容の詳細については,「2.1.2 プロバイダURLについて」を参照してください。
- -f <EARファイルのパス>
-
-
-rawを指定した場合
エクスポートするJ2EEアプリケーションを含めるEARファイルのパスを指定します。
-
-normalを指定,または省略した場合
アプリケーションサーバのアプリケーション実行環境情報ファイル(hitachi-runtime.jar(拡張子はzip))の出力先となるファイルのパスを指定します。
-
- -name <J2EEアプリケーション名>
-
エクスポートするJ2EEアプリケーション名を指定します。
- -raw
-
EARファイルに実行時情報を含めない場合に指定します。この場合,出力EARファイルは,JavaTM 2 Platform, Enterprise Editionに準拠したものになります。
- -normal
-
EARファイルに実行時情報を含める場合に指定します。実行時情報を含んだEARファイルは,実行時情報分だけファイルサイズが大きくなります。-rawオプション,-normalオプションのどちらも指定されていない場合,-normalオプションを指定した場合と同じになります。
入力例
cjexportapp MyServer -f App1.ear -name App1 -raw
戻り値
- 0:
-
正常終了しました。
- 1:
-
異常終了しました。
- 2:
-
排他エラーによってコマンドを実行できません。
- 3:
-
タイムアウトが発生しました。
- 9:
-
管理者特権がないため,コマンドが実行できません(Windowsの場合)。
注意事項
-
J2EEアプリケーションのエクスポート時には,実行時情報やEARファイルのDDに関して注意事項があります。J2EEアプリケーションのエクスポートについては,マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「8.2 J2EEアプリケーションのエクスポート」を参照してください。
-
指定されたJ2EEアプリケーションが存在しない場合,このコマンドはエラー終了します。
-
コマンドの引数にサーバ名称を指定する場合,cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
-
コマンドの引数にサーバ名称を指定する場合,コマンド名の直後にする必要があります。そのほかの引数は,サーバ名称より後ろ(サーバ名称を省略した場合はコマンド名の後ろ)にあれば順序は任意です。ただし,オプション名と値の順序の入れ替え(例:<プロバイダURL> -nameserver)やオプション名と値を非対応にすること(例:-nameserver <J2EEアプリケーション名> -name <プロバイダURL>)はできません。
-
J2EEアプリケーションに含まれているcosminexus.xmlの定義を変更,追加または削除した場合,cosminexus.xmlは次のようにエクスポートされます。
-
コメントは保持されません。
-
文字エンコードがUTF-8になります。
-
エクスポートしたアプリケーション実行環境情報ファイルやEARファイルに含まれるのはJ2EEサーバが最後に読み込みに成功したcosminexus.xmlです。
J2EEサーバがcosminexus.xmlを読み込んだあとに,アプリケーションディレクトリ内のcosminexus.xmlを変更しても,変更後の定義情報はエクスポートしたアプリケーション実行環境情報ファイルやEARファイルに含まれません。
例:展開ディレクトリ形式のJ2EEアプリケーションをインポート後に,アプリケーションディレクトリ内のcosminexus.xmlを書き換え,J2EEアプリケーションを開始しないで,そのJ2EEアプリケーションをEAR形式でエクスポートした場合,EARファイルにはインポート後に更新したアプリケーションディレクトリ内のcosminexus.xmlは含まれません。インポート時点のものと同等のcosminexus.xmlが含まれます。
-
-
WARアプリケーションのエクスポートはできません。-nameオプションにWARアプリケーションを指定した場合,このコマンドは異常終了します。