Thank you for downloading this release of the Tivoli Management eXtension for JavaTM (TMX4J) also known as Tivoli JMX. TMX4J is the Tivoli's implementation of the JavaTM Management Extensions (JMX) Specification.Version 2.1 is an update release of the TMX4J v1.3. This release contains fixes for a select list of bugs. Every effort has been made to support programs written for previous version of the TMX4J. All software should migrate to current version with no reprogramming.
See the Release Notes for getting all details about the changes. See also the online documentation for the new enhancements and features.
TMX4J is the Tivoli's implementation of JMX, which defines architecture, design patterns, APIs, and services for application and network management in Java. TMX4J implements all of the specified JMX interfaces and classes but has yet to be tested for complete conformance by the JMX Technology Compatibility Kit.In addition to the JMX implementation, Tivoli JMX includes a simple Unix daemon/NT Service that hosts a JMX Agent; an RMI-based Connector Server and HTTP Protocol Adaptor that allow users to access the JMX Agent remotely; a basic JMX Tutorial; a set of sample MBeans; a flexible message logging facility; and IBM's Logging Toolkit for Java.
JMX defines a standard instrumentation model, called MBeans, for use in Java programs and by Java management applications. JMX also specifies a set of complementary services that work with MBean instrumentation to monitor and manage Java-based applications. These services range from simple monitors and timers to a powerful relation service that can be used to create user-defined associations between MBeans in named roles and a mechanism for dynamically loading new instrumentation and services at run time.
The installation procedure has the following steps:
Download the tmx4j_2.1.zip file.
Unpack the zip file in the directory where you wish to install (for instance using WinZip(R), unzip, or other equivalent utilities to extract compressed files in a ZIP archive). Do not install the TMX4J JAR files under the java extensions directory (
jre/lib/ext
), as this will create problems with the logging mechanism.After the TMX4J 2.1 software has been installed, yuo will see the following directory structure:
tmx4j/README.htmlthis file tmx4j/base/lib:jmxc.jar, jmxx.jar, jflt.jar (the core TMX4J JAR files), log.jar (the IBM Logging Toolkit for Java), jmx.properties (the configuration file) tmx4j/ext/bin/nt:jmxservice.exe and install_service.bat - NT Service bin/solaris:jmxd.sh, jmxd - Unix Daemon and associated script tmx4j/ext/lib:jmxext.jar (classes for the HTTP Adaptor, daemon, RMI Connector, JarInstaller), bootstrap.properties, adaptor.properties /lib/nt:jmx_error.dll /lib/solaris:libjmx_error.so tmx4j/ext/samples:sample java programs to demonstrate the use of TMX4J /samples/ntsample batch files for the NT platform /samples/solarissample scripts for the Unix platform /samples/mbeanssample TMX4J compliant MBeans tmx4j/docs:on-line documentation (FAQs, Tutorials, Overview of TMX4J, Overview of Sample Agent, etc.) /docs/base:documentation related to the TMX4J core software /docs/ext:documentation related to the TMX4J extensions Note: the installation includes the file
- (Optional) If you want to recover disk space, delete the tmx4j_2.1.zip file you originally downloaded.
- (Optional) Follow the installation procedure for the TMX4J Sample Agent for Windows NT or Solaris.
- If you choose not to install the Sample Agent, be sure to set the
CLASSPATH
variable correctly before using TMX4J. The sampleSetClassPath.bat
may serve as a useful guideline.log.jar
, which is IBM's Logging Toolkit for Java (JLog), Version 2.1.2.
For additional information, refer to these pages on the World Wide Web:
- http://www.alphaworks.ibm.com/tech/TMX4J
- The Tivoli JMX official home on IBM alphaWorks web site, with the latest information on TMX4J technology, software downloads, and discussion forums.
- http://jcp.org/aboutJava/communityprocess/final/jsr003/index.html
- The Final Release of the JMX Specification of the Java Community ProcessSM Program.
- http://www.tivoli.com
- The Tivoli Home page, with the latest information and news on products based on TMX4J technology.