brooklyn-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From drigod...@apache.org
Subject [1/2] brooklyn-docs git commit: Put osgi mode debugging in separate section
Date Wed, 17 May 2017 16:01:35 GMT
Repository: brooklyn-docs
Updated Branches:
  refs/heads/master ea94440aa -> 0cf29b2bd


Put osgi mode debugging in separate section

Add JAVA_DEBUG_PORT description.

Recommend up to date JAVA_DEBUG_OPTS flags
Those are the same used with bin/karaf debug


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

Branch: refs/heads/master
Commit: f9e0ffb68f7d9644e0717598f2386184e21d428c
Parents: 6144986
Author: Valentin Aitken <bostko@gmail.com>
Authored: Tue May 9 15:32:30 2017 +0300
Committer: Valentin Aitken <bostko@gmail.com>
Committed: Wed May 10 10:29:59 2017 +0300

----------------------------------------------------------------------
 guide/ops/osgi.md | 32 ++++++++++++++++++++------------
 1 file changed, 20 insertions(+), 12 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/f9e0ffb6/guide/ops/osgi.md
----------------------------------------------------------------------
diff --git a/guide/ops/osgi.md b/guide/ops/osgi.md
index 915539b..97becec 100644
--- a/guide/ops/osgi.md
+++ b/guide/ops/osgi.md
@@ -5,10 +5,8 @@ children:
 - osgi-configuration.md
 ---
 
-# Running Apache Brooklyn inside Karaf container
-
 The Apache Brooklyn Karaf based distribution lives in brooklyn-dist/karaf/apache-brooklyn
folder.
-It's still in a testing stage so some features might not work as expected. Please contact
us on the 
+Please contact us on the
 [mailing list](mailto:dev@brooklyn.apache.org) if you find any problems.
 
 ## Building
@@ -33,6 +31,17 @@ This will launch the [Karaf console](https://karaf.apache.org/manual/latest/user
 where you can interact with the running instance. Note that Brooklyn has already started
at this point
 and is reachable at the usual web console url.
 
+Start the instance as a server in the background using the following command
+
+{% highlight bash %}
+bin/start
+{% endhighlight %}
+
+The Karaf container will keep state such as installed bundles and configuration between restarts.
+To reset any changes add **clean** to the cli arguments.
+
+## Debugging
+
 To start in debug mode use
 
 {% highlight bash %}
@@ -41,23 +50,22 @@ bin/karaf debug
 
 and connect to port 5005 using your normal Java debugger.
 
-To pause startup until the debugger is connected you can use
+If you want to change dt_socket port you can pass `JAVA_DEBUG_PORT` environment variable
 
-{% highlight bash %}
-JAVA_DEBUG_OPTS='-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005'
bin/karaf debug
+{%highlight bash %}
+JAVA_DEBUG_PORT=5006 bin/karaf debug
 {% endhighlight %}
 
-
-Start the instance as a server in the background using the following command
+To pause startup until the debugger is connected you can use
 
 {% highlight bash %}
-bin/start
+JAVA_DEBUG_OPTS='-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005' bin/karaf
debug
 {% endhighlight %}
 
-The Karaf container will keep state such as installed bundles and configuration between restarts.
-To reset any changes add **clean** to the cli arguments.
+For other options please check your JVM JPDA documentation.
+Hotspot JPDA:  https://docs.oracle.com/javase/8/docs/technotes/guides/jpda/
 
 ## Configuring
 
-Configuration of Brooklyn when running under Karaf is largely done through standard Karaf
mechanisms. 
+Configuration of Brooklyn when running under Karaf is largely done through standard Karaf
mechanisms.
 See the page on [OSGI Configuration](osgi-configuration.html) for details.
\ No newline at end of file


Mime
View raw message