Return-Path: Delivered-To: apmail-geronimo-scm-archive@www.apache.org Received: (qmail 26550 invoked from network); 21 Jun 2007 16:40:08 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 21 Jun 2007 16:40:08 -0000 Received: (qmail 33849 invoked by uid 500); 21 Jun 2007 16:40:11 -0000 Delivered-To: apmail-geronimo-scm-archive@geronimo.apache.org Received: (qmail 33805 invoked by uid 500); 21 Jun 2007 16:40:11 -0000 Mailing-List: contact scm-help@geronimo.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: dev@geronimo.apache.org List-Id: Delivered-To: mailing list scm@geronimo.apache.org Received: (qmail 33794 invoked by uid 99); 21 Jun 2007 16:40:11 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 21 Jun 2007 09:40:11 -0700 X-ASF-Spam-Status: No, hits=-99.5 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 21 Jun 2007 09:40:07 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id CFCA01A981A; Thu, 21 Jun 2007 09:39:46 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r549536 - in /geronimo/samples/trunk/geronimo-samples-archetype/src/main/resources/archetype-resources: README.txt install-sample.html Date: Thu, 21 Jun 2007 16:39:46 -0000 To: scm@geronimo.apache.org From: prasad@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20070621163946.CFCA01A981A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: prasad Date: Thu Jun 21 09:39:45 2007 New Revision: 549536 URL: http://svn.apache.org/viewvc?view=rev&rev=549536 Log: * modified to reflect the drop in -Puser profile Removed: geronimo/samples/trunk/geronimo-samples-archetype/src/main/resources/archetype-resources/README.txt Modified: geronimo/samples/trunk/geronimo-samples-archetype/src/main/resources/archetype-resources/install-sample.html Modified: geronimo/samples/trunk/geronimo-samples-archetype/src/main/resources/archetype-resources/install-sample.html URL: http://svn.apache.org/viewvc/geronimo/samples/trunk/geronimo-samples-archetype/src/main/resources/archetype-resources/install-sample.html?view=diff&rev=549536&r1=549535&r2=549536 ============================================================================== --- geronimo/samples/trunk/geronimo-samples-archetype/src/main/resources/archetype-resources/install-sample.html (original) +++ geronimo/samples/trunk/geronimo-samples-archetype/src/main/resources/archetype-resources/install-sample.html Thu Jun 21 09:39:45 2007 @@ -68,9 +68,8 @@ There are 2 ways to play with a Geronimo sample.
    -
  • install a readily available sample binary. This requires a Geronimo server to be running. -
  • build the sample and install it. This requires Maven v2.0.5. - The sample thus built will be deployed for you on an already running server or on a server that will be downloaded. +
  • install a readily available sample binary. This requires a running Geronimo server to deploy the sample. +
  • build the sample and install it. This requires Maven v2.0.5 to build the sample and a running Geronimo server to deploy it.
@@ -88,34 +87,17 @@

2. Building a sample from source

- 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. + This will give you an opportunity to play with the source code.

- 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 target directory. - Or you may choose a different installation directory. -

- You may let the build download the geronimo binary from a remote repository or point it to an already downloaded binary. -

- By default, it will download a Geronimo binary with the jetty webcontainer. You may however choose the Geronimo binary with the tomcat webcontainer.

    Steps:
  1. if you don't have Maven v2.0.5 already, download that from Apache's maven site. Add maven's bin directory to your path.
  2. Download the sample source zip and unpack it. 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.
  3. go to the directory where the sample source code has been unpacked -
  4. execute the command mvn -Puser install site -
      Some optional arguments: -
    • -Puser: The user profile will deploy your sample app to Geronimo server. Without this, it will just build the sample. You will have to deploy it yourself. -
    • -DgeronimoHome: path to directory where a server has already been unpacked. -

    • -DinstallDirectory: path to directory where a server has to be unpacked. If a server already exists there, a more recent 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. -

    • -DassemblyId: [jetty | tomcat] By default, Geronimo with the jetty webcontainer will be downloaded and started. Set the value of this to tomcat for the tomcat webcontainer. -

    • -DassemblyArchive: path to an assembly archive (zip binary) already downloaded.

      -

    - - Example: mvn -Puser install site -DinstallDirectory=c:\Geronimo

    +

  5. execute the command mvn install site
  6. start the server using startServer.bat or startServer.sh +
  7. deploy the downloaded sample binary using deploy.bat --user system --password manager deploy /path/to/sample/binary/sample.ear
  8. open a browser and go to the sample's context root.