blob: 7aef60847bd1c50d16aed47a9b6c863faf949f21 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<!--
Copyright (c) 2018 Oracle and/or its affiliates. All rights reserved.
This program and the accompanying materials are made available under the
terms of the Eclipse Distribution License v. 1.0, which is available at
http://www.eclipse.org/org/documents/edl-v10.php.
SPDX-License-Identifier: BSD-3-Clause
-->
<title>README--AMX SDK</title>
<meta http-equiv="content-type"
content="text/html; charset=ISO-8859-1">
<meta name="description"
content="Starting place for Appserver Management Extensions (AMX) SDK">
</head>
<body bgcolor="#ffffff">
<div style="text-align: center;"><big><big><big><span
style="font-weight: bold;"><small>Appserver Management Extensions
(AMX) README</small> <br>
</span></big></big></big>
<div style="text-align: left;"><br>
<small><span style="font-style: italic;">Last updated: 27 January 2004</span></small><br>
<br>
<big style="font-weight: bold;">Introduction<br>
<br>
</big>Sun's Java Enterprise System Appserver, and the J2EE SDK both now
include an Java Management Extensions (JMX) MBean API for
management/configuration and monitoring of the server.&nbsp; This API
is denoted <span style="font-weight: bold;">A</span>ppserver <span
style="font-weight: bold;">M</span>anagement E<span
style="font-weight: bold;">X</span>tensions (AMX), <span
style="font-style: italic;"><span style="font-weight: bold;">A</span>ppserver
</span>because
it's for the Appserver, <span style="font-style: italic;"><span
style="font-weight: bold;">M</span>anagement </span>because it covers
configuration,
management, and monitoring, <span style="font-style: italic;">E</span><span
style="font-weight: bold; font-style: italic;">x</span><span
style="font-style: italic;">tensions </span>because the APIs go well
beyond the J2EE Management (JSR 77) specification.<big
style="font-weight: bold;"><br>
</big><br>
<big><span style="font-weight: bold;">Contents</span></big><br>
<br>
The SDK consists of the following:<br>
<br>
<table cellpadding="2" cellspacing="2" border="1"
style="text-align: left; width: 100%;">
<tbody>
<tr>
<td style="vertical-align: top; font-weight: bold;"><a
href="./amx-javadoc">Item<br>
</a> </td>
<td style="vertical-align: top; font-weight: bold;"><a
href="./amx-javadoc">Description<br>
</a> </td>
</tr>
<tr>
<td style="vertical-align: top;"><span
style="font-family: monospace;">amx-client.jar</span><br>
</td>
<td style="vertical-align: top;">jar file containing the <a
href="./amx-javadoc/index.html">AMX
APIs</a>. Tthe contents of this jar are almost entirely interfaces, but
there are some concrete classes as needed to support clients.<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;"><a
href="./amx-javadoc/index.html"><span style="font-family: monospace;">amx-javadoc/</span></a><br
style="font-family: monospace;">
<a href="./samples-javadoc/index.html"><span
style="font-family: monospace;">samples-javadoc/</span></a><br>
</td>
<td style="vertical-align: top;">Javadoc for the AMX APIs, and
the sample code, respectively.<br>
</td>
</tr>
<tr>
<td style="vertical-align: top; font-family: monospace;"><a
href="./samples/amx">samples/amx</a><br>
</td>
<td style="vertical-align: top;">source code for the samples<br>
</td>
</tr>
<tr>
<td style="vertical-align: top; font-family: monospace;"><a
href="./run-samples.sh">run-samples.sh</a><br>
<a href="./run-samples.bat">run-samples.bat</a><br>
</td>
<td style="vertical-align: top;">Scripts to run the sample
command line.<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;"><a href="./SampleMain.properties"><span
style="font-family: monospace;">SampleMain.properties</span></a><br>
</td>
<td style="vertical-align: top;">Properties file used by the
sample command line.&nbsp; <span style="font-weight: bold;">Edit this
file</span> appropriately for your target server.<br>
</td>
</tr>
<tr>
<td style="vertical-align: top;"><span
style="font-family: monospace;">jmxri.jar</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">javax77.jar</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">jmxremote.jar</span><br>
</td>
<td style="vertical-align: top;">Required jar files containing
JMX 1.2, J2EE Management (JSR 77) and JMX Remote (JSR 160)
classes.&nbsp; The contents of these jar files is required.&nbsp; Note
that JMX and JMX Remote are included in JDK 1.5, but not in JDK 1.4<br>
</td>
</tr>
</tbody>
</table>
<br>
</div>
</div>
The source code is already compiled.&nbsp; Edit <a
href="./SampleMain.properties">SampleMain.properties</a>
appropriately, and run the sample script.<br>
<br>
<br>
<br>
</body>
</html>