配備計画の使用

この機能は高度な開発者を対象としています。

配備計画は、Application Server に固有の配備記述子だけを含む JAR ファイルです。このような配備記述子、たとえば sun-application.xml などについては、『Application Server 開発者ガイド』で説明されています。配備計画は、JSR 88: J2EE Application Deploymentの実装の一部です。配備計画を使用して、Application Server に固有の配備記述子を含まないアプリケーションやモジュールを配備します。

配備計画を使用して配備を行うには、asadmin deploy コマンドの --deploymentplan オプションを指定します。たとえば、次のコマンドは、mydeployplan.jar ファイルによって指定される計画に従って、myrosterapp.ear ファイルのエンタープライズアプリケーションを配備します。

$ asadmin deploy --user admin ---deploymentplan mydeployplan.jar myrosterapp.ear

エンタープライズアプリケーション (EAR) の配備計画ファイルでは、sun-application.xml ファイルがルートに置かれています。各モジュールの配備記述子は、構文 module-name.sun-dd-name に従って格納されています。sun-dd-name は、モジュールタイプによって異なります。モジュールに CMP マッピングファイルが含まれる場合、ファイルは module-name.sun-cmp-mappings.xml という名前になります。.dbschema ファイルはルートレベルに格納されていて、スラッシュ (/) はシャープ記号 (#) に置き換えられます。次のリストは、エンタープライズアプリケーション (EAR) の配備計画ファイルの構造を示しています。

$ jar -tvf mydeployplan.jar
420 Thu Mar 13 15:37:48 PST 2003 sun-application.xml
370 Thu Mar 13 15:37:48 PST 2003 RosterClient.war.sun-web.xml
418 Thu Mar 13 15:37:48 PST 2003 roster-ac.jar.sun-application-client.xml
1281 Thu Mar 13 15:37:48 PST 2003 roster-ejb.jar.sun-ejb-jar.xml
2317 Thu Mar 13 15:37:48 PST 2003 team-ejb.jar.sun-ejb-jar.xml
3432 Thu Mar 13 15:37:48 PST 2003 team-ejb.jar.sun-cmp-mappings.xml
84805 Thu Mar 13 15:37:48 PST 2003 team-ejb.jar.RosterSchema.dbschema

Web アプリケーションまたはモジュールファイルの配備計画では、Application Server に固有の配備記述子がルートレベルにあります。スタンドアロンの EJB モジュールに CMP Bean が含まれる場合、配備計画には、ルートレベルの sun-cmp-mappings.xml ファイルや .dbschema ファイルが含まれます。次のリストでは、配備計画が CMP bean を示しています。

$ jar r -tvf myotherplan.jar
3603 Thu Mar 13 15:24:20 PST 2003 sun-ejb-jar.xml
3432 Thu Mar 13 15:24:20 PST 2003 sun-cmp-mappings.xml
84805 Thu Mar 13 15:24:20 PST 2003 RosterSchema.dbschema