Github user drigodwin commented on a diff in the pull request:

    https://github.com/apache/brooklyn-docs/pull/108#discussion_r79151739
  
    --- Diff: guide/ops/osgi.md ---
    @@ -0,0 +1,56 @@
    +---
    +title: OSGi Distribution
    +layout: website-normal
    +children:
    +- osgi-configuration.md
    +---
    +
    +# Running Apache Brooklyn inside Karaf container
    +
    +The Apache Brooklyn Karaf based distribution lives in 
brooklyn-server/karaf/apache-brooklyn folder.
    +It's still in a testing stage so some features might not work as expected. 
Do reach out if you
    +find any problems.
    +
    +## Building
    +
    +{% highlight bash %}
    +cd brooklyn-server
    +mvn clean install
    +cd karaf/apache-brooklyn/target
    +tar -zxvf apache-brooklyn-{{ site.brooklyn-version }}.tar.gz
    +cd apache-brooklyn-{{ site.brooklyn-version }}
    +{% endhighlight %}
    +
    +## Running
    +
    +Start the instance using the following command
    +
    +{% highlight bash %}
    +bin/karaf
    +{% endhighlight %}
    +
    +This will launch the [Karaf 
console](https://karaf.apache.org/manual/latest/users-guide/console.html)
    +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.
    +
    +To start in debug mode use
    +
    +{% highlight bash %}
    +bin/karaf debug
    +{% endhighlight %}
    +
    +and connect to port 5005 using your debugger.
    +
    +To pause startup until the debugger is connected you can use
    +
    +{% highlight bash %}
    +JAVA_DEBUG_OPTS='-Xdebug -Xnoagent -Djava.compiler=NONE 
-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=5005' bin/karaf debug
    +{% endhighlight %}
    +
    +The Karaf container will keep state like installed bundles and 
configuration between restarts.
    --- End diff --
    
    keep state such as installed


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---

Reply via email to