Updating the Database Monitoring Agent
The Nodinite Database Monitoring Agent is currently migrating from .NET Framework 4.8 to .NET and follows a monthly update release cycle with security patches, performance improvements, and bug fixes. Keep your agent up to date to maintain support and ensure compatibility with Nodinite Core Services.
On this page, you will learn how to:
- ✅ Update agents using the modern Portal-based scripted installation (v7 - recommended)
- ✅ Apply MSI-based updates to remote servers when Portal approach is not available (legacy)
- ✅ Verify compatibility and versioning for seamless upgrades
- ✅ Troubleshoot and resolve common update issues
Release notes
For information about the releases, please visit the Release Notes for the Database Monitoring Agent.
Important
Always read the release notes before updating to understand new features, bug fixes, and potential breaking changes.
Nodinite version 7
Preferred Method: Portal-Based Scripted Installation
In Nodinite v7, updating agents is automated through the Portal-based scripted installation. This modern approach:
✅ Automates agent installation and updates via PowerShell scripts
✅ Configures multiple agents simultaneously with consistent settings
✅ Eliminates manual MSI installations and reduces human error
✅ Centrally manages all environments from the Portal
Follow the Install Nodinite v7 or Update Nodinite v7 guide to update agents using the Portal-based approach. The Portal generates PowerShell scripts that install and configure agents automatically.
Nodinite version 6 (MSI-Based Installation - Legacy)
Warning
The MSI-based installation method for Nodinite v6 is deprecated and will be retired. Please upgrade to Nodinite v7 for the modern Portal-based scripted installation experience.
Running Version
The installed version is displayed in the 'Version' text box.
Example of the Version text box showing the installed agent version.
You can also get this information from the file details property on the local installation:
Example of file version details in Windows Explorer properties.
Prerequisites for Updating
You must have successfully installed the Nodinite Database Monitoring Agent prior to an update. The Service account credentials to use must have Logon as Service Right. See Prerequisites for Database Monitoring Agent for more information. You must be a local administrator to have the right to install (and thereby update) Windows Services.
Compatibility and versioning issues
- 5.0 -> 5.1
- New installation folder is being used, move 'Settings.json' from old folder to new folder and restart
- New Service URL due to changed name of the agent: http://SERVERNAME:8000/Nodinite/Monitor/Agent/Database/
- All Specific categories have been removed, review your Monitor Views after the update
- 4.X -> 5.X review Updating from V4 to V5
- 4.1.0.x -> 4.1.0.y
- Additional features have been added, make sure to review settings and affected Monitor Views after an update
- LogText for Resources written by the Monitoring Agents have been modified to never change unless the state does.
- 4.0 -> 4.1
- Update from older XML configuration based versions requires a manual re-configuration (open old configuration file using notepad and then copy paste applicable settings).
Update guide
Follow the steps next to update the Database Monitoring Agent.
Step 1: Start the installer
Double-click on the MSI file to start the update of the Nodinite Database Monitoring Agent.
Example of the MSI installer file for the Database Monitoring Agent.
Step 2: Welcome Screen
On successful execution of the MSI file, a Welcome screen is presented.
Example of the Welcome screen in the Database Monitoring Agent installer.
Click the 'Next' button to continue with the update process or the 'Cancel' button to quit the installer.
Step 3: Custom Setup
Select features and the location to update.
Example of the Custom Setup screen showing feature selection and installation location.
Note
Default settings are recommended
Note
If you change the location your old configuration will be lost
Click the 'Next' button to continue with the update process or the 'Cancel' button to quit the installer.
Step 4: Service Account Information
Enter the credentials for the Account to run Nodinite Database Monitoring Agent.
Note
Depending on the connection string used in remote configuration different accounts may be used when monitoring different databases
Service Account Fields
Domain: The name of the Domain the Server belongs to. If a local account is being used, use the name of the server or a . (dot) as Domain
User: The name of the account
Password: The password for the account
Example of the Service Account Information screen with domain, user, and password fields.
Note
The account must have 'Log on as Service Right'
Click the 'Next' button to continue with the update process or the 'Cancel' button to quit the installer.
Insufficient Privileges
Error message when account information does not meet Prerequisites.
Example of the Insufficient Privileges error message during installation.
If you get this message, the most common reason is that the account is not allowed to run as a service or is not a local Administrator on the server. Follow the guide How to set Logon as a Service right and click retry. If the problem remains, click cancel and restart. Make sure to enter valid credentials!
Tip
Check the local event log if there are errors (both System and Application)
Step 5: Completed setup
The last step of the update process gives either a success or a premature exit.
Example of the Completed Setup screen showing successful update.
Click the 'Finish' button to Exit and quit the installer (update process).
When the setup has finished the default text editor will open a text file named the 'README.txt'. The README.txt file holds additional information that you need to manage the agent as a Monitoring Agents.
Example of the README.txt file opened after installation with configuration information.
Troubleshooting
A failed update will render a premature exit.
Example of the Premature Exit screen indicating a failed update.
Support
Contact our Support for additional guidance if you fail to resolve the update problem.
Note
Additional information to aid the troubleshooting may exist in the Windows Event Logs.
Next Step
Configuration of the agent
Add or manage a Monitoring Agent Configuration