Adding or removing BlackBerry Enterprise Server components

Article ID: KB27548

Type: Support Content

Last Modified: 07-30-2012

 

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 for IBM® Lotus® Domino®
  • BlackBerry® Enterprise Server 5.0 for Microsoft® Exchange®
  • BlackBerry® Enterprise Server 5.0 for Novell® GroupWise®
CollapseOverview

After installing a BlackBerry® Enterprise Server, one or more BlackBerry Enterprise Server components may be added or removed to the existing BlackBerry Enterprise Server.

CollapseResolution

To add or remove a BlackBerry Enterprise Server component, run the setup application again. The setup application removes the existing BlackBerry Enterprise Server software from the computer, and installs only the BlackBerry Enterprise Server components that are selected.

Before Beginning :

If High Availability is configured and components will be added or removed a BlackBerry Enterprise Server component from a computer that hosts a primary BlackBerry Enterprise Server, perform a manual fail-over to the standby BlackBerry Enterprise Server so that users are not affected by the adding or removing of a BlackBerry Enterprise Server component.

To remove a BlackBerry Router, BlackBerry Attachment Service, BlackBerry MDS Connection Service, BlackBerry Collaboration Service, or BlackBerry MDS Integration Service, use the BlackBerry Administration Service to remove the component from the list of component instances that the BlackBerry Enterprise Server use.

  1. Log in to a computer using the Windows® account that was used to install the BlackBerry Enterprise Server components.

    Note: For Domino environments, stop the IBM Lotus Domino server, and change the startup type of the IBM Lotus Domino server to manual.
  2. Stop the BlackBerry Enterprise Server services.
  3. In the BlackBerry Enterprise Server installation files, double-click setup.exe. If the operating system is Windows Server® 2008, run setup.exe as an administrator.
  4. In the Setup type dialog box, select Use an existing BlackBerry Configuration Database.
  5. In the Database information dialog box, perform the following actions:
    a. Verify the names of the database server and BlackBerry Configuration Database that the BlackBerry Enterprise Server instances use.
    b. If the database server was configured to use static ports, select the Static option. If the static port number is not 1433, in the Port field, type the port number.
  6. To configure database mirroring, select Add support for database mirroring in the Database mirroring options dialog box and type the name of the database server that hosts the mirror database in the Name of the mirror database server field. The setup application does not create the BlackBerry Configuration Database on the mirror Microsoft® SQL Server®; it adds a registry key to the computer that includes the name of the mirror Microsoft SQL Server.
  7. In the Setup options dialog box, select the components to be added and clear the check boxes for the components to be removed. The setup application upgrades any components that were installed previously.
  8. When the setup application prompts to restart the computer, click Yes.
  9. Log in to the computer using the same account that was used in step 1.
  10. In the Application extensibility information dialog box, consider the following information:

· Type an Fully Qualified Domain Name (FQDN) to create a BlackBerry MDS Integration Service pool or add the BlackBerry MDS Integration Service instance to a pool that was created during a previous installation process.

· To configure a hardware load balancer for the BlackBerry MDS Integration Service pool, type an FQDN that corresponds to a DNS record in the DNS server that maps the FQDN to the IP address of the virtual server that was configured on the hardware load-balancer.

· The setup application creates the BlackBerry MDS Integration Service database on the database server that hosts the BlackBerry Configuration Database.

· If the BlackBerry MDS Integration Service instance is added to an existing pool, the setup application selects the existing BlackBerry MDS Integration Service database and existing administrator account and publisher account.

  1. In the Administration settings dialog box, consider the following information:

· In the Pool name field, type a valid FQDN or IP address. The setup application uses the FQDN or IP address to create the BlackBerry Administration Service web address.

· It is mandatory to type the password for the SSL certificate that the BlackBerry Administration Service uses for authentication with browsers.

  1. In the Microsoft® Active Directory® settings dialog box, in the User password field, type the password for the Microsoft Active Directory account (for example, BESAdmin) that the BlackBerry Enterprise Server instance uses to authenticate to Microsoft Active Directory. After clicking Next, if the setup application cannot locate any of the global catalog servers that are associated with the Microsoft Active Directory account, choose the global catalog servers that will be added to the list manually. To add a global catalog server to the list, click Add and select the appropriate server. Each global catalog server that is added to the list must belong to the domain that the Microsoft Active Directory user account belongs to.

Note : In the DIIOP settings dialog box perform the following actions for Lotus Domino installations:

· In the FQDN field, type the FQDN of the IBM Lotus Domino server that is running the DIIOP task. If high availability is configured, for the DIIOP task, type the FQDN of a hardware load balancer entry or software load balancer entry.

· In the Port number field, type the TCP/IP port number for the DIIOP task (by default, port 63148).

  1. Start the services for the BlackBerry Enterprise Server instance.

  2. In the Console addresses dialog box, copy the web addresses for the BlackBerry Enterprise Server components and paste them into a document for future reference. The web addresses to log in to the BlackBerry Enterprise Server components may be used.

    Next Steps:

If components were added, perform one of the following actions to view the component information in the BlackBerry Administration Service:

  • Restart the BlackBerry Administration Service.
  • On every computer that hosts the BlackBerry Administration Service, go to: BlackBerry Administration Service >> Servers and components menu >> expand BlackBerry Solution topology >> BlackBerry Domain. Click Component view and then click Refresh list of registered components.

If components were removed other than the BlackBerry Router, use the BlackBerry Administration Service to delete the component information from the BlackBerry Configuration Database.

If the BlackBerry Administration Service was reinstalled, delete the cache content in Windows® Internet Explorer®.

CollapseAdditional Information

BlackBerry Enterprise Server

Choose one of the following options:

  • The BlackBerry Enterprise Server (which includes a BlackBerry Attachment Service, BlackBerry Dispatcher, BlackBerry MDS Connection Service, BlackBerry Messaging Agent, BlackBerry Policy Service, BlackBerry Router, and BlackBerry Synchronization Service) may be removed and have one or more remote components installed instead
  • Any remote components may be removed and install a BlackBerry Enterprise Server instead

BlackBerry Administration Service

Choose one of the following options:

  • If the BlackBerry Administration Service was installed with a BlackBerry Enterprise Server, it can be removed
  • If the BlackBerry Enterprise Server was installed, the BlackBerry Administration Service can be added
  • If the BlackBerry Administration Service was installed as a remote component, it can be removed
  • If remote components were installed, the BlackBerry Administration Service can be added

BlackBerry Attachment Service

Choose one of the following options:

  • If BlackBerry Attachment Service was installed as a remote component, it can be removed
  • The BlackBerry Attachment Service can be added to an existing installation of another remote component

BlackBerry Collaboration Service

Choose one of the following options:

  • If the BlackBerry Collaboration Service was installed with a BlackBerry Enterprise Server, it can be removed
  • If the BlackBerry Enterprise Server was installed, the BlackBerry Collaboration Service can be added
  • If the BlackBerry Collaboration Service was installed as a remote component, it can be removed
  • If remote components were installed, the BlackBerry Collaboration Service can be added

BlackBerry MDS Connection Service

Choose one of the following options:

  • If BlackBerry MDS Connection Service was installed as a remote component, it can be removed
  • The BlackBerry MDS Connection Service can be added to an existing installation of another remote component

BlackBerry MDS Integration Service

Choose one of the following options:

  • If the BlackBerry MDS Integration Service was installed with a BlackBerry Enterprise Server, it can be removed
  • If the BlackBerry Enterprise Server was installed, the BlackBerry MDS Integration Service can be added
  • If the BlackBerry MDS Integration Service was installed as a remote component, it can be removed
  • If remote components were installed, the BlackBerry MDS Integration Service can be added

BlackBerry Monitoring Service

Choose one of the following options:

  • If BlackBerry Monitoring Service was installed as a remote component, it can be removed
  • The BlackBerry Monitoring Service can be added to an existing installation of another remote component
  • Only one BlackBerry Monitoring Service instance can exist in the organization's BlackBerry Domain.

BlackBerry Router

Choose one of the following options:

  • If BlackBerry Router was installed as a remote component, it can be removed
  • The BlackBerry Router can be added to an existing installation of another remote component

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.