To develop an application that uses the Teracloud®
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 Teracloud
Streams resources. To use the JMX API successfully, users must be authorized to
access Teracloud
Streams objects.
You can configure the access control lists by using the Streams
Console.
Alternatively, you can use the streamtool setacl command
to set domain and instance permissions.
- Determine the URL that you can use to establish a JMX
connection. The URL is the connection string for the JMX 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 files
in your class path:
- jmxremote_optional.jar
- glassfish-corba-omgapi-*.jar
- commons-cli-*.jar
These
files can be found in the following directory: product-installation-root-directory/ext/lib.
Note: you will need to replace the * in the jar file names with the version numbers of the files in this directory.
Important: To find
and use the Teracloud
Streams JMX
connector implementation successfully, you must include com.ibm.streams.management.jmxmp.jar in
the class path before jmxremote_optional.jar.