Apache Geronimo

As you may have guessed by now, this is the default home page for Geronimo. If you're seeing this page, and you don't think you should be, then either you're a user who has arrived at new installation of Geronimo, or you're an administrator who hasn't got his/her setup quite right. If you need help setting up or administering Geronimo, see the Geronimo Documentation.

If you'd like to get started configuring Geronimo and the applications and services available in Geronimo, you might want to start with the Geronimo Admin Console (if you have not yet configured this the admin username is "system" with password "manager").

Would you like your application to appear at this URL?
To set the context root for a web application, you can write a Geronimo deployment plan that uses the context-root element to specify the URL prefix used to reach that application. If you specify a context root of "/" then the application will appear at this URL. However, you'll need to stop this small Welcome application first!

Your web deployment plan should look like this, and you can either pack it into the WAR at WEB-INF/geronimo-web.xml or provide it as a separate argument to the deploy tool.

<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1">
    <environment>
        <moduleId>
            <artifactId>MyApplication</artifactId>
        </moduleId>
    </environment>
    <context-root>/</context-root>
</web-app>

Then you can stop this application and deploy yours from the Admin Console or from the command line with a sequence of commands like this:

<% boolean jetty = application.getServerInfo().toLowerCase().indexOf("jetty") > -1; %>

java -jar bin/deployer.jar stop welcome-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>
java -jar bin/deployer.jar deploy MyWebApp.war

Would you like a slimmer Geronimo installation?
Geronimo ships with a number of sample applications and demonstration services running. The table below lists the default configurations and whether they're required or optional for a J2EE application server configuration.

Optional configurations can be disabled from the Admin Console or by running a command like this:

java -jar bin/deployer.jar stop configuration-name

Name	Comments
Application EARs (list)
geronimo/daytrader-derby-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Optional; day trader sample application
geronimo/uddi-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Optional; JAXR/UDDI repository
geronimo/webconsole-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Recommended; Web management console
Web Application WARs (list)
geronimo/jmxdebug-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Optional; JMX debugging web application
geronimo/jsp-examples-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Optional; JSP examples
geronimo/ldap-demo-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Optional; Directions and tests for sample LDAP security realm
geronimo/remote-deploy-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Recommended; support for running deployment commands from a remote machine
geronimo/servlets-examples-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Optional; Servlet examples
geronimo/welcome-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>/1.0/car	Optional; this welcome site
J2EE Connector RARs (list)
geronimo/activemq/1.0/car	Required; Standard ActiveMQ configuration and connection factories
geronimo/system-database/1.0/car	Required; Embedded Derby database supporting key system functions
Application Client JARs (list)
geronimo/daytrader-derby-<% if(jetty) {%>jetty<%} else {%>tomcat<%}%>-streamer-client/1.0/car	Optional; Client for daytrader sample application
System Modules (list)
geronimo/directory/1.0/car	Optional; Embedded Apache Directory LDAP server
geronimo/ldap-realm/1.0/car	Optional; Sample security realm using embedded LDAP server
geronimo/hot-deployer/1.0/car	Recommended; Supports hot deployment for
geronimo/j2ee-corba/1.0/car	Optional; Support for code in Geronimo acting as a CORBA client or server
geronimo/javamail/1.0/car	Optional; Supports JavaMail resources
Other System Modules	Do Not Change; The other system configurations that are running should not be stopped, and the other system configurations that are not running should not be started.