- 3 minutes to read

Installing the Nodinite JMX Monitoring Agent

This guide teaches how to install the Nodinite JMX Monitoring Agent for use with Nodinite in order to Monitor JVM CPU and Memory.

Note

You must be a local administrator to have the right to install Windows Services and IIS Web Applications.

Before you begin

Make sure you comply with the prerequisites for JMX Monitoring Agent.

Step 1: Install Open JDK

First, Download and install the Open JDK.

Then, review the following environment paths:

  • JAVA_HOME - Default
  • ORACLE_HOME - IF you are using the Oracle JDK

Verify the environment variable points to the folder where you installed the Open JDK version to use.

Step 2: Download and Extract files for the Nodinite JMX Agent

From the Nodinite Portal, download the version to use and extract the files to folder: C:\Program Files\Nodinite\Monitoring Agent - JMX on the target server.

C:\Program Files\Nodinite\Monitoring Agent - JMX

Make sure to Unblock the extracted files.

Get-ChildItem -Path 'C:\Program Files\Nodinite\Monitoring Agent - JMX\' -Recurse | Unblock-File

Step 3: Create IIS Application

You can opt to use a new Web Site or create a new Web Application. Depending on your choice, the Service URI will look different. This guide simply creates a new Web Application in the Default Web Site.

In IIS, point the Web Site or the Web Application to the folder with the agent.

C:\Program Files\Nodinite\Monitoring Agent - JMX

Application Pool

  • Application Pool Identity
  • Unmanaged code

Next, please verify the Web Application is operational. In the IIS MMC, open the Web Application; then, you should be able to explore the Swagger-enabled API.
Swagger enabled API
The Agents sports a Swagger enabled API.

Instructions on how to add the JMX Monitoring agent as a Monitoring Agents is detailed in a shared article, click on the link below to learn more:

Step 4: Run agent as a Windows Service

In this step, you will download a free 3rd party tool to run the Nodinite JMX Monitoring agent as a service.

https://nssm.cc/ add 3rd party

https://nssm.cc/download

Put it in the same folder as the Nodinite JMX monitoring agent

nssm install "Nodinite JMX API" "%JAVA_HOME%\bin\java.exe" "-jar C:\Program Files\Nodinite\Monitoring Agent - JMX" nodinitejmxapi-1.0.2.jar

Note

The version may be different and you may have to adjust accordingly.


Support

Contact our Support for additional guidance if you fail to resolve the installation problem.

Note

Additional information to aid the troubleshooting may exist in the Windows Event Logs.

Frequently asked questions

Additional solutions to common problems and the FAQ for the Nodinite JMX Monitoring agent exist in the Troubleshooting user guide.


Next Step

Add or manage a Monitoring Agent Configuration
Update
Uninstall

Configuration
Monitoring Agents
Prerequisites