Welcome to the AMX home page. This page is dedicated to discussing the Appserver Management eXtensions MBean API available in Glassfish V2.x.
Feb 23. 2009 — for information on AMX in GlassFish V3, please see GlassFish
V3 AMX SPI.
AMX is composed of a client-side and server-side portions:
Clients may use the AMX APIs by including appserv-ext.jar in their java client classpath.
Please see note at top regarding GlassFish V3 vs V2.
21 July 2006—Reorganized this page, added instructions on checking out the sample code.
10 April 2006—Material has been added to AMX: Implementation. Though not yet complete, it will be helpful to anyone wanting to understand how AMX is implemented. The AMX: Design and Use document was updated recently also.
21 March 2006—The complex types support has been comitted to cvs. Complex types are now supported with the Logging interface (LogQueryResult), and certain web services types (WebServiceEndpointInfo and MessageTrace). The AMX Javadoc has been updated.
06 March 2006—Please see the summary of changes to the AMX 9.0 API.
06 March 2006—The Java Generics proposal is still pending. The code changes are done and tested, but not yet committed.
28 February 2006—The AMX white paper has been updated. Though not yet complete, it contains a substantial amount of content now.
23 January 2006—An AMX white paper is in progress. Though not yet complete, it already contains some helpful information.
The sample code may be checked out from the repository without checking out any of the other source code:
MB:/amx-samples lloyd$ cvs -d :pserver:firstname.lastname@example.org:/cvs login Logging in to :pserver:email@example.com:2401/cvs CVS password: ******** MB:/amx-samples lloyd$ cvs -d :pserver:firstname.lastname@example.org:/cvs co glassfish/www/javaee5/amx cvs server: Updating glassfish/www/javaee5/amx ...
You will also need a copy of appserv-ext.jar (for AMX client interfaces) and javaee.jar (for JSR77 Stats and Statistics interfaces). The casen be obtained from an installed (or built) version of Glassfish. Both appserv-ext.jar and javaee.jar are found in $INSTALL_ROOT/lib. Copy them to the samples directory.
Next, copy appserv-ext.jar to the samples directory:
MB:/amx-samples/www/javaee5/amx/samples lloyd$ cp /gf/run/lib/appserv-ext.jar . MB:/amx-samples/www/javaee5/amx/samples lloyd$ cp /gf/run/lib/javaee.jar .
Compile the samples:
MB:/gf/build/glassfish/www/javaee5/amx/samples lloyd$ sh compile-samples.sh Compiling AMX Samples... DONE
Start the server (if not already running).
MB:/ gf/run/bin/asadmin start-domain Starting Domain domain1, please wait. Log redirected to /gf/run/domains/domain1/logs/server.log. Domain domain1 is ready to receive client requests.
Run the Samples command line demo.
MB:/gf/build/glassfish/www/javaee5/amx/samples lloyd$ sh run-samples.sh Reading properties from: "SampleMain.properties" Connecting...:host=localhost, port=8686,
AMX uses JUnit as its test framework, and has extensive unit tests. For more information, see:
There are also additional links from the amx-unit-tests.html page.
ToDo list will be maintained using Issue Tracker