Configuring and Connecting to JMX on an OUAF-based Product

Use this procedure only for monitoring performance for products that are based on OUAF 4.2 or later. Using it for other products will cause the process to abort with an "Operation not supported" error.

  1. Obtain BATCH_RMI_PORT and other variables from the ENVIRON.INI file as described in the following table.
    Table 1. Common Information for JMX Connections
    Field Comment Source
    Batch Mode Execution Mode BATCH_MODE (ENVIRON.INI)
    Cluster Address Cluster Address COHERENCE_CLUSTER_ADDRESS (ENVIRON.INI)
    Cluster Port Cluster Port COHERENCE_CLUSTER_PORT (ENVIRON.INI)
    Batch JMX Port RMI Port for connection BATCH_RMI_PORT (ENVIRON.INI)
    Online Batch Enabled Whether Online Batch is enabled BATCHENABLED (ENVIRON.INI)
    Online Batch Threads Number of threads allocated to DEFAULT threadpools BATCHTHREADS (ENVIRON.INI)
    Online Batch Daemon Whether Online Batch Daemon is enabled BATCHDAEMON (ENVIRON.INI)
  2. Obtain the JMX user name and password from the following files contained in SPLEBASE/scripts:
    • Access file: ouaf.jmx.access.file
    • Encrypted password file: ouaf.jmx.password.file.
  3. Connect to JMX using the Java API class javax.management.remote (JMXConnector, JMXServiceURL).

    • If connecting to a batch server target, use the URL:

      
jmx:rmi:///jndi/rmi://server:port/spl/fw/jmxConnector

    • If connecting to a web application target, use the URL:

      
jmx:rmi:///jndi/rmi://server:port/oracle/ouaf/webAppConnector

    • If connecting to a web services target, use the URL:

      
jmx:rmi:///jndi/rmi://server:port/oracle/ouaf/ejbAppConnector

    If BATCH_RMI_PORT is not available, the error message "JMX support not configured" is issued. If a connection is not available, the error message "JMX Service not available" is issued.

  4. Use the following stub/beans to obtain values from the server:
    • com.splwg.base.support.batch.management.ActiveBatchMBean
    • com.splwg.base.support.batch.management.ActiveBatchJobMBean
    • com.splwg.base.support.batch.management.ActiveClusteredNodeMBean
    • com.splwg.base.support.batch.management.ActiveCobolBatchThreadMBean
    • com.splwg.base.support.batch.management.ActiveGridNodeMBean
    • com.splwg.base.support.batch.management.ActiveJavaBatchThreadMBean