BlackBerry Enterprise Server TechNotes

Information relating to the installation and configuration of BlackBerry Enterprise Server 4.x and 5.x mobile messaging platform.

 

During the BlackBerry Enterprise Activation process, the BlackBerry smartphone sends a message containing a file called ETP.DAT file, which contains activation information, to an activation email address stored on the BlackBerry device.

Once the user selects Activate in the Enterprise Activation application on the BlackBerry smartphone, the following actions occur:

  1. The ETP.DAT message is sent to the BlackBerry Infrastructure, which forwards it to the email address that was typed in the Enterprise Activation application.

  2. The BlackBerry Enterprise Server, which monitors the BlackBerry device user’s mailbox, picks up the ETP.DAT message.

    The activation process begins.

  3. The BlackBerry Enterprise Server sends the acknowledgement and encryption information to the BlackBerry smartphone.

  4. The IT policy is sent to the BlackBerry smartphone.

    Once the BlackBerry Enterprise Server verifies that the policy has been applied successfully, it sends the required service books to the BlackBerry smartphone.

  5. When the BlackBerry Enterprise Server has sent all the required information to the BlackBerry device, the following message is displayed:
                             Your email address “<This email address is being protected from spambots. You need JavaScript enabled to view it.>” is now enabled

  6. The synchronization process begins.

 

On the 25th February 2009, Research in Motion released the BES for Domino 4.1 SP 6 Maintenance Release #4.

Prior to installing this (or any Maintenance Release), you should backup your BES Management Database (see Backup the BESMgmt database script).

To download this maintenance release, please visit: http://na.blackberry.com/eng/support/downloads/#tab_ddetail_subtab_software

 

To install the maintenance release

  1. While logged in to the computer that hosts the BlackBerry Enterprise Server, stop all IBM Lotus Domino services.
  2. Close BlackBerry Manager and the BlackBerry Configuration Panel.
  3. In the Windows Services, stop all BlackBerry Enterprise Server services.
  4. Double-click besn416mr4.zip.
  5. Extract the setup program files to a local drive on your computer.
  6. Browse to the location of the setup program files.
  7. Double-click besn416mr3.msp to run the executable.
  8. Click Update.
  9. Complete the configuration screens.
  10. Click Finish.
  11. In the Windows Services, restart all BlackBerry Enterprise Server services.

The BlackBerry Enterprise Activation process is designed to allow a BlackBerry smartphone to be wirelessly activated on the BlackBerry Enterprise Server.

With this process, you can wirelessly manage encryption keys and service book records.

Pre-requisites for enterprise activation

Before setting up a BlackBerry Enterprise Activation process, you verify that the following pre-requisites are met:

  1. The service provider has provisioned the assigned SIM card with the BlackBerry Enterprise Server service class.
  2. The user account is added to the BlackBerry Enterprise Server.
  3. The BlackBerry Enterprise Server is correctly configured to access the user's mailbox.
  4. An activation password is set for the BlackBerry user account.

Once the conditions listed above are met, the BlackBerry Enterprise Server monitors the mailbox for new messages, including the ETP.DAT activation message that will be sent from the BlackBerry smartphone.

 

Smartphone Activation

The following scenario outlines the steps used to prepare for a wireless enterprise activation process:

  1. A BlackBerry user receives a new BlackBerry smartphone, and contacts you to activate it.
  2. You set the Enterprise Activation password on the BlackBerry user’s account and communicate it to the user.

During this period, between the setting of the user's activation password and the user actually activating the smartphone, the account status is Initializing.

 

Stages of the BlackBerry Enterprise Activation process

THis is an overview of the four phases of the BlackBerry Enterprise Activation Process.

Phase 1 - Activation
  1. The user types their email address and activation password in the Enterprise Activation application on the BlackBerry smartphone.

  2. The BlackBerry smartphone creates an encrypted activation message containing an ETP.DAT file and sends it, via the wireless network, to the user's mailbox.

The ETP.DAT message contains information about the BlackBerry smartphone such as PIN Number, routing information and the BlackBerry smartphones’s public keys for activation.

  • The ETP.DAT message is routed through the BlackBerry Infrastructure to the user's mailbox as a standard SMTP message with an encrypted attachment.
  • When the ETP.DAT message is received, and the BlackBerry Enterprise Server retrieves it, the BlackBerry user displays a status of Activating.
Phase 2 - Encryption verification
  1. When the ETP.DAT message arrives at the messaging server, the BlackBerry Messaging Agent checks the message contents.

  2. The BlackBerry Enterprise Server processes the data attached to the message, first verifying that the encrypted password matches the one that was set for the user. If it matches, the BlackBerry Messaging Agent generates a new permanent encryption key using either Triple Data Encryption Standard (Triple DES) or Advanced Encryption Standard (AES),  and sends it to the BlackBerry BlackBerry smartphone.

  3. The BlackBerry device displays a status of Verifying Encryption.
Phase 3 - Receiving services
  1. The BlackBerry Enterprise Server and the BlackBerry smartphone establish a master encryption key. The BlackBerry smartphone and the BlackBerry Enterprise Server verify this master encryption key with each other.

  2. The BlackBerry smartphone stores the new encryption key and displays the following message:
         Encryption Verified. Waiting for Services.

  3. The BlackBerry Messaging Agent forwards a request to the BlackBerry Policy Service to generate the service books.

  4. The BlackBerry Policy Service receives and queues the request, and then sends the defined IT policy to the BlackBerry smartphone.

  5. The BlackBerry smartphone registers that the policy has been applied successfully.

  6. The BlackBerry Policy Service generates and sends the service books to the BlackBerry smartphone, which is now able to send/receive messages, and displays the Services Received message.

  7. The BlackBerry device then displays the following message:
         Your email address, <This email address is being protected from spambots. You need JavaScript enabled to view it.> is now enabled.
         Synchronization service Desktop [SRP_Identifier]

 

Phase 4 - Synchronization
  1. Once the [CMIME] service book has arrived, the BlackBerry smartphone will be able to reconcile messages with the user's email account.  All the service books should arrive at the same time, but only the [CMIME] is required for email reconciliation.

  2. The BlackBerry smartphone registers the receipt of its service books to the BlackBerry Enterprise Server and the activation process completes. The message Activation Complete is shown.

  3. The synchronization process begins with a BlackBerry smartphone request, synchronizing data from the calendar first (using the [CICAL] service book), and then the other organizer databases.

  4. For wireless synchronization to occur, the Desktop [SYNC] service book is sent to the BlackBerry device.

    The [SYNC] service book allows for organizer data synchronization, wireless backup and restore capability, and synchronization of email settings and filters.

    The process is managed by the BlackBerry Messaging Agent for the Calendar, and the BlackBerry Synchronization Service for the remaining organizer databases.

  5. The appropriate service books and IT Policies are sent from the BlackBerry Enterprise Server to the BlackBerry smartphone. The  user is now able to send and receive email messages on the BlackBerry smartphone.

  6. If the user is configured for wireless organizer data synchronization and wireless backup, the BlackBerry Enterprise Server will send the following data to the BlackBerry device:

             * Calendar entries
             * Address Book entries
             * Tasks
             * Memos
             * Email messages
             * Existing BlackBerry device options that were backed up through automatic wireless backup

    When the enterprise activation process is complete, the BlackBerry device displays a status of Activation Complete.

 

For further information on the role of ETP.DAT file, please see this article .

 

This document outlines the differences between BlackBerry Enterprise Server Service Packs and Maintentance Releases.

Service Packs

Service packs are software releases that contain product updates, including fixes for identified issues and feature enhancements. They are bundled separately for the following types of BlackBerry Enterprise Server software:
  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server for IBM Lotus Domino
  • BlackBerry Enterprise Server for Novell GroupWise
  • BlackBerry Enterprise Server for MDS Applications

Maintenance Releases

There are two types of maintenance releases (MRs) that you can install - these are known as HotFixes and Rollups.
HotFix
A hotfix contains fixes for BlackBerry Enterprise Server software. Because of the often urgent and reactive nature of a hotfix, there is no release schedule followed.
A hotfix can be specific to customers or BlackBerry Enterprise Server software types, or can be specific to a component common between the differing BlackBerry Enterprise Server software types.

Rollup

A rollup contains a small set of fixes. It can, and normally will, include the same fixes as hotfixes, but it is intended to release any important fixes on a schedule.

A Rollup can be expected to be released approximately six weeks after the previous MR is posted to the BlackBerry web site.

For example, an organization with BlackBerry Enterprise Server software version 4.1 Service Pack 6 (4.1.6) can install any of the following posted maintenance releases:

  • BlackBerry Enterprise Server software version 4.1.6 MR1 (Rollup)
  • BlackBerry Enterprise Server software version 4.1.6 MR2 (Rollup)
  • BlackBerry Enterprise Server software version 4.1.6 MR3 (Rollup)
  • BlackBerry Enterprise Server software version 4.1.6 MR4 (Rollup)


In this example, each MR (MR1 through MR4) contains all fixes from previous MRs.

So as a customer, who wished to update you BlackBerry Enterprise Server v4.1 Service Pack 6, you would only need to install the latest version, which is MR4.

 

 

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.