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
You can uninstall the IBM MQ Monitoring Agent by running the installer directly or by using 'Add or Remove Programs' in Windows.
Remove affected Monitoring Agents and Resources from Monitor Views before you uninstall the agent.
If you uninstall the agent without removing the Monitoring Agents, users will receive error alerts. The Monitoring Agent Configuration will also appear as unavailable in the list of Monitoring Agents.
Here's an example of unavailable Monitoring Agents.
Add or remove Programs
Open Add or Remove Programs in Windows to start the uninstall process.
Select the IBM MQ Monitoring Agent and choose to remove the installation.
Start the installer
Double-click the MSI file to start uninstalling the IBM MQ Monitoring Agent.
Run the MSI installer to begin the uninstall process.
Depending on your Windows settings, a security warning may appear. Click 'Run' to continue.
Security warning prompt when launching the installer.
If prompted, close any running services before uninstalling.
Welcome Screen
When you successfully execute the MSI file or start from 'Add or Remove Programs', a Welcome screen appears.
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.
Choose 'Remove' to uninstall the agent.
If you did not stop the Service before uninstalling, a dialogue may appear. Click 'Ok' to close and continue.
Dialog if files are in use during uninstall.
If you did not stop the Service before uninstalling, a dialogue may appear. Click 'Ok' to close and continue.
Dialog if unable to close files during uninstall.
Ready to Remove Program
Click the 'Remove' button to remove the agent and proceed to the next step.
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
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