Date: 2004-02-25T00:35:07
Editor: 208.42.65.236 <>
Wiki: Apache Geronimo Wiki
Page: BuildingAndRunning
URL: http://wiki.apache.org/geronimo/BuildingAndRunning
no comment
Change Log:
------------------------------------------------------------------------------
@@ -18,7 +18,12 @@
$ cd incubator-geronimo
$ cvs -qz3 update -dP
$ maven
-$ maven run:server
+$ 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.
@@ -42,8 +47,6 @@
= General Advice =
-On Jan 21, 2004, we tagged the fairly stable current version and commenced
rewriting the deployment structure. Until this process is complete, you may
wish to experiment with the tagged version by checking out the
last_geronimombean branch. You may wish to check on the IRC channel and
mailing list to see how far the rewrite has proceeded.
-
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.
@@ -81,21 +84,27 @@
= Running The Server =
== For HEAD revision: ==
-(Feb 12, 2004) Deployment is still changing but hopefully is a little less
fraught than it has been for the last couple of weeks. There is a now a
standalone deployer (bin/deploy.jar) that is a front-end to a GBean based
deployment system. Currently there is a GBean deployer but work is going on to
move the WAR and RAR deployers over.
Configurations are pre-built for the Geronimo server.
-||Config ID||Purpose||
-||org/apache/geronimo/System||Critical services for all server configurations||
-||org/apache/geronimo/Server||Normal server configuration||
+||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 config-store org/apache/geronimo/System
org/apache/geronimo/Server
+$ 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 equivilent; a proper shutdown command will
be made available when the deployment includes the remoting framework.
+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.
@@ -106,22 +115,18 @@
You can find the schema files in ${geronimo.base.dir}/schema
-To deploy a new configuation use the `deploy.jar` command:
+To deploy a new configuration use the `deploy.jar` command:
{{{
$ cd target
-$ java -jar bin/deploy.jar --install --plan <your-plan>.xml --store
config-store --deployer org/apache/geronimo/ServiceDeployer
+$ java -jar bin/deploy.jar --install --plan <your-plan>.xml
}}}
-The need to define the store and deployer will be removed soon when the WAR
and RAR deployers have been converted. You should also only run this with the
server stopped - online deployment will be available soon when default
deployment includes the remoting layer.
-
-== For the legacy last_geronimombean tagged copy: ==
-Once you've downloaded the source code, installed Maven and built the server,
type `maven run:main` to run the server.
-As of December, 2003, there is no way to stop the server other than killing
it, control-C or other such means.
-
+You should only run this with the server stopped - online deployment will be
available soon when default deployment includes the remoting layer.
-= Accessing The Geronimo-Web-Console =
+= Accessing The Debug Console =
-Enter http://localhost:8080/geronimo-web-console to access the JMX Debug
Application.
+The debug console is only available when running the
org/apache/geronimo/DebugConsole configuration.
+Enter http://localhost:8080/debug-console in to you browser to access the JMX
Debug Application.
= Cleaning your workspace =
