Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Although this installation path is the fastest one, still you will need to install some software before installing Geronimo.

...

Java SE 5

Apache Geronimo v2.1 is Java EE 5 Certified using the Sun 1.5.0 JDK. Refer to the following URL for details on how to download and install J2SE 1.5the latest Java SE 5 JRE or JDK (only required for wsgen tools):
http://java.sun.com

Info

Notes on other Java levels -

  • It is possible to run the Apache Geronimo v2.1 server on Sun Java SE 6, but we have not and do not plan on certifying the server on that level of Java until the v2.2 release.
  • It is possible to run Apache Geronimo v2.1 on the IBM 1.5.0/1.6.0 SDK and other implementations of Java that are certified as Java SE 5 or 6 compliant, but we do not test or certify Geronimo on those implementations.

Download binaries

Depending on the platform you plan to install and run Apache Geronimo you will select the appropriate installation image. Open a Web browser and access the following URL, there you will find the available packages for download (binaries and source code).

...

  • Java EE 5 : full Java EE 5 functionality - Certified version.
  • Minimal (Little-G) : Web Container, Transaction, and Connector capabilities
  • Framework : Geronimo kernel core functionality

...

With Apache Geronimo already installed, open a command line console and change directory to <geronimo_home>/bin and run one of the following commandcommands:

geronimo run
start-server
gsh geronimo/start-server

This script starts will start the server on within the same terminal you run the commandexisting terminal, instead of as a background process. Once the server is started you should see a screen similar to this one.

No Format
bgColor#000000
borderStylesolid

D:\geronimo-tomcat6-javaee5-2.1\bin>geronimo run
Using GERONIMO_BASE:   D:\geronimo-tomcat6-javaee5-2.1
Using GERONIMO_HOME:   D:\geronimo-tomcat6-javaee5-2.1
Using GERONIMO_TMPDIR: var\temp
Using JRE_HOME:        C:\Java\jdk1.5.0_06\jre
Booting Geronimo Kernel (in Java 1.5.0_06)...
Starting Geronimo Application Server v2.1
[****************************************] 100%  46s Startup complete
  Listening on Ports:
       0 0.0.0.0   Derby Connector
    1050 127.0.0.1 CORBA Naming Service
    1099 0.0.0.0   RMI Naming
    2001 127.0.0.1 OpenEJB ORB Adapter
    4201 0.0.0.0   OpenEJB Daemon
    6882 127.0.0.1 OpenEJB ORB Adapter
    8009 0.0.0.0   Tomcat Connector AJP AJP
    8080 0.0.0.0   Tomcat Connector HTTP BIO HTTP
    8443 0.0.0.0   Tomcat Connector HTTPS BIO HTTPS
    9999 0.0.0.0   JMX Remoting Connector
   61613 0.0.0.0   ActiveMQ Transport Connector
   61616 0.0.0.0   ActiveMQ Transport Connector

  Started Application Modules:
    EAR: org.apache.geronimo.configs/uddi-tomcat/2.1/car
    EAR: org.apache.geronimo.plugins/agent/2.1/car
    EAR: org.apache.geronimo.plugins/console-tomcat/2.1/car
    EAR: org.apache.geronimo.plugins/mconsole-tomcat/2.1/car
    JAR: org.apache.geronimo.configs/mejb/2.1/car
    RAR: org.apache.geronimo.configs/activemq-ra/2.1/car
    RAR: org.apache.geronimo.configs/system-database/2.1/car
    RAR: org.apache.geronimo.plugins/agent-ds/2.1/car
    RAR: org.apache.geronimo.plugins/mconsole-ds/2.1/car
    WAR: org.apache.geronimo.configs/ca-helper-tomcat/2.1/car
    WAR: org.apache.geronimo.configs/dojo-legacy-tomcat/2.1/car
    WAR: org.apache.geronimo.configs/dojo-tomcat/2.1/car
    WAR: org.apache.geronimo.configs/remote-deploy-tomcat/2.1/car
    WAR: org.apache.geronimo.configs/welcome-tomcat/2.1/car
    WAR: org.apache.geronimo.plugins/activemq-console-tomcat/2.1/car
    WAR: org.apache.geronimo.plugins/debugviews-console-tomcat/2.1/car
    WAR: org.apache.geronimo.plugins/plancreator-console-tomcat/2.1/car
    WAR: org.apache.geronimo.plugins/plugin-console-tomcat/2.1/car
    WAR: org.apache.geronimo.plugins/sysdb-console-tomcat/2.1/car

  Web Applications:
    /
    /CAHelper
    /activemq
    /console
    /console-base
    /debug-views
    /dojo
    /dojo/0.4
    /juddi
    /monitoring
    /plan-creator
    /plugin
    /remote-deploy
    /system-database

Geronimo Application Server started

...

Code Block
xml
xml
borderStylesolid
titleGeronimo deployment plan geronimo-web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-2.0.1">
    <environment>
        <moduleId>
            <groupId>sample.applications<<groupId>org.apache.geronimo.samples</groupId>
            <artifactId>HelloWorldApp</artifactId>
            <version>2.1</version>
            <type>war</type>
        </moduleId>             
    </environment>
    <context-root>/hello</context-root>
</web-app>

...

http://localhost:8080/hello

Stop the server

In the terminal used to start the server, press CTRL+C initiate a server shutdown.

Summary

This article showed you how simple is to have Apache Geronimo up and running. The overall time for getting the server running should be less than five minutes if you have the prerequisites already installed. Additionally, this article also showed you how to create, deploy and test a very simple JSP in less than five minutes.