Uninstalling the IBM MQ Monitoring Agent
Easily and safely uninstall the IBM MQ Monitoring Agent for Nodinite by following this step-by-step guide. On this page, you will learn how to:
- ✅ Remove the IBM MQ Monitoring Agent using the installer or Windows Add/Remove Programs
- ✅ Clean up all related Monitoring Agents and Resources to avoid errors
- ✅ Prevent unnecessary alerts and keep your monitoring environment healthy
- ✅ Troubleshoot and resolve common uninstall issues
Nodinite version 7
Preferred Method: Portal-Based PowerShell Script
In Nodinite v7, agent uninstallation is automated through the Portal-based PowerShell scripts. This modern approach:
✅ Automates agent removal via PowerShell commands
✅ Removes multiple agents simultaneously with consistent settings
✅ Eliminates manual uninstallation steps and reduces human error
✅ Centrally manages uninstallation from the Portal
Nodinite version 6 (Add or Remove Programs - Legacy)
Warning
The Add or Remove Programs uninstallation method for Nodinite v6 is deprecated and will be retired. Please upgrade to Nodinite v7 for the modern Portal-based scripted uninstallation experience.
Before You Uninstall
Important
Remove Nodinite configurations BEFORE uninstalling the agent to prevent error alerts and maintain a clean monitoring environment.
Required Configuration Changes
- Remove Resources - Delete all Resources associated with this agent from Monitor Views
- Remove Monitoring Agent Configuration - Delete the Monitoring Agent entry from Administration
- Update Monitor Views - Remove any filters by Category, Application, or specific Resources from this agent
What Happens If You Skip This?
If you uninstall the agent without removing configurations:
- ❌ Users receive continuous error alerts - Monitor Views will show "unavailable" errors for missing resources
- ❌ Monitoring Agent appears broken - Configuration shows as unavailable in Monitoring Agents list
- ❌ Monitor Views display errors - Any view filtering by this agent's resources will fail
- ❌ Cleanup requires manual intervention - You'll need to log into Nodinite to remove orphaned configurations
Example of unavailable Monitoring Agents after uninstalling without removing configurations.
Uninstall Methods
You can uninstall the IBM MQ Monitoring Agent by running the installer directly or by using 'Add or Remove Programs' in Windows. This IBM MQ Message Queuing cleanup can include resources related to queue, Topic, and Broker monitoring scenarios.
Add or remove Programs
Example of Windows Programs and Features where the IBM MQ Monitoring Agent can be selected for uninstall.
Start the installer
Double-click the MSI file to start uninstalling the IBM MQ Monitoring Agent.
Example of the MSI installer used to begin the uninstall process.
If Windows displays a security warning, click 'Run' or 'Open' to proceed.
Welcome Screen
When you successfully execute the MSI file or start from 'Add or Remove Programs', a Welcome screen appears.
Example of welcome screen of the IBM MQ Monitoring Agent uninstaller.
Click the 'Next' button to continue the uninstall process or click the 'Cancel' button to quit the installer.
Change, Repair, Remove
In the 'Change, Repair, Remove' dialogue, click the 'Remove' button to uninstall the agent and proceed to the next step.
Example of the Remove option used to uninstall the agent.
Files in Use
If you did not stop the Service before uninstalling, Windows may display a files-in-use dialog. Click 'Ok' or 'Ignore' to continue with the uninstall.
Ready to Remove Program
Click the 'Remove' button to remove the agent and proceed to the next step.
Example of final confirmation before removing the agent.
Completed setup
The last step of the un-installation gives either a success or a premature exit.
Successful un-installation example
Example of successful uninstall example.
Failed un-installation example: If the uninstall fails, you will see a premature exit.
Example of a failed uninstall with premature exit.
Click the Finish button to exit and quit the installer.
Support
If you fail to resolve the uninstall problem, contact our Support.
Note
Additional information to aid troubleshooting may exist in the Windows Event Logs.
Next Step
Add or manage Monitor View
Add or manage a Monitoring Agent Configuration