How to migrate the BlackBerry Enterprise Server to new hardware using a second SRP

Article ID: KB12304

Type: Support Content

Last Modified: 07-09-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Domino
  • BlackBerry Enterprise Server for Novell GroupWise
  • BlackBerry Enterprise Server Express for Microsoft Exchange
CollapseEnvironment
  • BlackBerry Enterprise Server 4.0 to 5.0
  • BlackBerry Enterprise Server Express 5.0
  • BlackBerry smartphones
  • Windows 
CollapseOverview

This process allows for phased migration of BlackBerry smartphone users between multiple versions of the BlackBerry Enterprise Server. Two Server Routing Protocol (SRP) Identifiers are necessary to complete migration using multiple servers.

To obtain the new replacement SRP to be used for the migration, follow the information appropriate to the edition of the BlackBerry Enterprise Server that is installed.

For BlackBerry Enterprise Server

  • A migration kit is available to provide a new replacement SRP to be used in the migration.
  • KB10945 - What is a BlackBerry Enterprise Server migration kit.

For BlackBerry Enterprise Server Express

  • Register for a new BlackBerry Enterprise Server Express to obtain the replacement SRP to be used on the new BlackBerry Enterprise Server in the migration.
  • BlackBerry Enterprise Server Express registration is located at www.blackberry.com/BESX

See the Additional Information section below for information on how to migrate the BlackBerry Enterprise Server to new hardware without using a second SRP.

Information for BlackBerry Enterprise Server 5.0 only

When migrating the BlackBerry Enterprise Server 5.0 to new hardware, the migration needs to be considered as the following two distinct components:

  • BlackBerry Enterprise Server core functions, which will be migrated by adding a second new BlackBerry Enterprise Server to the BlackBerry Domain.
  • The BlackBerry Administration Service, which is having a new node added and an old one removed.

    Once the new node is installed, both BlackBerry Administration nodes will be online and both will be fully functional. While these are two distinct components, the setup of them will be completed at the same time using the BlackBerry Enterprise Server installer.

Task 1 - Preparation Steps

  1. If the BlackBerry Configuration Database is currently installed on the same server as the BlackBerry Enterprise Server, then the BlackBerry Configuration Database should be moved to the new server first. See the following KB articles: 
     
    • KB03112 - How to move the BlackBerry Configuration Database to a new Microsoft SQL Server instance.
    • KB18129 - How to change the BlackBerry Configuration Database in BlackBerry Enterprise Server 5.0.

      Note : If the current BlackBerry Configuration Database is installed on a remote Microsoft SQL Server, then no action is required on the Microsoft SQL Server database.

  2. Complete BESAdmin user account pre-installation steps on the new BlackBerry Enterprise Server from the Installation and Configuration Guide in the section called Configure permissions for the Windows account in Documentation for Administrators and select the guide appropriate for the installed platform.

Task 2 - Migrating the BlackBerry Enterprise Server

This process installs the new BlackBerry Enterprise Server as a second server in an existing BlackBerry Domain. For more information about installing a second BlackBerry Enterprise Server into an existing BlackBerry domain, see the "Installing the BlackBerry Enterprise Server software, Prerequisites: Installing the BlackBerry Enterprise Server" software section of the BlackBerry Installation and Configuration Guide in Documentation for Administrators.

  1. Install the new BlackBerry Enterprise Server. When prompted for the BlackBerry Enterprise Server name, ensure the new name is different from the existing BlackBerry Enterprise Server instance name.
  2. During the database configuration phase of the installation, direct the new BlackBerry Enterprise Server instance to the existing BlackBerry Configuration Database in use by the existing BlackBerry Enterprise Server instance and update it if prompted.
  3. Enter the second SRP identifier and SRP authentication key for the new BlackBerry Enterprise Server instance.

    Note: When this installation is complete, the two BlackBerry Enterprise Server instances are sharing Client Access Licences (CALs), so there will be no need to purchase or move the licences.

  4. For BlackBerry Enterprise Server 5.0 only - When prompted for the BlackBerry Administration Service pool name, either the same pool name can be used as the current BlackBerry Administration Service on the existing BlackBerry Enterprise Server or a new pool name for the new BlackBerry Administration Service that is the DNS name for the new BlackBerry Enterprise Server can be used. If the same pool name is used as the existing BlackBerry Administration Service, ensure the DNS entry for the pool name remains valid after the current DNS name is removed.

    For more information about BlackBerry Administration Service pools, see the "BlackBerry Administration Service high availability" section of the BlackBerry Enterprise Server Planning Guide located in the Documentation for Administrators.

  5. For BlackBerry Enterprise Server 5.0 only - Upon completion of the installation, the new BlackBerry Administration node is online and functional. Confirm that the new BlackBerry Administration node is working correctly by logging in to it. 
     
    • If migrating from a BlackBerry Enterprise Server 5.0 to 5.0, there will now be two fully functional BlackBerry Administration nodes online — one on the old server and one on the new server. Both nodes will be functional at the same time, and either one could be used to administer the BlackBerry Enterprise Server. This is by design.
    • If migrating from a BlackBerry Enterprise Server 4.0 or 4.1 to 5.0, and this is the first BlackBerry Enterprise Server 5.0 in the BlackBerry Domain, there will only be one BlackBerry Administration node online on the new server. 
       
  6. Once the new BlackBerry Enterprise Server instance is installed, if it is a later version than the existing BlackBerry Enterprise Server instance, all BlackBerry smartphone user management tasks should be done from the new BlackBerry Enterprise Server instance manager or the new BlackBerry Administration Service. 
     
    • For more information about managing mixed versions of the BlackBerry Enterprise Server, refer to the "Managing a mixed version environment" section of the Upgrade Planning Guide located in the Documentation for Administrators
       
  7. From the BlackBerry Manager or the BlackBerry Administration Service, move a test user to the new BlackBerry Enterprise Server. Confirm the moved test user is fully functional. 
     
    • If the BlackBerry smartphone user has a BlackBerry smartphone with BlackBerry Device Software 4.0 to 5.0, it will be automatically updated with the new SRP identifier. If the BlackBerry smartphone is running earlier than BlackBerry Device Software 4.0, the BlackBerry smartphone user will need to cradle the BlackBerry smartphone to receive the update to the SRP Identifier. 
       
  8. Remaining users can be moved in phases to ensure that the new BlackBerry Enterprise Server is fully functional. Once all the BlackBerry smartphone users are moved, the old BlackBerry Enterprise Server instance can be uninstalled, decommissioned, and removed from the database. 
     
    • For more information about removing a decommissioned BlackBerry Enterprise Server from the BlackBerry Administration Service, see KB20515 - How to remove decommissioned BlackBerry Enterprise Servers from the BlackBerry Administration Service console. 
    • For more information, see the "Removing the BlackBerry Enterprise Server software" section of the BlackBerry Enterprise Server Installation and Configuration Guide located in the Documentation for Administrators.
CollapseAdditional Information

Step 8 can be completed at any time and does not need to be done immediately. Waiting for a period of time to uninstall the existing BlackBerry Enterprise Server allows BlackBerry smartphone users and administrators to confirm that the new BlackBerry Enterprise Server is functioning correctly before removing the existing BlackBerry Enterprise Server.

If a problem is found with the new BlackBerry Enterprise Server and the previous BlackBerry Enterprise Server is still installed, BlackBerry smartphone users can be moved back to the previous BlackBerry Enterprise Server to restore service while the issue with the new BlackBerry Enterprise Server is investigated.

For BlackBerry Enterprise Server 4.0 and 4.1, the knife-edge cutover can be used as an alternate method of migrating the BlackBerry Enterprise Server to new hardware. For more information about the knife-edge cutover method of migrating, see the appropriate platform and BlackBerry Enterprise Server version:

BlackBerry Enterprise Server 4.0 and 4.1 for Microsoft Exchange

KB10278 - How to perform a knife-edge cutover for BlackBerry Enterprise Server software

BlackBerry Enterprise Server 4.0 to 4.1 for IBM Domino

KB04261 - How to perform a cutover to another BlackBerry Enterprise Server instance in an IBM Domino environment

For BlackBerry Enterprise Server 5.0, the high-availability failover can be used as an alternate method of migrating the BlackBerry Enterprise Server to new hardware. For more information about the high-availability method of method of migrating, see KB22499.

This article contains information previously documented in KB13871.

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.