Updating the Nodinite IBM MQ Monitoring Agent
The Nodinite IBM MQ Monitoring Agent is built on .NET and follows a monthly update release cycle with security patches, performance improvements, and bug fixes. Keep your monitoring 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 a releases, visit the Release Notes for the IBM MQ 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
You can view the installed version in the 'Version' text box.
Example of the Version text box displaying the installed IBM MQ Monitoring Agent version.
You can also check the file details property on the local installation.
Example of the file version details property for the IBM MQ Monitoring Agent.
Compatibility and versioning issues
| Version | Comment |
|---|---|
| 5.3.x | Sensitive information is now encrypted and the configuration file is tied with the service account/password combination. Make sure to store passwords in your password-protected manager. |
Prerequisites for Updating
Before you update, make sure you have successfully installed the Nodinite IBM MQ Monitoring Agent. The Service account credentials you use must have Logon as Service Right. See Prerequisites for IBM MQ Monitoring Agent for more information. You must be a local administrator to install (and thereby update) Windows Services.
Step 1: Start the installer
Double-click the MSI file to start the update process.
Example of the MSI installer file for the IBM MQ Monitoring Agent.
Depending on your Windows settings, a security warning may appear. Click 'Run' to continue.
Example of the Windows security warning dialog when launching the installer.
Step 2: Welcome Screen
When you successfully execute the MSI file, a Welcome screen appears.
Example of the Welcome screen in the IBM MQ Monitoring Agent installer.
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Step 3: Custom Setup
Select the Components and the Location for the installation. The Default settings are recommended.
Example of the Custom Setup screen showing component and location selection.
Note
If you change the location, you will lose your old configuration.
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Step 4: Service Account Information
Enter the credentials for the Account that will run the Nodinite IBM MQ Monitoring Agent. Depending on the connection string settings, this account will log on and query the databases being monitored.
Service Account Fields
Domain: Enter the name of the Domain the Server belongs to. If you use a local account, use the name of the server or a . (dot) as Domain.
User: Enter the name of the account.
Password: Enter the password for the account.
Example of the service account credentials dialog for the IBM MQ Monitoring Agent.
Note
The account must have 'Log on as Service Right'.
Click the 'Next' button to continue with the update process or click the 'Cancel' button to quit the installer.
Insufficient Privileges
If the account information does not meet Prerequisites, you will see an error message.
Example of the Insufficient Privileges error message during installation.
If you see 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 you enter valid credentials!
Tip
Check the local event log if you see 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 after a successful update.
If the update fails, you will see a premature exit.
Example of the premature exit screen indicating a failed update.
Click the 'Finish' button to exit and quit the installer (update process).
When the setup finishes, the default text editor opens a text file named 'README.txt'. The README.txt file holds additional information you need to manage the agent as a Monitoring Agents.
Example of the README.txt file opened in the default text editor after installation.
Support
If you fail to resolve the update problem, contact our Support.
Note
Additional information to aid troubleshooting may exist in the Windows Event Logs.
Next Step
Add or manage a Monitoring Agent Configuration
Configuration of the agent
Install IBM MQ Monitoring Agent
Uninstall