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 this from `rave-integration-tests`
directory.

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/`