Return-Path: Delivered-To: apmail-geronimo-scm-archive@www.apache.org Received: (qmail 91219 invoked from network); 1 Oct 2004 15:38:53 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 1 Oct 2004 15:38:53 -0000 Received: (qmail 57478 invoked by uid 500); 1 Oct 2004 15:36:08 -0000 Delivered-To: apmail-geronimo-scm-archive@geronimo.apache.org Received: (qmail 57310 invoked by uid 500); 1 Oct 2004 15:36:05 -0000 Mailing-List: contact scm-help@geronimo.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: dev@geronimo.apache.org Delivered-To: mailing list scm@geronimo.apache.org Delivered-To: moderator for scm@geronimo.apache.org Received: (qmail 42706 invoked by uid 99); 1 Oct 2004 15:30:44 -0000 X-ASF-Spam-Status: No, hits=-10.0 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Content-Type: text/plain; charset="iso-8859-1" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: scm@geronimo.apache.org To: scm@geronimo.apache.org Subject: =?iso-8859-1?q?=5BApache_Geronimo_Wiki=5D_Updated=3A__Deployment?= Date: Fri, 01 Oct 2004 15:30:26 -0000 Message-ID: <20041001153026.85228.95360@minotaur.apache.org> X-Spam-Rating: localhost.hyperreal.org 1.6.2 0/1000/N X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Date: 2004-10-01T08:30:26 Editor: TobyCabot 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]] = -=3D Deployment From Maven =3D +=3D Deployment =3D = -The preferred deployment method for a project built with maven is to use t= he geronimo maven deployment plugin to install an application specific copy= of geronimo and deploy one or more modules to it. More extensive instruct= ions are on the [wiki:Running Running] page. + =3D=3D Deployment From Maven =3D=3D = -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 d= escriptor or external to the module and located by an additional parameter = to the deploy command. Again, this is discussed in more detail on the [wik= i:Running Running] page. Additional aspects of each deployment plan are di= scussed below. + The preferred deployment method for a project built with maven is to use= the geronimo maven deployment plugin to install an application specific co= py of geronimo and deploy one or more modules to it. More extensive instru= ctions are on the [wiki:Running Running] page. = -=3D Deployment Without Maven =3D + Generally, a geronimo deployment plan is advisable. A simple default pl= an can be generated for all module types except resource adapters. The pla= n can either be included in the module next to the spec-required deployment= descriptor or external to the module and located by an additional paramete= r to the deploy command. Again, this is discussed in more detail on the [w= iki:Running Running] page. Additional aspects of each deployment plan are = discussed below. = -The Geronimo deployment tool is packaged in the executable jar `bin/deploy= er.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 pr= oduced by a JSR-88 tool but for now an XML aware text editor is the best ch= oice. + =3D=3D Deployment From the Command Line =3D=3D = -'''NOTE:''' You should only run the deploy tool with the server stopped - = online deployment will be available soon when default deployment includes t= he remoting layer. + The Geronimo deployment tool is packaged in the executable jar `bin/depl= oyer.jar`. The deployer uses a XML deployment plan to figure out what to d= o 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. + + =3D=3D Deployment from Ant =3D=3D + + Here's an example fragment from an Ant `build.xml` file: + {{{ + + + + + +}}} = =3D=3D General Configuration =3D=3D = @@ -45,27 +58,16 @@ = These two equivalent declarations, add a dependency on junit-3.8.jar. W= hen Geronimo starts this configuration it will search its own repository (n= ot the maven repository) for the specified file and will add it to the clas= s path of the configuration. = - =3D=3D Deployment from Ant =3D=3D - - Here's an example fragment from an Ant `build.xml` file: - {{{ - - - - - -}}} - =3D J2EE Application (.ear file) =3D = =3D=3D Configuration =3D=3D = - You need to add a `geronimo-application.xml` file to your .ear file. He= re's an example: + If you're using the M2 snapshot or an older version you must add a `gero= nimo-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: = {{{ }}} = @@ -79,7 +81,7 @@ = Once the deployment completes, you can start your configuration by execu= ting the following command from the Geronimo home directory: {{{ -java -jar bin/server.jar ApplicationExample = +java -jar bin/server.jar YourApplication = }}} = =3D Web Application =3D