How to remove decommissioned BlackBerry Enterprise Servers from the BlackBerry Administration Service console

Article ID: KB20515

Type: Support Content

Last Modified: 01-29-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Lotus Domino
  • BlackBerry Enterprise Server for Novell GroupWise
CollapseEnvironment
  • BlackBerry Enterprise Server 5.0 to 5.0 SP3
CollapseOverview

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 software from the server hosting the 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. To accomplish this, there are two options:
  1. If removing one of multiple components installed on a particular host server:
    1. Run the setup.exe file from the latest installation media that was used on the server.
    2. At the component selection screen, uncheck the component you wish to remove.
    3. Complete the setup process before proceeding to Task 2.
  2. If removing all components installed on a particular host server:
    1. Refer to KB04096 for instructions on the complete removal of BlackBerry Enterprise Server software.

Note: If this task 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 the SYNC, POLC, LOG and ALRT. These components should be removed when the BlackBerry Enterprise Server instance is removed.

Disclaimer

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

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase 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 www.blackberry.com/btsc.