Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 1 Getting up to speed with Apache Geronimo Tom McQueeney O'Reilly Open Source Convention Aug. 4, minutes Audience: J2EE developers

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 2 Goals for this talk Demystifying Geronimo  What's inside, terminology Exploring the architecture  Kernel, GBeans, configurations Demo and examples: Deploying apps Web app EJB Web Service Customizing Geronimo  Database and Messaging System  Tomcat vs. Jetty web containers Review and Summary  Where to find more tools and resources

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 3 Overview: Geronimo as a J2EE 1.4 Application Server EJBs Deployment and Management Tools JSPs Servlets  Mail Server Message Queue Directory Service Applet Web Browser Application Client RDBMS J2EE 1.4 APIs J2SE 1.4 APIs EIS Kernel EJB Container Web Container Java Application  CORBA

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 4 Overview Geronimo and Open Source Projects EJBs Deploy and Mgmt Tools JSPs Servlets Applet Web Browser RDBMS J2EE 1.4 APIs J2SE 1.4 APIs EIS Kernel EJB Container Web Container Tomcat Jetty OpenEJB Derby CMP TranQL XML Beans Velocity Logging Log4j Application Client Message Queue Directory Service ActiveMQ  Mail Server Java Application  CORBA

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 5 Overview Geronimo - Open Source Projects J2EE 1.4 APIs Monitoring Scout Axis JAXR HOWL JTA JOTM MX4J ManagementJMX JMS ActiveMQ Velocity J2SE 1.4 APIs JNDIJAASJava IDLRMI-IIOPJDBC TranQL Web Services JCA JavaMail JACC JAF JAX-RPC SAAJ Custom Code JAXP Xerces

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 6 Overview Core Geronimo Infrastructure Geronimo Kernel GBeans Logging Configuration Management MBeans Deployment and Management Tools

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 7 Geronimo Kernel G-Lingo: Kernel The “core” framework Manages all J2EE services, lifecycles –Configurations, GBeans, dependencies Based on Inversion of Control (IoC) –GBean tells kernel what it needs and kernel "injects" it Lightweight footprint –J2EE services live outside the kernel

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 8 Geronimo Kernel G-Lingo: Configuration A deployable component Your J2EE modules are configurations J2EE services like JMS are configurations Managed as unit: Started, stopped, undeployed Each configuration has a unique name May depend on one other configuration (parent) Saved in a configuration store: restored on restart May define one or more GBeans Configuration Management

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 9 Geronimo Kernel G-Lingo: GBean (Geronimo bean) Managed object that wraps a Geronimo service Class or object with a kernel-managed lifecycle: start, stop, fail Geronimo creates them to manage deployed components You can configure existing GBeans to add services to an application (in deployment plan). E.g. –GBean wraps a Tomcat access log "Valve" for a web app –GBean wraps customized security realm You must create GBean if you add new service GBeans Configuration Management

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 10 Geronimo Kernel G-Lingo: GBeans / MBeans (JMX managed bean) Kernel exposes GBeans as MBeans for management Kernel creates and uses JMX MBeanServer for object management Kernel wraps all GBeans in an MBean Exposes MBeans/GBeans for external management and monitoring MBeans GBeans Configuration Management

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 11 G-Lingo: Module (not a Geronimo-specific term) J2EE term for a deployable J2EE component  Every module requires J2EE deployment descriptor  Optional: Geronimo-specific deployment descriptor –It's called a Deployment Plan when used outside JAR file Enterprise Archive EAR WAR  Module Web Applications JAR  Module EJB Applications JAR  Module Application Clients RAR  Module Resource Adapters

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 12 G-Lingo: Deployment Plan, 3 Options Geronimo Deployment Plan.xml J2EE Module J2EE Deployment Descriptor.xml No plan supplied: Container uses default values J2EE Module J2EE Deployment Descriptor.xml Geronimo Default Deployment Plan.xml Geronimo Deployment Plan.xml J2EE Module J2EE Deployment Descriptor.xml 1.No plan: Use Geronimo’s module defaults (war, jar, ear) 2.Supply deployment plan within the jar (requires specific name) 3. Supply plan to deploy tool as external file

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 13 G-Lingo Deployment Plan - File Names Required plan file name when included in module JAR ModuleFile TypeJ2EE DDGeronimo Default Deployment Plan Names WebWARweb.xmlgeronimo-jetty.xml geronimo-tomcat.xml EJBJARejb-jar.xmlopenejb-jar.xml ConnectorsRARra.xmlgeronimo-ra.xml Client AppsJARapplication- client.xml geronimo-application- client.xml EnterpriseEARapplication.xmlgeronimo-application.xml

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 14 Deployment Facilities Deploying to Geronimo  Deploy tool: Java CLI application packaged as executable JAR: deployer.jar Connects to Geronimo locally (remotely?) over RMI JSR-88 deployment tool  Maven deployer plug-in for Maven fans Also maven plug-in to stop/start Geronimo Deployment and Management Tools

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 15 Deployment Examples Demo of deploying three types of modules:  Web application  EJB  Web Service Additional topics covered during the demo  Starting/Stopping Geronimo  Configurations  Derby database and database connectors  Customizing the message system

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 16 Demo

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 17 Geronimo Coming Features J2EE 1.4 certification  Passed J2EE 1.4 TCK on June 29 at 9:17: pm PDT Better management and monitoring tools Clustering and failover support  wadi.codehaus.org Spring integration EJB 3.0 support

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 18 Geronimo Resources Online information  geronimo.apache.org Download the source to build Documentation?  wiki.apache.org/geronimo How to build/install from source NB: Wiki has history of stale information  issues.apache.org/jira/secure/BrowseProject.jspa?id=10220 Bugs and roadmap to future releases  geronimolive.com Links to articles and supporting open source projects  jroller.com/page/GeronimoLive Blog on Geronimo

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 19 Geronimo Community Join the Apache Geronimo Community  Use Geronimo and provide feedback Something broken or unclear? Have a suggestion for new features?  Develop and donate code Submit bug patches, improvements  Keep updated on news – Mailing Lists Users: Developers:  Join the discussion - IRC Used by development team for daily communication [irc.freenode.net channel: #geronimo]

Apache Geronimo Open Source J2EE Application Server Getting up to speed with Apache Geronimo - Copyright 2005 Tom McQueeney 20 Questions? Tom McQueeney