You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by he...@apache.org on 2022/01/07 12:29:57 UTC
[brooklyn-docs] branch master updated (c8a8782 -> 7d0c88e)
This is an automated email from the ASF dual-hosted git repository.
heneveld pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-docs.git.
from c8a8782 use truly unique identifier, prevent occasional failures due to collisions
new 6fa51ed put externalized config before logging in the docs
new a4b3092 add felix debugging logging configuration
new 3d44106 fix documentation for catalog options
new 7d0c88e Merge branch 'master' of https://gitbox.apache.org/repos/asf/brooklyn-docs
The 4 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
guide/ops/configuration/index.md | 32 +++++++++-----------------
guide/ops/index.md | 2 +-
guide/ops/troubleshooting/slow-unresponsive.md | 12 ++++++++++
3 files changed, 24 insertions(+), 22 deletions(-)
[brooklyn-docs] 04/04: Merge branch 'master' of https://gitbox.apache.org/repos/asf/brooklyn-docs
Posted by he...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
heneveld pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-docs.git
commit 7d0c88ed1f3693f83287aafc390aa52f4977d796
Merge: 3d44106 c8a8782
Author: Alex Heneveld <al...@cloudsoftcorp.com>
AuthorDate: Fri Jan 7 12:25:45 2022 +0000
Merge branch 'master' of https://gitbox.apache.org/repos/asf/brooklyn-docs
_plugins/site_structure.rb | 7 +++++--
guide/ops/configuration/https.md | 7 +++++++
2 files changed, 12 insertions(+), 2 deletions(-)
[brooklyn-docs] 02/04: add felix debugging logging configuration
Posted by he...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
heneveld pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-docs.git
commit a4b30929c68c35861ca66d0e5a78e7d0b71d9796
Author: Alex Heneveld <al...@cloudsoftcorp.com>
AuthorDate: Tue Jan 4 13:47:33 2022 +0000
add felix debugging logging configuration
---
guide/ops/troubleshooting/slow-unresponsive.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/guide/ops/troubleshooting/slow-unresponsive.md b/guide/ops/troubleshooting/slow-unresponsive.md
index 93b5e5e..9c77761 100644
--- a/guide/ops/troubleshooting/slow-unresponsive.md
+++ b/guide/ops/troubleshooting/slow-unresponsive.md
@@ -144,6 +144,18 @@ jstack-active $BROOKLYN_PID
{% endhighlight %}
+#### OSGi Resolution
+
+The Karaf OSGi subsystem can in some cases spend a lot of energy identifying which bundles should provide packages.
+Often this can be resolved by removing redundant bundles.
+To observe this, add the following to `etc/org.ops4j.pax.logging.cfg` (no restart normally needed):
+
+ log4j2.logger.felix.name = org.apache.felix
+ log4j2.logger.felix.level = DEBUG
+
+To get a unique list of duplicate packages: `grep chains data/log/*.debug.log | sed 's/.*exposed to //' | sed 's/from .*//' | sort | uniq`
+
+
#### Profiling
If an in-depth investigation of the CPU usage (and/or object creation) of a Brooklyn Server is
[brooklyn-docs] 01/04: put externalized config before logging in the docs
Posted by he...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
heneveld pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-docs.git
commit 6fa51ed124ef3f72cb2681a9d8b032810ca63f89
Author: Alex Heneveld <al...@cloudsoftcorp.com>
AuthorDate: Thu Dec 2 16:39:28 2021 +0000
put externalized config before logging in the docs
---
guide/ops/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/guide/ops/index.md b/guide/ops/index.md
index 20077a7..676d6ce 100644
--- a/guide/ops/index.md
+++ b/guide/ops/index.md
@@ -12,8 +12,8 @@ children:
- configuration/
- persistence/
- high-availability/
-- logging/
- externalized-configuration.md
+- logging/
- requirements.md
- paths.md
- upgrades/
[brooklyn-docs] 03/04: fix documentation for catalog options
Posted by he...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
heneveld pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-docs.git
commit 3d441064000e7a79f3f35cbcb18afb7ccefce698
Author: Alex Heneveld <al...@cloudsoftcorp.com>
AuthorDate: Tue Jan 4 17:09:38 2022 +0000
fix documentation for catalog options
---
guide/ops/configuration/index.md | 32 +++++++++++---------------------
1 file changed, 11 insertions(+), 21 deletions(-)
diff --git a/guide/ops/configuration/index.md b/guide/ops/configuration/index.md
index 77f050c..f67b2fd 100644
--- a/guide/ops/configuration/index.md
+++ b/guide/ops/configuration/index.md
@@ -5,6 +5,7 @@ layout: website-normal
children:
- { section: Memory Usage }
- { section: Authentication and Security }
+- { section: Catalog in OSGi }
- brooklyn_cfg.md
- https.md
- cors.md
@@ -76,19 +77,12 @@ Users and passwords for Brooklyn can be configured in the brooklyn.cfg as detail
See [HTTPS Configuration](https.md) for general information on configuring HTTPS.
-<!--
-----------
--- NOTE: comment out this section on catalog as the behaviour described is not enabled by default since
--- https://github.com/apache/brooklyn-server/pull/233; re-enable this when that changes
-----------
## Catalog in OSGi
-With the traditional launcher, Brooklyn loads the initial contents of the catalog from a `default.catalog.bom` file
-as described in the section on [installation](/guide/ops/production-installation.md). Brooklyn finds Java
-implementations to provide for certain things in blueprints (entities, enrichers etc.) by scanning the classpath.
-In the OSGI world this approach is not used, as each bundle only has visibility of its own and its imported Java packages.
-Instead, in the Karaf OSGi container, each bundle can declare its own `catalog.bom` file, in the root of the bundle,
-with the catalog declarations for any entities etc. that the bundle contains.
+OSGi bundles may include a `catalog.bom` file at root, defining the elements to be added to the Apache Brooklyn catalog
+when the bundle is installed. These bundles may be installed using the API or as part of the initial catalog.
+The initial catalog is loaded from `etc/default.catalog.bom` which typically references files in `catalog/*`,
+as described in the section on [installation](/guide/ops/production-installation.md).
For example, the `catalog.bom` file for Brooklyn's Webapp bundle looks like (abbreviated):
@@ -116,6 +110,12 @@ In the above YAML the first item declares that the bundle provides an entity who
item declares that the bundle provides a template application, with id `resilient-bash-web-cluster-template`, and
includes a description for what this is.
+Note: the `type` argument can only refer to unqualified class names where the bundle is in scope,
+such as contained in the same bundle as one containing the `catalog.bom` (in some cases),
+or a bundle specified in the `org.apache.brooklyn.classloader.fallback.bundles` list supplied at startup;
+to reference a type in another bundle, the syntax `osgi-bundle:org.package.Class` is supported in most places.
+
+
### Configuring applications in the Catalog
When running some particular deployment of Brooklyn it may not be desirable for the sample applications to appear in
@@ -202,13 +202,3 @@ to ensure any OSGi services they provide are available to other bundles,
for any of the bundle installation techniques listed above.)
-### Caveats
-
-In the OSGi world specifying class names by string in Brooklyn's configuration will work only
-for classes living in Brooklyn's core modules. Raise an issue or ping us on IRC if you find
-a case where this doesn't work for you. For custom SecurityProvider implementations refer to the
-documentation of BrooklynLoginModule.
-
- END Catalog in Karaf comment -->
-
-