README

TMX4J, Tivoli Management eXtension for JavaTM
Version 2.1

Contents

Introduction

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.

What is TMX4J?

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.

How does it work?

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.

Installation

The installation procedure has the following steps:
tmx4j/README.html
this 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/nt
sample batch files for the NT platform
               /samples/solaris
sample scripts for the Unix platform
               /samples/mbeans
sample 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 log.jar, which is IBM's Logging Toolkit for Java (JLog), Version 2.1.2.

Web Pages on JMX

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.

 


Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.
 
File Last Updated: 11/26/2001