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.
Nodinite version 7
Important
The JMX Monitoring Agent is not yet available for automated Portal-based installation in Nodinite v7. Please contact Nodinite Support for installation details and assistance.
Future: Portal-Based Scripted Installation
Once available, agent installation will be automated through the Portal-based scripted installation. This modern approach will:
✅ Automate agent installation and configuration via PowerShell scripts
✅ Configure multiple agents simultaneously with consistent settings
✅ Eliminate manual installations and reduce human error
✅ Centrally manage all environments from the Portal
Nodinite version 6 (Manual Installation - Current Method)
Warning
The manual installation method for Nodinite v6 is the current installation method for the JMX Monitoring Agent. This may be replaced with Portal-based scripted installation in a future release.
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.
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
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