Added: websites/staging/rave/trunk/content/source.html ============================================================================== --- websites/staging/rave/trunk/content/source.html (added) +++ websites/staging/rave/trunk/content/source.html Mon Mar 26 19:51:18 2012 @@ -0,0 +1,147 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<html> +<head> +<!-- + + 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. +--> + <link rel="shortcut icon" href="/rave/images/RAVE-icon.ico" type="image/x-icon" /> + <link href="/rave/css/rave.css" rel="stylesheet" type="text/css"> + <title>Getting Started</title> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +</head> + +<body> + <div id="banner"> + <img id="logo" alt="Apache Rave" src="/rave/images/RAVE-logo_main-logo-small.png"/> + </div> + + <div id="navigation"> + <h1 id="general">General</h1> +<ul> +<li><a href="/rave/index.html">About</a></li> +<li><a href="/rave/documentation/index.html">Documentation</a></li> +<li><a href="/rave/downloads.html">Downloads</a></li> +<li><a href="/rave/license.html">License</a></li> +</ul> +<h1 id="community">Community</h1> +<ul> +<li><a href="/rave/get-involved.html">Get Involved</a></li> +<li><a href="/rave/mailing-lists.html">Mailing Lists</a></li> +<li><a href="/rave/people.html">People</a></li> +</ul> +<h1 id="development">Development</h1> +<ul> +<li><a href="/rave/source.html">Getting Started</a></li> +<li><a href="/rave/ide-settings-and-debugging.html">IDE Settings and debugging</a></li> +<li><a href="/rave/release-management.html">Release Management</a></li> +<li><a href="/rave/issue-management.html">Issue Tracker</a></li> +<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/";>Continuous Integration</a></li> +<li><a href="https://analysis.apache.org/dashboard/index/58996";>Sonar Dashboard</a></li> +<li><a href="/rave/edit-website.html">Website</a></li> +</ul> +<h1 id="asf">ASF</h1> +<ul> +<li><a href="http://www.apache.org";>Apache Software Foundation</a></li> +<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> +<li><a href="http://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a></li> +<li><a href="http://www.apache.org/security/";>Security</a></li> +</ul> + </div> + + <div id="content"> + <h1 class="title">Getting Started</h1> + <p>We use <a href="http://subversion.apache.org";>Apache Subversion</a> for version control. You can <a href="http://svn.apache.org/viewvc/rave/";>browse our +repository</a> in your web browser.</p> +<h2 id="getting-the-source-code">Getting the source code</h2> +<p>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 <a href="ide-settings-and-debugging.html">separate instructions</a> for you.</p> +<h3 id="anonymous-access">Anonymous access</h3> +<div class="codehilite"><pre><span class="n">svn</span> <span class="n">co</span> <span class="n">http:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/rave/</span><span class="n">trunk</span> <span class="n">rave</span> +</pre></div> + + +<h3 id="developer-access">Developer access</h3> +<div class="codehilite"><pre><span class="n">svn</span> <span class="n">co</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/rave/</span><span class="n">trunk</span> <span class="n">rave</span> +</pre></div> + + +<h2 id="building-and-running">Building and Running</h2> +<p>To build from source code:</p> +<h3 id="requirements">Requirements:</h3> +<ul> +<li>Sources compilation require Java SE 6 or higher.</li> +<li>The project is built with Apache Maven 3+ (version 3.0.3 or later is <em>required</em>) <a href="http://maven.apache.org/download.html";>Download</a> and <a href="http://maven.apache.org/download.html#Installation";>install</a></li> +</ul> +<h3 id="apache-rave-project">Apache Rave Project</h3> +<p>To build the Apache Rave project invoke maven from the project root directory:</p> +<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">install</span> +</pre></div> + + +<p>If you have any problems relating to the rave-master project, see the +"Apache Rave Master Project" section at the end of this document.</p> +<h3 id="deploying-and-running-on-tomcat">Deploying and Running on Tomcat</h3> +<p>To run a local Tomcat instance with rave-shindig and rave-portal and Wookie deployed:</p> +<ul> +<li> +<p>navigate to the rave-portal subdirectory and invoke:</p> +<p><code>mvn cargo:start</code></p> +</li> +<li> +<p>open url http://localhost:8080/portal in a browser</p> +</li> +<li>press Ctrl-C in the console to stop Tomcat again</li> +</ul> +<h3 id="logging-in">Logging in</h3> +<p>Once the server is running:</p> +<ul> +<li>localhost:8080/portal</li> +<li>login as one of the following test users (password is same as username)<ul> +<li>canonical (this user has admin rights)</li> +<li>john.doe</li> +<li>jane.doe</li> +<li>OpenID: http://rave2011.myopenid.com/ (password rave2011)</li> +</ul> +</li> +</ul> +<h3 id="apache-rave-master-project">Apache Rave Master Project</h3> +<p>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.</p> +<p>If so needed, the Apache Rave Master project can be checked out from:</p> +<div class="codehilite"><pre> <span class="n">http:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/rave/</span><span class="n">rave</span><span class="o">-</span><span class="n">master</span><span class="o">-</span><span class="n">pom</span><span class="o">/</span><span class="n">trunk</span> <span class="n">rave</span><span class="o">-</span><span class="n">master</span><span class="o">-</span><span class="n">pom</span><span class="o">.</span> +</pre></div> + + +<p>After check out, cd into rave-master-pom and invoke maven to install it using:</p> +<div class="codehilite"><pre> <span class="nv">$mvn</span> <span class="n">install</span> +</pre></div> + </div> + + <div id="footer"> + <div class="copyright"> + <p> + Copyright © 2011 The Apache Software Foundation, Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache License, Version 2.0</a>. + <br /> + Apache and the Apache feather logos are trademarks of The Apache Software Foundation. + </p> + </div> + </div> + +</body> +</html>
