How to decommission a BlackBerry Enterprise Server or component and remove it from the BlackBerry Administration Service console

Article ID: KB20515

Type: Support Content

Last Modified: 09-26-2014


Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
  • BlackBerry Enterprise Server for Novell GroupWise
  • BlackBerry Enterprise Server 5.0 to 5.0 SP4

To remove a decommissioned BlackBerry Enterprise Server, or remote component, from the BlackBerry Domain, remove the components from the BlackBerry Administration Service console by completing the following tasks:

  1. Uninstall the BlackBerry Enterprise Server software from the server hosting the component that needs to be removed.
  2. Remove the BlackBerry Enterprise Server components from the BlackBerry Configuration Database using the BlackBerry Administration Service.

Task 1- Uninstall the BlackBerry Enterprise Server or component that needs to be removed.

Before the components can be removed from the BlackBerry Configuration Database, the services for the BlackBerry Enterprise Server instance or remote component being removed must first be uninstalled from the computer hosting them.

Partial Uninstall

To remove one or more BlackBerry Enterprise Server components (but not all the components) that are installed on a particular host server:

  1. Run the setup.exe file from the latest service pack that was used on the server.
  2. At the component selection screen, uncheck the component(s) to be uninstalled / deleted.
  3. Complete the setup process before proceeding to Task 2.

Complete Uninstall

If removing all BlackBerry Enterprise Server components installed on one or more particular host servers, refer to the following article for instructions on the complete removal of BlackBerry Enterprise Server software: KB04096.

Note: If Task 1 is not completed, the services may still be communicating with the BlackBerry Configuration Database. This could prevent the BlackBerry Administration Service from being able to remove the component from the BlackBerry Configuration Database.

Task 2 - Remove the BlackBerry Enterprise Server components

  1. In the BlackBerry Administration Service console, navigate to Servers and components > BlackBerry Solution topology > BlackBerry Domain > Component View.

    Note: Select Component View rather than expanding it.

  2. In the Component View, locate the appropriate BlackBerry Enterprise Server component section, for example, Controller. Click the trashcan icon next to the component to be removed.
  3. The BlackBerry Administration Service console asks Are you sure you want to delete this instance?. A summary including key information points is displayed. To confirm the deletion, select the Yes - Delete the instance link below the summary.
  4. The BlackBerry Administration Service then performs a series of checks to ensure the BlackBerry Enterprise Server component can be deleted. If all conditions have been met, a final notification is displayed:

    All conditions have been met for the <component> instance to be deleted. Are you sure you want to delete this instance?

  5. Select the Yes - Delete the instance link to delete the BlackBerry Enterprise Server component.

    The deletion is confirmed by the message, The instance has been deleted.

  6. Repeat these steps for each component of the decommissioned BlackBerry Enterprise Server to be removed.

    Note: It is important not to remove components that still are in use. Review the summary page before confirming deletion to ensure that active components are not removed.

CollapseAdditional Information

This article contains information previously documented in articles KB19317, KB20020 and KB20088.

Please note that some components which are associated with the BlackBerry Enterprise Server instance will not have the trash icon in the BlackBerry Administration console. These are:

  • BlackBerry Synchronization Service (SYNC)
  • BlackBerry Policy Service (POLC)
  • LOG
  • BlackBerry Alert Service (ALRT).

Those components should be automatically removed when the BlackBerry Enterprise Server instance is removed.


By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.

Visit the BlackBerry Technical Solution Center at