geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Geronimo Wiki] Update of "Building" by AnitaKulshreshtha
Date Fri, 23 Dec 2005 16:56:13 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Geronimo Wiki" for change notification.

The following page has been changed by AnitaKulshreshtha:
http://wiki.apache.org/geronimo/Building

------------------------------------------------------------------------------
  
  = For the impatient ... =
  
- ... who wants to work on a fresh checkout of all major geronimo-related projects in one
maven build environment.
+ ... who want to work on a fresh checkout of all major geronimo-related projects in one maven
build environment.
  
   {{{
  NOTE: OpenEJB's CORBA layer uses some classes that belong to sun.com.* package of Java 1.4.
Because of this it's not yet possible to build OpenEJB and thus use the steps described in
this section with Java 5.
@@ -32, +32 @@

  $ svn checkout http://svn.apache.org/repos/asf/geronimo/trunk geronimo
  $ cd geronimo
  $ maven m:fresh-checkout
+   [ BE CAREFUL: Deletes checkout of OpenEJB and checks it out again and updates Geronimo
-   [ BECAREFUL: Deletes checkout of OpenEJB, and TranQL 
-                and checks them out again and updates Geronimo
    ]
- $ maven m:rebuild-all
+ $ maven
    [ Same as m:clean m:clean-repo m:default 
      and it includes geronimo-spec modules
    ]
  }}}
- 
+      This builds '''j2ee-jetty-server''' and '''j2ee-tomcat-server''' in `assemblies/j2ee-jetty-server`
and `assemblies/j2ee-tomcat-server` directory respectively.
- Build next time with: 
+ Build the second time with: 
      {{{
  $ maven m:update 
-   [ updates OpenEJB and TranQL
+   [ updates OpenEJB
    ]
  $ maven m:rebuild -o
-   [ Deletes all targets and the tests are run again.
+   [ Deletes all targets and runs tests again.
    ]
  }}}
  
- The "m:update" gets new code from cvs/svn, and the "m:rebuild" rebuilds.  The "-o" flag
tells Maven to build offline, which is much faster than the default online process.  Occasionally,
though, the offline build might fail if some dependency goes out of date; in that case you'll
want to run `maven m:rebuild` without the "-o" flag (cf. the section "Building geronimo and
related projects" on this page for further cures to build failures: `-Dmaven.test.skip=true`
and/or `-Dmaven.itest.skip=true`).  
+ The "m:update" gets new code from cvs/svn, and the "m:rebuild" rebuilds.  The "-o" flag
tells Maven to build offline, which is much faster than the default online process.  Occasionally,
though, the offline build might fail if some dependency goes out of date; in that case you'll
want to run `maven m:rebuild` without the "-o" flag. See [http://wiki.apache.org/geronimo/Building#head-fbeacda90e0376260d2c28af9c0f41ebae58953b
"Building geronimo and related projects] on this page for further cures to build failures:
`-Dmaven.test.skip=true` and/or `-Dmaven.itest.skip=true`).  
  
- Run server with the debug console web application:  
+ Run the server with the debug console web application:  
      {{{
- $ java -jar modules/assembly/target/geronimo-1.0-SNAPSHOT/bin/server.jar org/apache/geronimo/DebugConsole
+ $ cd assemblies/j2ee-jetty-server/target/geronimo-1.0-SNAPSHOT
+                     OR 
+ $ cd assemblies/j2ee-tomcat-server/target/geronimo-1.0-SNAPSHOT
+ 
+ $ java -jar bin/server.jar
  
  }}}
  (Please also check http://wiki.apache.org/geronimo/Running)
@@ -88, +91 @@

  
  Edit project.properties and set the cvs info appropriately for any project you may be a
committer on.
  
- run `maven m:checkout` to get OpenEJB, and TranQL from cvs.
+ run `maven m:checkout` to get OpenEJB from cvs.
  
  run `maven m:build` or just `maven` to build everything.  There may be test failures in
other projects, so you may need `-Dmaven.test.failure.ignore=true`.  You might need to run
twice to make sure all plugins are installed before they are used.
  
@@ -98, +101 @@

  
  To remove the local maven repository artifacts of Geronimo, OpenEJB, and TranQL, do `maven
m:clean-repo` -- and build again.  
  
- Once the build successfully completes, the assembled server will be available in the target
directory of the assembly module (on unix `geronimo/modules/assembly/target/distributions/geronimo-1.0-SNAPSHOT.zip`).
+ Once the build successfully completes, the assembled server will be available in the target
directories, i.e. `geronimo/assemblies/j2ee-jetty-server/target/geronimo-1.0-SNAPSHOT` and
`assemblies/j2ee-tomcat-server/target/geronimo-1.0-SNAPSHOT`
+ 
+ In some cases synchronized changes are made to several of the 
+ projects at once, and you may have trouble building the HEAD code 
+ of Geronimo against the older binaries of OpenEJB.  
+ In that case, you can run:
+ 1. To checkout OpenEJB
+      {{{
+ 	$ maven m:co
+ 	$ maven m:rebuild-all
+      }}}
+ 
+ The first command checks out the latest OpenEJB code,
+ while the second cleans and previous build output and rebuilds
+ Geronimo, OpenEJB from scratch. You can stop the build when you get to the
+ assembly module, and certainly when you get to itests.
+ 2. build the plugins explicitly:
+     {{{
+       $ cd plugins
+       $ maven -o multiproject:install
+       $ cd ..
+     }}}
+ 3. build the configs:
+     {{{
+       $ cd configs
+       $ maven -o multiproject:install
+       $ cd ..
+     }}}
+       This step uses the packaging plugin to build all the
+ configurations we need for both jetty and tomcat servers, and installs
+ them in your local maven repo as .car files.
+ 4. build the servers:
+     {{{
+       $ cd assemblies/j2ee-jetty-server
+                 OR 
+       $ cd assemblies/j2ee-tomcat-server
+ 
+       $ maven -o clean default
+     }}}
+ Warning:
+ The configIds of these configurations are incompatible with the configIds used by the previous
assembly.  If you deploy anything on these servers and you specify a parentId or an import
you will have to modify them.
+ 
  
  = Building Offline =
  
  If you're not online (so Maven fails to download), use the -o flag to maven (i.e. run `maven
-o`). 
+ 
  
  = Build Just One Module =
  

Mime
View raw message