Re: [CONF] Apache Geronimo v2.1: Sample applications (page edited)

[Joe Bohn <jo...@earthlink.net>]

David,

Since these documents are for Geronimo 2.1 server (not branches/2.1) and 
the samples for that server image, I think we need to still for Geronimo 
2.1 I think we need to insist that maven 2.0.7 is used rather than 
2.0.9.   Since the 2.1 samples are dependent upon the 2.1 server (and 
the 2.1 server plugin) we get errors if we attempt to build with maven 
2.0.9.

Joe



confluence@apache.org wrote:
> 
> Page Edited : GMOxDOC21 
> <http://cwiki.apache.org/confluence/display/GMOxDOC21> : Sample 
> applications 
> <http://cwiki.apache.org/confluence/display/GMOxDOC21/Sample+applications>
> 
> Sample applications 
> <http://cwiki.apache.org/confluence/display/GMOxDOC21/Sample+applications> 
> has been edited by David Jencks 
> <http://cwiki.apache.org/confluence/display/~djencks> (May 30, 2008).
> 
> Change summary:
> 
> Add some basic general instructions for samples.
> 
> (View changes) 
> <http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=78004&originalVersion=5&revisedVersion=6> 
> 
> 
> Content:
> 
> 
>     General Instructions
> 
> 
>       Obtaining and building
> 
> While it is possible to build each sample separately you may be less 
> likely to run into odd maven problems if you check out and build all the 
> samples at once. This is a small amount of code so should not be a major 
> burden on anyone.
> 
> You need svn and maven v 2.0.9 or later installed on your system.
> 
> To check out the trunk samples:
> 
> svn co https://svn.apache.org/repos/asf/geronimo/samples/trunk
> 
> Depending on when you look you may find earlier or released versions of 
> the samples under samples/branches and samples/tags. You can browse in 
> any web browser to see what's there.
> 
> Build using
> 
> mvn clean install
> 
> There are minimal smoke tests to assure that the sample plugins can be 
> installed on the framework server. To run this tests use
> 
> mvn clean install -Pit
> 
> (not available before geronimo 2.2 and possibly 2.1.2)
> 
> 
>       Installing samples as plugins
> 
> Recommended practice for geronimo is to set up a workflow using geronimo 
> plugins and maven from development through test and production. To 
> demonstrate part of this the samples are built into plugins suitable for 
> the jetty and tomcat web containers in geronimo. Many samples require 
> database access and this is encapsulated into a separate plugin.
> 
> 	
> 
> TODO: Demonstrate how to swap databases using plugins; see also the 
> roller plugin
> 
> In any case, to install samples as plugins you need to build them first.
> 
> 
>         Installing through the admin console.
> 
> For this you need a geronimo server with a web container installed, such 
> as the geronimo-jetty-minimal or geronimo-jetty6-javaee5 servers. In the 
> admin console go to the plugins page, push the "Show Plugins" button, 
> find the sample(s) you want to install, and click install. Be sure to 
> select only plugins for the web container you have installed (e.g. jetty 
> plugins for the jetty web container). Any necessary dependencies such as 
> the SampleDatabase plugin will be installed automatically.
> 
> 
>         Installing through gshell
> 
> For this you can use any geronimo server such as geronimo-framework. 
> After starting geronimo, run ./bin/gsh deploy/list-modules in another 
> terminal window and follow the instructions. Installing a sample plugin 
> will install the sample database plugin and all other dependencies such 
> as the required web container.
> 
> 
>       Deploying samples as javaee artifacts.
> 
> Many samples also include a suitable geronimo plan allowing you to 
> deploy them as javaee applications. For most samples you will need to 
> install the sample database plugin first. Samples can be deployed from 
> the admin console "deploy new" on a suitable server or using gshell 
> ./bin/gsh deploy/deploy. Note that in this case you need to start with a 
> server with all the required bits already installed, not the framework 
> server. Since this installation method is not tested automatically it is 
> more likely to be broken that the plugin method.
> 
> 
>     Sample applications available
> 
>     * DB Pool Testing sample application
>       </confluence/display/GMOxDOC21/DB+Pool+Testing+sample+application>
>     * EJB sample application
>       </confluence/display/GMOxDOC21/EJB+sample+application>
>     * How to Access Resources via JNDI
>       </confluence/display/GMOxDOC21/How+to+Access+Resources+via+JNDI>
>     * Inbound JCA example
>       </confluence/display/GMOxDOC21/Inbound+JCA+example>
>     * Jar to Jar EJB references (no ear)
>       </confluence/display/GMOxDOC21/Jar+to+Jar+EJB+references+%28no+ear%29>
>     * JMS and MDB Sample Application
>       </confluence/display/GMOxDOC21/JMS+and+MDB+Sample+Application>
>     * JMS Resources Deployment
>       </confluence/display/GMOxDOC21/JMS+Resources+Deployment>
>     * LDAP Sample Application
>       </confluence/display/GMOxDOC21/LDAP+Sample+Application>
>     * Simple Database Access Application
>       </confluence/display/GMOxDOC21/Simple+Database+Access+Application>
>     * Simple Web Service with JAX-WS
>       </confluence/display/GMOxDOC21/Simple+Web+Service+with+JAX-WS>
>     * Using EJB 3.0 Functions
>       </confluence/display/GMOxDOC21/Using+EJB+3.0+Functions>
>     * Using Geronimo's Default JavaMail Session
>       </confluence/display/GMOxDOC21/Using+Geronimo%27s+Default+JavaMail+Session>
>     * Very Simple Entity EJB Example
>       </confluence/display/GMOxDOC21/Very+Simple+Entity+EJB+Example>
>     * Very Simple Session EJB Example
>       </confluence/display/GMOxDOC21/Very+Simple+Session+EJB+Example>
>     * Web Application Security Sample
>       </confluence/display/GMOxDOC21/Web+Application+Security+Sample>
> 
> Powered by Atlassian Confluence 
> <http://www.atlassian.com/software/confluence/default.jsp?clicked=footer> 
> (Version: 2.2.9 Build:#527 Sep 07, 2006) - Bug/feature request 
> <http://jira.atlassian.com/secure/BrowseProject.jspa?id=10470>
> 
> Unsubscribe or edit your notifications preferences 
> <http://cwiki.apache.org/confluence/users/viewnotifications.action>