SEPprep competitive product uninstall tool

Article:TECH148513  |  Created: 2011-01-19  |  Updated: 2014-05-13  |  Article URL http://www.symantec.com/docs/TECH148513
Article Type
Technical Solution


Issue



SEPprep is an unsupported tool that is designed to uninstall any competitive product automatically. This tool can also launch another application before or after removing all competitive products.  Configure this tool to first remove all competitive products (including Norton products) and then launch the SEP installer automatically and silently.  SEPprep works on all supported Windows SEP client operating systems (both 32-bit and 64-bit). There are two different binaries: one for 32-bit systems and one for 64-bit systems.


Environment



SEPprep works on all supported Windows SEP client operating systems (both 32-bit and 64-bit).  There are two different binaries: one for 32-bit systems and one for 64-bit systems.  SEPprep comes with and requires the use of the SEPprep.ini file. This file is used for configuration of the SEPprep tool.

The tool comes with several files: 

  • SEPprep.exe – The 32-bit version of the tool. This file can be renamed.
  • SEPprep64.exe – The 64-bit version of the tool. This file can be renamed.
  • SEPprep.ini – The configuration file used with both the 32-bit and 64-bit versions of the tool. This file is required for either SEPprep.exe or SEPprep64.exe to work.  This file cannot be renamed. It must be called SEPprep.ini.
  • SEPprep.pdf – Documentation on how the SEPprep tool works
  • SEPprep.mp4 - Demonstration video of how to use the SEPprep tool

Solution



The SEPprep tool and associated files are attached to this document and can be downloaded below.  To use the SEPprep tool follow the following steps:

How to Configure the SEPprep.ini file:  The SEPprep.ini configuration file has a number of options that control how the SEPprep tool works. This file is required for SEPprep.exe and SEPprep64.exe to function. The file works much like any other traditional .ini file. It is divided into three sections ([Settings], [UninstallPaths], [ProductNames]).  Within the sections are configurable options/features of this tool.  The .ini file and its configured values are the key to its functionality.

1.  [Settings]   This section is the first section in the file. All the items in this section of the .ini file control how the SEPprep tool runs.

  • ShowGUI:  This option controls whether the tool runs silently. Note: Even if this option is disabled, the popup messages will still be seen if the AskBeforeRemoval option is enabled.  This option can be set to Y or N. This option is disabled by default.
  • ShowMessageBox: This option controls whether the tool shows a custom message dialog before removing any competitive products. Note: The message box will always be shown if enabled, regardless of whether the ShowGUI option is enabled or the AskBeforeRemoval option is enabled.  This option can be set to Y or N. This option is disabled by default.
  • MessageBoxText: This option controls the text for the custom message box dialog. Use \n for line break and \t for tab. Note: the ShowMessageBox option must be enabled for this text to be displayed to the user. This option can be set to Y or N. This option is disabled by default.
  • AutoRunAfterUILoads: This option configures the tool to start running as soon as the user interface is loaded. In addition it also causes the tool to quit as soon as it has finished uninstalling all products and launched all programs. This option can be used to display the user interface, but still want the tool to run unattended. This option can be set to Y or N. This option is disabled by default.
  • AskBeforeRemoval: The AskBeforeRemoval option controls whether the tool should pop-up a message to ask the user before removing the competitive products that are found. This option can be set to Y or N. This is enabled by default. Note: the RunAfterRemoval commands will still run even if the user clicks “No”.
  • SilentMSIInstaller: The SilentMSIInstaller option will allow the tool to run the uninstallation of the competitor silently. If this option is enabled then the competitor’s uninstallation will happen silently. This option can be set to Y or N. This is enabled by default.
  • RemoveSymantec: The RemoveSymantec option controls whether SEPprep should remove any Symantec product it finds. This option will not remove all Symantec products, instead it will only remove the Symantec products listed in the [ProductNames] section of the SEPprep.ini file. If this option is disabled, it will skip any product it finds that has the word “Symantec” in it. Enabling this can be useful to remove products such as older versions of SAV or SCS. However, be careful, as this will remove the SEP client also. This option can be set to Y or N. This is disabled by default.
  • CheckDiskSpace: The CheckDiskSpace option checks to make sure there is at least 500 MBs of disk space before removing the competitive products. If there is not enough disk space found it will quit. This option can be set to Y or N. This is enabled by default.
  • EnableLogging: The EnableLogging option will enable a log file to be created to log which competitive applications where removed. The log file will always be called SEPprep.log. This option can be set to Y or N. This is disabled by default.
  • ResumeAfterReboot: The ResumeAfterReboot option will cause configure SEPprep tool to run after the system reboots. SEPprep does this by adding itself into the RunOnce registry key. Once the tool is launched after reboot it will automatically enable the AutoRunAfterUILoads option even if that option is not enabled in the SEPprep.ini file. This option can be set to Y or N. This is enabled by default.
  • LogPath: Use the LogPath option to choose where to save the log file. Environment variables are supported at the beginning of this string. The log file will always be called SEPprep.log. If the folder does not exist or if this line is blank SEPprep will log locally to the same folder as SEPprep is running from. The syntax for this is a valid folder path.
  • MSIExtraParameters: Use the MSIExtraParameters option to add additional parameters to the MSI uninstall strings. For instance this can be used to add the MSI uninstall password or to add some specific commands for the product being removed. These parameters are only added to the MSI uninstall strings.
  • InstallShieldExtraParameters: Use the InstallShieldExtraParameters option to add additional parameters to the InstallShield uninstall strings. For instance this can be used to add a silent parameter or to add some specific commands for the product being removed. These parameters are only added to the InstallShield uninstall strings.
  • DefaultExtraParameters: Use the DefaultExtraParameters option to add additional parameters to the uninstall strings, to add a silent parameter or some specific commands for the product being removed for example. These parameters are added to all uninstall strings.
  • RunBeforeRemoval: Use the RunBeforeRemoval option to configure a command to run before the tool removes any competitive product. Use this to do things like adding commands to clear out an uninstall password for the McAfee or Trend client or even for Sygate Protection Agent 5.1. Use the RunBeforeRemoval option to run multiple commands from the same .ini file. SEPprep will run each command in the order listed in SEPprep.ini file. The syntax for this should be the same as from the Run command in the Start Menu of Windows.
  • RunAfterRemoval: Use the RunAfterRemoval option to configure a command to run after the tool has removed all competitive products and before the SEPprep tool exits. Add the command to run the SEP installer here to allow SEP to be installed after SEPprep has completed. It is possible to have multiple RunAfterRemoval options in the same .ini file. SEPprep will run each command in the order listed in SEPprep.ini file. Note: the RunAfterRemoval commands will still run even if the user clicks “No” on the AskBeforeRemoval messages. The syntax for this should be the same as in the Run command in the Start Menu in Windows.
    • Defer installation of SEP until the next boot: In some cases the competitive software will require a reboot after uninstallation before installing Symantec Endpoint Protection. For instance CA iTechnology requires this. Also use SEPprep to remove Symantec Endpoint Protection and then reinstall if a reboot is required before reinstalltion. Here is a sample of how to configure SEPprep to reboot prior to installing Symantec Endpoint Protection:

RunAfterRemoval=reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce /v "Install SEP 11" /t REG_SZ /d "C:\SEPInst\SEPsetup.exe

RunAfterRemoval=cmd /c "md C:\SEPInst"

RunAfterRemoval=cmd /c "xcopy *.* C:\SEPInst /e /y"

RunAfterRemoval=shutdown -r -t 30 -f

2.  [UninstallPaths]  Use this section to add the registry path for uninstall strings. This is mainly for internal use and likely will not need to be modified. It currently only has one item listed but more items can be listed if  needed.


3.  [ProductNames]  This section lists the name of any product to uninstall. The SEPprep tool will search through the Add/Remove Programs for any product whose name matches part of or all of the strings listed here. The tool will go through this list in the order listed. Note: The tool will match even a part of the name specified.

How to add SEPprep to a SEP client installation package: The SEPrep tool can be added to a SEP client installation package so the SEP installer will remove any competitive product prior to deployment

1.  Get a copy of the SEP client installation package. The package cannot be a single EXE file. Unzip the exe file first, if the package is a single EXE file. 

  • Note: Most zip programs (such as WinZip) can extract the EXE file.
  • Note: Step 7 (below) will not work with a client package from the CD because not all files will be imported into the SEPM database. Client packages from the CD have the data1.cab file. Make sure the package used does not have any .cab files.

2.  Copy the SEPprep files into the SEP installation folder next to the setup.exe file.

3.  Verify whether the SEP client package is a 32-bit package or a 64-bit package.

  • If the SEP client package is a 32-bit package then copy the SEPprep.exe and the SEPprep.ini file into the SEP client installation folder.
  • If the client package is a 64-bit package then copy the SEPprep64.exe and the SEPprep.ini files into the SEP client installation folder.
  • Make sure to copy both the .exe file and the .ini file into the SEP installation folder alongside the setup.exe file.

4.  Rename the default setup.exe file to SEPsetup.exe.

5.  Rename the SEPprep.exe (or SEPprep64.exe) file previously copied into the folder, to setup.exe. (This will make SEPprep.exe run in place of the setup.exe file).

6.  Update the SEPprep.ini file to have it run SEPsetup.exe after removal.

7.  Open the SEPprep.ini file with Notepad and change the “RunAfterRemoval” line to “RunAfterRemoval=SEPsetup.exe” (no quotes). Make sure that all other settings in the .ini file are correct.


How to use SEPprep with the Find Unmanged Computers wizard: Add SEPprep to a SEP client package on the SEPM hard drive to enable use of the Find Unmanged Computers wizard.

Note: this will also affect the AutoUpgrade feature of the clients as they also use these files to upgrade themselves to a later version.

1.  Find the location on SEPM where the client packages are stored. For example, the SEP MR4MP2 32-bit install package is under

C:\Program Files\Symantec\Symantec Endpoint Protection Manager\Inetpub\ClientPackages\... ce2e122b9c98597ee66cd77f64d4ce25\full

2.  Verify whether the SEP client package is a 32-bit package or a 64-bit package.

3.  Copy the appropriate SEPprep files into the folder identified by following Step 1 above.

  • If the SEP client package is a 32-bit package then copy both the SEPprep.exe and the SEPprep.ini file into the SEP client installation folder.
  • If the client package is a 64-bit package then copy the SEPprep64.exe and the SEPprep.ini files into the SEP client installation folder.
  • Make sure to copy both the .exe file and the .ini file into the SEP installation folder alongside the setup.exe file.


4.  Rename the default setup.exe file to SEPsetup.exe.

5.  Rename SEPprep.exe to setup.exe.This will make SEPprep.exe run in place of the setup.exe file.

6.  Open the SEPprep.ini file with notepad and change the “RunAfterRemoval” line to “RunAfterRemoval=SEPsetup.exe” (without the quotes).

  • Make sure that all other settings in the .ini file are correct.

 


Attachments

SEPPrep 32-bit version of the tool
SEPprep.exe (204 kBytes)
SEPPrep 64-bit version of the tool
SEPprep64.exe (246 kBytes)


Configuration file used with both the 32-bit and 64-bit versions of the tool
SEPprep.ini (7 kBytes)
Documentation on how the SEPprep tool works
SEPprep.pdf (467 kBytes)
SEPprep ReadMe file
Readme.txt (3 kBytes)
Demonstration video of how to use the SEPprep tool
SEPprep.mp4 (11.5 MBytes)


Article URL http://www.symantec.com/docs/TECH148513


Terms of use for this information are found in Legal Notices