mx4j/src/etc BUILD-HOWTO,1.1,1.2 README,1.14,1.15
Simone Bordet <[email protected]> Sun, 10 Oct 2004 19:42:02 +0000
| Newsgroups | gmane.comp.java.mx4j.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/mx4j/mx4j/src/etc
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv985/src/etc
Modified Files:
BUILD-HOWTO README
Log Message:
Updated information to reflect the changes in the new release
Index: README
===================================================================
RCS file: /cvsroot/mx4j/mx4j/src/etc/README,v
retrieving revision 1.14
retrieving revision 1.15
diff -C2 -d -r1.14 -r1.15
*** README 5 Apr 2004 20:02:10 -0000 1.14
--- README 10 Oct 2004 19:41:59 -0000 1.15
***************
*** 1,8 ****
! Welcome to MX4J, an open source implementation of the
! Java(TM) Management Extensions (JMX) (JSR 3) and of the
Java(TM) Management Extensions (JMX) remote API (JSR 160).
! For further information about JMX and JSR 3, see
http://java.sun.com/jmx and
http://jcp.org/en/jsr/detail?id=3
--- 1,8 ----
! Welcome to MX4J, an open source implementation of the
! Java(TM) Management Extensions (JMX) (JSR 3) and of the
Java(TM) Management Extensions (JMX) remote API (JSR 160).
! For further information about JMX and JSR 3, see
http://java.sun.com/jmx and
http://jcp.org/en/jsr/detail?id=3
***************
*** 13,17 ****
! Refer to the MX4J home page (http://mx4j.sourceforge.net) for
new releases and further information about the MX4J project.
--- 13,17 ----
! Refer to the MX4J home page (http://mx4j.sourceforge.net) for
new releases and further information about the MX4J project.
***************
*** 23,44 ****
~~~~~~~~~~~~~~~~~~~~~
! MX4J's binary distribution is bundled in a compressed file, that
contains documentation, examples, libraries.
! The structure of binary distribution is as follows:
! /docs/ contains the documentation
! /examples/ contains examples on how to use JMX
! /lib/ contains the MX4J implementation,
! tools and examples jars
! MX4J's source distribution is bundled in a compressed file, that
contains the source code and an Ant build file, but no libraries.
! The structure of source distribution is as follows:
! /build/ contains the Ant build file
! /lib/ put here the libraries needed to build MX4J
! /src/ the source code
--- 23,50 ----
~~~~~~~~~~~~~~~~~~~~~
! MX4J's binary distribution is bundled in a compressed file, that
contains documentation, examples, libraries.
! The structure of binary distribution is as follows, where ${release}
! indicates the MX4J release of the distribution:
! /mx4j-${release}/
! docs/ contains the documentation
! examples/ contains examples on how to use JMX
! lib/ contains the MX4J implementation,
! tools and examples jars
! MX4J's source distribution is bundled in a compressed file, that
contains the source code and an Ant build file, but no libraries.
+ Refer to the BUILD-HOWTO file for further information on how to
+ build MX4J from sources.
! The structure of source distribution is as follows, where ${release}
! indicates the MX4J release of the distribution:
! /mx4j-${release}/
! build/ contains the Ant build file
! lib/ put here the libraries needed to build MX4J
! src/ contains the source files
***************
*** 53,65 ****
MX4J jars
~~~~~~~~~
! Under the /lib/ directory there are the following jars:
+ mx4j-jmx.jar --> contains the JSR 3 javax.management.* classes
+ mx4j-impl.jar --> contains the mx4j.* classes that implements
JSR 3 functionalities
+ mx4j.jar --> The mx4j-jmx.jar and mx4j-impl.jar packed together
!
+ mx4j-rjmx.jar --> contains the JSR 160 javax.management.remote.* classes
+ mx4j-rimpl.jar --> contains the mx4j.* classes that implements
--- 59,89 ----
+ Running MX4J examples
+ ~~~~~~~~~~~~~~~~~~~~~
+
+ MX4J examples source files are present in the /examples/ directory, while compiled
+ example classes are packaged in the /lib/mx4j-examples.jar file of the binary
+ distribution (see below).
+ MX4J examples include JSR 160 examples, under the mx4j.examples.remote package.
+ To run JSR 160 examples with J2SE 1.3, you need to download JAAS from
+ http://java.sun.com/products/jaas and put jaas.jar in the classpath.
+ MX4J examples run out of the box when using J2SE 1.4, since JAAS classes are already
+ included in standard Java Runtime.
+ Since J2SE 5.0 (JDK 1.5), JMX and JSR 160 classes are included in the standard Java
+ Runtime, so running the examples will pick up JDK classes, not MX4J's. To pick up
+ MX4J classes, you should put relevant MX4J jars in the boot classpath with the /p
+ option (normally this is done using: java -Xbootclasspath/p:<MX4J jars>).
+
+
+
MX4J jars
~~~~~~~~~
! Under the /lib/ directory of the binary distribution there are the following jars:
+ mx4j-jmx.jar --> contains the JSR 3 javax.management.* classes
+ mx4j-impl.jar --> contains the mx4j.* classes that implements
JSR 3 functionalities
+ mx4j.jar --> The mx4j-jmx.jar and mx4j-impl.jar packed together
!
+ mx4j-rjmx.jar --> contains the JSR 160 javax.management.remote.* classes
+ mx4j-rimpl.jar --> contains the mx4j.* classes that implements
***************
*** 78,82 ****
+ HTTP adaptor, shows the MBeanServer's status in XML.
! By transforming with XSLT the XML, can be used to see the HTML view
of an MBeanServer in a browser
+ Configuration loader, an XML file format and loader to startup and shutdown
--- 102,106 ----
+ HTTP adaptor, shows the MBeanServer's status in XML.
! By transforming with XSLT the XML, can be used to see the HTML view
of an MBeanServer in a browser
+ Configuration loader, an XML file format and loader to startup and shutdown
***************
*** 91,94 ****
--- 115,120 ----
* A 'local' JSR 160 connector and connector server
* A 'soap' JSR 160 connector and connector server
+ * A 'hessian' JSR 160 connector and connector server
+ * A 'burlap' JSR 160 connector and connector server
* RemoteMBeanProxy, to proxy MBeans that reside on a remote MBeanServer
* RMI [Client|Server] SocketFactories over SSL
***************
*** 99,112 ****
MX4J's Deprecated Tools
~~~~~~~~~~~~~~~~~~~~~~~
! + The JRMPAdaptor and the IIOPAdaptor were tools that allowed connection with a
remote MBeanServer via plain RMI and via CORBA's IIOP protocol.
! Since MX4J 2.x now implements the standard JMX Remote API (JSR 160), these
! tools are not mantained anymore and they're not shipped with the binary
distribution, to protote use of the standard JMX Remote API.
They're still present in the source distribution and can be compiled using the
! provided build file if needed.
Their usage is strongly discouraged, though, and they will not be supported
any longer.
! + The HeartBeat tool, which was dependent on the above JRMPAdaptor, is also
deprecated and not mantained nor supported anymore.
--- 125,138 ----
MX4J's Deprecated Tools
~~~~~~~~~~~~~~~~~~~~~~~
! + The JRMPAdaptor and the IIOPAdaptor were tools that allowed connection with a
remote MBeanServer via plain RMI and via CORBA's IIOP protocol.
! Since MX4J 2.x now implements the standard JMX Remote API (JSR 160), these
! tools are not mantained anymore and they're not shipped with the binary
distribution, to protote use of the standard JMX Remote API.
They're still present in the source distribution and can be compiled using the
! provided build file if needed.
Their usage is strongly discouraged, though, and they will not be supported
any longer.
! + The HeartBeat tool, which was dependent on the above JRMPAdaptor, is also
deprecated and not mantained nor supported anymore.
***************
*** 116,122 ****
~~~~~~~~~~~~~~~~~~~~
! Refer to the included documentation under /docs/ for further
! details on how to use MX4J, and to the online, nightly updated, documentation
! for the latest changes.
--- 142,148 ----
~~~~~~~~~~~~~~~~~~~~
! Refer to the included documentation under the /docs/ directory of the binary
! distribution for further details on how to use MX4J, and to the online,
! nightly updated, documentation for the latest changes.
***************
*** 134,135 ****
--- 160,162 ----
+ The Jetty project (http://jetty.mortbay.org)
+ The Jython project (http://www.jython.org)
+ + The Caucho project (http://www.caucho.com)
Index: BUILD-HOWTO
===================================================================
RCS file: /cvsroot/mx4j/mx4j/src/etc/BUILD-HOWTO,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** BUILD-HOWTO 16 Nov 2003 17:57:56 -0000 1.1
--- BUILD-HOWTO 10 Oct 2004 19:41:59 -0000 1.2
***************
*** 1,8 ****
! Welcome to MX4J, an open source implementation of the
! Java(TM) Management Extensions (JMX) (JSR 3) and of the
Java(TM) Management Extensions (JMX) remote API (JSR 160).
! For further information about JMX and JSR 3, see
http://java.sun.com/jmx and
http://jcp.org/en/jsr/detail?id=3
--- 1,8 ----
! Welcome to MX4J, an open source implementation of the
! Java(TM) Management Extensions (JMX) (JSR 3) and of the
Java(TM) Management Extensions (JMX) remote API (JSR 160).
! For further information about JMX and JSR 3, see
http://java.sun.com/jmx and
http://jcp.org/en/jsr/detail?id=3
***************
*** 13,17 ****
! Refer to the MX4J home page (http://mx4j.sourceforge.net) for
new releases and further information about the MX4J project.
--- 13,17 ----
! Refer to the MX4J home page (http://mx4j.sourceforge.net) for
new releases and further information about the MX4J project.
***************
*** 24,28 ****
To build an MX4J binary distribution from an MX4J source distribution,
! you must have a J2SE(TM) version 1.3 or later installed
(see http://java.sun.com/j2se).
Unpack the MX4J source distribution into a directory that will be
--- 24,28 ----
To build an MX4J binary distribution from an MX4J source distribution,
! you must have a J2SE(TM) version 1.3 or later installed
(see http://java.sun.com/j2se).
Unpack the MX4J source distribution into a directory that will be
***************
*** 37,57 ****
The directory where Ant is installed will be referred to as
$ANT_HOME
!
* Download BCEL version 5.0 or later from
http://jakarta.apache.org/bcel
Put bcel.jar into $MX4J/lib
!
* Download Commons-Logging version 1.0 or later from
http://jakarta.apache.org/commons
Put commons-logging.jar into $MX4J/lib
!
* Download Log4J version 1.2 or later from
http://jakarta.apache.org/log4j
! Put log4j-xxx.jar into $MX4J/lib
!
! + Issue the command
! $ANT_HOME/bin/ant compile.jmx
from the $MX4J/build directory
!
Building JSR 160 (Java Management Extensions Remote API) classes
--- 37,57 ----
The directory where Ant is installed will be referred to as
$ANT_HOME
!
* Download BCEL version 5.0 or later from
http://jakarta.apache.org/bcel
Put bcel.jar into $MX4J/lib
!
* Download Commons-Logging version 1.0 or later from
http://jakarta.apache.org/commons
Put commons-logging.jar into $MX4J/lib
!
* Download Log4J version 1.2 or later from
http://jakarta.apache.org/log4j
! Put log4j-*.jar into $MX4J/lib
!
! + Issue the command
! $ANT_HOME/bin/ant compile.jmx
from the $MX4J/build directory
!
Building JSR 160 (Java Management Extensions Remote API) classes
***************
*** 62,66 ****
* [J2SE 1.3 only]
! Download JAAS version 1.0 or later from
http://java.sun.com/products/jaas
Unpack jaas.jar into $MX4J/lib. This step is needed to workaround
--- 62,66 ----
* [J2SE 1.3 only]
! Download JAAS version 1.0 or later from
http://java.sun.com/products/jaas
Unpack jaas.jar into $MX4J/lib. This step is needed to workaround
***************
*** 71,77 ****
$MX4J/lib/com/sun/security/auth and subdirectories,
containing the JAAS classes.
!
! + Issue the command
! $ANT_HOME/bin/ant compile.rjmx
from the $MX4J/build directory
--- 71,77 ----
$MX4J/lib/com/sun/security/auth and subdirectories,
containing the JAAS classes.
!
! + Issue the command
! $ANT_HOME/bin/ant compile.rjmx
from the $MX4J/build directory
***************
*** 80,83 ****
--- 80,85 ----
~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ Warning: some MX4J tools depend on JDK 1.4, since they depend on
+ 3rd party libraries that depend on JDK 1.4.
Follow the instruction given for building the JSR 160 classes, and
do the following:
***************
*** 85,102 ****
* Download Axis version 1.1 or later from
http://ws.apache.org/axis
! Put axis.jar, commons-discovery.jar, jaxrpc.jar, saaj.jar and
wsdl4j.jar into $MX4J/lib
* [J2SE 1.3 only]
Download JSSE version 1.0 or later from
http://java.sun.com/products/jsse
Put jcert.jar, jnet.jar and jsse.jar into $MX4J/lib
!
! * [Optional]
! Download Jetty version 4.2 or later from
! http://jetty.mortbay.org
! Put org.mortbay.jetty.jar into $MX4J/lib
!
! + Issue the command
$ANT_HOME/bin/ant compile.tools
from the $MX4J/build directory
--- 87,125 ----
* Download Axis version 1.1 or later from
http://ws.apache.org/axis
! Put axis.jar, commons-discovery.jar, jaxrpc.jar, saaj.jar and
wsdl4j.jar into $MX4J/lib
+ * Download the servlet API classes version 2.3 or later from
+ http://java.sun.com/products/servlet/reference/api/index.html
+ Most likely, you have to rename the downloaded file from
+ servlet-2_3-fcs-classfiles.zip to servlet.jar and put it under
+ $MX4J/lib
+
+ * Download Jetty version 4.2 or later from
+ http://jetty.mortbay.org
+ Put org.mortbay.jetty.jar into $MX4J/lib
+
+ * [Optional]
+ Download JavaMail and the JavaBean Activation Framework from
+ http://java.sun.com/products/javamail
+ http://java.sun.com/beans/glasgow
+ Put mail.jar and activation.jar into $MX4J/lib
+
+ * [Optional]
+ Download Jython from
+ http://www.jython.org
+ Put jython.jar into $MX4J/lib
+
+ * [Requires J2SE 1.4]
+ Download Hessian from
+ http://www.caucho.com
+ Put hessian-*.jar into $MX4J/lib
+
* [J2SE 1.3 only]
Download JSSE version 1.0 or later from
http://java.sun.com/products/jsse
Put jcert.jar, jnet.jar and jsse.jar into $MX4J/lib
!
! + Issue the command
$ANT_HOME/bin/ant compile.tools
from the $MX4J/build directory
-------------------------------------------------------
This SF.net email is sponsored by: IT Product Guide on ITManagersJournal
Use IT products in your business? Tell us what you think of them. Give us
Your Opinions, Get Free ThinkGeek Gift Certificates! Click to find out more
http://productguide.itmanagersjournal.com/guidepromo.tmpl