- 2 minutes to read

Uninstalling the IBM MQ Monitoring Agent

The IBM MQ Monitoring Agent can be uninstalled running either the installer directly or by using 'Add or Remove Programs' in Windows.

You should remove affected Monitoring Agents and Resources in use within Monitor Views before uninstalling the agent.

If you uninstall the agent without removing the Monitoring Agents alerts with errors will be sent to users. Also, the Monitoring Agent Configuration will be listed as unavailable in the list of available Monitoring Agents.
Unavailable Monitoring Agent
Here's an example of unavailable Monitoring Agents


Add or remove Programs

Add or Remove Programs

Remove Installation

Start the installer

Double-click on the MSI file to start the un-installation of the IBM MQMonitoring Agent.
msi

Depending on settings in Windows a security warning may be presented. Click 'Run' to continue.
Warning

CloseBeforeUninstall

Welcome Screen

On successful execution of the MSI file or starting from 'Add or remove programs' a Welcome screen is presented.
Welcome

Click the 'Next' button to continue the installation 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.
Remove

If the Service was not stopped before uninstalling a dialogue may appear. Click 'Ok' to close and continue.

In Use

If the Service was not stopped before uninstalling a dialogue may appear. Click 'Ok' to close and continue.

Unable To Close

Ready to Remove Program

Click the 'Remove' button to remove the agent and proceed to the next step.
RemoveProgram.png

Completed setup

The last step of the un-installation gives either a success or a premature exit.
Successful un-installation example

Completed

Failed un-installation example: A failed un-installation will render a premature exit
Premature exit

Click the Finish button to Exit and quit the installer.

Support

Contact our Support for additional guidance if you fail to resolve the installation problem.

Note

Additional information to aid the troubleshooting may exist in the Windows Event Logs..


Next Step

Add or manage Monitor View
Add or manage a Monitoring Agent Configuration

IBM MQ Agent
Resources
Monitoring Agents
Monitor Views