Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

anchortoptop

If you are in a hurry to have Apache Geronimo up and running right away, this article will provide you with some basic steps for downloading, building (when needed) and run the server in no time. This is clearly not a complete guide so you may want to check the other links in the Apache Geronimo v1.1 - User's Guide main section for further information.

...

Background

Apache Geronimo is a J2EE certified application server that is completely opensource and under the Apache License. Geronimo first passed the Technology Compatibility Kit(TCK) test in 2005 and v1.0 was released in January 2006. The Geronimo community is backed by over 28 committers from more than 8 companies, multiple organizations have already started builing applications on Geronimo. Geronimo v1.1 is the second official release of the application server by the Apache Software Foundation.

...

http://geronimo.apache.org/downloads.html

...

...

Apache Geronimo v1.1 is certified on J2EE 1.4 but it works with 1.5 as long as CORBA or daytrader are not used.

...

Select the file compression format compatible with your system (zip, tar, gz) by clicking directly on the link, download it and expand the binary to your hard drive in a new directory. For example in z:/geronimo, from now on this directory will be referenced as <geronimo_home>.

...

These jar files can be started using the java -jar to invoke the main class in <geronimo_home>/bin/<the name of the .jar file>.
The client.jar file can be used to start the Geronimo configuration that contains the application client that you want to run.
The deployer.jar file is a Java application that manages J2EE artifacts and GBeans that run on the Geronimo server.
The server.jar file is used to start the Geronimo server.
The update.jar can be used to upgrade xml files from the previous Geronimo version to the current one.
The shutdown.jar file can be invoked from command line to shutdown the server.

...

To start the server run the following command:

java -jar server.jar

Alternatively a script is provided, the startup script will also start the server. Once the server is started you should see the following information on the command line console.
noformat
bgColor#000000borderStylesolid Booting Geronimo Kernel (in Java 1.5)... Starting Geronimo Application Server v1.1 [**********************] 100% 32s Startup complete Listening on Ports: 1099 0.0.0.0 RMI Naming 1527 0.0.0.0 Derby Connector 4201 0.0.0.0 ActiveIO Connector EJB 4242 0.0.0.0 Remote Login Listener 8009 0.0.0.0 Tomcat Connector AJP 8080 Jetty Connector AJP13 8080 0.0.0.0 Tomcat Jetty Connector HTTP 8443 0.0.0.0 Tomcat Jetty Connector HTTPS 9999 0.0.0.0 JMX Remoting Connector 61616 0.0.0.0 ActiveMQ Message Broker Connector Started Application Modules: EAR: geronimo/webconsole-tomcatjetty/1.1/car RAR: geronimo/activemq/1.1/car RAR: geronimo/system-database/1.1/car WAR: geronimo/remote-deploy-tomcatjetty/1.1/car WAR: geronimo/welcome-tomcatjetty/1.1/car Web Applications: http://hcunicolsf-c9gr5600wbf:8080/ http://hcunicolsf-c9gr5600wbf:8080/console http://hcunicolsf-c9gr5600wbf:8080/console-standard http://hcunicolsf-c9gr5600wbf:8080/remote-deploy Geronimo Application Server started
To test the Apache Geronimo server you can just point your Web browser to the following URL to test the Geronimo Console. The Geronimo Console is the first application you can test, and the good thing is, it is already deployed.

...

Create a plain text file in the <app_home> directory named HelloWorld.jsp and copy the content of the following example.

...

...

Although for such a simple application it is not necessary, you will still create a Geronimo deployment plan so you would get a first view of the deployment plans. Create a directory named WEB-INF inside the <app_home> directory.

Create a plain text file in the <app_home>/WEB-INF directory named geronimo-web.xml and copy the content of the following example.

...

...

This version of geronimo-web.xml will not work in Geronimo v1.0

Create a plain text file in the <app_home>/WEB-INF directory named web.xml and copy the content of the following example.

...

...

Package the application

From a command line window change directory to <app_home> and run the following command to package the HelloWorld application into a single .war file.

jar -cvf HelloWorld.war *

This will create a HelloWorld.war file in the <app_home> directory. The next step is to deploy this application.

...

Change directory to <geronimo_home>/bin and run the following command:

java -jar deployer.jar --user system --password manager deploy <app_home>/HelloWorld.war

Once the application is successfully deployed you should see the following message:

No FormatbgColor#000000borderStylesolid E:\geronimo\bin>java -jar deployer.jar --user system --password manager deploy E:\HelloWorld\HelloWorld.war Deployed HelloWorld @ http://hcunicolocalhost:8080/hello

Test the application by pointing a Web browser to the following URL:

...