Installing the Nodinite IBM MQ Monitoring Agent
Unlock seamless, secure monitoring for your IBM MQ environment with the Nodinite IBM MQ Monitoring Agent. This guide covers both the modern Portal-based installation (recommended) and the legacy MSI-based approach for remote servers.
Nodinite v7.0.4 and Later (Recommended)
New 7.0.4
IBM MQ Monitoring Agent v7.0.4 and later should be installed using the Nodinite Portal-based scripted installation. This modern approach provides automated installation and configuration with minimal manual intervention.
Why Use Portal-Based Installation?
✅ Automated agent installation and configuration 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
✅ Includes AI Diagnostics New 7.0.4 for intelligent error analysis
✅ Supports .NET 10 Hosting Bundle for modern runtime performance
Get Started with Portal-Based Installation
Follow the comprehensive Install Nodinite v7 guide to install the IBM MQ Monitoring Agent using the Portal-based approach. The Portal generates PowerShell scripts that install and configure the agent automatically.
Key Steps:
- Register your environment in the Nodinite Portal
- Select IBM MQ Agent in the Agents configuration tab
- Configure agent settings (port, service account, queue manager connections)
- Download the installation package with embedded PowerShell scripts
- Run the PowerShell script to install and configure automatically
Complete Portal Installation Guide - Step-by-step instructions with screenshots
Legacy Installation (Remote Servers Only - Not Recommended)
Warning
Deprecated: The MSI-based installation method is legacy and intended only for remote server installations where the Portal-based approach cannot be used. This method is not recommended for new deployments and will be retired in future versions.
Important
Version 7.0.4+ Users: If you are installing IBM MQ Monitoring Agent v7.0.4 or later, use the Portal-based installation method instead. The MSI approach below is for legacy v6 installations or remote servers only.
When to Use MSI Installation
Use this method only if:
- You are installing on a remote server that cannot be managed via Portal scripts
- You are maintaining a legacy v6 environment (upgrade to v7 recommended)
- You have specific infrastructure constraints preventing automated installation
MSI Installation Prerequisites
Follow these steps to install the Nodinite IBM MQ Monitoring Agent using the legacy MSI-based approach.
Note
You must be a local administrator to install Windows Services.
Before you begin
Make sure you meet all prerequisites for IBM MQ Monitoring Agent before proceeding.
Step 1: Start the installer
From the server where you want to install the IBM MQ Monitoring Agent, use RDP and double-click the MSI file to launch the installation.
The MSI installer for IBM MQ Monitoring Agent.
Step 2: Welcome Screen
When the MSI file runs, you'll see the Welcome screen.
Welcome screen for the IBM MQ Monitoring Agent installer.
Click 'Next' to continue or 'Cancel' to exit the installer.
Step 3: Custom Setup
Select features and the installation location. Default settings are recommended for most users.
Custom setup options for the IBM MQ Monitoring Agent.
Click 'Next' to proceed or 'Cancel' to exit.
Step 4: Service Account Information
Enter credentials for the Account that will run the IBM MQ Monitoring Agent as a Windows Service. You will set specific user rights per queue manager later during Configuration.
- Account (Domain\User)
- Domain: Enter the domain name or use the server name/dot (.) for a local account
- User: Enter the account name
- Password: Enter the password for the account.
Service account credentials for the IBM MQ Monitoring Agent.
Note
The account must have 'Log on as Service Right'. Review Prerequisites for details.
Click 'Next' to continue or 'Cancel' to exit.
Step 5: Ready to install
Ready to install the IBM MQ Monitoring Agent.
Files in use
If the Monitoring Agent is already installed and you are performing an Update, you may see a dialog about files in use. Select 'Close the applications and attempt to restart them' and click 'Ok'.
Depending on current load and threads in use, the operation may take anywhere from 0-30 seconds to complete
Dialog shown when updating an existing Monitoring Agent installation.
Insufficient Privileges
If the account information does not meet the Prerequisites for the IBM MQ Monitoring Agent, you will see an error message.
Error message for insufficient privileges during installation.
The most common reasons are that the account is not allowed to run as a service or is not a local Administrator. Follow the How to set Logon as a Service right guide and click retry. If the problem persists, click cancel and restart. Make sure to enter valid credentials!
Tip
Check the local event log for errors (both System and Application).
Step 6: Completed setup
The final step shows either a success or a premature exit.
Successful installation example
Successful installation of the IBM MQ Monitoring Agent.
Failed installation example: A failed installation will result in a premature exit.
Premature exit due to failed installation.
Click Finish to exit the installer.
When setup completes successfully, your default text editor will open a file named 'README.txt'. This file contains additional information needed to add the agent as a Monitoring Agent. The file is [re]generated on each successful start.
README.txt file with post-installation instructions.
To add the IBM MQ Monitoring Agent as a Monitoring Agent, follow the shared article below:
Support
If you encounter installation issues, contact our Support team for expert guidance.
Note
Additional troubleshooting information may be available in the Windows Event Logs.
Frequently asked questions
Find solutions to common problems and FAQs for the Nodinite IBM MQ Monitoring Agent in the Troubleshooting user guide.
Next Step
Add or manage a Monitoring Agent Configuration
Configuration
Uninstall
Update