Author: jasha
Date: Sat May 5 12:28:11 2012
New Revision: 1334412
URL: http://svn.apache.org/viewvc?rev=1334412&view=rev
Log:
RAVE-610 document how to run the integration tests
Added:
rave/site/trunk/content/integration-tests.mdtext
Modified:
rave/site/trunk/content/source.mdtext
Added: rave/site/trunk/content/integration-tests.mdtext
URL:
http://svn.apache.org/viewvc/rave/site/trunk/content/integration-tests.mdtext?rev=1334412&view=auto
==============================================================================
--- rave/site/trunk/content/integration-tests.mdtext (added)
+++ rave/site/trunk/content/integration-tests.mdtext Sat May 5 12:28:11 2012
@@ -0,0 +1,50 @@
+Title: Integration tests
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Individual classes and methods should be covered with JUnit tests. In order to
check the overall features of the Apache
+Rave project, integration tests are needed. For Apache Rave we use
[JBehave](http://jbehave.org) to develop and run
+test stories. JBehave uses Selenium to start a browser session and perform the
tests in the browser (Mozilla Firefox).
+
+## System requirements
+ * Java 6 or up
+ * [Maven 3](http://maven.apache.org)
+
+Running the integration tests requires more memory than a normal build. It is
recommended to raise the memory settings:
+
+ export MAVEN_OPTS="-Xmx768m -XX:MaxPermSize=256m"
+
+## Run all tests
+
+The integration tests can be triggered as integral part of the portal build
from the `rave-project` directory:
+
+ mvn -Pintegration-tests
+
+If you only want to run the integration tests without building the whole
project execute from `rave-integration-tests`
+directory:
+
+ mvn clean integration-test
+
+Maven will delete the existing H2 database in `/tmp`, start up the portal, run
all tests and then shut down the portal.
+
+## Run individual test stories
+
+Individual stories that extend
`org.apache.rave.integrationtests.stories.PortalStories` can be run as junit
tests in
+your IDE.
+
+For individual stories Maven will not automatically start or stop the portal.
You need a running portal on
+`http://localhost:8080/`
\ No newline at end of file
Modified: rave/site/trunk/content/source.mdtext
URL:
http://svn.apache.org/viewvc/rave/site/trunk/content/source.mdtext?rev=1334412&r1=1334411&r2=1334412&view=diff
==============================================================================
--- rave/site/trunk/content/source.mdtext (original)
+++ rave/site/trunk/content/source.mdtext Sat May 5 12:28:11 2012
@@ -68,6 +68,7 @@ Once the server is running:
* canonical (this user has admin rights)
* john.doe
* jane.doe
+ * johnldap
* OpenID: http://rave2011.myopenid.com/ (password rave2011)
### Apache Rave Master Project
@@ -83,11 +84,15 @@ If so needed, the Apache Rave Master pro
After check out, cd into rave-master-pom and invoke maven to install it using:
- $mvn install
+ mvn install
+### Running the integration tests
+
+See the article about [integration tests][6]
[1]: http://subversion.apache.org
[2]: http://svn.apache.org/viewvc/rave/
[3]: ide-settings-and-debugging.html
[4]: http://maven.apache.org/download.html
- [5]: http://maven.apache.org/download.html#Installation
\ No newline at end of file
+ [5]: http://maven.apache.org/download.html#Installation
+ [6]: integration-tests.html
\ No newline at end of file
