You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2020/02/19 11:57:12 UTC
svn commit: r1056721 - in /websites/production/cxf/content:
cache/docs.pageCache docs/jmx-management.html
Author: buildbot
Date: Wed Feb 19 11:57:12 2020
New Revision: 1056721
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/docs/jmx-management.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/jmx-management.html
==============================================================================
--- websites/production/cxf/content/docs/jmx-management.html (original)
+++ websites/production/cxf/content/docs/jmx-management.html Wed Feb 19 11:57:12 2020
@@ -124,15 +124,14 @@ Apache CXF -- JMX Management
...
<bean id="org.apache.cxf.management.InstrumentationManager"
- class="org.apache.cxf.management.jmx.InstrumentationManagerImpl">
+ class="org.apache.cxf.management.jmx.InstrumentationManagerImpl" init-method="init">
<property name="enabled" value="true" />
<property name="bus" ref="cxf" />
<property name="usePlatformMBeanServer" value="true" />
</bean>
</pre>
</div></div><p>The default InstrumentationManager accepts the following configuration options:</p><div class="table-wrap"><table class="wrapped confluenceTable"><colgroup span="1"><col span="1"><col span="1"><col span="1"></colgroup><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Name</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Value</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Default</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>enabled</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>If the JMX integration should be enabled or not</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>false</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>bus</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The CXF bus instance to register the JMX extension with</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>None</p></td></tr><tr><td colspan="1" rowspan="1" class="confl
uenceTd"><p>server</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>An optional reference to an MBeanServer instance to register MBeans with. If not supplied, an MBeanServer is resolved using the "usePlatformMBeanServer" and/or "serverName" options.</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>None</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>usePlatformMBeanServer</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>If true and no reference to an MBeanServer is supplied, the JMX extension registers MBeans with the platform MBean server.</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>false</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>serverName</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>If supplied, usePlatformMBeanServer is false, and no reference to an MBeanServer is supplied, the JMX extension registers MBeans with the MBean server carrying this name.</p></td><td colspan
="1" rowspan="1" class="confluenceTd"><p>None</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>createMBServerConnectorFactory</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>If true, a connector is created on the MBeanServer.</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>true</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>threaded</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Determines if the creation of the MBean connector is performed in this thread or in a separate thread. Only relevant if createMBServerConnectorFactory is true.</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>false</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>daemon</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>Determines if the MBean connector creation thread is marked as a daemon thread or not. Only relevant if createMBServerConnectorFactory is true.</p></td><td colspan="1" rowspa
n="1" class="confluenceTd"><p>false</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>JMXServiceURL</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>The URL of the connector to create on the MBeanServer. Only relevant if createMBServerConnectorFactory is true.</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>service:jmx:rmi:///jndi/rmi://localhost:9913/jmxrmi</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd">environment</td><td colspan="1" rowspan="1" class="confluenceTd">This is a map that is used to configure the RMI environment.</td><td colspan="1" rowspan="1" class="confluenceTd">None</td></tr></tbody></table></div><p>The MBean instrumentation provided by the above configuration will provide generic information about the WSDL supported by the web service as well as web service administration commands. To see performance metrics of the SOAP call processing, further <a shape="rect" href="https://cwiki.apache.org/confluence/p
ages/viewpage.action?pageId=84806267">configuration</a> is required – these are disabled by default to avoid unnecessary runtime overhead.</p><p>If you're using Maven, make sure you have the following dependency added to the pom.xml for the web service provider:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<pre class="brush: java; gutter: false; theme: Default">
-<dependency>
+<pre class="brush: java; gutter: false; theme: Default"><dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-rt-management</artifactId>
<version>${cxf.version}</version>
@@ -141,10 +140,10 @@ Apache CXF -- JMX Management
</div></div><h2 id="JMXManagement-ExampleConfiguration">Example Configuration</h2><p>Enable JMX integration by adding the following XML to your CXF Spring context.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
<pre class="brush: java; gutter: false; theme: Default">
<bean id="org.apache.cxf.management.InstrumentationManager"
- class="org.apache.cxf.management.jmx.InstrumentationManagerImpl">
+ class="org.apache.cxf.management.jmx.InstrumentationManagerImpl" init-method="init">
<property name="bus" ref="cxf" />
<property name="enabled" value="true" />
- <property name="JMXServiceURL " value="service:jmx:rmi:///jndi/rmi://localhost:9914/jmxrmi" />
+ <property name="JMXServiceURL" value="service:jmx:rmi:///jndi/rmi://localhost:9914/jmxrmi" />
</bean>
</pre>
</div></div><p>Starting from 2.5.2, an equivalent configuration of the above instrumentation manager can be directly made within the bus configuration using the corresponding property names having the "bus.jmx" prefix, as in</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
@@ -191,7 +190,7 @@ Apache CXF -- JMX Management
<property name="bus" ref="cxf" />
<property name="enabled" value="true" />
<!-- Unless you really want to open an additional connector, set this to false -->
- <property name="createMBServerConnectorFactory " value="false" />
+ <property name="createMBServerConnectorFactory" value="false" />
<!-- Inject the reference to the MBeanServer -->
<property name="server" ref="mbeanServer" />