Author: buildbot
Date: Fri Oct 17 00:32:48 2014
New Revision: 926027
Log:
Staging update by buildbot for cayenne
Modified:
websites/staging/cayenne/trunk/content/ (props changed)
websites/staging/cayenne/trunk/content/dev/building-cayenne.html
websites/staging/cayenne/trunk/content/dev/running-unit-tests.html
Propchange: websites/staging/cayenne/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Oct 17 00:32:48 2014
@@ -1 +1 @@
-1628495
+1632455
Modified: websites/staging/cayenne/trunk/content/dev/building-cayenne.html
==============================================================================
--- websites/staging/cayenne/trunk/content/dev/building-cayenne.html (original)
+++ websites/staging/cayenne/trunk/content/dev/building-cayenne.html Fri Oct 17
00:32:48 2014
@@ -102,6 +102,14 @@
<li>Make sure <a href="http://maven.apache.org/";>Maven</a> is installed.</li>
<li><a href="/dev/code-repository.html">Get the source code</a>.</li>
</ul>
+<h3 id="recommended-maven-settings">Recommended Maven Settings</h3>
+<p>Here are the MAVEN_OPTS that should be used for the build. MAVEN_OPTS
variable can either be exported in a shell,
+or placed in <em>$HOME/.mavenrc</em>. Optimal values vary from platform to
platform and between Cayenne versions,
+but these should probably work for everyone:</p>
+<div class="codehilite"><pre><span class="n">MAVEN_OPTS</span><span
class="p">=</span>"<span class="o">-</span><span
class="n">Djava</span><span class="p">.</span><span class="n">net</span><span
class="p">.</span><span class="n">preferIPv4Stack</span><span
class="p">=</span><span class="n">true</span> <span class="o">-</span><span
class="n">Xms512m</span> <span class="o">-</span><span class="n">Xmx512m</span>
<span class="o">-</span><span class="n">XX</span><span class="p">:</span><span
class="n">MaxPermSize</span><span class="p">=</span>128<span
class="n">m</span>"
+</pre></div>
+
+
<h3 id="building-with-maven">Building with Maven</h3>
<p>Depending on what you want to do, there are various flavors of the builds
discussed below. All builds should be executed from the root folder of the
source checkout.</p>
Modified: websites/staging/cayenne/trunk/content/dev/running-unit-tests.html
==============================================================================
--- websites/staging/cayenne/trunk/content/dev/running-unit-tests.html
(original)
+++ websites/staging/cayenne/trunk/content/dev/running-unit-tests.html Fri Oct
17 00:32:48 2014
@@ -96,22 +96,16 @@
<hr>
<div id="content">
- <p>Cayenne provides a comprehensive suite of unit tests. To execute
unit tests
+ <h2 id="running-unit-tests">Running Unit Tests</h2>
+<p>Cayenne provides a comprehensive suite of unit tests. To execute unit tests
you must first get Cayenne from SVN, install JDK 1.5 and obtain the latest
Maven.</p>
-<p><a name="RunningUnitTests-Prerequisites"></a></p>
-<h2 id="prerequisites">Prerequisites</h2>
-<p>On some systems (e.g. Ubuntu 8.x) the following line needs to be placed in
-<em>"~/.mavenrc"</em> or otherwise there will be test failures in the unit
tests
-relying on JGroups. This is a workaround of a known JVM bug:</p>
-<div class="codehilite"><pre><span class="n">MAVEN_OPTS</span><span
class="p">=</span>"<span class="o">-</span><span
class="n">Djava</span><span class="p">.</span><span class="n">net</span><span
class="p">.</span><span class="n">preferIPv4Stack</span><span
class="p">=</span><span class="n">true</span>"
-</pre></div>
-
-
-<h2 id="running-against-embedded-hsqldb">Running Against Embedded HSQLDB</h2>
+<h3 id="prerequisites">Prerequisites</h3>
+<p>Maven <a href="/dev/building-cayenne.html">build prerequisites and
recommended settings</a> apply here. </p>
+<h3 id="running-against-embedded-hsqldb">Running Against Embedded HSQLDB</h3>
<p>No extra setup is required. Just run Maven:</p>
<div class="codehilite"><pre>$ <span class="n">cd</span> <span
class="n">cayenne</span>
-$ <span class="n">mvn</span> <span class="n">install</span><span
class="p">{</span><span class="n">noformat</span><span class="p">}</span>
+$ <span class="n">mvn</span> <span class="n">install</span>
</pre></div>
@@ -121,7 +115,7 @@ $ <span class="n">mvn</span> <span class
</pre></div>
-<h2 id="running-against-a-specific-database">Running Against a Specific
Database</h2>
+<h3 id="running-against-a-specific-database">Running Against a Specific
Database</h3>
<h4 id="step-1-install-jdbc-driver-jars-in-a-local-maven-repo">Step 1. Install
JDBC Driver Jars in a Local Maven Repo</h4>
<p>Most commercial drivers are not present in the public Maven repositories.
So they have to be installed by the tester locally. The group and artifact
@@ -213,17 +207,6 @@ the example above). Note that in this ca
<em>cayenneTestConnection</em>. E.g.:</p>
<div class="codehilite"><pre>$ <span class="n">mvn</span> <span
class="n">test</span> <span class="o">-</span><span
class="n">DcayenneTestConnection</span><span class="p">=</span><span
class="n">derby</span>
</pre></div>
-
-
-<blockquote>
-<p><strong>Note.</strong> <em>If you are testing Cayenne 3.0, use
-Dcayenne.test.connection instead
-of -DcayenneTestConnection. Also it is only possible to pass the DB
-properties via "connection.properties" file, and not possible to pass them
-on command line</em></p>
-</blockquote>
-<p><a name="RunningUnitTests-Lookattestresults"></a></p>
-<h2 id="look-at-test-results">Look at test results</h2>
-<p>To look for failed tests, grep the output files.</p>
<hr>
<p id="footer">Copyright © 2001-2012 Apache Software Foundation.
Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache
Cayenne project logo are trademarks of The Apache Software Foundation. <a
href="/privacy-policy.html">Privacy policy</a>.
</div>
