You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@rave.apache.org by bu...@apache.org on 2011/07/06 11:42:42 UTC
svn commit: r792318 - in /websites/staging/rave/trunk/content/rave: ./
docs/governance/
Author: buildbot
Date: Wed Jul 6 09:42:41 2011
New Revision: 792318
Log:
Staging update by buildbot
Added:
websites/staging/rave/trunk/content/rave/ide-settings-and-debugging.html
Modified:
websites/staging/rave/trunk/content/rave/docs/governance/consensusBuilding.html
websites/staging/rave/trunk/content/rave/docs/governance/lazyConsensus.html
websites/staging/rave/trunk/content/rave/docs/governance/voting.html
websites/staging/rave/trunk/content/rave/downloads.html
websites/staging/rave/trunk/content/rave/edit-website.html
websites/staging/rave/trunk/content/rave/get-involved.html
websites/staging/rave/trunk/content/rave/index.html
websites/staging/rave/trunk/content/rave/license.html
websites/staging/rave/trunk/content/rave/mailing-lists.html
websites/staging/rave/trunk/content/rave/people.html
websites/staging/rave/trunk/content/rave/release-management.html
websites/staging/rave/trunk/content/rave/release-process.html
websites/staging/rave/trunk/content/rave/release-setup.html
websites/staging/rave/trunk/content/rave/source.html
Modified: websites/staging/rave/trunk/content/rave/docs/governance/consensusBuilding.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/docs/governance/consensusBuilding.html (original)
+++ websites/staging/rave/trunk/content/rave/docs/governance/consensusBuilding.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/docs/governance/lazyConsensus.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/docs/governance/lazyConsensus.html (original)
+++ websites/staging/rave/trunk/content/rave/docs/governance/lazyConsensus.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/docs/governance/voting.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/docs/governance/voting.html (original)
+++ websites/staging/rave/trunk/content/rave/docs/governance/voting.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/downloads.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/downloads.html (original)
+++ websites/staging/rave/trunk/content/rave/downloads.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/edit-website.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/edit-website.html (original)
+++ websites/staging/rave/trunk/content/rave/edit-website.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/get-involved.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/get-involved.html (original)
+++ websites/staging/rave/trunk/content/rave/get-involved.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Added: websites/staging/rave/trunk/content/rave/ide-settings-and-debugging.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/ide-settings-and-debugging.html (added)
+++ websites/staging/rave/trunk/content/rave/ide-settings-and-debugging.html Wed Jul 6 09:42:41 2011
@@ -0,0 +1,212 @@
+<!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>IDE Settings and Debugging</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+
+<body>
+ <div id="banner">
+ <img id="logo" alt="Apache Rave (Incubating)" src="/rave/images/RAVE-logo_main-logo-small.png"/>
+ </div>
+
+ <div id="navigation">
+ <h1 id="general">General</h1>
+<ul>
+<li><a href="index.html">About</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li><a href="http://incubator.apache.org/projects/rave.html">Incubator page</a></li>
+<li><a href="license.html">License</a></li>
+</ul>
+<h1 id="community">Community</h1>
+<ul>
+<li><a href="get-involved.html">Get Involved</a></li>
+<li><a href="mailing-lists.html">Mailing Lists</a></li>
+<li><a href="people.html">People</a></li>
+</ul>
+<h1 id="development">Development</h1>
+<ul>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
+<li><a href="release-management.html">Release Management</a></li>
+<li><a href="https://issues.apache.org/jira/browse/rave">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="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>
+ <a alt="Apache Incubator" href="http://incubator.apache.org">
+ <img id="asf-logo" alt="Apache Incubator" src="/rave/images/apache-incubator-logo.png"/>
+ </a>
+ </div>
+
+ <div id="content">
+ <h1 class="title">IDE Settings and Debugging</h1>
+ <h2 id="configuring_eclipse">Configuring Eclipse</h2>
+<ul>
+<li>Install <a href="http://download.eclipse.org/webtools/downloads/">Eclipse for Java EE</a></li>
+<li>Install M2Eclipse from the <a href="http://m2eclipse.sonatype.org/sites/m2e">Update Site</a></li>
+<li>Install <a href="http://subclipse.tigris.org/update_1.6.x/">Subclipse</a></li>
+<li>File -> Import -> Maven -> Check Out maven project from SCM<ul>
+<li>select SVN</li>
+<li>URL is https://svn.apache.org/repos/asf/incubator/rave/trunk</li>
+</ul>
+</li>
+<li>Ensure rave-portal is building without errors<ul>
+<li>you may need to update dependencies first</li>
+</ul>
+</li>
+<li>With m2eclipse you can configure it to automatically resolve
+ (download) missing dependencies if you have set Eclipse
+ Preferences/Maven/Offline to false (unchecked), which should be
+ the default. We recommend you always set that preference to true
+ (checked) as this one specific feature of m2eclipse is often a
+ performance drain (Update Maven projects on startup being the
+ other).</li>
+</ul>
+<p>Now the application is building you probably want to be able to develop and debug
+Rave from inside Eclipse. This gives a faster turnaround in the
+edit/build/deploy cycle.</p>
+<p>There are a few different ways to do this:</p>
+<h3 id="using_remote_debugging_and_the_eclipse_filesync_plugin">Using Remote debugging and the Eclipse FileSync plugin</h3>
+<p>The OSS <a href="http://andrei.gmxhome.de/filesync/index.html">Eclipse FileSync</a> plugin can automatically synchronize (re)source changes
+(e.g. .jsp, .css, .js) made in the Eclipse IDE directly to the runtime tomcat deployment
+started (separately) through maven cargo:start. And you can attach the Eclipse debugger
+to the cargo started Tomcat instance (see above) as remote application on default port 8000.</p>
+<p>The <a href="http://code.google.com/p/mavenfilesync/">maven-filesync-plugin</a> is pre-configured to generate default Eclipse FileSync
+configurations for the rave-shindig and rave-portal projects, mapping their source folders
+src/main/webapps and src/main/resources to synchronize (copy) changes to the Tomcat deployment
+environment under rave-portal/target/Tomcat6x, so this will work out-of-the-box.</p>
+<p>Prerequisite: install the Eclipse FileSync plugin from its <a href="http://andrei.gmxhome.de/eclipse/">Update Site</a></p>
+<p>The first time you build the Rave project with maven, the maven-filesync-plugin
+will generate this default FileSync configuration for the FileSync plugin.
+Afterwards you only have to refresh the Eclipse projects once to have them recognize this.
+Thereafter you can customize the synchronization configuration manually within Eclipse through
+the project properties dialog.
+Note: manual changes will not be overridden anymore by the maven-filesync-plugin once they
+exist. Furthermore, if you are not using Eclipse, this plugin will simply skip its execution.</p>
+<p>If you have "Build automatically" enabled within Eclipse, the FileSync plugin will synchronize
+changes automatically after you saved them in Eclipse. Otherwise you can force a manual
+synchronization from the project (rave-portal or rave-shindig) its context menu actions.</p>
+<h3 id="using_remote_debugging_with_the_jrebel_plugin">Using Remote debugging with the JRebel plugin</h3>
+<p>Using <a href="http://www.zeroturnaround.com/jrebel/how-to-install-jrebel-for-eclipse/">JRebel</a> provides one the best remote debugging and runtime code change synchronizing
+solutions, as well as can handle resource (non-code) change synchronization.</p>
+<p>However, JRebel is not free. If you are a committer you can get a free licence, but if not you
+will need to buy your own licence (you can try out a free 30 day trial licence first).</p>
+<h4 id="setting_up_the_jrebel_plugin">Setting up the JRebel plugin</h4>
+<p>To enable JRebel for the Rave project add the following profile to the rave-project (root) pom:</p>
+<div class="codehilite"><pre><span class="nt"><profile></span>
+ <span class="nt"><id></span>jrebel<span class="nt"></id></span>
+ <span class="nt"><activation></span>
+ <span class="nt"><property></span>
+ <span class="nt"><name></span>jrebel<span class="nt"></name></span>
+ <span class="nt"></property></span>
+ <span class="nt"></activation></span>
+ <span class="nt"><properties></span>
+ <span class="nt"><javaagent></span>-javaagent:<span class="cp">${</span><span class="n">env</span><span class="o">.</span><span class="n">REBEL_HOME</span><span class="cp">}</span>/jrebel.jar<span class="nt"></javaagent></span>
+ <span class="nt"></properties></span>
+ <span class="nt"><build></span>
+ <span class="nt"><plugins></span>
+ <span class="nt"><plugin></span>
+ <span class="nt"><groupId></span>org.zeroturnaround<span class="nt"></groupId></span>
+ <span class="nt"><artifactId></span>jrebel-maven-plugin<span class="nt"></artifactId></span>
+ <span class="nt"><version></span>1.0.7<span class="nt"></version></span>
+ <span class="nt"><executions></span>
+ <span class="nt"><execution></span>
+ <span class="nt"><id></span>generate-rebel-xml<span class="nt"></id></span>
+ <span class="nt"><phase></span>process-resources<span class="nt"></phase></span>
+ <span class="nt"><goals></span>
+ <span class="nt"><goal></span>generate<span class="nt"></goal></span>
+ <span class="nt"></goals></span>
+ <span class="nt"></execution></span>
+ <span class="nt"></executions></span>
+ <span class="nt"></plugin></span>
+ <span class="nt"></plugins></span>
+ <span class="nt"></build></span>
+<span class="nt"></profile></span>
+</pre></div>
+
+
+<p>To build the Rave project with JRebel descriptors run</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">install</span> <span class="o">-</span><span class="n">Djrebel</span>
+</pre></div>
+
+
+<p>The same profile also takes care of enabling the JRebel java agent when running Cargo.
+To run Cargo with JRebel enabled, use the following command from the rave-portal directory:</p>
+<div class="codehilite"><pre><span class="n">mvn</span> <span class="n">cargo:run</span> <span class="o">-</span><span class="n">Djrebel</span>
+</pre></div>
+
+
+<p>Note: using both the Eclipse FileSync plugin for (only) resources synchronization and JRebel
+for the hot-code replacement probably will provide the best combination with the least
+configuration overhead.</p>
+<h3 id="using_eclipse_wtp">Using Eclipse WTP</h3>
+<p>The Rave project can also be deployed through Eclipse WTP, and might be adequate for some, but it
+it is less functional and sometimes a bit quirky. Furthermore, because of (current) limitations
+of the m2eclipse WTP integration for maven war overlays (which the rave-shindig project uses),
+you'll need to use some workarounds to make it workable.</p>
+<p>Prerequisite: Install m2eclipse-wtp integration from the m2eclipse-extras <a href="http://m2eclipse.sonatype.org/sites/m2e-extras">Update Site</a></p>
+<p>If you already imported the Rave projects in Eclipse, first remove them (but don't need to delete them)
+and then (re)import the Rave project as Maven projects to get the m2eclipse-wtp integration enabled. </p>
+<p>Then you need to follow these steps:</p>
+<ul>
+<li>Right click on the rave-shindig project and select Properties</li>
+<li>Open the "Deployment Assembly" property</li>
+<li>Press Add, select Directive Type "Folder", and select the
+ target/rave-shindig-0.1-incubating-SNAPSHOT folder.
+ (do a "mvn install" in rave-project first for this folder to be available)</li>
+<li>configure the correct Context root paths for rave-portal
+ ("portal") and rave-shindig ("/") in their Eclipse project
+ properties under "Web Project Settings"</li>
+</ul>
+<p>Now we need to add the the two webapps to a pre-setup (Tomcat 6) server:</p>
+<ul>
+<li>Windows->Show View->Other...</li>
+<li>Server->Servers</li>
+<li>OK</li>
+<li>In the servers view right click your chosen server and slect Add and Remove...</li>
+<li>Add rave-shindig and rave-portal</li>
+<li>Start the server</li>
+<li>Now see the instructions above for logging into the server</li>
+</ul>
+ </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>
Modified: websites/staging/rave/trunk/content/rave/index.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/index.html (original)
+++ websites/staging/rave/trunk/content/rave/index.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/license.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/license.html (original)
+++ websites/staging/rave/trunk/content/rave/license.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/mailing-lists.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/mailing-lists.html (original)
+++ websites/staging/rave/trunk/content/rave/mailing-lists.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/people.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/people.html (original)
+++ websites/staging/rave/trunk/content/rave/people.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/release-management.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/release-management.html (original)
+++ websites/staging/rave/trunk/content/rave/release-management.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/release-process.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/release-process.html (original)
+++ websites/staging/rave/trunk/content/rave/release-process.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/release-setup.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/release-setup.html (original)
+++ websites/staging/rave/trunk/content/rave/release-setup.html Wed Jul 6 09:42:41 2011
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
Modified: websites/staging/rave/trunk/content/rave/source.html
==============================================================================
--- websites/staging/rave/trunk/content/rave/source.html (original)
+++ websites/staging/rave/trunk/content/rave/source.html Wed Jul 6 09:42:41 2011
@@ -20,7 +20,7 @@
-->
<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>Source Control</title>
+ <title>Getting Started</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
@@ -45,7 +45,8 @@
</ul>
<h1 id="development">Development</h1>
<ul>
-<li><a href="source.html">Source Code</a></li>
+<li><a href="source.html">Getting Started</a></li>
+<li><a href="ide-settings-and-debugging.html">IDE Settings and debugging</a></li>
<li><a href="release-management.html">Release Management</a></li>
<li><a href="https://issues.apache.org/jira/browse/rave">Issue Tracker</a></li>
<li><a href="https://builds.apache.org/hudson/view/M-R/view/Rave/">Continuous Integration</a></li>
@@ -65,7 +66,7 @@
</div>
<div id="content">
- <h1 class="title">Source Control</h1>
+ <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/incubator/rave/">browse our
repository</a> in your web browser.</p>
<h2 id="getting_the_source_code">Getting the source code</h2>
@@ -125,91 +126,6 @@ needed on general and global level.</p>
</ul>
</li>
</ul>
-<h3 id="configuring_eclipse">Configuring Eclipse</h3>
-<ul>
-<li>Install <a href="http://download.eclipse.org/webtools/downloads/">Eclipse for Java EE</a></li>
-<li>Install M2Eclipse from the <a href="http://m2eclipse.sonatype.org/sites/m2e">Update Site</a></li>
-<li>Install <a href="http://subclipse.tigris.org/update_1.6.x/">Subclipse</a></li>
-<li>File -> Import -> Maven -> Check Out maven project from SCM<ul>
-<li>select SVN</li>
-<li>URL is https://svn.apache.org/repos/asf/incubator/rave/trunk</li>
-</ul>
-</li>
-<li>Ensure rave-portal is building without errors<ul>
-<li>you may need to update dependencies first</li>
-</ul>
-</li>
-<li>With m2eclipse you can configure it to automatically resolve
- (download) missing dependencies if you have set Eclipse
- Preferences/Maven/Offline to false (unchecked), which should be
- the default. We recommend you always set that preference to true
- (checked) as this one specific feature of m2eclipse is often a
- performance drain (Update Maven projects on startup being the
- other).</li>
-</ul>
-<p>Now the application is building you probably want to be able to develop and debug
-Rave from inside Eclipse. This gives a faster turnaround in the
-edit/build/deploy cycle.</p>
-<p>There are a few different ways to do this:</p>
-<h4 id="using_remote_debugging_and_the_eclipse_filesync_plugin">Using Remote debugging and the Eclipse FileSync plugin</h4>
-<p>The OSS <a href="http://andrei.gmxhome.de/filesync/index.html">Eclipse FileSync</a> plugin can automatically synchronize (re)source changes
-(e.g. .jsp, .css, .js) made in the Eclipse IDE directly to the runtime tomcat deployment
-started (separately) through maven cargo:start. And you can attach the Eclipse debugger
-to the cargo started Tomcat instance (see above) as remote application on default port 8000.</p>
-<p>The <a href="http://code.google.com/p/mavenfilesync/">maven-filesync-plugin</a> is pre-configured to generate default Eclipse FileSync
-configurations for the rave-shindig and rave-portal projects, mapping their source folders
-src/main/webapps and src/main/resources to synchronize (copy) changes to the Tomcat deployment
-environment under rave-portal/target/Tomcat6x, so this will work out-of-the-box.</p>
-<p>Prerequisite: install the Eclipse FileSync plugin from its <a href="http://andrei.gmxhome.de/eclipse/">Update Site</a></p>
-<p>The first time you build the Rave project with maven, the maven-filesync-plugin
-will generate this default FileSync configuration for the FileSync plugin.
-Afterwards you only have to refresh the Eclipse projects once to have them recognize this.
-Thereafter you can customize the synchronization configuration manually within Eclipse through
-the project properties dialog.
-Note: manual changes will not be overridden anymore by the maven-filesync-plugin once they
-exist. Furthermore, if you are not using Eclipse, this plugin will simply skip its execution.</p>
-<p>If you have "Build automatically" enabled within Eclipse, the FileSync plugin will synchronize
-changes automatically after you saved them in Eclipse. Otherwise you can force a manual
-synchronization from the project (rave-portal or rave-shindig) its context menu actions.</p>
-<h4 id="using_remote_debugging_with_the_jrebel_plugin">Using Remote debugging with the JRebel plugin</h4>
-<p>Using <a href="http://www.zeroturnaround.com/jrebel/how-to-install-jrebel-for-eclipse/">JRebel</a> provides one the best remote debugging and runtime code change synchronizing
-solutions, as well as can handle resource (non-code) change synchronization.</p>
-<p>However, JRebel is not free. If you are a committer you can get a free licence, but if not you
-will need to buy your own licence (you can try out a free 30 day trial licence first).</p>
-<p>Setting up and configuring JRebel is not pre-configured for the Rave project but by following
-the instructions from the JRebel manual this should be relatively easy to do.</p>
-<p>Note: using both the Eclipse FileSync plugin for (only) resources synchronization and JRebel
-for the hot-code replacement probably will provide the best combination with the least
-configuration overhead.</p>
-<h4 id="using_eclipse_wtp">Using Eclipse WTP</h4>
-<p>The Rave project can also be deployed through Eclipse WTP, and might be adequate for some, but it
-it is less functional and sometimes a bit quirky. Furthermore, because of (current) limitations
-of the m2eclipse WTP integration for maven war overlays (which the rave-shindig project uses),
-you'll need to use some workarounds to make it workable.</p>
-<p>Prerequisite: Install m2eclipse-wtp integration from the m2eclipse-extras <a href="http://m2eclipse.sonatype.org/sites/m2e-extras">Update Site</a></p>
-<p>If you already imported the Rave projects in Eclipse, first remove them (but don't need to delete them)
-and then (re)import the Rave project as Maven projects to get the m2eclipse-wtp integration enabled. </p>
-<p>Then you need to follow these steps:</p>
-<ul>
-<li>Right click on the rave-shindig project and select Properties</li>
-<li>Open the "Deployment Assembly" property</li>
-<li>Press Add, select Directive Type "Folder", and select the
- target/rave-shindig-0.1-incubating-SNAPSHOT folder.
- (do a "mvn install" in rave-project first for this folder to be available)</li>
-<li>configure the correct Context root paths for rave-portal
- ("portal") and rave-shindig ("/") in their Eclipse project
- properties under "Web Project Settings"</li>
-</ul>
-<p>Now we need to add the the two webapps to a pre-setup (Tomcat 6) server:</p>
-<ul>
-<li>Windows->Show View->Other...</li>
-<li>Server->Servers</li>
-<li>OK</li>
-<li>In the servers view right click your chosen server and slect Add and Remove...</li>
-<li>Add rave-shindig and rave-portal</li>
-<li>Start the server</li>
-<li>Now see the instructions above for logging into the server</li>
-</ul>
</div>
<div id="footer">