Upgrade Guide

Local Navigation

Prerequisites: Upgrading the BlackBerry Enterprise Server software

  • The BlackBerry® Configuration Database and all BlackBerry Administration Service instances in the BlackBerry Domain must run the same version of the BlackBerry® Enterprise Server software. Before you upgrade the BlackBerry Configuration Database, you must stop the BlackBerry Administration Service services that run on all other computers in the BlackBerry Domain until you upgrade the computers.
  • Install or upgrade the BlackBerry Administration Service on the computer that you perform the upgrade process on in the BlackBerry Domain first.
  • Upgrade all BlackBerry Enterprise Server instances to version 4.1 SP7 or later.
  • If you installed the BlackBerry MDS Integration Service, you must remove it before you upgrade to the latest BlackBerry Enterprise Server version.
  • Retrieve the following information:
    • BlackBerry® Client Access License key
    • SRP host (for BlackBerry Enterprise Server 5.0 and later, the format of the SRP host is different from earlier versions)
    • SRP identifier
    • SRP key
    • computer name and port number of the instant messaging server (use the virtual server name and port number where the AJAX service is installed for Microsoft® Office Live Communications Server 2005 and Microsoft® Office Communications Server 2007)
    • computer name and port number of the proxy server (optional)
  • If you upgrade from the BlackBerry Enterprise Server Small Business Edition to a BlackBerry Enterprise Server, you must obtain a BlackBerry Enterprise Server Trade-Up Key. For more information, visit www.blackberry.com/btsc to read article KB03535.
  • Delete inactive user accounts from the BlackBerry Enterprise Server.
  • If you upgrade from BlackBerry Enterprise Server software 5.0 or earlier, remove the BlackBerry Administration API from all of the computers that host the BlackBerry Administration Service in the BlackBerry Domain. You can use the Windows control panel to remove the BlackBerry Administration API. In BlackBerry Enterprise Server 5.0 SP1 and later, the setup application installs the BlackBerry Administration API automatically when the setup application installs the BlackBerry Administration Service.
  • Close all BlackBerry Manager instances in the BlackBerry Domain and do not open the instances again. If you run the BlackBerry Manager with BlackBerry Enterprise Server 5.0 and later, you might experience issues with the BlackBerry Configuration Database.
  • Back up the BlackBerry Enterprise Server databases.
  • If you configured database replication for the BlackBerry Configuration Database, turn database replication off during the upgrade process to avoid possible errors.
  • If you installed the BlackBerry database notification system on a remote Microsoft® SQL Server®, upgrade the BlackBerry database notification system manually.
  • If you configured the BlackBerry Administration Service instances in a pool to communicate across network subnets using TCP, you must configure the instances again in the BlackBerry Administration Service after you complete the upgrade process.
  • Verify that the Windows® account that you use to upgrade the BlackBerry Enterprise Server software is the same account that you used to install the BlackBerry Enterprise Server software.
  • If you install the BlackBerry Administration Service, verify that a WAN bridge does not separate the computers that host the BlackBerry Administration Service and BlackBerry Configuration Database.
  • If you perform the upgrade on a computer that has more than one NIC, verify that the production NIC is first in the bind order in Windows network settings.
  • If you want to install Microsoft SQL Server 2005 Express Edition SP3 on a computer that does not host any BlackBerry Enterprise Server components, you can navigate to the Tools folder in the BlackBerry Enterprise Server installation files and run Sqlexpr.exe.

Was this information helpful? Send us your comments.