| Sun ONE Application Server 7, Enterprise Edition 管理者ガイド |
第 12 章
アプリケーションの配備この章では、Sun ONE Application Server 7, Enterprise Edition に対し、さまざまなモジュールやアプリケーションを配備する方法について説明します。
Sun ONE Application Server 7, Enterprise Edition のモジュールとアプリケーションには、J2EE 標準の要素と Sun ONE Application Server 7, Enterprise Edition に固有の要素が含まれます。この章では、Sun ONE Application Server 7, Enterprise Edition に固有の要素についてだけ詳しく説明しています。
配備するモジュールとアプリケーションのパッケージ化とアセンブルについては、『Sun ONE Application Server 開発者ガイド』を参照してください。
この章では次のトピックについて説明します。
J2EE モジュールについてJ2EE モジュールは、J2EE コンポーネントの集合で、同一コンテナタイプの 2 つの配備記述子を持ちます。1 つは J2EE 標準の配備記述子で、もう 1 つは Sun ONE Application Server 7, Enterprise Edition に固有の配備記述子です。J2EE モジュールの種類は次のとおりです。
- Web アプリケーションアーカイブ (WAR) : Web アプリケーションは、サーブレット、HTML ページ、クラスなどのリソースの集合で、いくつかの J2EE アプリケーションサーバーにバンドルして配備することができます。WAR ファイルは次のアイテムから構成されます。Servlet、JSP、JSP タグライブラリ、ユーティリティクラス、静的ページ、クライアントサイドアプレット、Beans、Bean クラス、および配備記述子 (web.xml およびオプションで sun-web.xml) から構成されます。
- EJB JAR ファイル : EJB JAR ファイルは、Enterprise JavaBean をアセンブルするときに使われる標準フォーマットです。このファイルには、Bean クラス (ホーム、リモート、ローカル、および実装)、すべてのユーティリティクラス、および配備記述子 (ejb-jar.xml、およびオプションで sun-ejb-jar.xml) が含まれています。EJB がコンテナ管理パーシスタンス付きのエンティティ Beans である場合、CMP 配備記述子である sun-cmp-mapping.xml ファイルも同様に含まれる場合があります。
- アプリケーション (RMI/IIOP) クライアント JAR ファイル : RMI/IIOP クライアントは、Sun ONE Application Server 7, Enterprise Edition に固有の J2EE クライアントです。RMI/IIOP クライアントでは、J2EE 標準のアプリケーションクライアント仕様がサポートされているだけでなく、Sun ONE Application Server 7, Enterprise Edition に直接アクセスすることができます。RMI/IIOP クライアントの配備記述子は、application-client.xml、およびオプションで sun-application-client.xml です。
- リソース RAR ファイル: RAR ファイルは、J2EE CA コネクタに適用されます。コネクタモジュールは、デバイスドライバのような働きをします。この移植性のある方法を使用すると、EJB は外部の企業システムにアクセスできます。Sun ONE Application Server 7, Enterprise Edition の各コネクタには ra.xml という J2EE XML ファイルがあります。コネクタには、sun-ra.xml という Sun ONE Application Server 7, Enterprise Edition 配備記述子も必要です。
モジュールを配備した後にクラスローダが正しいクラスを検索できるように、すべてのモジュールのソースコードでパッケージ定義を使う必要があります。
配備記述子内の情報は宣言型であるため、ソースコードを変更しなくても変更できます。J2EE サーバーは、実行時に読み込んだ配備記述子内の情報に従って動作します。
また、EJB JAR および Web モジュールは、次の図に示すように、.jar ファイルまたは .war ファイルとして個別にアセンブルされ、アプリケーションの外部に個別に配備することもできます。
J2EE アプリケーションについてJ2EE アプリケーションは、1 つまたは複数の J2EE モジュールの論理集合で、アプリケーション配備記述子によって関連付けられています。コンポーネントは、モジュールレベルまたはアプリケーションレベルでアセンブルできます。また、モジュールレベルまたはアプリケーションレベルで配備することもできます。
コンポーネントはモジュールとしてアセンブルされ、その後、配備可能な Sun ONE Application Server 7, Enterprise Edition アプリケーション .ear ファイルにアセンブルされます。
各モジュールには、Sun ONE Application Server 7, Enterprise Edition 配備記述子と J2EE 配備記述子があります。Sun ONE Application Server 7, Enterprise Edition の管理インタフェースは、アプリケーションコンポーネントの配備、および Sun ONE Application Server 7, Enterprise Edition へのリソースの登録に配備記述子を使います。
アプリケーションは、1 つまたは複数のモジュール、オプションの Sun ONE Application Server 7, Enterprise Edition 配備記述子、および必要な J2EE アプリケーション配備記述子で設定されています。これらのすべてのアイテムが、Java ARchive (.jar) ファイル形式で、拡張子 .ear を持つ 1 つのファイルにアセンブルされます。
J2EE 標準記述子J2EE プラットフォームでは、アセンブリおよび配備機能が提供されます。これらの機能では、コンポーネントおよびアプリケーションの標準パッケージとして JAR ファイルが使われ、パラメータのカスタマイズには XML ベースの配備記述子が使われます。J2EE アセンブリおよび配備プロセスの詳細は、『Developing Enterprise Applications with the J2EE, v 1.0』の第 7 章を参照してください。
J2EE 標準配備記述子については、J2EE 仕様書 バージョン 1.3 に説明があります。
配備前に配備記述子の正確さを確認する方法については、『Sun ONE Application Server 開発者ガイド』の配備記述子ベリファイアに関する情報を参照してください。
次の表「J2EE 標準記述子」は、J2EE 標準配備記述子に関する詳細情報の参照先を示しています。左の列は配備記述子、右の列はそれらの記述子に関する詳細情報の参照先を示しています。
仕様書は、次の場所にあります。
Sun ONE Application Server 記述子Sun ONE Application Server 7, Enterprise Edition には、Sun ONE Application Server 7, Enterprise Edition に固有の機能を設定するための追加配備記述子があります。これらの記述子は、コネクタモジュールに必要な sun-ra.xml ファイルを除いて、任意で使用できます。
配備前に配備記述子の正確さを確認する方法については、『Sun ONE Application Server 開発者ガイド』の配備記述子ベリファイアに関する情報を参照してください。
次の表「Sun ONE Application Server 7, Enterprise Edition 記述子」は、Sun ONE Application Server 7, Enterprise Edition 配備記述子に関する詳細情報の参照先を示しています。左の列は配備記述子、右の列はそれらの記述子に関する詳細情報の参照先を示しています。
すべての Sun ONE Application Server 7, Enterprise Edition 配備記述子の DTD スキーマファイルは、install_dir/appserv/lib/dtds ディレクトリにあります。
命名規則アプリケーション名および個別に配備された EJBJAR、WAR、およびコネクタ RAR モジュールの名前 (server.xml ファイル内の name 属性によって指定される) は、Sun ONE Application Server 7, Enterprise Edition 内で一意である必要があります。名前を指定しない場合、ファイル名の最初の部分がデフォルト名となります (.war または .jar 拡張子は含まない)。server.xml の詳細は、『Sun ONE Application Server 7, Enterprise Edition 管理者用設定ファイルリファレンス』を参照してください。
さまざまなタイプのモジュールが、1 つのアプリケーション内で同じ名前を持つ可能性があります。なぜなら、アプリケーションが配備されると、それぞれのモジュールを持つディレクトリ名には、_jar、_war、_rar などのサフィックスが付けられるためです。1 つのアプリケーション内にある同じタイプのモジュールには、一意の名前を付ける必要があります。さらに、データベーススキーマのファイル名も 1 つのアプリケーション内で一意である必要があります。
ejb-jar.xml ファイルの <module-name> に指定するモジュールファイル名や、ejb-jar.xml ファイルの <ejb-name> に指定する EAR ファイル名には、Java パッケージ方式の命名規則を使用することをお勧めします。Java パッケージ方式の命名規則を使えば、名前の衝突は発生しません。この命名規則を、Sun ONE Application Server 7, Enterprise Edition だけでなく、ほかの J2EE アプリケーションサーバーでも適用することをお勧めします。
EJB の JNDI ルックアップ名も一意でなければなりません。この場合も、一貫した命名規則を作成すると有効です。たとえば、EJB 名にアプリケーション名とモジュール名を追加すると、確実に一意な名前になります。この場合、モジュール pkgingEJB.jar 内の EJB の JNDI 名は、アプリケーション pkging.ear にパッケージ化されているため、mycompany.pkging.pkgingEJB.MyEJB になります。
パッケージとファイル名に、スペースや使用しているオペレーティングシステムで不正となる文字が含まれていないことを確認してください。
配備ディレクトリの構造アプリケーションを配備すると、個別のモジュールを持つディレクトリ名には、_jar、_war、_rar などのサフィックスが付きます。EAR ファイルの代わりに、asadmin deploydir コマンドを使用してディレクトリを配備した場合、ディレクトリ構造はこの規則に従っています。
モジュールおよびアプリケーションのディレクトリ構造は、J2EE 仕様書に示されている構造に準拠します。
次に、Web モジュール、EJB モジュール、クライアントモジュールを含む簡単なアプリケーションのディレクトリ構造の一例を示します。
次に、個別に配備したコネクタモジュールのディレクトリ構造の例を示します。
+ MyConnector/
|--- readme.html
|--- ra.jar
|--- client.jar
|--- win.dll
|--- solaris.so
'--+ META-INF/
|--- MANIFEST.MF
|--- ra.xml
'--- sun-ra.xml
実行時環境コンポーネントを個別に配備するモジュールとして配備する場合も、アプリケーションとして配備する場合も、配備は、ファイルシステムやサーバー設定に影響を及ぼします。次に示す図「モジュールの実行時環境」と「アプリケーションの実行時環境」を参照してください。
モジュールの実行時環境
次の図「モジュールの実行時環境」は、モジュールベースで個別に配備した場合の実行時環境です。
図 12-1 モジュールの実行時環境
ファイルシステムのエントリとして、モジュールは次のように抽出されます。
instance_dir/applications/j2ee-modules/module_name
instance_dir/generated/ejb/j2ee-modules/module_name
instance_dir/generated/jsp/j2ee-modules/module_namegenerated/ejb ディレクトリには、スタブとタイがあり、generated/jsp ディレクトリには、コンパイル済みの JSP があります。
ライフサイクルモジュールは、次の手順で抽出されます。
instance_dir/applications/lifecycle-modules/module_name
設定エントリは、server.xml 内に次のように追加されます。
<server>
<applications>
<type-module>
...module configuration...
</type-module>
</applications>
</server>server.xml 内のモジュールの type は、lifecycle、ejb、web、または connector のいずれかになります。server.xml の詳細は、『Sun ONE Application Server 7, Enterprise Edition 管理者用設定ファイルリファレンス』を参照してください。
アプリケーションの実行時環境
次の図「アプリケーションの実行時環境」は、アプリケーションベースで配備した場合の実行時環境を示しています。
図 12-2 アプリケーションの実行時環境
ファイルシステムのエントリとして、アプリケーションは次のように抽出されます。
instance_dir/applications/j2ee-apps/app_name
instance_dir/generated/ejb/j2ee-apps/app_name
instance_dir/generated/jsp/j2ee-apps/app_namegenerated/ejb ディレクトリには、スタブとタイがあり、generated/jsp ディレクトリには、コンパイル済みの JSP があります。
設定エントリは、server.xml 内に次のように追加されます。
<server>
<applications>
<j2ee-application>
...application configuration...
</j2ee-application>
</applications>
</server>server.xml の詳細は、『Sun ONE Application Server 7, Enterprise Edition 管理者用設定ファイルリファレンス』を参照してください。
クラスローダについてSun ONE Application Server 7, Enterprise Edition クラスローダに関する知識は、使用するモジュールやアプリケーションに対し、サポートする JAR ファイルやリソースファイルの位置や目的の決定に、役立つことがあります。
Java 仮想マシン (JVM) のクラスローダは、依存関係の解決に必要な Java クラスファイルを動的に読み込みます。たとえば、java.util.Enumeration のインスタンスを作成する場合は、クラスローダの 1 つが関連するクラスを実行時環境に読み込みます。クラスローダの詳細は、『Sun ONE Application Server 開発者ガイド』を参照してください。
モジュールおよびアプリケーションの配備この節では、J2EE のアプリケーションおよびモジュールを Sun ONE Application Server 7, Enterprise Edition に配備する方法について説明します。この節には、次の項目があります。
配備名とエラー
アプリケーションまたはモジュールを配備すると、一意の名前が server.xml ファイルに作成されます。この名前を変更しないでください。配備時に、サーバーは名前の重複を検出し、一意の名前を持たないアプリケーションまたはモジュールをロードしません。この場合、サーバーログにメッセージが送信されます。詳細は、「命名規則」を参照してください。
配備中にエラーが発生すると、アプリケーションまたはモジュールは配備されません。アプリケーション内のモジュールにエラーが含まれる場合、そのアプリケーション全体が配備されません。
server.xml の詳細は、『Sun ONE Application Server 7, Enterprise Edition 管理者用設定ファイルリファレンス』を参照してください。
配備のライフサイクル
アプリケーションが初めて配備された後、修正、再読み込み、再配備、無効化、再有効化、および配備取り消し (サーバーから削除) されることがあります。この節には、配備のライフサイクルに関連する次の項目があります。
動的配備
サーバーを再起動せずにアプリケーションまたはモジュールを配備、再配備、および配備取り消しすることができます。これを動的配備と呼びます。
動的な配備は、主にサーバーを再起動せずに新しいアプリケーションおよびモジュールを運用環境でオンラインにするために使用されます。ただし、再配備を行うと、再配備中に実行されていたセッションが無効になります。クライアントはセッションを実行し直す必要があります。
配備されたアプリケーションまたはモジュールの無効化
配備されたアプリケーションまたはモジュールをサーバーから削除しないで無効にすることができます。各アプリケーションまたはモジュールは server.xml ファイルに enabled 属性があり、対応するオプションが管理インタフェースにあります。server.xml の詳細は、『Sun ONE Application Server 7, Enterprise Edition 管理者用設定ファイルリファレンス』を参照してください。
動的再読み込み
動的再読み込みを有効にすると、コードを変更したときにアプリケーションまたはモジュールを再配備する必要がありません。必要となるのは、変更したクラスファイルをアプリケーションまたはモジュールの配備ディレクトリにコピーすることだけです。サーバーは、定期的に変更を確認して、アプリケーションを変更に合わせて自動的かつ動的に再配備します。
この機能は、変更したコードをすぐにテストできるため、開発環境で役に立ちます。動的な再読み込みは、パフォーマンスが低下することがあるので運用環境にはお勧めしません。また、再読み込みを行うと、再読み込み中に実行されていたセッションが無効になります。クライアントはセッションを実行し直す必要があります。
動的再読み込みを有効にするには、次のいずれかを行います。
- 管理インタフェースを使用する :
- サーバーインスタンスの下にある「Applications (アプリケーション)」コンポーネントを開きます。
- 「Applications (アプリケーション)」ページに移動します。
- 「Reload Enabled (再読み込みを有効)」ボックスをオンにして動的再読み込みを有効にします。
- 「Reload Poll Interval (再読込のポーリング間隔)」フィールドに秒数を入力して、アプリケーションとモジュールにコードの変更がないか確認して動的に再読み込みする間隔を設定します。
- 「Save (保存)」ボタンをクリックします。
- サーバーインスタンスのページを表示し、「Apply Changes (変更の適用)」ボタンを選択します。
- server.xml ファイルの applications 要素の次の属性を編集します。
さらに、新しいサーブレットファイルの読み込み、変更に関連する EJB の再読み込み、または配備記述子の変更の再読み込みを行うには、次の操作を行う必要があります。
JSP では、sun-web.xml ファイルの jsp-config 要素にある reload-interval プロパティで設定した頻度で、変更が自動的に再読み込みされます。JSP の動的再読み込みを無効にするには、reload-interval="-1" に設定します。
配備ツール
ここでは、モジュールとアプリケーションを配備するときに使用するツールについて説明します。次の配備ツールがあります。
asadmin ユーティリティ
asadmin ユーティリティを使用すると、アプリケーションおよび個別に配備されたモジュールをローカルサーバー上に配備および配備取り消しができます。複数マシンへの同時配備はサポートされていません。ここでは、asadmin ユーティリティについて簡単に解説します。
ライフサイクルモジュールを配備する場合は、「ライフサイクルモジュールの配備」を参照してください。
asadmin deploy
asadmin deploy コマンドを使用すると、WAR、JAR、RAR、または EAR ファイルを配備できます。アプリケーションを配備するには、コマンドに --typeapplication を指定します。個別のモジュールを配備するには、--typeejb、web、または connector を指定します。構文は次のとおりです。オプションパラメータにデフォルト値がある場合は、その値を表示しています。
asadmin deploy --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--virtualservers virtual_servers] [--type application|ejb|web|connector] [--contextroot contextroot] [--force=true] [--precompilejsp=false] [--name component_name] [--upload=true] [--retrieve local_dirpath] [--instance instance_name] filepath
たとえば、次のコマンドは、個別の EJB モジュールを配備します。
asadmin deploy --user jadams --password secret --host localhost --port 4848 --type ejb --instance server1 packagingEJB.jar
asadmin deploydir
asadmin deploydir コマンドを使用すると、オープンディレクトリ構造内のアプリケーションまたはモジュールを配備できます。ディレクトリ構造は、「配備ディレクトリの構造」に指定されているとおりにする必要があります。dirpath の場所が instance_dir/applications/j2ee-apps の下または instance_dir/applications/j2ee-modules の下のどちらにあるかによって、それがアプリケーションか個別に配備されたモジュールかが決まります。構文は次のとおりです。オプションパラメータにデフォルト値がある場合は、その値を表示しています。
asadmin deploydir --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--virtualservers virtual_servers] [--type application|ejb|web|connector] [--contextroot contextroot] [--force=true] [--precompilejsp=false] [--name component_name] [--instance instance_name] dirpath
たとえば、次のコマンドは、個別の EJB モジュールを配備します。
asadmin deploydir --user jadams --password secret --host localhost --port 4848 --type ejb --instance server1 packagingEJB
asadmin undeploy
asadmin undeploy コマンドを使用すると、アプリケーションまたはモジュールを配備取り消しができます。アプリケーションの配備を取り消すには、コマンド内に --typeapp を指定します。個別のモジュールの配備を取り消すには、--typeejb、web、または connector を指定します。構文は次のとおりです。オプションパラメータにデフォルト値がある場合は、その値を表示しています。
asadmin undeploy --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--type application|ejb|web|connector] [--instance instance_name] component_name
たとえば、次のコマンドは、個別の EJB モジュールの配備を取り消します。
asadmin undeploy --user jadams --password secret --host localhost --port 4848 --type ejb --instance server1 packagingEJB
管理インタフェース
管理インタフェースを使用すると、モジュールとアプリケーションをローカルおよびリモートの Sun ONE Application Server 7, Enterprise Edition サイトに配備できます。このツールを使うには、次の手順で行います。
- サーバーインスタンスの下にある「Applications (アプリケーション)」コンポーネントを開きます。
- 「Enterprise Applications (エンタープライズアプリケーション)」、「Web Applications (Web アプリケーション)」、「Connector Modules (コネクタモジュール)」、「EJB Modules (EJB モジュール)」のいずれかのページに移動します。
- 「Deploy (配備)」ボタンをクリックします。
- モジュールまたはアプリケーションへのフルパスを入力し、(または「Browse (ブラウズ)」をクリックして指定)、「OK (了解)」ボタンをクリックします。
- モジュールまたはアプリケーションの名前を入力します。
モジュールまたはアプリケーションがすでに配備されていれば、適切なボックスをチェックして、それを再配備することもできます。これはオプションです。
- 仮想サーバー名の隣のボックスにチェックマークをつけて、1 つまたは複数の仮想サーバーにアプリケーションまたはモジュールを割り当てます。
- 「OK (了解)」ボタンをクリックします。
ライフサイクルモジュールを配備する場合は、「ライフサイクルモジュールの配備」を参照してください。
Sun ONE Studio
J2EE アプリケーションとモジュールの配備には Sun ONE Studio 4 を利用できます。Sun ONE Studio に関する詳細は、『Sun ONE Studio 4, Enterprise Edition のチュートリアル』を参照してください。
注
Sun ONE Studio では、モジュールまたはアプリケーションの配備を「実行」と呼びます。「実行」には、サーバーが稼働していることの確認、およびモジュールまたはアプリケーションをアクティブにする正しい URL の表示も含まれます。
モジュールまたはアプリケーションの配備
アプリケーションまたはアプリケーションから独立した個別のモジュールを配備することができます。アプリケーションベースまたは個別のモジュールベースで配備したときの実行時環境およびファイルシステムについては、「実行時環境」を参照してください。
次のものがコンポーネントにアクセスする場合は、個別のモジュールベースで配備することをお勧めします。
複数のモジュールを 1 つの EAR ファイルに結合すると、1 つのモジュールとして配備できるようになります。これは、EAR のモジュールを個別に配備するのと似ています。
WAR モジュールの配備
WAR モジュールの配備は、「配備ツール」で説明されている方法で行うことができます。
JSP 用の生成されたソースは、-keepgenerated プロパティを sun-web.xml 内の jsp-config 要素に追加することによって保持できます。WAR モジュールを配備するときにこのプロパティを追加すると、生成されたソースが保存されます。保存先は、アプリケーションの場合は instance_dir/generated/jsp/j2ee-apps/app_name/module_name、個別に配備された Web モジュールの場合は instance_dir/generated/jsp/j2ee-modules/module_name です。-keepgenerated プロパティの詳細は、『Sun ONE Application Server 7, Enterprise Edition Web アプリケーション開発者ガイド』を参照してください。
EJB JAR モジュールの配備
EJB JAR モジュールの配備は、「配備ツール」に記載されている方法で行うことができます。
スタブとタイ用の生成されたソースは、-keepgenerated フラグを server.xml 内の java-config 要素の rmic-options 属性に追加することによって保持できます。EJB JAR モジュールを配備するときにこのフラグを追加すると、生成されたソースが保存されます。保存先は、アプリケーションの場合は instance_dir/generated/ejb/j2ee-apps/app_name/module_name、個別に配備された EJB JAR モジュールの場合は instance_dir/generated/ejb/j2ee-modules/module_name です。-keepgenerated フラグの詳細は、『Sun ONE Application Server 7, Enterprise Edition 管理者用設定ファイルリファレンス』を参照してください。
ライフサイクルモジュールの配備
ライフサイクルモジュールに関する一般的な情報については、『Sun ONE Application Server 開発者ガイド』を参照してください。
ライフサイクルモジュールを配備するには、次のツールを使います。
asadmin ユーティリティ
ライフサイクルモジュールを配備するには、asadmin create-lifecycle-module コマンドを使います。構文は次のとおりです。オプションパラメータにデフォルト値がある場合は、その値を表示しています。
asadmin create-lifecycle-module --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--instance instance_name] --classname classname [--classpath classpath] [--loadorder load_order_number] [--failurefatal=false] [--enabled=true] [--description text_description] [--property (name=value)[:name=value]*] modulename
次に例を示します。
asadmin create-lifecycle-module --user jadams --password secret --host localhost --port 4848 --instance server1 --classname RMIServer MyRMIServer
ライフサイクルモジュールの配備を取り消すには、asadmin delete-lifecycle-module コマンドを使います。構文は次のとおりです。オプションパラメータにデフォルト値がある場合は、その値を表示しています。
asadmin delete-lifecycle-module --user admin_user [--password admin_password] [--host localhost] [-port 4848] [--secure | -s] [--instance instance_name] module_name
次に例を示します。
asadmin delete-lifecycle-module --user jadams --password secret --host localhost --port 4848 --instance server1 MyRMIServer
サーバーインスタンス上に配備されたライフサイクルモジュールをリスト表示するときは、asadmin list-lifecycle-modules コマンドを使います。構文は次のとおりです。オプションパラメータにデフォルト値がある場合は、その値を表示しています。
asadmin list-lifecycle-modules --user admin_user [--password admin_password] [--host localhost] [-port 4848] instance_name
次に例を示します。
asadmin list-lifecycle-module --user jadams --password secret --host localhost --port 4848 server1
管理インタフェース
管理インタフェースを使ってライフサイクルモジュールを配備することもできます。次の手順に従います。
- サーバーインスタンスの下にある「Applications (アプリケーション)」コンポーネントを開きます。
- 「Life Cycle Modules (ライフサイクルモジュール)」ページに移動します。
- 「Deploy (配備)」ボタンをクリックします。
- 次の情報を入力します。
- 「Name (名前)」(必須) - ライフサイクルモジュールの名前
- 「Class Name (クラス名)」(必須) - ライフサイクルモジュールのクラスファイルの完全修飾された名前
- 「Classpath (クラスパス)」(オプション) - ライフサイクルモジュールのクラスパス。モジュールの場所を指定する。デフォルトの場所は、アプリケーションのルートディレクトリの下
- 「Load Order (読み込み順序)」(オプション) - 起動時にライフサイクルモジュールが読み込まれる順序を決定する。モジュールに指定された数値が小さいほど、早く読み込まれる。値の範囲は、101 から オペレーティングシステムの MAXINT まで。1 から 100 までの値は予約されている
- 「Failure Fatal (致命的な障害)」(オプション) - ライフサイクルモジュールが失敗した場合にサーバーをシャットダウンするかどうかを決定する。デフォルトは false
- 「Enable (ライフサイクルを有効)」(オプション) - ライフサイクルモジュールを有効にするかどうかを決定する。デフォルトは true
- 「OK (了解)」ボタンをクリックします。
RMI/IIOP クライアントの配備
EJB とやりとりするクライアントの場合のみ、配備が必要です。RMI/IIOP クライアントは、3 つの手順で配備します。
- RMI/IIOP クライアントがアクセスする EAR または EJB JAR を配備します。
- 必要なクライアントファイルをアセンブルし、クライアントを配備します。
- 配備後、クライアント JAR ファイルは、アプリケーション用の次の場所に作成されます。
instance_dir/applications/j2ee-apps/app_name/app_nameClient.jar
または、個別に配備されたモジュール用の次の場所に作成されます。
instance_dir/applications/j2ee-modules/module_name/module_nameClient.jar
クライアント JAR には、RMI/IIOP クライアント用のタイおよび必要なクラスが含まれています。このファイルをクライアントマシンにコピーし、クライアント上の APPCPATH 環境変数がこの JAR を示すように設定します。
これで、クライアントを実行する準備ができました。詳細は、『Sun ONE Application Server 7, Enterprise Edition Developer's Guide to Clients』を参照してください。
J2EE CA リソースアダプタの配備
コネクタモジュールの配備は、「配備ツール」で説明されている方法で行うことができます。
静的コンテンツの配備
静的コンテンツ (HTML、画像など) は、Web サーバー上および Sun ONE Application Server 7, Enterprise Edition 上で管理できます。ただし、WAR が登録されているときは、静的コンテンツはアプリケーションサーバーに配備されます。Sun ONE Application Server 7, Enterprise Edition に同梱されているすべてのサンプルでは、静的なコンテンツを、アプリケーションサーバー側に格納します。
たとえば、アプリケーションサーバー上の静的ファイル index.html にアクセスするには、次のパスを使います。
http://server:port/tcontext_root/index.html
共有フレームワークへのアクセス
J2EE のアプリケーションとモジュールで共有フレームワーククラス (コンポーネント、ライブラリなど) を使用する場合、それらのクラスはアプリケーションやモジュールではなくシステムクラスローダまたは共有クラスローダのパスに配備できます。サイズが大きい共有ライブラリを、そのライブラリを使用するすべてのモジュールにアセンブルする場合、サーバーへの登録に多くの時間がかかります。また、同一クラスの複数のインスタンスが独自のクラスローダを使用すると、リソースの浪費になります。
システムクラスローダについては、「クラスローダについて」を参照してください。
アプリケーション配備記述子ファイルSun ONE Application Server 7, Enterprise Edition には、次の 2 種類の配備記述子ファイルがあります。
アプリケーション配備記述子ファイルの詳細は、『Sun ONE Application Server 開発者ガイド』を参照してください。
