Uninstalling the Message Queueing Monitoring Agent
This guide walks you through the safe and complete uninstallation of the Nodinite Message Queueing Monitoring Agent. Follow these steps to avoid common pitfalls, prevent unnecessary alerts, and ensure a clean removal from your environment.
✅ Step-by-step instructions for a safe uninstall
✅ Prevent orphaned agents and error alerts in Monitor Views
✅ Visual examples for each step
✅ Support resources for troubleshooting
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.
The Message Queueing Monitoring Agent can be uninstalled by running the installer directly or by using 'Add or Remove Programs' in Windows.
Before uninstalling, remove affected Monitoring Agents and Resources from your Monitor Views.
If you uninstall the agent without removing the Monitoring Agents, users will receive error alerts, and the Monitoring Agent Configuration will appear as unavailable in the list of Monitoring Agents.
Example of uninstalled and therefore unavailable Monitoring Agents:
Generic example of unavailable Monitoring Agents
Uninstall guide
Follow these steps to uninstall the Message Queueing Monitoring Agent:
Before You Uninstall
Important
Remove Nodinite configurations BEFORE uninstalling the agent to prevent continuous error alerts for all users.
Required Configuration Changes
Before clicking Uninstall, complete these steps in the [Web Client][]:
- Remove Resources – Delete all Resources monitored by this agent
- Remove Monitoring Agent Configuration – Delete the agent from Monitoring Agents
- Update Monitor Views – Remove this agent from all Monitor Views
What Happens If You Skip This?
❌ Users receive continuous error alerts: "Monitoring agent unavailable"
❌ Agent appears broken in Monitoring Agents list
❌ Monitor Views display errors for missing agent
❌ Cleanup requires manual intervention across all views
Step 1: Add or Remove Programs
Use the Windows built-in feature to remove installed programs.
Windows 'Add or remove programs' feature.
From the list of installed programs, select the Message Queueing Monitoring Agent.
![Remove Installation][]
List of installed Nodinite applications
Step 2: Start the installer
Optionally, double-click the MSI file to start the [un]-installation of Nodinite.
Start the MSI installer to begin uninstallation.
Step 3: Welcome Screen
On successful execution of the MSI file or starting from 'Add or remove programs', a Welcome screen is presented.
Welcome screen for the uninstallation process.
Click the 'Next' button to continue or the 'Cancel' button to quit the installer.
Step 4: Change, Repair or Remove the installation
In the 'Change, repair or remove installation' dialog, click the 'Remove' button to uninstall the agent and proceed to the next step.
Choose Remove to uninstall the agent.
Step 5: Remove Program
Click the 'Remove' button to remove the agent and proceed to the next step. Final removal of the agent.
Completed setup
The last step of the un-installation gives either a success or a premature exit.
Successful un-installation example
Uninstallation completed successfully.
Failed un-installation example: A failed un-installation will render a premature exit
Premature exit if uninstall fails.
Click the Finish button to exit and quit the installer.
Support
Contact our Support for additional guidance if you fail to resolve the uninstallation problem.
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
Related Topics
Message Queueing Monitoring Agent
Resources
Monitoring Agents
Monitor Views