brooklyn-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From henev...@apache.org
Subject [01/18] git commit: Adds basic instructions for setting up IDEA Intelli-J, and also some debugging tips
Date Tue, 07 Oct 2014 23:59:40 GMT
Repository: incubator-brooklyn
Updated Branches:
  refs/heads/master 28801ed26 -> 648049689


Adds basic instructions for setting up IDEA Intelli-J, and also some debugging tips


Project: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/commit/90b286cd
Tree: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/tree/90b286cd
Diff: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/diff/90b286cd

Branch: refs/heads/master
Commit: 90b286cd3423889180ad2fa979231a4cadfbebd3
Parents: bbe2940
Author: Martin Harris <github@nakomis.com>
Authored: Mon Sep 29 14:51:51 2014 +0100
Committer: Martin Harris <github@nakomis.com>
Committed: Thu Oct 2 14:40:37 2014 +0100

----------------------------------------------------------------------
 docs/dev/build/ide.md | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/blob/90b286cd/docs/dev/build/ide.md
----------------------------------------------------------------------
diff --git a/docs/dev/build/ide.md b/docs/dev/build/ide.md
index 07e8157..9a126ac 100644
--- a/docs/dev/build/ide.md
+++ b/docs/dev/build/ide.md
@@ -82,14 +82,31 @@ If the pain starts to be too much, come find us on IRC #brooklyncentral
or [else
 
 
 
-## Intelli-J IDEA
-
-Many of our contributers prefer Intelli-J.  However none of them have yet volunteered any
set-up tips.
-[Be the first!]({{site.url}}/dev/tips/update-docs.html)
+## IntelliJ IDEA
 
+To develop or debug Brooklyn in IntelliJ, you will need to ensure that the Groovy and TestNG
plugins are installed
+via the IntelliJ IDEA | Preferences | Plugins menu. Once installed, you can open Brooklyn
from the root folder, 
+(e.g. ``~/myfiles/brooklyn``) which will automatically open the subprojects.
 
 
 ## Netbeans
 
 Tips from Netbeans users wanted!
 
+
+
+## Debugging Tips
+
+To debug Brooklyn, create a launch configuration which launches the ``BrooklynJavascriptGuiLauncher``
class. NOTE: You may
+need to add additional projects or folders to the classpath of the run configuration (e.g.
add the brooklyn-software-nosql
+project if you wish to deploy a MongoDBServer).
+
+To debug the jsgui (the Brooklyn web console), you will need to build Brooklyn with -DskipOptimization
to prevent the build from minifying the javascript.
+When building via the command line, use the command ``mvn clean install -DskipOptimization``,
and if you are using IntelliJ IDEA, you can add the option
+to the Maven Runner by clicking on the Maven Settings icon in the Maven Projects tool window
 and adding the ``skipOptimization`` property with no value.
+
+When running at the command line you can enable remote connections so that one can attach
a debugger to the Java process:
+    Run Java with the following on the command line or in JAVA_OPTS: ``-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005``
+
+To debug a brooklyn instance that has been run with the above JAVA_OPTS, create a remote
build configuration (IntelliJ - 
+Run | Edit Configurations | + | Remote) with the default options, ensuring the port matches
the address specified in JAVA_OPTS.


Mime
View raw message