Apache Geronimo V1 - Documentation Draft

Article donated by: Hernan Cunico

This page is an attempt to organize and consolidate all the documentation for Apache Geronimo. There is a list of topics to be covered and the discussion about the content is being carried on the developers mailing list dev@geronimo.apache.org, for subscription information refer to the Mailing Lists at the Apache Geronimo Web site.

The following is a proposed table of contents to address as many topics as possible on Apache Geronimo. This structure should be the foundation for upcoming releases of Geronimo. 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.

1. Quick start - Apache Geronimo for the impatient
   • Getting the software
   • Start the server
   • Create and deploy a sample application
2. Apache Geronimo project overview
   • About Apache Software Foundation (ASF)
   • Technology Compatibility Kit (TCK)
3. Architecture
4. Installation
   • Supported platforms
   • Hardware and software prerequisites
   • Getting the source code
   • Build from the source
   • Installation
5. Samples for Apache Geronimo
6. Administration
   • Tools and commands
   • Geronimo Administration Console
   • Administrative tasks
     • Administering the Apache Geronimo Server
       • Changing the Web container
       • Starting and stopping the server
       • Configuring resources
       • Installing applications
       • Starting and stopping application modules
       • Configure log level
       • Performance monitoring
       • Adding new listeners for the Web containers
       • Configuring the EJB server engine
       • Configuring J2EE connectors
       • CORBA/IIOP
       • Configuring the UDDI server
     • Configuring Services
       • Adding files to the Geronimo repository
       • Configuring database pools
       • Configuring JMS
       • Configuring JavaMail
     • Administering applications
       • Installing and removing applications
       • Starting and stopping applications
     • Administering security
       • Addiing security realms
       • Importing certificates
       • Configure LDAP
       • Configuring SSL
   • Backup and recovery
   • Maintenance
7. Development
   • Eclipse tools
   • Simple servlet and JSP applications
   • Web applications
   • EJB applications
   • Security applications
   • Web services applications
   • Client applications
   • ...
8. Deployment
   • Deployer tool
   • Hot deployment
   • Deployment plans
   • Deploying secure applications (Security)
   • Deploying configurations and resources
9. Security
   • Concepts
   • Login into Geronimo
   • Geronimo and JAAS
   • JaasLoginService API Discussion
   • Component Configuration
   • Authorization - mapping J2EE roles to Principals
   • Security Definition Schema
   • Geronimo Login Config Schema
   • Deploying secure applications
   • Available login modules
     • Configure Geronimo LDAP using Jetty
   • Mapping J2EE Roles in M5 release
   • Configuring SSL
10. Migrating to Apache Geronimo
    • JBoss to Geronimo - Servlets and JSPs Migration
    • JBoss to Geronimo - JDBC Migration
    • JBoss to Geronimo - Security Migration
    • JBoss to Geronimo - JCA Migration
    • JBoss to Geronimo - Web Services Migration
    • JBoss to Geronimo - EJB-BMP Migration
    • JBoss to Geronimo - EJB-MDB Migration
    • JBoss to Geronimo - EJB-Session Beans Migration
    • JBoss to Geronimo - EJB-CMP Migration
11. Performance and high availability
    • Scalability
    • Clustering
12. Hints and Tips
13. Troubleshooting