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 <[email protected]> Authored: Tue May 9 15:32:30 2017 +0300 Committer: Valentin Aitken <[email protected]> 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:[email protected]) 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
