Class: atg.appassembly.ant.CreateUnpackedEarTask
Description
This Ant task invokes the application assembler, which combines Oracle Commerce Platform libraries, Nucleus component configuration, J2EE applications, and J2EE application components to create a single J2EE application, in the form of an unpacked (open-directory) EAR file.
Required Task Parameters
Attribute | Description |
---|---|
| Specifies the path of the EAR file to be created. |
| Specifies the Oracle Commerce Platform modules to include in the EAR file, as a comma-delimited string. |
| Specifies the path to the Oracle Commerce Platform installation directory. |
Optional Task Parameters
Attribute | Description |
---|---|
| Specifies an existing EAR file whose contents are added to the assembled EAR file. |
| If The default is |
| Specifies a Java properties file to be used to override the context-root values for any web applications included in the assembled EAR file. In this properties file, each line has the format:
This assigns the specified context root to the web application indicated by the module URI. |
| Specifies the value to be used for the |
| Specifies the X Window System variable declaring where any X display should be sent. For example, |
| Specifies a file that supplies Oracle Commerce Platform environment properties to be added to |
| If The default is |
| Enables one or more Named Configuration layers for the application. This switch can take multiple arguments, each representing a named configuration layer. This option must immediately precede the |
| If The default is |
| If The default is |
| Includes the comma separated list of jar files on the class path. This attribute is useful for applying hot fixes. For example:
Note: Special characters appearing in jar file names can cause that file to be ignored. When naming files, it is best to use only alphanumeric characters and the underscore. |
| If set, specifies the Oracle Commerce Platform server (for |
| If The default is |
Example
To use CreateUnpackedEarTask
in an Ant build file, you must first declare it, using the taskdef
element:
<taskdef name="assemble-jar"
classname="atg.appassembly.ant.CreateUnpackedEarTask"
classpath="C:/ATG/ATG11.1/home/lib/assembler.jar">
You can then create a target that assembles an Oracle Commerce Platform application EAR file:
<target name="create-quincy-ear"> <-- It's a good idea to delete any old directories before assembling... --> <delete dir="QuincyFundsEar"/> <assemble-jar dynamoRoot="c:/ATG/ATG11.1" dynamoModules="DSSJ2EEDemo,DafEar.Admin" destinationFile="QuincyFundsEar" overwrite="true" /> </target>