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.
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