You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jg...@apache.org on 2014/07/26 03:52:29 UTC
[47/50] git commit: [KARAF-3073] Document how to use jVisualVM
profiler
[KARAF-3073] Document how to use jVisualVM profiler
Project: http://git-wip-us.apache.org/repos/asf/karaf/repo
Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/7dc1f813
Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/7dc1f813
Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/7dc1f813
Branch: refs/remotes/karaf-2.3.x
Commit: 7dc1f813960873b9b6f46aa8c6189f13e3d3ee0c
Parents: 6558f69
Author: Jean-Baptiste Onofré <jb...@apache.org>
Authored: Fri Jul 25 16:35:28 2014 +0200
Committer: Jean-Baptiste Onofré <jb...@apache.org>
Committed: Fri Jul 25 16:36:51 2014 +0200
----------------------------------------------------------------------
.../filtered-resources/etc/config.properties | 13 +++++++++++
.../main/webapp/developers-guide/debugging.conf | 24 +++++++++++++++-----
2 files changed, 31 insertions(+), 6 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/karaf/blob/7dc1f813/assemblies/apache-karaf/src/main/filtered-resources/etc/config.properties
----------------------------------------------------------------------
diff --git a/assemblies/apache-karaf/src/main/filtered-resources/etc/config.properties b/assemblies/apache-karaf/src/main/filtered-resources/etc/config.properties
index acbcadb..cd695af 100644
--- a/assemblies/apache-karaf/src/main/filtered-resources/etc/config.properties
+++ b/assemblies/apache-karaf/src/main/filtered-resources/etc/config.properties
@@ -146,6 +146,19 @@ eecap-1.2= osgi.ee; osgi.ee="OSGi/Minimum"; version:List<Version>="1.0,1.1", \
#
org.osgi.framework.bootdelegation=org.apache.karaf.jaas.boot,sun.*,com.sun.*,javax.transaction,javax.transaction.*,javax.xml.crypto,javax.xml.crypto.*,org.apache.xerces.jaxp.datatype,org.apache.xerces.stax,org.apache.xerces.parsers,org.apache.xerces.jaxp,org.apache.xerces.jaxp.validation,org.apache.xerces.dom
+# jVisualVM support
+# in order to use Karaf with jvisualvm, the org.osgi.framework.bootdelegation property has to contain the org.netbeans.lib.profiler.server package
+# and, so, it should look like:
+#
+# org.osgi.framework.bootdelegation=org.apache.karaf.jaas.boot,org.apache.karaf.jaas.boot.principal,org.apache.karaf.management.boot,sun.*,com.sun.*,javax.transaction,javax.transaction.*,javax.xml.crypto,javax.xml.crypto.*,org.apache.xerces.jaxp.datatype,org.apache.xerces.stax,org.apache.xerces.parsers,org.apache.xerces.jaxp,org.apache.xerces.jaxp.validation,org.apache.xerces.dom,org.netbeans.lib.profiler.server
+#
+# YourKit support
+# in order to use Karaf with YourKit, the org.osgi.framework.bootdelegation property has to contain the com.yourkit.* packages
+# and, so, it should look like:
+#
+# org.osgi.framework.bootdelegation=org.apache.karaf.jaas.boot,org.apache.karaf.jaas.boot.principal,org.apache.karaf.management.boot,sun.*,com.sun.*,javax.transaction,javax.transaction.*,javax.xml.crypto,javax.xml.crypto.*,org.apache.xerces.jaxp.datatype,org.apache.xerces.stax,org.apache.xerces.parsers,org.apache.xerces.jaxp,org.apache.xerces.jaxp.validation,org.apache.xerces.dom,com.yourkit.*
+#
+
#
# OSGi Execution Environment
#
http://git-wip-us.apache.org/repos/asf/karaf/blob/7dc1f813/manual/src/main/webapp/developers-guide/debugging.conf
----------------------------------------------------------------------
diff --git a/manual/src/main/webapp/developers-guide/debugging.conf b/manual/src/main/webapp/developers-guide/debugging.conf
index 5d45753..079ae76 100644
--- a/manual/src/main/webapp/developers-guide/debugging.conf
+++ b/manual/src/main/webapp/developers-guide/debugging.conf
@@ -80,24 +80,36 @@ set DEFAULT_JAVA_DEBUG_OPTS='-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:tr
h2. Profiling
+h3. jVisualVM
+
+You have to edit the {{etc/config.properties}} configuration file to add the jVisualVM package:
+
+{code}
+org.osgi.framework.bootdelegation=...,org.netbeans.lib.profiler.server
+{code}
+
+Run Karaf from the console, and you should now be able to connect using jVisualVM.
+
h3. YourKit
You need a few steps to be able to profile Karaf using YourKit.
The first one is to edit the {{etc/config.properties}} configuration file and add the following property:
-{noformat}
+
+{code}
org.osgi.framework.bootdelegation=com.yourkit.*
-{noformat}
+{code}
Then, set the {{JAVA_OPTS}} environment variable:
-{noformat}
+
+{code}
export JAVA_OPTS='-Xmx512M -agentlib:yjpagent'
-{noformat}
+{code}
or, on Windows
-{noformat}
+{code}
set JAVA_OPTS='-Xmx512M -agentlib:yjpagent'
-{noformat}
+{code}
Run Karaf from the console, and you should now be able to connect using YourKit standalone or from your favorite IDE.