Add or remove a BlackBerry Enterprise Server component

When you perform this task, the BlackBerry® Enterprise Server components on the computer that you perform this task on are unavailable for use until the installation process is complete and you have restarted the BlackBerry Enterprise Server services.

The process includes a restart of a BlackBerry Enterprise Server.

Before you begin:
  • If you configured high availability and you want to add or remove a BlackBerry Enterprise Server component from a computer that hosts a primary BlackBerry Enterprise Server, perform a manual failover to the standby BlackBerry Enterprise Server so that users are not affected by the adding or removing of a BlackBerry Enterprise Server component.
  • If you configured database mirroring for the BlackBerry Configuration Database, you must verify that the BlackBerry Enterprise Server is connected to the principal database before you run the setup application.
  • If you want to remove a BlackBerry Router, BlackBerry Attachment Service, BlackBerry MDS Connection Service, or BlackBerry Collaboration Service, use the BlackBerry Administration Service to remove the component from the list of component instances that the BlackBerry Enterprise Server instances use.
  1. Log in to a computer using the Windows® account that you used to install the BlackBerry Enterprise Server components.
  2. If you installed the IBM® Lotus® Domino® server, perform the following actions:
    1. Stop the IBM® Lotus® Domino® server.
    2. Change the startup type of the IBM Lotus Domino server to manual.
  3. Stop the BlackBerry Enterprise Server services.
  4. In the BlackBerry Enterprise Server installation files, double-click setup.exe. If your operating system is Windows Server® 2008, run setup.exe as an administrator.
  5. In the Setup type dialog box, select Use an existing BlackBerry Configuration Database.
  6. In the Database information dialog box, perform the following actions:
    • Verify the names of the database server and BlackBerry Configuration Database that the BlackBerry Enterprise Server instances use.
    • If you configured the database server to use static ports, select the Static option. If the static port number is not 1433, in the Port field, type the port number.
  7. If you want to configure database mirroring, in the Database mirroring options dialog box, you can select Add support for database mirroring 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.
  8. In the Setup options dialog box, select the components that you want to add and clear the checkboxes for the components that you want to remove. The setup application upgrades any components that you installed previously that you select and the components might be unavailable for users during the installation process.
  9. When the setup application prompts you to restart the computer, click Yes.
  10. Log in to the computer using the same account that you used in step 1.
  11. 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.
    • You must type the password for the SSL certificate that the BlackBerry Administration Service uses for authentication with browsers.
  12. 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 you click the Next button, if the setup application cannot locate any of the global catalog servers that are associated with the Microsoft Active Directory account, you must choose the global catalog servers that you want to add to the list manually. To add a global catalog server to the list, click the Add button and select the appropriate server. Each global catalog server that you add to the list must belong to the domain that the Microsoft Active Directory user account belongs to.
  13. In the DIIOP settings dialog box perform the following actions:
    • In the FQDN field, type the FQDN of the IBM Lotus Domino server that is running the DIIOP task or if you want to configure high availability 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).
  14. Start the services for the BlackBerry Enterprise Server instance.
  15. 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. You can use the web addresses to log in to the BlackBerry Enterprise Server components.
After you finish:
  • If you added a component, to view the component information in the BlackBerry Administration Service, perform one of the following actions:
    • Restart the BlackBerry Administration Service.
    • On every computer that hosts the BlackBerry Administration Service, in the BlackBerry Administration Service, in the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain. Click Component view and then click Refresh list of registered components.
  • If you removed a component other than the BlackBerry Router, to delete the component information from the BlackBerry Configuration Database, use the BlackBerry Administration Service.
  • If you reinstalled the BlackBerry Administration Service, in Windows® Internet Explorer®, delete the cache content.

Was this information helpful? Send us your comments.