Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)
展開ディレクトリ形式を使用する場合の注意事項を次に示します。
- 展開ディレクトリ形式のJ2EEアプリケーションでは,アーカイブ形式のJ2EEアプリケーションと比べて,次の作業ができません。
- EJB-JAR/WAR/RARの追加
- EJB-JAR/WAR/RARの削除
- ライブラリJARの追加
- ライブラリJARの削除
展開ディレクトリ形式のJ2EEアプリケーションでこれらの作業を実施したい場合には,次の手順で実施してください。
- J2EEサーバから展開ディレクトリ形式のJ2EEアプリケーションを削除します。
- アプリケーションディレクトリを修正します。
- 修正した展開ディレクトリ形式のJ2EEアプリケーションをインポートします。
- 展開ディレクトリ形式のJ2EEアプリケーションを使用する場合には,J2EEアプリケーションが任意のリソースへアクセスできるように,セキュリティの設定を変更することをお勧めします。セキュリティの設定の変更については,「13.4.3 展開ディレクトリ形式のJ2EEアプリケーションを使用するための設定(セキュリティの設定変更)」を参照してください。
- 展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合に,アプリケーションディレクトリのパスとしてUNC名を含むパスは指定できません。UNC名を含むパスを指定した場合には,コマンドの実行エラーになります。
- J2EEサーバの起動処理中やサーバ管理コマンドの実行中にアプリケーションディレクトリ以下のファイルおよびディレクトリを追加/削除/上書きしないでください。
- application.xmlに<alt-dd>タグが指定されているJ2EEアプリケーションは,展開ディレクトリ形式で使用できません。展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合,またはEARファイルや,J2EEサーバからエクスポートしたZIPファイルを展開ディレクトリ形式でインポートする場合に,J2EEアプリケーションのapplication.xmlに<alt-dd>タグが指定されているときは,コマンドの実行エラーになります。
- J2EEサーバ内で,複数のJ2EEアプリケーションが同一のディレクトリをアプリケーションディレクトリとして指定することはできません。展開ディレクトリ形式のJ2EEアプリケーションをインポートする場合,またはEARファイルや,J2EEサーバからエクスポートしたZIPファイルを展開ディレクトリ形式でインポートする場合に,指定したディレクトリがすでにほかのJ2EEアプリケーションのアプリケーションディレクトリであるときは,コマンドの実行エラーになります。
- 次のディレクトリをアプリケーションディレクトリまたはWARディレクトリとして持つJ2EEアプリケーションが,すでにJ2EEサーバ内に存在する場合,インポートでコマンドの実行エラーになります。
- cjimportappコマンドの-aオプション,または-dオプションに指定したディレクトリの上位にあるディレクトリ
- cjimportappコマンドの-aオプション,または-dオプションに指定したディレクトリの下位にあるディレクトリ
- cjimportappコマンドの-aオプションにWindowsのドライブ直下(C:\など)のディレクトリ,またはUNIXのルートディレクトリ(/)を指定してインポートする場合は,application.xmlファイルの<display-name>タグにアプリケーション名を指定してください。
- インポート時に指定したJARファイル名は,作業ディレクトリ中のディレクトリ名として用いられます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにJARファイル名を指定してください。作業ディレクトリのパス長の見積もりについては,マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1 J2EEサーバの作業ディレクトリ」を参照してください。
- アプリケーションディレクトリ以下にJavaソースファイルを置くような構成は推奨しません。同じディレクトリに置かれているクラスファイルとJavaソースファイルの同期が取れていない場合,アプリケーションの開始やリロードに失敗する場合があります。
- 次の半角記号はエスケープ文字として扱われるため,アプリケーションディレクトリ名およびモジュール名には指定しないでください。
! # % +
- アプリケーションディレクトリ以下に置かれているJARファイルはライブラリJARとして扱われます。このため,アプリケーションディレクトリ以下には,cjgetstubsjarコマンドで取得したスタブおよびインタフェースを置かないでください。
- 展開ディレクトリ形式のJ2EEアプリケーションをインポートする際,EJB-JARディレクトリとWARディレクトリを除くアプリケーションディレクトリ以下を対象にライブラリJARが検索されます。このため,EJB-JARディレクトリとWARディレクトリを除くアプリケーションディレクトリ以下に多数のファイルがある場合,インポートに時間が掛かることがあります。
- アプリケーションの開始時,インポート時に展開されるWARファイル,EJB-JARファイル,またはEARファイルに含まれるエントリの展開後のファイル絶対パスが,それぞれのルートディレクトリ内にない場合,KDJE42389-Eのエラーメッセージを出力して,ファイルの展開処理を中断します。
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.