Welcome to the Apache Geronimo v2.2 documentation. This is a work in progress and at this point in time we are starting to outline the new features that will become part of this new release, so expect this documentation to be updated frequently.
To help you find the content you are looking for we are separating the documentation in two main groups, User's guide and Developer's guide. In a nutshell, the former is mostly targeted to system administrators and overall users that will be installing and configuring Geronimo and applications. The latter on the other hand is targeted to applications developers, the idea is to provide all the info you need to know to develop applications and to get the most of them (and your time) when deploying to Geronimo.
So, how are we doing this? Check this out!
User's guide
- What's new in 2.2
- New features
- Enhanced features
- Geronimo distributions
- Configuration changes
- Compatibility with earlier versions
- Getting started with Apache Geronimo
- Getting the software
- Geronimo directory structure
- Starting the server
- Creating and deploying a sample application
- Getting the software
- Planning and installing
- Installing prerequisite software
- Getting Geronimo
- Building Geronimo from source
- Building Geronimo with Maven
- Building Geronimo from Eclipse
- Building Geronimo from source
- Installing Geronimo
- Initial configuration
- Starting and stopping the server
- Running Geronimo as a non-root user
- Running multiple Geronimo instances
- Running Geronimo as a Windows, or UINX service
- Configuring and administering
- Deploying and and administering assets in Geronimo
- Configuring and administering the Apache Geronimo Server
- Administering Geronimo using the Geronimo administration console
- Administering Geronimo using command line tools
- Add new listeners for Web containers
- Aliasing modules
- Configuring virtual host
- Configuring a remote Apache HTTP server
- Configuring JAX-WS engine
- Clustering
- Custom server assemblies
- Plugin basics
- Buidling,installing plugins and extracting a server from an exsiting server
- Assembling a server using Maven
- Congifuring services
- Configuring multiple repositories
- Adding archives to the Geronimo repository
- Configuring database pools
- Configuring JMS
- Administering security
- Configuring the transaction manager identity
- Creating an embedded database in Geronimo
- Monitoring the health of the Apache Geronimo server
- Configuring your own Monitoring Plugin DataSource
- Monitoring the status of the server using the Information portlet in the Geronimo administration console
- Monitoring the performance of the server using the Monitoring portlet in the Geronimo administration console
- Displaying JVM information
- Extensible Administration Console
- Migrating
- JBoss to Geronimo
- Using the J2G migration tool
- EJB-BMP migration
- EJB-session beans migration
- Hibernate migration
- JDBC migration
- Servlets and JSPs migration
- Tomcat to Geronimo
- JBoss to Geronimo
- Developing
- Setting up your development environment
- Selecting tools and options
- Eclipse
- Maven Integration for Eclipse
- Web Tools Platform (WTP)
- Geronimo Eclipse plug-in
- NetBeans
- Apache Maven
- JBoss to Geronimo Migration Tool (J2G)
- Eclipse
- Installing Eclipse
- Installing Geronimo Eclipse Plug-in
- Defining Geronimo server runtimes and servers
- Configuring your development environment
- Selecting tools and options
- Developing applications for Geronimo
- Getting familiar with the development environment
- Configuring Application Specific Logging with Log4j
- Preparing to run SQL statements at Deployment Time
- Locating your application specific configuration files
- Quick Debugging JSPs of your application
- Deploying applications using the Geronimo Eclipse Plugin (GEP)
- Developing Web applications with GEP
- Creating a Dynamic Web project using Eclipse
- Developing Web applications for accessing EJB
- Developing Web applications for accessing JDBC
- Developing Web applications for accessing JMS
- Developing JavaServer faces applications
- Basics of JavaServer Faces
- Developing AJAX with JSF applications in GEP
- Using JSP immediate expressions to access JSF
- Developing user interface with JSF
- Developing Web services in Geronimo
- Overview of Web services
- Web Services Architecture
- Web Services Description Language (WSDL)
- Developing Web services
- Developing a simple Calculator Web Service
- Developing JAX-RPC Web Services
- Developing a JAX-WS POJO Web Service
- Developing a JAX-WS EJB Stateless Session Bean Web Service
- Developing Clients for a JAX-WS Web Service
- Developing SAAJ Messaging Web Services
- Developing MTOM Web Services
- Developing a simple RESTful Service
- Developing Client for RESTful Web Service
- Migrating from JAX-RPC to JAX-WS
- WS Addressing
- Secruing your applications
- Developing JEE application clients
- Developing EJB applications
- Configuring, developing, and deploying enterprise applications with Eclipse and Geronimo
- Developing EJB applications with Stateless Session Bean
- Developing EJB applications with Stateful Session Bean
- Developing JMS applications with Message-Driven Bean
- Persistence
- Developing container managed persistence with JPA
- Developing bean managed persistence with JPA
- Developing persistence for JSF applications using JPA
- Developing portlets for the Geronimo administration console
- Convert your current applications into plugins
- Getting familiar with the development environment
- Creating deployment plans
- Deployment plan changes for going from Geronimo 1.1 to Geronimo 2.1
- Creating deployment plans using the deployment plan wizard
- Understanding XML schemas for deployment plans
- Configurations in deployment plans
- Creating deployment plans for applications
- Annotations
- Geronimo architecture
- Repositories
- GBeans
- Modules and assemblies
- Setting up your development environment
- Reference
- Tools and commands
- GShell
- Startup
- Shutdown
- Geronimo
- deploy
- Client
- JAX-WS tools
- Samples
- Sample applications
- Sample plug-ins
- Tools and commands
- Troubleshooting
- Troubleshooting runtime issues
- Troubleshooting Web services issues