brooklyn-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
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


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

 docs/dev/build/ | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)
diff --git a/docs/dev/build/ b/docs/dev/build/
index 07e8157..9a126ac 100644
--- a/docs/dev/build/
+++ b/docs/dev/build/
@@ -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.

View raw message