How to use the Java VisualVM to monitor the resource usage of the NuGenesis LMS Server service - WKB30386

OBJECTIVE or GOAL

Use the VisualVM tool in a Java RE to monitor and analyze the memory usage of the Java process for the NuGenesis LMS Server service.

ENVIRONMENT

• NuGenesis 9 LMS
• NuGenesis 8 LMS
• NuGenesis 8 ELN

PROCEDURE

1. There are two ways to monitor the LMS Server with VisualVM:
   • Remotely, with a JMX connection
   • Locally, with the JVisualVM tool running on the LMS Server machine
2. Locally is preferred because the VisualGC plugin is not compatible with JMX connections and this plugin provides greater insight into the memory usage of the server; however, this requires some downtime for the system.
3. The VisualVM tool requires an Oracle Java/OpenJDK installation.  VisualVM is incorporated into most releases of Oracle Java versions 7 and 8.  For later releases, and for OpenJDK, visualVM is a separate component.  Download the VisualVM tool from: VisualVM: Download
4. Local connection:
   • NuGenesis 8 LMS:
     1. Stop the NuGenesis LMS Server service.
     2. Edit the file: Drive:\WatersLMSServer\jboss.6.0.0.Final\bin\run.conf.bat
     3. Set the -Xmx parameter to match that of the LMS service.
        • Example: set "JAVA_OPTS=-Xms128M -Xmx4096M -XX:MaxPermSize=256M"
     4. Save and close the file.
     5. Run StartElnServer.bat.
     6. Run the jvisualvm.exe program
     7. When the LMS server is fully started, JVisualVM will see the server as a local Java process. The VisualGC tab will be available.
   • NuGenesis 9 LMS:
     1. Stop the NuGenesis LMS Server service
     2. Run the file Drive:\WatersLMSServer\Wildfly-11.0.0.Final\bin\startLmsServer.bat
     3. Run the jvisualvm.exe program, located in Drive:\oracle\prodcut\19.6.0\Oracle19c\jdk\bin

         

5. Remote connection via JMX:
   1. Run the jvisualvm.exe program in the JDK.
   2. Click File menu > Add Connection.
   3. In the "Connection:" box, specify the LMS server's hostname and the port 1190.
      • Example: lmsprod1:1190
   4. Click OK to create the connection.
   5. The VisualGC plugin does not work with JMX connections, but the Monitor, Threads, and Sample plugins work.

ADDITIONAL INFORMATION