Using JConsole to access the MBeans

Edit online

Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15

You can use the JConsole tool to view the MBean attributes, modify the indexers and retrievers MBean attributes that are not in read-only mode, and invoke operations.

About this task

Whatever your choice, you use the JConsole in the same way.

Procedure

Launch JConsole using the following syntax.

On Windows:

jconsole -J-Djava.class.path=<JAVA_HOME>/lib/jconsole.jar;                                                                
                                <JAVA_HOME>/lib/tools.jar;
                                <PFS_INSTALL_DIR>/wlp/clients/restConnector.jar
           -J-Djavax.net.ssl.trustStore=trustStoreAbsoluteName
           -J-Djavax.net.ssl.trustStorePassword=trustStorePassword
           -J-Djavax.net.ssl.trustStoreType=keystoreType

On UNIX:

jconsole -J-Djava.class.path=<JAVA_HOME>/lib/jconsole.jar:
                                <JAVA_HOME>/lib/tools.jar:
                                <PFS_INSTALL_DIR>/wlp/clients/restConnector.jar
           -J-Djavax.net.ssl.trustStore=trustStoreAbsoluteName 
           -J-Djavax.net.ssl.trustStorePassword=trustStorePassword         
           -J-Djavax.net.ssl.trustStoreType=trustStoreType

trustStoreAbsoluteName is the name of a truststore prefixed with its absolute path.
trustStoreType is the type of the truststore.
trustStorePassword is the password for accessing the content of the truststore.

Example:

jconsole -J-Djava.class.path=C:/IBM/Java/lib/jconsole.jar;C:/IBM/Java/lib/tools.jar;C:/IBM/wlp/clients/restConnector.jar 
-J-Djavax.net.ssl.trustStore=C:/IBM/wlp/usr/servers/pfs/resources/security/key.jks 
-J-Djavax.net.ssl.trustStorePassword=password -J-Djavax.net.ssl.trustStoreType=jks

Provide authentication information for the connection:
1. Select the Remote Process connection.
2. Type the following service URL to connect JConsole to the Liberty REST Connector exposed by Process Federation Server, with the Process Federation Server host name for hostname, and the HTTPS port for port:service:jmx:rest://hostname:port/IBMJMXConnectorREST
3. Type the user name and the password.
  The user must be declared as a Liberty administrative user in the Liberty server.xml file.
Example:
```
url : service:jmx:rest://pfsHost.com:9443/IBMJMXConnectorREST
user : uid=admin,o=defaultWIMFileBasedRealm
password : admin
```
Go to the MBean tab:
- If you want to monitor a process indexer, go to com.ibm.bpm.federation.server > Indexers > BpdIndexers.
- If you want to monitor a BPEL indexer, go to com.ibm.bpm.federation.server > Indexers > BpelIndexers.
- If you want to monitor a process retriever, go to com.ibm.bpm.federation.server > Retrievers > BpdRetrievers.
- If you want to monitor a BPEL retriever, go to com.ibm.bpm.federation.server > Retrievers > BpelRetrievers.
- If you want to monitor a Case retriever, go to com.ibm.bpm.federation.server > Retrievers > CaseRetrievers.
Click:
- Attributes to view or manage attributes.
- Operation to invoke operations.