Getting the source code¶
The instructions on this page will help you get started using command line tools. If you prefer to work in an IDE then we have separate instructions for you.
git clone https://git-wip-us.apache.org/repos/asf/rave
Building and Running¶
To build from source code:
- Sources compilation require Java SE 6 or higher.
- The project is built with Apache Maven 3+ (version 3.0.3 or later is required) Download and install
Apache Rave Project¶
To build the Apache Rave project invoke maven from the project root directory:
If you have any problems relating to the rave-master project, see the "Apache Rave Master Project" section at the end of this document.
If Maven can't find the artifacts oauth-httpclient4 or caja, you are probably behind a Maven proxy (repository manager) that doesn't know about the corresponding repositories. Rave depends transitively on these artifacts via Shindig. Shindig, thus adds repositories via their pom.xml files. If your proxy doesn't know about these repositories you have to add these URLs in your proxy-configuration:
Deploying and Running on Tomcat¶
To run a local Tomcat instance with rave-shindig and rave-portal and Wookie deployed:
navigate to the rave-portal subdirectory and invoke:
If you are behind a proxy, then you can specify it with the following command
mvn -Dcargo.args="-Dhttp.proxyHost=PROXYHOST -Dhttp.proxyPort=PROXYPORT -Dhttp.nonProxyHosts=NONPROXYHOST" cargo:run
- open url http://localhost:8080/portal in a browser
- press Ctrl-C in the console to stop Tomcat again
Once the server is running:
- login as one of the following test users (password is same as username)
- canonical (this user has admin rights)
- OpenID: http://rave2011.myopenid.com/ (password rave2011)
Apache Rave Master Project¶
The Apache Rave project depends on the separate Apache Rave Master project which defines general and global settings for the whole of the Apache Rave project, independent of a specific release. As its rave-master-pom is already published to the Apache Snapshots repository, there is no need to check it out manually and build it locally yourself, unless changes are needed on general and global level.
If so needed, the Apache Rave Master project can be checked out from:
After check out, cd into rave-master-pom and invoke maven to install it using:
Running the integration tests¶
See the article about integration tests