river-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r778971 - /websites/staging/river/trunk/content/building-river.html
Date Tue, 09 Nov 2010 14:49:30 GMT
Author: buildbot
Date: Tue Nov  9 14:49:30 2010
New Revision: 778971

URL: http://svn.apache.org/viewvc?rev=778971&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=778971&r1=778970&r2=778971&view=diff
==============================================================================
--- websites/staging/river/trunk/content/building-river.html (original)
+++ websites/staging/river/trunk/content/building-river.html Tue Nov  9 14:49:30 2010
@@ -70,10 +70,7 @@
           <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><strong>The build process does not place nicely if you have spaces in your
path names</strong></p>
 <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>
@@ -88,8 +85,25 @@ path names</p>
 <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>
+<h3 id="using_the_ant_script">Using the Ant script</h3>
+<p>The QA tests can also be run from the Ant script.</p>
+<p>Make sure that you have the following in your build.properties file.</p>
+<div class="codehilite"><pre><span class="n">river</span><span
class="o">.</span><span class="n">home</span><span class="o">=</span><span
class="nv">$RIVER_HOME</span>
+<span class="n">jtreg</span><span class="o">.</span><span class="n">home</span><span
class="o">=</span><span class="sr">/path/</span><span class="n">to</span><span
class="sr">/jtreg/i</span><span class="n">nstall</span>
+<span class="n">jdk1</span><span class="o">.</span><span class="mi">5</span><span
class="o">.</span><span class="n">home</span><span class="o">=</span><span
class="sr">/path/</span><span class="n">to</span><span class="o">/</span><span
class="n">java1</span><span class="o">.</span><span class="mi">5</span>

+<span class="n">jtreg</span><span class="o">.</span><span class="n">dir</span><span
class="o">=</span><span class="nv">$RIVER_HOME</span><span class="sr">/jtsk/</span><span
class="n">qa</span><span class="o">/</span><span class="n">jtreg</span>
+</pre></div>
+
+
+<p>Execute the following:</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="nv">$RIVER_HOME</span>
+<span class="n">cd</span> <span class="n">qa</span><span class="o">.</span><span
class="n">run</span>
+</pre></div>
+
+
+<p>The specific tests and categories of test which are run is set by <strong>doing
something which I can't remember</strong>.</p>
+<h3 id="using_jtreg_directly">Using jtreg directly</h3>
 <p>You must first download and install jtreg following the instructions on their site.</p>
-<p><em>I believe the following is not 100% correct yet.</em></p>
 <p>Execute the following:</p>
 <div class="codehilite"><pre><span class="n">cd</span> <span class="nv">$RIVER_HOME</span>
 <span class="n">cd</span> <span class="n">qa</span><span class="o">/</span><span
class="n">jtreg</span>
@@ -119,40 +133,7 @@ path names</p>
 </pre></div>
 
 
-<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>
+<p>The specific tests and categories of test which are run is set by <strong>doing
something which I can't remember</strong>.</p>
           </div>
         </td>
         <td valign="top">



Mime
View raw message