7.1 Starting the Jconsole Client

Jconsole is included in your JDK installation. To start it:


  1. Use the command jconsole in any directory.

    The JConsole: New Connection dialog opens.

    The JConsole: New Connection dialog

    If you want to monitor a local JVM process, select the Local Process option, select the process you want to view and then click on the Connect button.

    Note!

    Which process you should to select depends on what you want to monitor. If you want to monitor the Event Server, select the codeserver process. For other monitoring, e g Event Sender or workflow, select the picostart process for the Execution Context that the Event Sender or workflow is running on.

  2. If you want to be able to monitor a JVM process remotely, you have to add a few JVM properties in the platform.conf and the relevant Execution Context <pico>.conf files.

    Example - How to set the JVM properties

    If you enter the following properties in the platform.conf and the relevant Execution Context <pico>.conf (or both) using the mzsh topo command, you can connect to port 9999 without having to enter any user name or password, and without using SSL:

    mzsh topo set topo://container:<container>/pico:<pico name>/obj:config.jvmargs \
    'jmxremoteport:["-Dcom.sun.management.jmxremote.port=9999"]
    jmxremoteauthenticate:["-Dcom.sun.management.jmxremote.authenticate=false"]
    jmxremotessl:["-Dcom.sun.management.jmxremote.ssl=false"]'

    Note!

    Use different ports if you set remote ports in both the platform.conf or the relevant Execution Context <pico>.conf.

    For further information about which ports that you are recommended to use, how to set up user names and passwords, how to set up SSL, and remote monitoring and management in general, see the JVM product documentation regarding JConsole Management.

    In the New Connection dialog, you can then select the option Remote Process. Enter the hostname and port along with any username and password that may apply, and click the Connect button.

    The Java Monitoring & Management Console opens.