Overview
Corruption-related issues in the application, environment, or other environment variables may prevent the system from uninstalling MailEssentials successfully. Full removal of all installed components is necessary for confirming that the application is no longer affecting the processing of messages. This is useful for isolating issues that are solely related to the environment or other variables.
This article provides the process of manually removing GFI MailEssentials when the recommended process through the uninstallation wizard from the Windows Control Panel is not sufficient or fails to complete successfully.
Note: The article references the following registry keys with their abbreviations:
HKLM
: HKEY_LOCAL_MACHINE
HKCR
: HKEY_CLASSES_ROOT
Solution
Manually uninstalling MailEssentials involves four processes:
- Disabling the Processing of Messages
- Removing Services
- Removing Product Specific Registry Data
- Removing Installation Metadata from Registry
- Registry Keys Used for Detecting Installations
- Counters for Shared DLLs
- GFI MailEssentials Entry from Add/Remove Programs
Disabling Processing of Messages
Follow the steps below when dealing with Exchange 2003 SMTP (Simple Mail Transfer Protocol) event sinks:
- Open the MetaEditor/MetaEdit or the Registry Editor (regedit.exe).
Note: Get MetaEditor from Microsoft Downloads.
- Delete the following binding references:
HKLM\SmtpSvc\<SMTPINSTANCE>\EventManager\EventTypes\{F6628C90-0D5E-11d2-AA68-00C04FA35B82}\Bindings\{83D5BC59-B6C8-4B77-88B0-B7CA8F3BA1AC}
HKLM\SmtpSvc\<SMTPINSTANCE>\EventManager\EventTypes\{F6628C90-0D5E-11d2-AA68-00C04FA35B82}\Bindings\{2F0EF2E3-5A3E-40F6-B021-1BDDB43C35EF}
HKLM\SmtpSvc\<SMTPINSTANCE>\EventManager\EventTypes\{FF3CAA23-00B9-11d2-9DFB-00C04FA322BA}\Bindings\{A7D837CC-6273-4DA0-8B83-AFFCC9942B2B}
HKLM\SmtpSvc\<SMTPINSTANCE>\EventManager\EventTypes\{FF3CAA23-00B9-11d2-9DFB-00C04FA322BA}\Bindings\{5D631EE6-61BA-4F19-B7C3-4BAFB6A30876}
Note: Only delete the binding reference. Deleting the sink event itself (i.e., F6628C...) instead of the binding event (i.e., 83D5BC...) can cause adverse issues for other applications that are bound to the SMTP event (i.e., FaxMaker).
Follow the steps below when dealing with Exchange 2007+ Transport Agents:
- Start Exchange Management Shell.
- Execute the following commands:
Uninstall-TransportAgent -Identity "GfiAsRtSubmittedAgent"
Uninstall-TransportAgent -Identity "GfiAsRtRoutedAgent"
Uninstall-TransportAgent -Identity "GfiAsSmtpAgent"
Uninstall-TransportAgent -Identity "GfiAsSmtp2Agent"
Uninstall-TransportAgent -Identity "GfiAvSmtpAgent"
Uninstall-TransportAgent -Identity "GfiAvRoutingAgent"
- Answer
[Y]
as 'yes' to confirm.
Removing Services
- Open regedit.exe.
- Open
HKLM\SYSTEM\CurrentControlSet\Services
. - Each key listed here represents an individual service. Delete the following keys for MailEssentials:
Listserv
gfiscans
gfimesattendant
gfimesavupdate
gfiscanm
gfimesbackend
gfiasmsecatt
gfimesqashost
gfipop2exch
- To remove MailEssentials from restore points, delete any instances of these keys present in
HKLM\SYSTEM\ControlSet00x\Services
.
Note: During normal operations, this is an optional step.
Removing Product Specific Registry Data
- Open regedit.exe.
- Delete the following key:
- On 32-bit environments:
HKLM\SOFTWARE\GFI\MailEssentials
- On 64-bit environments:
HKLM\SOFTWARE\WOW6432NODE\GFI\MailEssentials
- On 32-bit environments:
Removing Installation Metadata from Registry
Remove registry keys and metadata values that the bootstrapper and windows installer use for detecting MailEssentials. These remnants, if not removed, can trigger a state in the bootstrapper to start the uninstall chain.
To remove this metadata from the registry keys, open regedit.exe file and perform the steps given in the following sections:
Registry Keys Used for Detecting Installations
On Windows 2008 (Vanilla and R2) and Windows 2012:
- Remove keys under
HKCR\Installer\Assemblies
that are related to MailEssentials. - Find
HKCR\Installer\UpgradesCodes\E32D08E2AE81F6D42A2CE4D31919F6F4
. It will have two values:Default
.- A key similar to
EA752CE510938D949A7CB96CE709B021
(let’s call thisPRODUCTCODE
). These are the upgrade and product codes used by the installation to determine the product, update, or version.
- Find and delete the following:
HKCR\Installer\Products\PRODUCTCODE
HKCR\Installer\Features\PRODUCTCODE
HKLM\Software\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Products\PRODUCTCODE
HKCR\Installer\UpgradesCodes\E32D08E2AE81F6D42A2CE4D31919F6F4
On Windows 2008 R2 and Windows 2003:
- Remove any keys under
HKCR\Installer\Dependencies
that are related to MailEssentials. They can be recognized with theirDisplayName
, which contains 'GFI MailEssentials for Exchange/SMTP'.
On Windows 2008 and Windows 2012:
- Remove any keys under
HKCR\Wow6432Node\Installer\Dependencies
that are related to MailEssentials. They can be recognized with theirDisplayName
, which contains 'GFI MailEssentials for Exchange/SMTP'.
Note: The keys deleted in the steps above have the same names that were used to populate the registry key for Add/Remove Programs located at HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
.
Counters for Shared DLLs
- Delete any values with the original installation path of MailEssentials from
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\SharedDLLs
. - If no other GFI products are installed, delete any values with
\<CommonFilesFolder>\GFI\common
.
GFI MailEssentials Entry from Add/Remove Programs
- Navigate to the following key
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
.
Note: If the target machine is an x64 environment, navigate to
HKLM\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall
. - You will see a bunch of letters and numbers as subkeys of this key. Go through these keys and remove the ones that have the
DisplayName
set to 'GFI MailEssentials for Exchange/SMTP'.
Confirmation
A complete uninstall is confirmed by restarting the server after the registry changes have been made and confirming that there are no orphan services left in the Windows Services Manager (services.msc). Refer to this linked article for detailed information on all Services Installed by MailEssentials.