svn commit: r778964 - /websites/staging/river/trunk/content/building-river.html

[bu...@apache.org]

Author: buildbot
Date: Tue Nov  9 12:21:40 2010
New Revision: 778964

URL: http://svn.apache.org/viewvc?rev=778964&view=rev
Log:
Staging update by buildbot

Modified:
    websites/staging/river/trunk/content/building-river.html

Modified: websites/staging/river/trunk/content/building-river.html
URL: http://svn.apache.org/viewvc/websites/staging/river/trunk/content/building-river.html?rev=778964&r1=778963&r2=778964&view=diff
==============================================================================
--- websites/staging/river/trunk/content/building-river.html (original)
+++ websites/staging/river/trunk/content/building-river.html Tue Nov  9 12:21:40 2010
@@ -69,6 +69,59 @@
         <td style="overflow: hidden;" valign="top" width="100%">
           <div class="wiki-content">
 <h1 id="building_river">Building River</h1>
+<p>Before you can start building River a word of warning;</p>
+<blockquote>
+<p>The build process does not place nicely if you have spaces in your
+path names</p>
+</blockquote>
+<p>So Windows users please be particular aware.  Also, where path separators are specified colons (:) should be used in preference to semi-colons (;)  even on Windows.</p>
+<h2 id="check_out_the_code">Check out the code</h2>
+<p>See <a href="source-code.html">this page</a> on how to check out the source code.</p>
+<h2 id="build_the_distribution">Build the distribution</h2>
+<p>River can be built simply by running Ant from where you checked the code out from.</p>
+<p>Assume "$RIVER_HOME" is where you have checked out the code to.</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="nv">$RIVER_HOME</span>
+<span class="n">ant</span>
+</pre></div>
+
+
+<p>Will build all the River JARs required.  You will then find them in the ${RIVER_HOME}/lib* directories.</p>
+<h2 id="testing_river">Testing River</h2>
+<p>This build process runs the (limited) suite of unit tests that comes with River.  River is tested predominantly by using <a href="http://openjdk.java.net/jtreg/">jtreg</a>.</p>
+<p><em>The following should be ignored, it has not been edited or checked yet.</em></p>
+<p>create a file in the trunk directory called "build.properties"</p>
+<p>Then define the following properties in that file:</p>
+<p>river.home="file path to trunk"
+jtreg.home="path to jtreg install directory"
+jdk1.5.home="path to jdk1.5 directory"  eg: jdk1.5.home="/usr/jdk/jdk1.5.0_15"
+jtreg.dir=C:apacheriverjtskqajtreg</p>
+<p>Then in a directory relative to the one you choose for your working directory, you must add a file named test.props</p>
+<p>the correct location for test.props:</p>
+<blockquote>
+<p>/<em><em>
+</em> Returns extra test properties. Looks for the file "../../test.props"
+</em> and reads it in as a Properties file. Assuming the working directory
+<em> is "<path>/JTwork/scratch", this will find "<path>/test.props".
+</em>/</p>
+</blockquote>
+<p>My test.props contains the following two lines:</p>
+<p>jsk.home=/opt/src/river/trunk
+javatest.maxOutputSize=500000</p>
+<p>$jtreg -verbose:all,nopass -cpa: /opt/src/river/trunk/lib-platform -jdk /usr/jdk/jdk1.5.0_15 -Djsk.home="/opt/src/river/trunk" -Djava.security.debug=access,failure -Djavatest.maxOutputSize=500000 ./qa/jtreg/</p>
+<p>To run the tests manually, do the following:</p>
+<ol>
+<li>Copy the following files to JTlib-tmp; jsk-lib.jar,
+    jsk-platform.jar, jsk-resources.jar, phoenix-init.jar, jsk-policy.jar</li>
+<li>Execute the following jtreg command from the trunk directory,
+    change the paths to suit your environment.</li>
+<li>$ jtreg -verbose:all,nopass
+    -cpa:./qa/jtreg/JTlib-tmp/jsk.lib.jar:./qa/jtreg/JTlib-tmp/jsk-platform.jar:./qa/jtreg/JTlib-tmp/jsk-resources.jar:./qa/jtreg/JTlib-tmp/phoenix-init.jar:.jsk-policy.jar
+    -jdk /usr/jdk/jdk1.5.0_15 -Djsk.home="/opt/src/river/trunk"
+    -Djava.security.debug=access,failure
+    -Djavatest.maxOutputSize=500000 -Djtlib.tmp=./qa/jtreg/JTlib-tmp
+    ./qa/jtreg/</li>
+</ol>
+<p>c:/apache/jtreg/win32/bin/jtreg "-verbose:all,nopass" "-cpa:./qa/jtreg/JTlib-tmp/jsk.lib.jar:./qa/jtreg/JTlib-tmp/jsk-platform.jar:./qa/jtreg/JTlib-tmp/jsk-resources.jar:./qa/jtreg/JTlib-tmp/phoenix-init.jar:.jsk-policy.jar:./qa/jtreg/JTlib-tmp/sun-util.jar" -jdk "c:/Program Files/Java/jdk1.6.0_20" -Djsk.home="c:/apache/river/jtsk/trunk" -Djava.security.debug=access,failure  -Djavatest.maxOutputSize=500000 -Djtlib.tmp=./qa/jtreg/JTlib-tmp ./qa/jtreg/</p>
           </div>
         </td>
         <td valign="top">