This feature is for advanced developers.
A deployment plan is a JAR file that contains only the deployment descriptors that are specific to the Sun Java System Application Server. These deployment descriptors, for example sun-application.xml
, are described in the Sun Java System Application Server Developer’s Guide. The deployment plan is part of the implementation of JSR 88: J2EE Application Deployment. Use a deployment plan when you want to deploy an application or module that does not contain the deployment descriptors that are specific to the Sun Java System Application Server.
To deploy using a deployment plan, specify the --deploymentplan
option of the asadmin
deploy
command. The following command, for example, deploys the enterprise application in the myrosterapp.ear
file according to the plan specified by the mydeployplan.jar
file.
$ asadmin deploy --user admin ---deploymentplan mydeployplan.jar
myrosterapp.ear
In the deployment plan file for an enterprise application (EAR), the sun-application.xml
file is located at the root. The deployment descriptor for each module is stored according to this syntax: module-name.sun-dd-name, where the sun-dd-name depends on the module type. If a module contains a CMP mappings file, the file is named module-name.sun-cmp-mappings.xml
. A .dbschema
file is stored at the root level with each forward slash character (/) replaced by a pound sign (#). The following listing shows the structure of the deployment plan file for an enterprise application (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
In the deployment plan for a web application or a module file, the deployment descriptor that is specific to the Sun Java System Application Server is at the root level. If a stand-alone EJB module contains a CMP bean, the deployment plan includes the sun-cmp-mappings.xml
and .dbschema
files at the root level. In the following listing, the deployment plan describes a 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