Blackbe;rry ENTERPRISE SERVER FOR IBM LOTUS DOMINO User manual

Installation Guide
BlackBerry Enterprise Server for IBM Lotus Domino
Version: 4.1 | Service Pack: 6

SWD-427521-0708051824-001

Contents
1Planning a BlackBerry Enterprise Server installation................................................................................................. 5
Installing all BlackBerry Enterprise Server components on one computer........................................................................ 5
Installing the BlackBerry Attachment Service........................................................................................................................ 5
Installing the BlackBerry Collaboration Service..................................................................................................................... 5
Installing the BlackBerry Manager........................................................................................................................................... 6
Installing the BlackBerry MDS Connection Service............................................................................................................... 6
Installing the BlackBerry MDS Integration Service............................................................................................................... 6
Installing the BlackBerry Router............................................................................................................................................... 7
Installing the Hosted BlackBerry Enterprise Server............................................................................................................... 7
2 System requirements.......................................................................................................................................................... 9
System requirements: BlackBerry Enterprise Server............................................................................................................. 9
System requirements: BlackBerry Attachment Service......................................................................................................... 12
System requirements: BlackBerry Manager............................................................................................................................ 12
System requirements: BlackBerry MDS Connection Service................................................................................................ 14
System requirements: BlackBerry MDS Integration Service................................................................................................ 14
System requirements: BlackBerry Router................................................................................................................................ 15
System requirements for optional environments and features............................................................................................ 15
Unsupported environments....................................................................................................................................................... 18
3 Configuring your messaging environment.................................................................................................................... 19
Create a group for BlackBerry Enterprise Server administrators......................................................................................... 19
Configure the server document to allow users to move within a BlackBerry Domain...................................................... 19
4 Setting up the database connection............................................................................................................................... 21
Specifying permissions when connecting to the BlackBerry Configuration Database using Microsoft Windows
authentication.............................................................................................................................................................................. 21
Specifying MSDE 2000 permissions for the Microsoft Windows account..................................................................... 21
Assign Microsoft SQL Server permissions to the Microsoft Windows account.............................................................. 21
Assign IBM DB2 UDB permissions to a local system account.......................................................................................... 22
Configuring authentication to the BlackBerry MDS Integration Service database.......................................................... 22
Configuring the local system account...................................................................................................................................... 22
Configure the local system account for Microsoft Windows authentication................................................................. 22
Configuring the local system account for database authentication............................................................................... 22

Create Microsoft Windows groups for administrators in an IBM DB2 UDB environment............................................... 23
Configure authentication to the BlackBerry Configuration Database in an IBM DB2 UDB environment.................... 24
5 Persistent socket connections for the BlackBerry Collaboration Service............................................................... 25
6 Installing the BlackBerry Enterprise Server software................................................................................................. 27
Applications installed with the BlackBerry Enterprise Server components....................................................................... 27
Prerequisites: Installing the BlackBerry Enterprise Server................................................................................................... 27
Install the BlackBerry Enterprise Server software.................................................................................................................. 28
Test the BlackBerry Enterprise Server installation................................................................................................................. 28
Install the BlackBerry database notification system.............................................................................................................. 29
7 Postinstallation tasks......................................................................................................................................................... 31
Specify the administration email address............................................................................................................................... 31
Connecting to a BlackBerry Attachment Service................................................................................................................... 31
Connect the BlackBerry MDS Connection Service to a BlackBerry Attachment Service............................................. 31
Connect the BlackBerry Collaboration Service to a remote BlackBerry Attachment Service..................................... 32
Connect the BlackBerry Messaging Agent to a BlackBerry Attachment Service.......................................................... 32
Connect a remote BlackBerry Attachment Service to the BlackBerry Messaging Agent............................................ 33
Verify that the BlackBerry Collaboration Service can connect to Microsoft Office Communications Server 2007 or
Microsoft Office Live Communications Server 2005............................................................................................................. 33
Authenticating the BlackBerry MDS Integration Service to the BlackBerry Manager and web services...................... 34
Allow the BlackBerry MDS Integration Service to communicate with the BlackBerry Manager................................ 34
Allow client authentication between the BlackBerry MDS Integration Service and web services............................. 35
Configure how users search for email addresses in a Hosted BlackBerry Enterprise Server environment.................. 35
Add or remove a BlackBerry Enterprise Server component.................................................................................................. 36
8 Creating and managing administrators......................................................................................................................... 37
Administrative roles.................................................................................................................................................................... 37
Creating a BlackBerry Enterprise Server administrator in a Microsoft SQL Server environment................................... 38
Assign an administrative role to a new or existing Microsoft SQL Server database account..................................... 39
Creating a BlackBerry Enterprise Server administrator in an IBM DB2 UDB environment............................................. 39
Create a BlackBerry Enterprise Server administrator in an IBM DB2 UDB environment............................................ 40
Configure the BlackBerry Manager to use database authentication in a Microsoft SQL Server environment............ 40
Assign a BlackBerry Enterprise Server administrator to a different administrative role................................................. 40
Delete an administrator account from a BlackBerry Enterprise Server.............................................................................. 41

9 Removing the BlackBerry Enterprise Server software................................................................................................ 43
Remove the BlackBerry Enterprise Server software............................................................................................................... 43
Delete registry entries from your computer............................................................................................................................ 43
Removing the BlackBerry database notification system....................................................................................................... 44
Remove the BlackBerry database notification system from one BlackBerry Configuration Database..................... 44
Remove the BlackBerry database notification system from all BlackBerry Configuration Database instances...... 44
10 Troubleshooting the BlackBerry Enterprise Server installation process................................................................. 47
A third-party tool did not install successfully and the BlackBerry Enterprise Server setup application closed.......... 47
Failed to write License Key to the Database........................................................................................................................... 47
Previous version detected but no database available............................................................................................................ 47
Could not open ID file................................................................................................................................................................. 48
The BlackBerry Collaboration Service does not connect to Microsoft Office Live Communications Server 2005...... 48
The setup application prompts you for access to the installation media for Microsoft .NET Framework Version 1.1
........................................................................................................................................................................................................ 48
Attempt to establish connection failed with security reason "3"......................................................................................... 49
11 Glossary................................................................................................................................................................................ 51
12 Legal notice.......................................................................................................................................................................... 53

Planning a BlackBerry Enterprise Server installation 1
You can install all BlackBerry® Enterprise Server components on one computer, or you can install specific components on
separate computers. Consider any impacts on system resources before you decide where to install a component.
Consider installing all components on one computer if you do not plan to activate many BlackBerry devices, if you have
determined that the computer can handle the traffic volume for the BlackBerry Enterprise Server components, or if you do
notmindthatthecomputerhasdirectaccesstothewirelessnetwork.Forperformanceinformation,seeBlackBerryEnterprise
Server Performance Benchmarking.
Installing all BlackBerry Enterprise Server components on one computer
If you want to set up an evaluation or complete a simple installation of the BlackBerry® Enterprise Server for a small number
of users, you can install all the BlackBerry Enterprise Server components on the same computer.
During the installation process, you can choose to install all BlackBerry Enterprise Server components, including the
BlackBerry MDS Integration Service, on the same computer. The BlackBerry MDS Integration Service is only required if you
want to use enterprise applications on BlackBerry devices.
Installing the BlackBerry Attachment Service
The BlackBerry® Attachment Service converts supported attachments into a format that users can view on their BlackBerry
devices.
The BlackBerry Attachment Service might use increased system resources when it processes numerous conversion requests
at the same time. If you want to increase the number of conversion requests that can occur concurrently without impacting
message delivery, you can install the BlackBerry Attachment Service on a separate computer.
You can connect multiple instances of the BlackBerry® Enterprise Server to a single BlackBerry Attachment Service.
If you install the BlackBerry Attachment Service on a separate computer, you install the BlackBerry Attachment Service and
the BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry Attachment Service and restarts it if it stops
responding.
Installing the BlackBerry Collaboration Service
The BlackBerry® Collaboration Service provides an encrypted connection between your organization's instant messaging
server and the collaboration client on the BlackBerry device.
If you want to help maximize the number of available sockets so that the BlackBerry Collaboration Service can respond to
more requests, you can install the BlackBerry Collaboration Service by itself on a separate computer.
Installation Guide Planning a BlackBerry Enterprise Server installation
5

If you install the BlackBerry Collaboration Service on a separate computer, you install the BlackBerry Collaboration Service
and the BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry Collaboration Service and restarts it if it
stops responding.
You can connect multiple instances of the BlackBerry® Enterprise Server to a single BlackBerry Collaboration Service.
A different BlackBerry Collaboration Service exists for each instant messaging environment. For example, a BlackBerry
Collaboration Service exists for Windows® Messenger, and a different BlackBerry Collaboration Service exists for IBM®
Lotus® Sametime®. You can install only one BlackBerry Collaboration Service in your environment. Users can use only one
type of collaboration client on their BlackBerry devices.
Installing the BlackBerry Manager
The BlackBerry® Manager allows administrators to manage a BlackBerry® Domain. A BlackBerry Domain consists of single
BlackBerry Configuration Database and all BlackBerry® Enterprise Server instances that use it.
You can install the BlackBerry Manager with other BlackBerry Enterprise Server components or by itself on administrator
computers. Install the BlackBerry Manager on administrator computers if you have many administrators or if administrators
cannot access the BlackBerry Enterprise Server computers.
Installing the BlackBerry MDS Connection Service
The BlackBerry® MDS Connection Service provides users with access to online content and applications on the corporate
intranet or the Internet.
The BlackBerry MDS Connection Service might use increased system resources when it processes content requests. If you
want to minimize the impact on message delivery, you can install the BlackBerry MDS Connection Service by itself on a
separate computer.
You can connect multiple instances of the BlackBerry® Enterprise Server to a single BlackBerry MDS Connection Service.
If you install the BlackBerry MDS Connection Service on a separate computer, you install the BlackBerry MDS Connection
Service and the BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry MDS Connection Service and
restarts it if it stops responding.
Installing the BlackBerry MDS Integration Service
The BlackBerry® MDS Integration Service provides connectivity between the BlackBerry MDS Runtime Application on
BlackBerry devices and enterprise applications.
The BlackBerry MDS Integration Service might use increased system resources when it processes content requests. If you
want to minimize the impact on message delivery, you can install the BlackBerry MDS Integration Service by itself on a
separate computer.
Installation Guide Installing the BlackBerry Manager
6

You can connect multiple instances of the BlackBerry® Enterprise Server to a single BlackBerry MDS Integration Service.
If you install the BlackBerry MDS Integration Service on a separate computer, you install the BlackBerry MDS Integration
Service and the BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry MDS Integration Service and
restarts it if it stops responding.
The BlackBerry MDS Integration Service requires the BlackBerry MDS Application Repository, which the setup application
installs on your database server during the installation process. Each BlackBerry MDS Integration Service instance supports
one BlackBerry MDS Application Repository.
Installing the BlackBerry Router
The BlackBerry® Router connects to the wireless network and routes data to and from BlackBerry devices.
You can install the BlackBerry Router with other BlackBerry® Enterprise Server components or by itself on a separate
computer. Install the BlackBerry Router on a separate computer if you want to set it up in the DMZ, or to install several
standby instances of the BlackBerry Router as failover components in case your primary BlackBerry Router becomes
unavailable.
You can connect multiple instances of the BlackBerry® Enterprise Server to a single BlackBerry Router.
If you install the BlackBerry Router on a separate computer, you install the BlackBerry Router and the BlackBerry Controller.
The BlackBerry Controller monitors the BlackBerry Router and restarts it if it stops responding.
Installing the Hosted BlackBerry Enterprise Server
The Hosted BlackBerry® Enterprise Server allows you to make the BlackBerry® Enterprise Server available to other
organizations (for example, small or medium-sized businesses). When you configure the Hosted BlackBerry Enterprise Server
in your corporate environment, one or multiple organizations can subscribe to your service.
If you want to install the Hosted BlackBerry Enterprise Server, the installation process and requirements are identical to
those for the BlackBerry Enterprise Server. The Hosted BlackBerry Enterprise Server includes all of the components of the
BlackBerry Enterprise Server, but it uses a different licensing model.
Depending on how you configure your hosted environment, you might require additional configurations after the installation.
Installation Guide Installing the BlackBerry Router
7