Installing a Geronimo sample/title> <meta content="text/html; CHARSET=iso-8859-1" http-equiv="Content-Type"> </style> </head> <body leftmargin="0" topmargin="0" bgcolor="#ffffff" marginwidth="0" marginheight="0" text="#000000" link="#000000" vlink="#666666"> <table valign="top" border="0" cellspacing="0" cellpadding="0" width="100%" background="http://geronimo.apache.org/images/header_bg_1x86.gif"> <tr> <td class="cell" valing="top" align="left"><img src="http://geronimo.apache.org/images/topleft_logo_437x64.gif" border="0"></td> <td class="cell" width="100%"> </td> <td class="cell" valign="top" align="right"><img src="http://geronimo.apache.org/images/subnav_angle_15x18.gif" width="15" height="18" alt="" border="0"></td> <td class="cell" valign="top" align="right"><a href="http://mail-archives.apache.org/mod_mbox/geronimo-user/"> <img src="http://geronimo.apache.org/images/subnav_userlist_55x18.gif" width="55" height="18" alt="" border="0"></a></td> <td class="cell" valign="top" align="right"><a href="http://mail-archives.apache.org/mod_mbox/geronimo-dev/"> <img src="http://geronimo.apache.org/images/subnav_devlist_59x18.gif" width="59" height="18" alt="" border="0"></a></td> <td class="cell" valign="top" align="right"><a href="http://cwiki.apache.org/geronimo"> <img src="http://geronimo.apache.org/images/subnav_wiki_39x18.gif" width="39" height="18" alt="" border="0"></a></td> <td class="cell" valign="top" align="right"><a href="http://issues.apache.org/jira/browse/GERONIMO"> <img src="http://geronimo.apache.org/images/subnav_issue_83x18.gif" width="83" height="18" alt="" border="0"></a></td> <td class="cell" valign="top" align="right"><a href="http://www.epiqtech.com"><img src="http://geronimo.apache.org/images/subnav_graph_95x18.gif" width="95" height="18" alt="" border="0"></a></td> </tr> </table> <table valign="top" border="0" cellspacing="0" cellpadding="0" width="100%" background="http://geronimo.apache.org/images/menu_bgstretch_1x22.gif"> <tr align="left"> <td valign="top"> <a href="index.html"><img src="http://geronimo.apache.org/images/menu_home_off_63x19.gif" width="63" height="19" border="0"></a> </td> <td valign="top" align="left"> <a href="documentation.html"><img src="http://geronimo.apache.org/images/menu_doc_off_116x19.gif" width="116" height="19" border="0"></a> </td> <td valign="top" align="left"> <a href="downloads.html"><img src="http://geronimo.apache.org/images/menu_download_off_85x19.gif" width="85" height="19" border="0"></a> </td> <td valign="top" align="left"> <a href="get-involved.html"><img src="http://geronimo.apache.org/images/menu_comm_off_96x19.gif" width="96" height="19" border="0"></a> </td> <td valign="top" align="left"> <a href="development.html"><img src="http://geronimo.apache.org/images/menu_dev_off_104x19.gif" width="104" height="19" border="0"></a> </td> <td width="100%"> </td> </tr> </table> <font face="Verdana, Helvetica, Arial"> <H2>Installing a Geronimo sample</H2> <font style="font-size:12px"> There are 2 ways to play with a Geronimo sample. <UL> <LI>install a readily available sample binary. This requires a Geronimo server to be running. <LI>build the sample and install it. This requires Maven v2.0.4. The sample thus built will be deployed for you on an already running server or on a server that will be downloaded. </UL> </FONT> <H3>1. Installing an available sample binary</H3> <font style="font-size:12px"> <OL>Steps: <LI>Download the sample binary <LI>go to the ${geronimoHome}/bin directory. It is the directory where you have the Geronimo server unpacked. <LI>start the server using <CODE>startServer.bat</CODE> or <CODE>startServer.sh</CODE> <LI>deploy the downloaded sample binary using <CODE>deploy.bat --user system --password manager deploy /path/to/sample/binary/sample.ear</CODE> <LI>open a browser and go to the sample's context root. </OL> </FONT> <H3>2. Building a sample from source</H3> <font style="font-size:12px"> This will give you an opportunity to play with the source code. The build will also deploy the sample application into a Geronimo server. You may choose an already unpacked and/or running server to deploy this sample application. <p> Alternatively, you may let the build download the latest Geronimo binary and unpack it. By default, a downloaded server binary will be unpacked into the sample project's <CODE>target</CODE> directory. Or you may choose a different installation directory. <p> You may let the build download the geronimo binary from a remote repository or point it to an already downloaded binary. <P> By default, it will download a Geronimo binary with the jetty webcontainer. You may however choose the Geronimo binary with the tomcat webcontainer. <OL>Steps: <LI>if you don't have Maven v2.0.4 already, download that from <A HREF="http://maven.apache.org/download.html">Apache's maven</A> site. Add maven's bin directory to your path. <LI>Download the sample source zip and unpack it. <I>If your platform is Windows, it is recommended that you unpack the zip in a directory quite close to the root to prevent a Windows restriction on long path name.</I> <LI>go to the directory where the sample source code has been unpacked <LI>execute the command <b><CODE>mvn site</CODE</B> <LI>execute the command <b><CODE>mvn</CODE></B> <UL>Some optional arguments: <LI>-DgeronimoHome: path to directory where a server has already been unpacked. <p><LI>-DinstallDirectory: path to directory where a server has to be unpacked. If one already exists there, a later one, if available, will be downloaded and installed. If a later binary isn't available, the existing server is started. If one doesn't exist, then the downloaded one will be unpacked here. <p><LI>-DassemblyId: [jetty | tomcat] by default, Geronimo with the <I>jetty</I> webcontainer will be downloaded and started. Set the value of this to <I>tomcat</I> for the tomcat webcontainer. <p><LI>-DassemblyArchive: path to an assembly archive already downloaded.<P> </UL> <LI>start the server using <CODE>startServer.bat</CODE> or <CODE>startServer.sh</CODE> <LI>open a browser and go to the sample's context root. </OL> </FONT> </FONT> </body> </html>