For this release of Apache Geronimo we consolidated both User's and Developer's guide into a single space. While maintaining a hierarchical structure this new organization will reduce the number of "clicks" to reach the info you are looking for. We hope you find this new organization easier to use. Enjoy it!

In this space we have consolidates all the documentation for Apache Geronimo v1.2. There is a list of topics to be covered and the discussion about the content is being carried on the developers mailing list [email protected], for subscription information refer to the Mailing Lists at the Apache Geronimo Web site.

The following table of contents is generated automatically as new content is added. This is a work in progress and collaboratively constructed through the Apache Geronimo community, your contributions to this documentation are welcome, this is a community effort. All the content contributed to this documentation is to be considered a donation to the Apache Geronimo project, as such all pages, docs and attachments are subject to the Apache License.

1. RELEASE-NOTES-1.2.TXT
2. Summary of changes
3. Quick start - Apache Geronimo for the impatient
   • Getting the software
   • Start the server
   • Create and deploy a sample application
4. Installation
5. Administration
   • Administrative tasks
     • Administering applications
       • Installing and removing applications
       • Starting and stopping application modules
     • Administering the Apache Geronimo Server
       • Adding new listeners for the Web containers
         • Add new AJP listener
         • Add new HTTP listener
         • Add new HTTPS listener
       • Configure log level
         • Derby Log Viewer
         • Log Manager
         • Server Log Viewer
         • Web Access Log Viewer
       • Configuring a remote Apache HTTP server
         • Configure Apache HTTPd as a reverse proxy (mod_proxy)
         • Configure Apache HTTPd with Jakarta Tomcat Connector (mod_jk)
       • Configuring the JMS server
       • Display JVM information
       • Monitor Server status
       • Performance monitoring
       • Starting and stopping the server
     • Configuring security
       • Administering certificates
       • Administering security realms
         • Certificate Properties File Realm
         • Database (SQL) Realm
         • LDAP Realm
       • Administering users and groups
       • Certification Authority
     • Configuring services
       • Adding archives to the Geronimo repository
       • Configuring database pools
         • Create new database pools
         • Import database pools from JBoss 4
         • Import database pools from WebLogic 8.1
         • Removing database pools
       • Configuring JMS
   • Configuring DB2 datasource
   • Configuring Virtual Hosts in Geronimo-Jetty
   • Configuring Virtual Hosts in Geronimo-Tomcat
   • Create a database
   • Geronimo Administration Console
   • Running Geronimo as a non-root user
   • Tools and commands
     • client.jar
     • deploy
     • Deployer tool
     • geronimo
     • jpa.jar
     • shutdown
     • startup
6. Deployment plans
   • Deployment Plans-Level-1
   • geronimo-application-client.xml
   • geronimo-application.xml
   • geronimo-ra.xml
   • geronimo-web.xml
   • openejb-jar.xml
7. Sample applications
   • DB Pool Testing sample application (1.2 Ok)
   • EJB sample application (1.2 Ok)
   • Exposing Web applications on distinct ports
   • Geronimo Tomcat Context Level Clustering - Sample Application
   • Geronimo Tomcat Host Level Clustering - Sample Application
   • JMS and MDB sample application (1.2 Ok)
   • LDAP sample application (1.2 Ok)
   • Simple database access sample application (1.2 Ok)
   • SPECjAppServer2004
   • Using Geronimo's default JavaMail session
   • Very simple example of CMP EJB
   • Very simple Session EJB example
   • Web application security sample (1.2 Ok)
   • Web services sample application

Geronimo v1.2 documentation being updated from the previous v1.1.1 release. From the list below the following docs still need to be updated: Summary of changes Configuring JMS Deployment plans Sample applications