The provided TMX4J Sample Agent for NT consists of an NT Service, an HTTP Adaptor,
an RMI Connector, and a simple bootstrap service.
Installing the Sample Agent
- Open an MS-Dos Command Prompt.
- Change to the
tmx4j\ext\bin\nt
directory. (For convenience you may wish to
add this directory to your system PATH).
- Edit the file set_tmx4j_home.bat. In particular set the value of the TMX4J_HOME
variable (the TMX4J install directory), as well as the JAVA_BASE_DIR (the
JDK install directory).
- Type 'install_service.bat' to install the TMX4J Sample Agent. This will
set the Classpath, install the neccessary dll file, and set your Registry
for the NT Service.
- Note that you may need Administrator privileges to install the Service.
A note on the Agent Classpath
If you follow these instructions for installing the Sample Agent, your existing
system Classpath will be pre-pended with the neccessary TMX4J Classpath.
However it must be noted that, once the NT Service is running, additional
changes to your Classpath will not have any effect on the Agent Classpath.
To force these changes, you need to stop and restart the Service.
Startup
- To launch the Service, double click on the Services icon in the Control
Panel. Select the TMX4J NT Service, and click on the Start button.
Running
- The daemon will launch an Agent with a registered HTTP Protocol Adaptor,
and the list of MBeans defined in the
bootstrap.properties
file.
- To use the HTTP Adaptor, start your Web Browser and enter the following
address: http://<host name>:6969/ (substitute <hostname> with
the hostname of the computer where the NT Service is running, eg. localhost).
To change the default port from 6969, edit your
adaptor.properties
file.
- The Service logs information to the NT Event Logger (To view use the Windows
EventViewer and set the Log menu option to 'Application').
- The TMX4J application logging will be written to the Tmx4j_<n>.log
file, where the number n will be incremented each time the log file reaches
the specified size limit. (Note that the location of this file and the size
limit are specified in your
jmx.properties
file, by default the logfile is created in C:\WINNT\system32
).
- Once the Service is running, to avoid having to reinstall due to Classpath
or JVM changes, you can edit the Service registry key settings under the following
key:
'HKEY_LOCAL_MACHINE\SOFTWARE\Tivoli\TMX4J NT Service\Parameters'
.
It may be necessary to use NT's Regedit.exe to change the value of your JDK
path (JavaPath
) or CLASSPATH
here, for example.
Stopping
- Double click on the Services icon in the Control Panel. Select the TMX4J
NT Service, and click on the Stop button.
Uninstalling
- Change to the
tmx4j\ext\bin\nt
directory.
- Type
'uninstall_service.bat'
from the command line. Note, this will stop
the Service if it is running, and remove the Service-related Registry entries
and the installed dll. It will not delete the original files.
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/21/2001