8.1.2 展開ディレクトリ形式のJ2EEアプリケーションのインポート
展開ディレクトリ形式のJ2EEアプリケーションは,J2EEサーバの作業ディレクトリ以下に各コンポーネントのclassファイルやJARファイルを持ちません。DDと展開ディレクトリのパス情報だけを持ち,EARファイルまたはZIPファイルが展開ディレクトリのパスに展開されているJ2EEアプリケーションです。ただし,J2EEアプリケーションに含まれるRARファイルはアーカイブ形式で格納されています。
展開ディレクトリ形式のJ2EEアプリケーションのインポートには,次の二つの方法があります。
- アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポートします。
- J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポートします。
- 注意
- 展開ディレクトリ形式のアプリケーションをインポートした場合,J2EEサーバの起動処理中またはサーバ管理コマンド実行中に,アプリケーションディレクトリ以下のディレクトリおよびファイルの追加,削除および上書きはしないでください。
展開ディレクトリ形式のアプリケーションのインポート手順を,次に示します。
- <この項の構成>
- (1) アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート
- (2) J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポート
(1) アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポート
次の手順で,J2EEサーバにアプリケーションディレクトリを登録します。
- アプリケーションディレクトリを作成します。
展開ディレクトリ形式のJ2EEアプリケーションを新規に作成する場合は,アプリケーションディレクトリを作成します。アプリケーションディレクトリの構成については,マニュアル「Cosminexus 機能解説」を参照してください。
- アプリケーションディレクトリをインポートします。
上記1.で作成した,アプリケーションディレクトリをJ2EEサーバに登録します。
次に示すコマンドを実行して,アプリケーションディレクトリをインポートします。
- 実行形式
cjimportapp [<サーバ名>] -a <アプリケーションディレクトリパス> |
- 実行例
cjimportapp MyServer -a AppDirPath
cjimportappコマンドの詳細については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。
- 注意事項
- リモート環境では実行できません。
- application.xmlに<alt-dd>タグを指定している,アプリケーションディレクトリを展開ディレクトリ形式で使用することはできません。
- J2EEサーバ内で,同じディレクトリをアプリケーションディレクトリとするJ2EEアプリケーションがすでにある場合,インポートできません。
- -dオプションを指定したインポートで展開ディレクトリに展開されたアプリケーションディレクトリが,次の場合,-aオプションを指定してインポートできません。
- EJB-JARのモジュール名が「.jar」で終わっていない。
- WARのモジュール名が「.war」で終わっていない。
- 拡張子を含まないモジュール名称が,拡張子を含まないほかのモジュール名称と同一である。
- 拡張子を含まないモジュールの名称が,EARファイル内のディレクトリと同一である。
(2) J2EEアプリケーションを展開ディレクトリ形式のアプリケーションとしてインポート
EARファイルまたはエクスポートした実行時情報付きEARファイルを展開ディレクトリ形式でインポートします。
次に示すコマンドを実行して,アプリケーションを展開ディレクトリ形式でインポートします。
- 実行形式
cjimportapp [<サーバ名>]-f <ファイルパス> -d <展開ディレクトリパス> |
- EARファイルまたはZIPファイルの内容は,展開ディレクトリパスに展開されます。
- 実行例
cjimportapp MyServer -f App1.zip -d ApplicationDir
cjimportappコマンドの詳細については,マニュアル「Cosminexus リファレンス コマンド編」を参照してください。
- 注意事項
- J2EEサーバを起動したユーザに対して,展開先ディレクトリパスに指定したディレクトリの書き込み権限が必要です。
- application.xmlに<alt-dd>タグを指定している,J2EEアプリケーションを展開ディレクトリ形式で使用することはできません。
- J2EEサーバ内で,同じディレクトリを展開ディレクトリとするJ2EEアプリケーションがすでにある場合,インポートできません。
- そのほかの注意事項は,アーカイブ形式のJ2EEアプリケーションのインポートと同じです。アーカイブ形式のJ2EEアプリケーションのインポートについては,「8.1.1 アーカイブ形式のJ2EEアプリケーションのインポート」の注意事項を参照してください。