You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by dr...@apache.org on 2017/05/17 16:01:35 UTC
[1/2] brooklyn-docs git commit: Put osgi mode debugging in separate
section
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 <bo...@gmail.com>
Authored: Tue May 9 15:32:30 2017 +0300
Committer: Valentin Aitken <bo...@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
[2/2] brooklyn-docs git commit: This closes #179
Posted by dr...@apache.org.
This closes #179
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/0cf29b2b
Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/0cf29b2b
Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/0cf29b2b
Branch: refs/heads/master
Commit: 0cf29b2bd0fa327768fa911ff0937500635ec5d4
Parents: ea94440 f9e0ffb
Author: Duncan Godwin <dr...@googlemail.com>
Authored: Wed May 17 17:01:27 2017 +0100
Committer: Duncan Godwin <dr...@googlemail.com>
Committed: Wed May 17 17:01:27 2017 +0100
----------------------------------------------------------------------
guide/ops/osgi.md | 32 ++++++++++++++++++++------------
1 file changed, 20 insertions(+), 12 deletions(-)
----------------------------------------------------------------------