To develop an application that uses the IBM®
Streams JMX
API, you must configure the access control lists and determine the
JMX URL for establishing a connection.
You can then build
and run your application with the required Java™ archive (.jar) files.
Procedure
- Configure the access control lists for the IBM
Streams resources. To use the JMX API successfully, users must be authorized to
access IBM
Streams objects.
You can configure the access control lists by using the Streams
Console.
Alternatively, you can use the streamtool setacl command
to set instance permissions and the streamtool setdomainacl command
to set domain permissions.
- Determine the URL that you can use to establish a JMX
connection. The URL is the connection string for the management API service.
You can use the streamtool getjmxconnect command
to obtain this information.
- Build and run your application with the necessary Java archive (.jar) files. To
successfully compile your application, you must include the following .jar files
in your class path: com.ibm.streams.management.jmxmp.jar; com.ibm.streams.management.mx.jar. These
files can be found in the following directory: product-installation-root-directory/lib.
To
successfully run the application, you must also include the following
.jar file
in your class path:
product-installation-root-directory/ext/lib
jmxremote_optional.jar.
Important: To find
and use the IBM
Streams JMX
connector implementation successfully, you must include the com.ibm.streams.management.jmxmp.jar in
the class path before the jmxremote_optional.jar.