Overview

The Unity Uninstall Utility will remove all Unity related files, registry settings and most directory items in Exchange/Active Directory from you system. You will need to manually remove 3 accounts and 3 distribution lists from your system after uninstalling before your system is clean. After that, you should be able to install a clean version of Unity after doing that and rebooting your server.

Requirements/Special Notes

This version of Uninstall only works with Unity 3.0(1) and later and 4.0(1) and later. There is a separate version for the 2.x uninstallation.

This tool does NOT remove Dialogic, NMS or Cisco TSPs or WAV drivers. Before running the Unity Uninstall utility you should Manually remove these items. See "Removing TSP and WAV drivers manually" below for more details on that process. It also does not remove Active Fax if installed. See “Removing Active Fax manually” below for more on that process.

If you are uninstalling a Unity server that is part of a failover configuration, see the “Uninstalling with Failover” section below.

This version of Uninstall will remove objects from the directory that were added by setup for Unity 4.0(3) and later. For versions of Unity earlier than that it will leave all objects in the directory and provides a list of objects that need to be removed manually for a complete uninstall. See the Removal Details section below for more.

Installation and Execution

To install and run the Uninstall utility you must be logged in as the account that installed Unity. Access to the directory for removing objects will not be possible if you're logged in as another administrator account. Simply run Setup.exe, no reboot is necessary.

When you run the Uninstal Utility you will be warned several times before being allowed to actually proceed. You can NOT undo this operation. Once the uninstall starts your Unity system will be inoperable and a reinstall will be required. Proceed with caution.

Be sure to follow the instructions at the end of the install. You will need to manually remove a few accounts and distribution lists by hand (these will be listed for you at the end of the uninstall) and sometimes the Unity install directory does not get fully removed and you need to remove it manually after a reboot (you’ll be warned of this at the end of the uninstall as well).

Removal Details

The Uninstall utility takes the following steps:

All Unity subscribers associated with the Unity server the tool is run on have their Unity specific data removed from them. This doesn't have any affect on their normal mail user properties in Exchange, only the Unity specific extensions are removed. High level items that are not Unity specific such as the recorded voice name are left in tact. Only Subscribers associated with the local Unity server will have their Unity specific properties removed so if you have multiple Unity servers installed into the same Exchange site, the uninstall should not affect users associated with the other systems.
The example administrator, example subscriber and Unity messaging system accounts created by the Unity setup are removed from the directory for Unity 4.0(3) and later. For earlier versions of Unity the accounts that need to be removed are presented on a dialog box at the end of the uninstall process.
All location objects associated with the local Unity server are removed from the directory entirely for Unity 4.0(3) and later. For earlier versions of Unity a dialog box is presented at the end of the uninstall detailing with location objects should be removed.
The public distribution lists that were added to the system by the Unity setup are removed from the directory entirely for Unity 4.0(3) and later. For earlier versions of Unity a dialog box is presented at the end of the uninstall detailing which distribution lists should be removed.
The Unity database information is removed from SQL. This includes all call handlers, COS definitions, interview handlers, restriction tables etc…
All Unity specific services are stopped and then removed from the Service Control Manager.
All Unity related registry settings are removed.
The Commserver directory and all it's subdirectories are removed from the hard drive. If some process has a handle open to a file under this directory the entire directory tree may not be removed – if this happens a warning dialog is displayed at the end of the uninstall process that tells you to manually remove the directory after a reboot.
The Unity program group is removed.
The links to the SA, Status monitor and the “part 2 setup” link are removed from the desktop.
The Tray status application is removed from the startup group.
All the Unity specific web information for the SA, AA and Status Monitor sites is removed from the wwwroot directory.
Several Unity specific DLLs are removed from the WinNT\System32 directory.

NOTE: The automatic removal of accounts and distribution lists noted above only happens for Unity 4.0(3) and later. For versions of Unity prior to that, when the uninstall completes you need to delete the following accounts by hand, either in Active Directory or in Exchange 5.5 depending on what your back end is:

Example Administrator
Example Subscriber
Unity_<machine name>
UAMIS (if the AMIS feature is installed)
“All Subscribers” distribution list
“System Event Messages” distribution list
“Unaddressed Messages” distribution list

NOTE: The Unity folder is not removed by the Uninstall utility. It’s not necessary to remove it, but if you feel the need follow the instructions in the “removing location objects manually” below.

As noted above, the Uninstall utility does not remove any TSP or WAV drivers that may be installed. You will want to remove Dialogic, NMS and/or Cisco TSP and WAV drivers manually before running the Uninstall utility. Since some of the Dialogic driver information is stored under the \commserver directory if you don’t’ do this before you Uninstall Unity it can be a real headache to remove properly later. Warning dialogs with this information are presented to the user at the beginning of the uninstall process.

Uninstalling With Failover

If you are uninstalling a Unity server that is the primary box in a failover configuration you first need to disconnect the servers from each other and terminate SQL replication between the boxes. The details for handling this are covered in the Failover guide in the “Uninstalling Failover on a Cisco Unity System” chapter. This document can be found online at:

http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity31/fail/fail31/fog_300.htm

If you run the uninstallation tool without first doing this, the failover will fail and you will have to clean up your system manually. If the Uninstall sees that the local system is the primary server in a failover configuration, it will warn you of that fact and give you the opportunity to exit the uninstall process and complete these steps.

Option to skip removing subscriber information from mail users in directory

If you’re uninstalling a fail over server or you’ve manually removed the “Unity” folder from Exchange or reinstalled Exchange or for whatever reason want the uninstall utility to skip removing all Exchange objects and subscriber information, uncheck the “Remove subscriber information from mail users in directory” checkbox in the “options” section. This will cause the installer to skip steps 1 and 2 under the Removal Details section above.

This can be handy if you’ve reinstalled Exchange but forgot to remove Unity first and you want to clean up all the Unity specific files on your hard drive and in the registry before installing a new version of Unity. This is required if you’re uninstalling a fail over server since you don’t want to remove the subscriber data in that case or the primary server will be render useless.

Removing Location Objects Manually

While it’s not necessary to do so, you can remove the location objects manually. NOTE: Just to be clear, it is NOT necessary to remove the Unity folder or delete the location objects to install Unity clean on the system. If, however, you want to remove the folder added by Unity, you may do so. For Unity 4.0(3) and later the local location objects are deleted from the directory automatically, for versions of Unity prior to that they are left in the directory.

WARNING: If there are other Unity servers installed in the directory, Do NOT remove any location objects, just leave them there. You run the risk of removing the wrong location object (one associated with another Unity server) which will render the other Unity server(s) inoperable.

For Exchange 5.5

You must open the Exchange Administrator in “raw” mode. You can do this by running the admin tool (ADMIN.EXE in the \Exchsrvr\bin directory) with the “-r” command line parameter. When the Exchange admin program comes up, select the Unity folder and then select “Edit | Delete Raw Object”. You’ll be asked to confirm and then the folder will be removed. Removing this folder will remove all location objects under it (there are not other objects stored here in Unity 3.0)<