BlackBerry Enterprise Server TechNotes

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

 

Jobs were introduced in BlackBerry Enterprise Server 5.0 and are a new feature of the BlackBerry Administration Service. In order to properly troubleshoot issues with BlackBerry Administration Service Jobs and Job Tasks, it is important to understand what the statuses indicate.

The following table lists the Key to Job states, as listed in the BASJob table of the BlackBerry Configuration Database:

Status

State

Pending/Created

0

Ready to Run

1

Running

2

Task Delivery Complete

3

Completed

4

Completed with task failure

5

Cancelled/Time out

6/7

 

The following table lists the Key to Task states, as listed in the BASJobTasks table of the BlackBerry Configuration Database:

Status

State

Ready to Deliver

0

Not Ready to Deliver

1

Optimized out

2

Pending Result

3

Ready to retry

4

Retriable failure

5

Success

6

Failure

7

Dependency Failure

8

Manual Failure

9

It's a good idea to backup your BlackBerry Enterprise Server before performing upgrades.
The backup includes the BlackBerry Enterprise Server list and BlackBerry smartphone user list. Depending on the version of the software, there are several methods to backup the databases.


BlackBerry Enterprise Server Software Version 3.6

Creating a backup BlackBerry Enterprise Server involves exporting the BlackBerry Enterprise Server list.
  1. Open the BlackBerry Management Console

  2. Scroll to BlackBerry Server Management and right-click. Select Export BlackBerry Servers.

  3. Specify where to save the backup.
Now it's time to export the BlackBerry smartphone user list.

  1. Open the BlackBerry Management Console.

  2. Click on the server name.

  3. Select all BlackBerry users by clicking on the first smartphone user, then pressing the shift key, and finally clicking on the last smartphone user.

  4. After the entire BlackBerry smartphone user list is highlighted, right-click it and select Export User Info.

  5. An option is given to export statistics and to clear statistics after exporting. This info doesn't affect the server, so it's optional.

  6. Choose where to save the backup.

BlackBerry Enterprise Server Software Versions 4.0 and 4.1

To create a backup BlackBerry Enterprise server, use either Microsoft SQL Server Desktop Engine (MSDE) or Microsoft SQL Server.

With MSDE:

  • Go to the Start icon, click it and select Run.

  • Type cmd in the box and select OK.

  • Type osql -E to log into the Microsoft SQL Server.

  • Type 1> backup database <DatabaseName> to disk = "C:\<DatabaseName>.bak"

  • Type 2> go

  • Type 1> quit

  • The default name of the database is BESMgmt, but the name of your database should replace <DatabaseName>.

If you are using the Microsoft SQL Server, follow these steps:

  • Select the SQL Enterprise Manager.

  • Drill down to the Database level.

  • Find the BlackBerry Enterprise Server database and right-click it.

  • Under All Tasks, select Backup Database.

  • Choose where to save the backup.


BlackBerry Configuration Database Backup Tool

Another way to backup the BlackBerry Enterprise Server databases is to use the BlackBerry Configuration Database Backup Tool. This is usually available if the server environment includes Microsoft SQL Server Express. The tool is part of the installation media for the Blackberry Enterprise Server. It provides a way to backup the database to a file. The backup file name is <database_name><YYYYMMDDHHMMSS>.bak.

To use the BlackBerry Configuration Database Backup Tool, follow these steps:

  • Copy the installation files of the BlackBerry Enterprise Server to the computer which hosts the database that you are about to backup.

  • Then, extract the installation files to a folder on the computer.

  • Go to the Tools folder of the installation files and run BlackBerryDbBackup.exe.
As the backup tool runs, it will save the specified database to a folder on the computer. There are several parameters you can set, but only the database name, -d or <database_name>, is required. The tool will save the database to the current folder if a folder, -f or <folder>, isn't specified. Some of the optional parameters of the backup tool include -S, or <database_server>, which identifies the name of the computer that hosts the database, and -p, or <percentage>, which shows the progress of the backup process as a percentage. Your login user name and password for the database are -U, <user_name>, and -P, <password>, respectively.

A typical command line will appear as BlackBerryDBBackup.exe -d BESMgmt -f C:\DB_backup_folder -U sqlusername -P sqlpassword, where BESMgmt is the database name, C:\DB_backup_folder is the folder to which the backup file will be saved to, and sqlusername and sqlpassword are your login user name and password.

For each major version of the BlackBerry Enterprise Server and associated components, the common platform and required third-party software are integrated and released as the recommended environment. This environment is the configuration against which test plans were executed with the release of the service pack.

Status of Third-party Platform Configuration

As new versions of third-party components are released, or as legacy versions become unsupported, the varying configuration scenarios may be supported in different ways by Research In Motion (RIM).

BlackBerry Enterprise Server Compatibility Matrix Usage

The BlackBerry Enterprise Server compatibility matrix shows the various combinations of third-party software components that have been reviewed for compatibility. It identifies the recommended environment for each service pack, as well as the support status for other environments.

Use the matrix to:

  • View the recommended configuration for your version of BlackBerry Enterprise Server
  • View the current compatibility status of a particular configuration
  • View additional comments/information, compatibility issue description and other pertinent technical information for a particular configuration

 

See also:   BlackBerry Enterprise Server Express for Microsoft Exchange Compatibility Matrix (PDF)
See also:   BlackBerry Enterprise Server Express for  IBM Lotus Domino Compatibility Matrix (PDF)
See also:   BlackBerry Enterprise Server for Microsoft Exchange Compatibility Matrix (PDF)
See also:   BlackBerry Enterprise Server for IBM Lotus Domino Compatibility Matrix (PDF)

 

 

BlackBerry Enterprise Server Client Access Licenses (CAL) come in different varieties, and can be obtained from different locations. The following table identifies the different ones.

Unless otherwise stated in the Notes section, no two CAL types can be used together on the same BlackBerry Domain.

With the exception of the BlackBerry Enterprise Server Express CALs, the format of all CALs make them indistinguishable from one another. Therefore, if the CAL type is unknown, it may be required to validate them manually.

 

 

Type of CALCostPurchase LocationBlackBerry Enterprise Server version that CAL is compatible withNotes
Enterprise CALsContact the Global Sales team of Research In Motion, the carrier sales team, or an authorized reseller for full price details.Research In Motion, Carrier, or Authorized Reseller.

BlackBerry Enterprise Server 3.6-5.0

BlackBerry Professional Software

 
Temporary CALsFree.Provided by Research In Motion or Carrier for testing purposes.

BlackBerry Enterprise Server 3.6-5.0

BlackBerry Professional Software

Can be used with Enterprise CALs, however, they will expire after a preset amount of days.
Evaluation CALsFree.Obtained by downloading an evaluation copy of BlackBerry Enterprise Server 5.0.BlackBerry Enterprise Server 5.0These CALs will expire after 90 days.  The SRP ID will also expire at the same time.  Purchase of the BlackBerry Enterprise Server software and CALs will be required after this point.
Small and Medium Business (SMB) CALsContact the Global Sales team of Research in Motion, the carrier sales team, or an authorized reseller for full price details.Research In Motion, Carrier, or Authorized Reseller.

BlackBerry Enterprise Server 3.6-4.1

BlackBerry Professional Software

BlackBerry Enterprise Server 5.0, but not SP1 or higher

SMB BlackBerry Enterprise Server has a limit of 15 CALs, but the Upgrader Key will allow Enterprise CALs to be used with no limit.  After the Upgrader Key is used, additional SMB CALs will not be accepted.

BlackBerry Professional Software has a hard cap of 30 users, but can use either SMB CALs or Enterprise CALs.

BlackBerry Enterprise Server 5.0 was not intended to use SMB CALs, but the ability to upgrade servers with SMB CALs still worked.  These CALs need to be replaced prior to applying any service packs.

BlackBerry Enterprise Server Express CALsFree.Obtained by registering for, and downloading BlackBerry Enterprise Server Express fromwww.blackberry.com/express.

BlackBerry Enterprise Server Express

Not for use with any other versions of BlackBerry Enterprise Server.

There is oneunlimitedCAL provided with the download.  The software has a limitation of 75 users when installed on the mail server, or 2000 users when installed on a standalone box.

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.