[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user asfgit closed the pull request at: https://github.com/apache/brooklyn-docs/pull/44 --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user neykov commented on the pull request: https://github.com/apache/brooklyn-docs/pull/44#issuecomment-209258489 Added a new commit addressing the comments so it's clear what the changes are. Will squash before merging. @sjcorbett The instructions are mostly one-liners copy & pasted from my workflow, so no need to go through them. What I'd be really interested in is an "outsider" testing the distribution and reporting his experience. --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user geomacy commented on the pull request: https://github.com/apache/brooklyn-docs/pull/44#issuecomment-208910092 What do we do about the numerous other pages where 'brooklyn.properties' is referenced? Is it best to leave them as-is until Brooklyn moves to a Karaf-only distribution? --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user geomacy commented on the pull request: https://github.com/apache/brooklyn-docs/pull/44#issuecomment-208910288 that's all the comments from me... --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user geomacy commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/44#discussion_r59375726
--- Diff: guide/misc/osgi.md ---
@@ -0,0 +1,63 @@
+---
+title: FAQ
+layout: website-normal
+---
+
+# Running Apache Brooklin inside Karaf container
+
+The Apache Brooklyn Karaf based distribution lives in
brooklyn-server/karaf/apache-brooklyn folder.
+
+## 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 %}
+
+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 %}
+
+## Configuring
+
+You can use the standard ~/.brooklyn/brooklyn.properties file to configure
Brooklyn. Alternatively
+create etc/brooklyn.cfg inside the distribution folder (same file format).
The keys in the former override
+those in the latter.
--- End diff --
I'd reword this to say 'use /etc/brooklyn.cfg' but making a
note that ~/.brooklyn/brooklyn.properties is still supported for backward
compatibility. But also explain that values in brooklyn.cfg can be viewed and
managed dynamically via the OSGI configuration admin commands in Karaf, e.g.
config:property-set, so this is better suited for working in an OSGI
environment.
---
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.
---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user geomacy commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/44#discussion_r59376672
--- Diff: guide/misc/osgi.md ---
@@ -0,0 +1,63 @@
+---
+title: FAQ
+layout: website-normal
+---
+
+# Running Apache Brooklin inside Karaf container
+
+The Apache Brooklyn Karaf based distribution lives in
brooklyn-server/karaf/apache-brooklyn folder.
+
+## 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 %}
+
+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 %}
+
+## Configuring
+
+You can use the standard ~/.brooklyn/brooklyn.properties file to configure
Brooklyn. Alternatively
+create etc/brooklyn.cfg inside the distribution folder (same file format).
The keys in the former override
+those in the latter.
+
+Web console related configuration is done through the corresponding Karaf
mechanisms:
--- End diff --
Need a blank line after this one if the bullets below are to render
properly.
---
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.
---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user m4rkmckenna commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/44#discussion_r59375180
--- Diff: guide/misc/osgi.md ---
@@ -0,0 +1,63 @@
+---
+title: FAQ
+layout: website-normal
+---
+
+# Running Apache Brooklin inside Karaf container
+
+The Apache Brooklyn Karaf based distribution lives in
brooklyn-server/karaf/apache-brooklyn folder.
+
+## 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 %}
+
+To start in debug mode use
+
+{% highlight bash %}
+bin/karaf debug
+{% endhighlight %}
+
--- End diff --
Might be worth mentioning `karaf clean` to reset config admin / installed
features to default
---
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.
---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user geomacy commented on a diff in the pull request: https://github.com/apache/brooklyn-docs/pull/44#discussion_r59375191 --- Diff: guide/misc/osgi.md --- @@ -0,0 +1,63 @@ +--- +title: FAQ +layout: website-normal +--- + +# Running Apache Brooklin inside Karaf container + +The Apache Brooklyn Karaf based distribution lives in brooklyn-server/karaf/apache-brooklyn folder. --- End diff -- Worth adding a note on the status of the Karaf distro, with caveats about not everything necessarily working yet. --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user geomacy commented on a diff in the pull request: https://github.com/apache/brooklyn-docs/pull/44#discussion_r59374944 --- Diff: guide/misc/osgi.md --- @@ -0,0 +1,63 @@ +--- +title: FAQ --- End diff -- The title is misleading, it's not a FAQ page really - change to 'OSGI'? --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user sjcorbett commented on the pull request: https://github.com/apache/brooklyn-docs/pull/44#issuecomment-208466458 Looks good. Do you want me to double check any of the instructions in particular? --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user sjcorbett commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/44#discussion_r59246331
--- Diff: guide/misc/osgi.md ---
@@ -0,0 +1,63 @@
+---
+title: FAQ
+layout: website-normal
+---
+
+# Running Apache Brooklin inside Karaf container
+
+The Apache Brooklyn Karaf based distribution lives in
brooklyn-server/karaf/apache-brooklyn folder.
+
+## 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 %}
+
+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 %}
+
+## Configuring
+
+You can use the standard ~/.brooklyn/brooklyn.properties file to configure
Brooklyn. Alternatively
+create etc/brooklyn.cfg inside the distribution folder (same file format).
The keys in the former override
+those in the latter.
+
+Web console related configuration is done through the corresponding Karaf
mechanisms:
+ * The port is set in etc/org.ops4j.pax.web.cfg, key
org.osgi.service.http.port.
+ * For authentication the JAAS realm "webconsole" is used; by default it
will use any
+SecurityProvider implementations configured in Brooklyn falling back
to auto generating
+the password. To configure a custom JAAS realm see the jetty.xml file
in "brooklyn-server/karaf/jetty-config/src/main/resources"
+and override it by creating a custom one in "etc" folder. Point the
"webconsole" login service
+to the JAAS realm you would like to use.
+ * For other Jetty related configuration consult the Karaf and pax-web
docs.
+
+
+## Caveats
+
+In the OSGi world specifying class names by string in Brooklyn's
configuraiton will work only
--- End diff --
`configuraiton`
---
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.
---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
Github user sjcorbett commented on a diff in the pull request: https://github.com/apache/brooklyn-docs/pull/44#discussion_r59246114 --- Diff: guide/misc/osgi.md --- @@ -0,0 +1,63 @@ +--- +title: FAQ +layout: website-normal +--- + +# Running Apache Brooklin inside Karaf container --- End diff -- `Brooklin` --- 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. ---
[GitHub] brooklyn-docs pull request: Initial OSGi docs
GitHub user neykov opened a pull request: https://github.com/apache/brooklyn-docs/pull/44 Initial OSGi docs You can merge this pull request into a Git repository by running: $ git pull https://github.com/neykov/brooklyn-docs osgi Alternatively you can review and apply these changes as the patch at: https://github.com/apache/brooklyn-docs/pull/44.patch To close this pull request, make a commit to your master/trunk branch with (at least) the following in the commit message: This closes #44 commit 1533b0d72e7d6f79d49f01a651e576abf81b7951 Author: Svetoslav Neykov Date: 2016-04-11T09:23:34Z Initial OSGi docs --- 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. ---
