Installation and Configuration Guide

Local Navigation

BlackBerry Manuals & Help  >  Administrator Documentation  >  BlackBerry Enterprise Server 5  >  BlackBerry Enterprise Server for IBM Lotus Domino  >  Installation and Configuration Guide BlackBerry Enterprise Server for IBM Lotus Domino - 5.0

Configuring connections for the BlackBerry Enterprise Server databases

The BlackBerry® Enterprise Server, BlackBerry Monitoring Service, and BlackBerry MDS Integration Service store data in their own databases. The database for the BlackBerry Enterprise Server is named the BlackBerry Configuration Database.

You can create the BlackBerry Configuration Database by installing a BlackBerry Enterprise Server instance or BlackBerry Administration Service instance, or by running the CreateDB executable. You can create the BlackBerry MDS Integration Service database or BlackBerry Monitoring Service database during the installation processes for the BlackBerry MDS Integration Service or BlackBerry Monitoring Service respectively.

The BlackBerry Enterprise Server, BlackBerry Monitoring Service, and BlackBerry MDS Integration Service can connect to the databases on the Microsoft® SQL Server® using Windows® authentication or database authentication. By default, the BlackBerry Enterprise Server, BlackBerry Monitoring Service, and BlackBerry MDS Integration Service log in to the databases using the Windows account that you use to complete the installation process, or the database credentials you provided during the installation process.

To support Microsoft SQL Server 2005 database mirroring with the BlackBerry Configuration Database or BlackBerry MDS Integration Service database, you must use Windows authentication. The BlackBerry Monitoring Service does not support database mirroring.

Specifying permissions when connecting to the BlackBerry Enterprise Server databases using Windows authentication

During the installation process, if you connect the BlackBerry® Enterprise Server, BlackBerry MDS Integration Service, and BlackBerry Monitoring Service to the BlackBerry® Enterprise Server databases using Windows® authentication, the Windows account that you specify must have database permissions on the database server. The type of permissions depends on the setup option that you select, and whether you create the BlackBerry Enterprise Server databases on the same computer as the BlackBerry Enterprise Server components or on another database server.

Specifying Microsoft SQL Server 2005 Express permissions for the Windows account

If you install Microsoft® SQL Server® 2005 Express during the BlackBerry® Enterprise Server installation process, you do not need to specify additional permissions. When you select Windows® authentication during the BlackBerry Enterprise Server installation process, the setup application automatically assigns the required permissions to the Windows account that you use to complete the installation process.

Assign Microsoft SQL Server permissions to the Windows account

Perform one of the following actions:
  • If you create the BlackBerry® Enterprise Server databases on the computer that hosts the BlackBerry Enterprise Server and require the setup application to install Microsoft® SQL Server® Express during the installation process, you are not required to assign Microsoft SQL Server permissions to the Windows® account. If you want the setup application to install the BlackBerry database notification system, assign the system administrator permission to the Windows account.
  • If you create the BlackBerry Enterprise Server databases on the computer that hosts the BlackBerry Enterprise Server and the computer already hosts a Microsoft SQL Server, assign the database creator permission to the Windows account that you use to complete the BlackBerry Enterprise Server installation process. If you want the setup application to install the BlackBerry database notification system, assign the system administrator permission to the Windows account.
  • If you create the BlackBerry Enterprise Server databases on a computer that does not host the BlackBerry Enterprise Server, you can assign the database creator permission to the Windows account that you use to complete the BlackBerry Enterprise Server installation process.

Configuring authentication to the BlackBerry MDS Integration Service database

When the setup application creates the BlackBerry® MDS Integration Service database during the installation process, you must use the same authentication method and account that you specified for the BlackBerry Configuration Database. The BlackBerry MDS Integration Service requires the same permissions to access the BlackBerry MDS Integration Service database that the BlackBerry® Enterprise Server requires to access the BlackBerry Configuration Database.

Configuring the local system account in an IBM Lotus Domino environment

Add Windows credentials to the local system account

You can configure the local system account to access the BlackBerry® Enterprise Server, install the BlackBerry Configuration Database on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server, and use Windows® authentication to connect to the BlackBerry Configuration Database.
In the Microsoft® SQL Server® Enterprise Manager or Microsoft SQL Server Management Studio, create a new user account with the following properties:
  • user name that is the same as the name of the BlackBerry Enterprise Server computer, and uses the format <Domain>\<computer_name>$
  • authentication configured to Windows authentication
  • roles assigned that are required to change the BlackBerry Configuration Database

Add database credentials to the local system account

You can add the user name and password for the database account to the Windows® registry if you want to use a local system account for the BlackBerry® Enterprise Server, install the BlackBerry Configuration Database on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server, and use database authentication to connect to the BlackBerry Configuration Database.
  1. On the computer that you want to install the BlackBerry® Enterprise Server software on, on the Start menu, click Run.
  2. Type regedit.
  3. Click OK.
  4. In HKEY_USERS\.DEFAULT\Software\Research In Motion\BlackBerry Enterprise Server\Database, create the following string values for a database account that has the required permissions:
    • Login
    • Password

Create a BlackBerry Configuration Database

If the security required by your organization does not allow applications to have permissions to create or upgrade databases, you can run the CreateDB executable on the database server to create the BlackBerry® Configuration Database instead of using the setup application. After you create or upgrade the BlackBerry Configuration Database using the CreateDB executable, you can run the setup application using a Windows® account with minimum requirements to the database server.
Before you begin: Verify that the appropriate permissions are configured on the database server.
  1. Log in to the computer that hosts the database server using a local administrator account or a Windows account that has SQL administrator permissions.
  2. Copy the BlackBerry® Enterprise Server installation media to the database server that you want to configure as the host server for the BlackBerry Configuration Database.
  3. Extract the contents to a folder on the computer.
  4. Navigate to <extracted_folder>\Database.
  5. Open the BesMgmt.cfg file in a text editor.
  6. Change the file to include information that is specific to your organization's environment.
  7. Save and close the file.
  8. Open a command prompt window.
  9. Change to <extracted_folder>\Database.
  10. Type CreateDB.exe BESMgmt.cfg.

BESMgmt.cfg properties

Property

Description

CMD

This property specifies the type of action that the CreateDB executable must complete (for example, whether to install or upgrade the BlackBerry® Configuration Database).

DATABASE_NAME

This property specifies the name of the BlackBerry Configuration Database.

SERVER

This property specifies the name of the database server that hosts the BlackBerry Configuration Database. If a database instance hosts the BlackBerry Configuration Database, follow the format database_server_name\database_instance_name.

USERID

If you use database authentication, this property specifies the user name of the database account that has server administrator permission and database creator permission.

PASSWORD

If you use database authentication, this property specifies the password for the database account.

SCRIPT_ROOT

This property specifies the path to the DBInstallScripts folder.

By default, this folder is in the same root folder that the CreateDB.exe file is located in.

LOG_DIR

This property specifies the path to the folder that you want to create log files in.

By default, this folder is in the same root folder that the CreateDB.exe file is located in.

DBMS

This property specifies the database management system that your organization uses.

DB_FILE_DIR

This property specifies an existing folder that you want to save the database files in.

By default, this folder is in the same root folder that the CreateDB.exe file is located in.

BACKUP_DIR

This property specifies an existing folder where you want to save the database backup in.

By default, this folder is located in the same root folder that the CreateDB.exe file is located in.

BES_TYPE

This property specifies the messaging server that your organization uses.
Next topic: Install the SNMP service for monitoring by the BlackBerry Monitoring Service
Previous topic: Configure the Server document to permit the BlackBerry Enterprise Server to move user accounts within a BlackBerry Domain

Was this information helpful? Send us your comments.