Uninstall of Windows agent failed

Owned by Walter Fisch
Last updated: Oct 28, 2024 by Matthew Hierholzer
3 min read


During uninstalling the Windows Agent, we detect several times the following messages:

LAST TESTED ON CHECKMK 2.3.0P1

Screenshot of a windows installer error. The error reads 22996aa.msi is not valid installation package for the product Check_MK agent. Try to find the installation package check-mk-agent-v1pvq1 in a folder from which you can install Check_MK agent.

Screenshot of the windows installer. The feature you are trying to use is on a network resource that is unavailable. Click OK.


The file 'C:\Windows\Installer\22996aa.msi' is not a valid installation package for the product Check_MK agent. Try to find the installation package check-mk-agent-v1pvq1 in a folder from which you can install Check_MK agent.


Table of Contents


We analyzed this further and noticed that this is happening if you remove the following files:

  • C:\Windows\Installer\ .msi
  • check-mk-agent-1.x.x-xyz.msi

Windows can't uninstall the Checkmk Agent if both files are missing from the system. So please don't remove both files.

If you're using the Agent Bakery, please keep in mind that for restoring, you need the Agent from the bakery with the same hash as previously installed on the system.

If you delete both files accidentally, you need to follow these steps for uninstalling the Checkmk Agent successfully.

Step-by-step guide

  1. Remove the corresponding Registry (delete the entire folder): Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Check_MK_Agent

  2. Stop the Checkmk Agent Service

    net stop Check_MK_Agent #(for CheckMK Agent 1.5)
net stop CheckMKService #(for CheckMK Agent 1.6 and 2.x)
  3. Remove the Directory  "C:\Program Files (x86)\check_mk"
    • In Control Panel "\Programs\Uninstall a program" you will find one deprecated entry for Check_MK Agent

  4. Download the troubleshooter for removing this entry:
    • Link to download the troubleshooter

    • Uninstall CheckMK Agent with the troubleshooter

      1. Open the uninstallation program
        Screenshot of the Windows Download folder. MicrosoftProgram_install_and_uninstall.meta.diagcab application selected.
        .
      2. Click Next
        Screenshot of the windows program install and uninstall troubleshooter. The Next button is highlighted.
        .
      3. Click Uninstalling
        Screenshot of the windows program install and uninstall troubleshooter. The Uninstalling button is highlighted.
        .
      4. Select your Checkmk Agent and click Next

        .
      5. Click Yes, try uninstall
        Screenshot of the windows uninstaller. Yes, try uninstall is highlighted.

      6. Click Close the troubleshooter
        Screenshot of the windows uninstaller. Close the troubleshooter is highlighted.
  5. Reboot