BESAdmin.info - Your Technical Support Source

Yahoo Buzz Technorati Stumbleupon Reddit Myspace Digg Delicious

BlackBerry device users initializing after upgrade from BlackBerry Enterprise Server software version 2.2 to 4.0

Contents [show]

Doc ID: KB03662
Modified Date: 11-14-2006
Document Type: Support

Products

  • BlackBerry® Enterprise Server
  • BlackBerry® Enterprise Server for IBM® Lotus® Domino®



Environment

  • BlackBerry® Enterprise Server software version 2.2 to 4.0
  • IBM® Lotus® Domino®

Warning: Some procedures require modifying databases. Modifying databases used by the BlackBerry Enterprise Server can cause irreparable damage, resulting in unexpected server behavior or service failure. Back up the databases prior to implementing any changes.




Overview

After you migrate BlackBerry device user accounts or upgrade from BlackBerry Enterprise Server software version 2.2 to 4.0, the Status column on the User List tab displays Initializing (or Initializing, not running) for all BlackBerry device users in the BlackBerry Manager. The Person icon is displayed in the Name column. The Email Address and PIN columns may or may not be populated.




Cause

The issue can be caused by one of the following:

  1. The BlackBerry profiles database template is not updated or the template is corrupt.
  2. The BlackBerry state database template is not updated or the template is corrupt.

Cause 1

The BlackBerry profiles database template is not updated during the upgrade, or the version 4.0 profiles template is corrupt.

Resolution

Replace the design of the BlackBerry profiles template.

Warning: Modifying databases used by the BlackBerry Enterprise Server can cause irreparable damage, resulting in unexpected server behavior or service failure. Back up the databases prior to implementing any changes.

To replace the design of the BlackBerry profiles database

  1. Shut down the BlackBerry Enterprise Server add-in task. In the Lotus Domino Server console, type tell bes quit.
  2. In the Domino Administrator client, select the BlackBerry Enterprise Server.
  3. Click on the Files tab and from the list in the middle pane, find and open the BlackBerry User Profiles database.
  4. Go to File>Database>Replace Design. The Replace Database Design window is displayed.
  5. Select the server that stores the BlackBerry templates from theTemplate server drop-down box.
  6. Select the Show advanced templates check box.
  7. Verify that the Inherit future design changes check box is selected.
  8. Select the BlackBerry Profiles Template from the list and click Replace.
  9. In the Lotus Domino Server console, type load bes to start the BlackBerry Enterprise Server.

Alternatively, you can replace a template design by performing the procedure below.

Note: The Design task will run on all IBM Lotus Domino databases, not just the BlackBerry profiles database.

  1. Shut down the BlackBerry Enterprise Server. In the Lotus Domino Server console, type tell bes quit.
  2. After the BES add-in task shuts down, type load design in the console.
  3. In the Lotus Domino Server console, type load bes to start the BlackBerry Enterprise Server.

If the above steps fail to resolve the issue, run theNBESMigration tool as instructed in theBlackBerry Enterprise Server for IBM Lotus Domino version 4.0 Maintenance Guide or Installation Guide, and then run the Design task.


Cause 2

The BlackBerry state database template is not updated during the upgrade or the version 4.0 BlackBerry profiles template is corrupt.

After the upgrade, and after the BES add-in task is started, all BlackBerry device users′ BlackBerry state databases are updated to the new 4.0 template. When the BlackBerry Dispatcher Service is started, the updated status is reported to the BlackBerry Dispatcher, and BlackBerry device users are successfully initialized.

In some cases, however, the BlackBerry Dispatcher Service is started before the BES add-in task. As a result, the templates are not updated because the BES add-in task must be started first for the update to occur, and the BlackBerry Dispatcher cannot properly initialize BlackBerry device users.

Resolution

Replace the design of the BlackBerry state database templates.

Warning: Modifying databases used by the BlackBerry Enterprise Server can cause irreparable damage, resulting in unexpected server behavior or service failure. Back up the databases prior to implementing any changes.

To replace the design of all the state database templates

Note: The Design task will run on all IBM Lotus Domino databases, not just the BlackBerry state databases.

  1. Shut down the BlackBerry Enterprise Server. In the Lotus Domino Server console, type tell bes quit.
  2. After the BES add-in task shuts down, type load design in the Lotus Domino Server console.
  3. Restart the BlackBerry Dispatcher Service and the BlackBerry Router Service using Windows Services administrative tool.
  4. In the Lotus Domino Server console, type load bes to start the BlackBerry Enterprise Server.
  5. Once the BlackBerry Enterprise Server has successfully started, all user accounts should display running in the Status column on the User List tab of BlackBerry Manager.

Note: See the Domino Administrator Help file for more information on Domino database maintenance and tasks.