|
Registering the Java Service Wrapper's MBean interfaces with JBoss is surprising simple.
This assumes that you have already gotten JBoss integrated with the Java Service Wrapper.
See the Integration Method 1 section,
in particular the example using JBoss.
This explanation assumes that you have installed all of the Wrapper files in the locations
described in the JBoss integration example.
Particularly the wrapper.jar file is assumed to be
located in the ${jboss.home}/lib directory.
JBoss allows you to register as an MBean,
any Object which implements an interface whose name is the same as the class, appended by "MBean".
The Java Service Wrapper provides two such classes
WrapperManager and
WrapperManagerTesting
in the
org.tanukisoftware.wrapper.jmx
package.
The first class,
WrapperManager,
provides several functions to restart and stop the JVM
as well as providing other information about the Java Service Wrapper.
The second class,
WrapperManagerTesting,
exposes a few methods which can be useful in the testing cycle.
They are broken out in case you wish to not include them in a final product release.
See the JavaDocs for more details.
To register both of the above MBeans, create an XML file named
"java-service-wrapper-service.xml"
in the ${jboss.home}/server/default/deploy directory.
The file should contain the following:
| Example: (java-service-wrapper-service.xml) |
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE server>
<server>
<classpath archives="wrapper.jar" codebase="../../lib"/>
<mbean code="org.tanukisoftware.wrapper.jmx.WrapperManager"
name="JavaServiceWrapper:service=WrapperManager"/>
<mbean code="org.tanukisoftware.wrapper.jmx.WrapperManagerTesting"
name="JavaServiceWrapper:service=WrapperManagerTesting"/>
</server>
|
Notice that the location of the wrapper.jar
file is relative to the location of the XML file.
Upon saving the file, JBoss should detect it and register your new MBeans almost immediately.
No need to restart JBoss. Pretty Cool.
Now, to actually use the new MBeans, simply point your browser to JBoss's JMX interface at:
http://localhost:8080/jmx-console/
You should notice a JavaServiceWrapper Agent with two MBeans,
WrapperManager and
WrapperManagerTesting.
Selecting either MBeans will present you with a set of attributes and actions provided by the MBean.
|
