Apache Rave (incubating) - README.txt Licensed under Apache License 2.0 - http://www.apache.org/licenses/LICENSE-2.

0 -------------------------------------------------------------------------------About ===== Apache Rave is A new WEb And SOcial Mashup Engine. It will provide an out-of-the-box as well as an extendible lightweight Java platform to host, serve and aggregate (Open)Social Gadgets and services through a highly customizable and Web 2.0 friendly front-end. Rave is targeted as engine for internet and intranet portals and as building block to provide context-aware personalization and collaboration features for multi-site/multi-channel (mobile) oriented and content driven websites and (social) network oriented services and platforms. For the OpenSocial container and services the (Java) Apache Shindig will be integrated. At a later stage further generalization is envisioned to also transparently support W3C Widgets using Apache Wookie. Disclaimer ========== Apache Rave is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator PMC. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF. Release Notes ============= - Added new runtime capability to override shindig host. Add -Dshindig.host=se rvername to $JAVA_OPTS to override the localhost setting Getting Started =============== Please visit the project website for the latest information: http://incubator.apache.org/rave/ Along with the developer mailing list archive: http://mail-archives.apache.org/mod_mbox/incubator-rave-dev/ System Requirements =================== You need a platform that supports Java SE 6 or later. Building and running ==================== To build from source code: - Requirements: Sources compilation require Java SE 6 or higher. The project is built with Apache Maven 3+ (suggested is 3.0.3). You need to download and install Maven 3 from: http://maven.apache.org/ - The Rave project itself (this one) depends on the separate Rave Master proje ct which defines general and global settings for the whole of the Rave project, independent of a specific release. As its rave-master-pom is already published to the Apache Snapshots reposito

ry, 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 Rave Master project can be checked out from: http://svn.apache.org/repos/asf/incubator/rave/rave-master-pom/trunk ravemaster-pom After check out, cd into rave-master-pom and invoke maven to install it usin g: $mvn install - To build the Rave project invoke maven in the root directory: $mvn install To run a local Tomcat instance with rave-shindig and rave-portal deployed: - from the top-level rave directory, use the command $mvn cargo:start -f rave-portal/pom.xml - alternatively, navigate to the rave-portal subdirectory and invoke: $mvn cargo:start - open url http://localhost:8080/ in a browser - press Ctrl-C in the console to stop Tomcat again --------------------------------------------------------------------------------