Mailing-List: contact rave-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: rave-dev@incubator.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1103955 -
 /incubator/rave/site/trunk/content/rave/source.mdtext
Date: Mon, 16 May 2011 23:45:19 -0000
To: rave-commits@incubator.apache.org
From: rgardler@apache.org
Message-Id: <20110516234519.63871238890D@eris.apache.org>

Author: rgardler
Date: Mon May 16 23:45:19 2011
New Revision: 1103955

URL: http://svn.apache.org/viewvc?rev=1103955&view=rev
Log:
Add instructions for logging in and for configuring Eclipse

Modified:
    incubator/rave/site/trunk/content/rave/source.mdtext

Modified: incubator/rave/site/trunk/content/rave/source.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/source.mdtext?rev=1103955&r1=1103954&r2=1103955&view=diff
==============================================================================
--- incubator/rave/site/trunk/content/rave/source.mdtext (original)
+++ incubator/rave/site/trunk/content/rave/source.mdtext Mon May 16 23:45:19 2011
@@ -21,9 +21,7 @@ repository][2] in your web browser.
 
 ## Getting the sourcecode
 
-    svn co http://svn.apache.org/repos/asf/incubator/rave/trunk rave
-
-(if you are a committer use https//)
+    svn co https://svn.apache.org/repos/asf/incubator/rave/trunk rave
 
 ## Building and Running
 
@@ -50,9 +48,73 @@ To run a local Tomcat instance with rave
   - open url http://localhost:8080/portal in a browser
   - press Ctrl-C in the console to stop Tomcat again
 
+### Logging in
+
+Once the server is running:
+
+  * localhost:8080/portal
+  * login as one of the following test users (password is same as username)
+    * canonical
+    * john.doe
+    * jane.doe
+    * OpenID: http://rave2011.myopenid.com/ (password rave2011)
+
+### Configuring Eclipse
+
+  * Install [Eclipse for Java EE][5]
+  * Install M2Eclipse from the [Update Site][6]
+  * Install [Subclipse][7]
+  * Install M2Eclipse-extras from the [Update Site][8]
+  * File -> Import -> Maven -> Check Out maven project from SCM
+    * select SVN
+    * URL is https://svn.apache.org/repos/asf/incubator/rave/trunk
+  * Ensure rave-portal is building without errors
+    * you may need to update dependencies first
+  * 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).
+
+Now the application is building you probably want to be able to run
+Rave inside of Eclispe. This gives a faster turnaround in the
+edit/build/deploy cycle. This is possible, but it is less than optimal.
+
+We recommend the use of JRebel rather than WTP. It's just
+better. However, it is not free. If you are a committer you can get a
+free licence, but if not you wither need to buy your own licence (you
+can get a free 30 day trial licence) or you need to use the adequate, but
+less functional Eclipse WTP.
+
+For those of you using Eclipse WTP you need to follow these steps:
+
+For those of you using Eclipse WTP you need to follow these steps:
+
+  * Right click on the rave-shindig project and select Properties
+  * Open the "Deployment Assembly" property
+  * Press Add, select Directive Type "Folder", and select the target/rave-shindig-0.1-incubating-SNAPSHOT folder. I had to do a "mvn install" in rave-project for this to be ava$
+  * configure the correct Context root paths for rave-portal
+    ("portal") and rave-shindig ("/") in their Eclipse project
+    properties under "Web Project Settings"
+
+Now we need to add the the two webapps to the server:
+
+  * Windows->Show View->Other...
+  * Server->Servers
+  * OK
+  * In the servers view right click your chosen server and slect Add and Remove...
+  * Add rave-shindig and rave-portal
+  * Start the server
+  * Now see the instructions above for logging into the server
+
 
   [1]: http://subversion.apache.org
   [2]: http://svn.apache.org/viewvc/incubator/rave/
   [3]: http://maven.apache.org/download.html
   [4]: http://maven.apache.org/download.html#Installation
-  [5]: http://repository.apache.org/snapshots/org/apache/rave/
\ No newline at end of file
+  [5]: http://download.eclipse.org/webtools/downloads/
+  [6]: http://m2eclipse.sonatype.org/sites/m2e
+  [7]: http://subclipse.tigris.org/update_1.6.x/
+  [8]:  http://m2eclipse.sonatype.org/sites/m2e-extras
\ No newline at end of file