You are viewing a plain text version of this content. The canonical link for it is here.
Posted to scm@geronimo.apache.org by sc...@geronimo.apache.org on 2004/10/01 17:30:26 UTC
[Apache Geronimo Wiki] Updated: Deployment
Date: 2004-10-01T08:30:26
Editor: TobyCabot <to...@caboteria.org>
Wiki: Apache Geronimo Wiki
Page: Deployment
URL: http://wiki.apache.org/geronimo/Deployment
indicated that geronimo-application.xml is optional
Change Log:
------------------------------------------------------------------------------
@@ -1,17 +1,30 @@
'''Contents'''
[[TableOfContents]]
-= Deployment From Maven =
+= Deployment =
-The preferred deployment method for a project built with maven is to use the geronimo maven deployment plugin to install an application specific copy of geronimo and deploy one or more modules to it. More extensive instructions are on the [wiki:Running Running] page.
+ == Deployment From Maven ==
-Generally, a geronimo deployment plan is advisable. A simple default plan can be generated for all module types except resource adapters. The plan can either be included in the module next to the spec-required deployment descriptor or external to the module and located by an additional parameter to the deploy command. Again, this is discussed in more detail on the [wiki:Running Running] page. Additional aspects of each deployment plan are discussed below.
+ The preferred deployment method for a project built with maven is to use the geronimo maven deployment plugin to install an application specific copy of geronimo and deploy one or more modules to it. More extensive instructions are on the [wiki:Running Running] page.
-= Deployment Without Maven =
+ Generally, a geronimo deployment plan is advisable. A simple default plan can be generated for all module types except resource adapters. The plan can either be included in the module next to the spec-required deployment descriptor or external to the module and located by an additional parameter to the deploy command. Again, this is discussed in more detail on the [wiki:Running Running] page. Additional aspects of each deployment plan are discussed below.
-The Geronimo deployment tool is packaged in the executable jar `bin/deployer.jar`. The deployer uses a XML deployment plan to figure out what to do and this xml file determined by the module type. Ultimately this will be produced by a JSR-88 tool but for now an XML aware text editor is the best choice.
+ == Deployment From the Command Line ==
-'''NOTE:''' You should only run the deploy tool with the server stopped - online deployment will be available soon when default deployment includes the remoting layer.
+ The Geronimo deployment tool is packaged in the executable jar `bin/deployer.jar`. The deployer uses a XML deployment plan to figure out what to do and this xml file determined by the module type. Ultimately this will be produced by a JSR-88 tool but for now an XML aware text editor is the best choice.
+
+ '''NOTE:''' You should only run the deploy tool with the server stopped - online deployment will be available soon when default deployment includes the remoting layer.
+
+ == Deployment from Ant ==
+
+ Here's an example fragment from an Ant `build.xml` file:
+ {{{
+ <target name="deploy" description="Deploy the application into Geronimo">
+ <java jar="path/to/deployer.jar" fork="true">
+ <arg line="--install --module YourApplication.ear" />
+ </java>
+ </target>
+}}}
== General Configuration ==
@@ -45,27 +58,16 @@
These two equivalent declarations, add a dependency on junit-3.8.jar. When Geronimo starts this configuration it will search its own repository (not the maven repository) for the specified file and will add it to the class path of the configuration.
- == Deployment from Ant ==
-
- Here's an example fragment from an Ant `build.xml` file:
- {{{
- <target name="deploy" description="Deploy the application into Geronimo">
- <java jar="path/to/deployer.jar" fork="true">
- <arg line="--install --module YourApplication.ear" />
- </java>
- </target>
-}}}
-
= J2EE Application (.ear file) =
== Configuration ==
- You need to add a `geronimo-application.xml` file to your .ear file. Here's an example:
+ If you're using the M2 snapshot or an older version you must add a `geronimo-application.xml` file to your .ear file. If you're using recent (post September 2004) CVS versions of Geronimo then this is optional. Here's an example:
{{{
<?xml version="1.0" ?>
<application xmlns="http://geronimo.apache.org/xml/ns/j2ee/application"
- configId="ApplicationExample"
+ configId="YourApplication"
parentId="org/apache/geronimo/Server" />
}}}
@@ -79,7 +81,7 @@
Once the deployment completes, you can start your configuration by executing the following command from the Geronimo home directory:
{{{
-java -jar bin/server.jar ApplicationExample
+java -jar bin/server.jar YourApplication
}}}
= Web Application =