geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From geronimo-...@incubator.apache.org
Subject [Apache Geronimo Wiki] Updated: BuildingAndRunning
Date Wed, 28 Apr 2004 22:29:04 GMT
   Date: 2004-04-28T15:29:04
   Editor: 208.42.65.236 <>
   Wiki: Apache Geronimo Wiki
   Page: BuildingAndRunning
   URL: http://wiki.apache.org/geronimo/BuildingAndRunning

   no comment

Change Log:

------------------------------------------------------------------------------
@@ -1,134 +1 @@
-This page exists to collect details of problems (and their solutions) in building or running
a fresh copy of Geronimo. This is an add-on to the geronimo distribution file README.txt.
The intention is that it will be the first port of call when such issues arise, and that developers
will update it as problems/solutions are found. Hopefully it will become less necessary as
Geronimo nears a formal release process ;-)
-
-First start with :
- * the default build process available in the Geronimo distribution file README.txt 
- * a list of KnownWorkingConfigurations
-
-'''Contents'''
-[[TableOfContents]]
-
-
-----
-
-= For the impatient ... =
-
-Assuming you have Maven 1.0-RC1 (note that the build doesn't complete with Maven 1.0-rc2)
installed.
-    {{{
-$ cvs -qz3 -d:pserver:anoncvs@cvs.apache.org:/home/cvspublic co incubator-geronimo
-$ cd incubator-geronimo
-$ cvs -qz3 update -dP
-$ maven
-$ java -jar target/bin/server.jar org/apache/geronimo/Server
-}}}
-
-To run server with the debug console web application 
-    {{{
-$ java -jar target/bin/server.jar org/apache/geronimo/DebugConsole
-}}}
-
-You should check back here occasionally as things may well change.
-
-----
-
-= New To Maven? =
-
-You don't build this project with Ant (directly), you build it with Maven.  Maven manages
downloading all the external dependencies for you, as well as handling the large number of
modules to build and then creating one consolidated Geronimo build based on that.
-
-To start with, download maven from http://maven.apache.org/ then install it and put its bin
directory on your path (or put a script to run it on your path or whatever).
-
-Now to build (and test) Geronimo, go to the geronimo directory you checked out of CVS and
run `maven` (you must be online at the time, so Maven can download all the dependencies of
Geronimo).
-
-There are a variety of parameters and options you can pass to maven to affect how it builds.
 Some are listed in the topics below.  If you run `maven -g` you will get a huge list of options,
separated into categories.  To use one, run "maven category:command", so to run the "compile"
command in the "java" category, you'd run `maven java:compile` (and you can also add multiple
commands to the command line).
-
-If you have common options you always want to pass to maven, you can put them in a file called
`build.properties` either in the directory you run maven from (to affect only that project)
or your home directory (to affect everything you run maven for).  See http://maven.apache.org/reference/user-guide.html#Behavioural%20Properties
and http://maven.apache.org/apidocs/constant-values.html for some common property names.
-
-For further reference on the available commands it may be a good idea to change into a subdirectory
of incubator-geronimo/modules and have a look at the respective maven.xml files.
-
-----
-
-= General Advice =
-
-If having problems building Geronimo, make sure it isn't simply because your Maven repository
has become 'corrupted' or out of sync:
-
-Delete (or temporarily rename) the .maven directory in your home directory and try building
Geronimo again.
-
-(Under UNIX this is typically in /home/yourusername whilst under Windows this is typically
in C:\Documents and Settings\yourusername)
-
-Running the command `maven site` seems to take up a lot of memory.  If you get an out of
memory error, try setting MAVEN_OPTS=-Xmx512m.
-
-= Building Offline =
-
-If you're not online (so Maven fails to download), use the -o flag to maven (i.e. run `maven
-o`). 
-
-= Bypassing Tests =
-
-If you don't want to run test at all, try adding `-Dmaven.test.skip=true` to your maven command
line.
-
-If you want to run all the tests but not stop if there's a failure, try adding `-Dmaven.test.failure.ignore=true`
to your maven command line.
-
-= Remoting Tests Hang =
-
-Make sure the host name of your machine (myworkstation.mydomain.com or whatever) is resolvable
in DNS.  Worst case, add it to the 127.0.0.1 line in `/etc/hosts` or `c:\windows\system32\drivers\etc\hosts`
-
-If you use a windows system,try upgrading the JDK to the latest version. There are few bugs
in older versions of JDK 1.4, which causes the infinite wait while a server is being closed.
-
-= Build Just One Module =
-
-cd to the directory holding the module (i.e. modules/core) and run `maven` from there.
-
-Alternately, set the "modules" system property to the name of the directory under "modules"
or "specs" that you want to affect.  For example, {{{maven -Dmodules=core}}} (for modules/core)
or `maven -Dmodules=j2ee-deployment` (for specs/j2ee-deployment)
-
-= Compile Only =
-
-Try `maven java:compile test:compile` or some variation thereof.
-
-= Running The Server =
-
-Configurations are pre-built for the Geronimo server.
-
-    ||Config ID||Purpose||Parent Configuration||
-    ||org/apache/geronimo/System||Critical services for all server configurations||-none-||
-    ||org/apache/geronimo/Server||Normal server configuration||org/apache/geronimo/System||
-    ||org/apache/geronimo/DebugConsole||Debug console web application||org/apache/geronimo/Server||
-
-To run use the `server.jar` command:
-    {{{
-$ cd target
-$ java -jar bin/server.jar org/apache/geronimo/Server
-}}}
-
-The `server.jar` command starts the specified configuration and all parent configurations,
so the following command will start System, Server, and DebugConsole:
-    {{{
-$ cd target
-$ java -jar bin/server.jar org/apache/geronimo/DebugConsole
-}}}
-
-To stop the server use ctrl-C or an equivalent; a proper shutdown command will be made available
when the deployment includes the remoting framework.
-
-You can also start the server using "maven run:server" or "maven debug:server", but startup
using maven disables the ctrl-C proper shutdown.
-
-= Deployment =
-
-The deployer uses a XML deployment plan to figure out what to do. Ultimately this will be
produced by a JSR-88 tool but for now an XML aware text editor is the best choice. The deployer
uses the namespace of this file to select an appropriate builder.
-
-    ||Namespace||Schema file||Root Element||Type||
-    ||http://geronimo.apache.org/xml/ns/deployment||geronimo-config.xsd||configuration||GBean
configuration||
-
-You can find the schema files in ${geronimo.base.dir}/schema
-
-To deploy a new configuration use the `deployer.jar` command:
-    {{{
-$ cd target
-$ java -jar bin/deployer.jar --install --plan <your-plan>.xml
-}}}
-
-You should only run this with the server stopped - online deployment will be available soon
when default deployment includes the remoting layer.
-
-= Accessing The Debug Console =
-
-The debug console is only available when running the `org/apache/geronimo/DebugConsole` configuration.
-Enter http://localhost:8080/debug-tool/ in to you browser to access the JMX Debug Application.
 
-
-= Cleaning your workspace =
-
-To clean your workspace, type `maven clean`.
+See [wiki:Building Building] or [wiki:Running Running]

Mime
View raw message