Blackbe;rry PROFESSIONAL SOFTWARE FOR IBM LOTUS DOMINO User manual

Getting Started Guide
BlackBerry Professional Software
Version: 4.1 | Service Pack: 4

SWDT305427-305427-0912091433-001

Contents
1BlackBerry Professional Software overview.................................................................................................................. 3
Architecture: BlackBerry Professional Software in a Microsoft Exchange messaging environment............................. 3
Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment............................. 6
2System requirements.......................................................................................................................................................... 11
System requirements: BlackBerry Professional Software in a Microsoft Exchange messaging environment.............. 11
System requirements: Client computers in a Microsoft Exchange messaging environment.......................................... 14
System requirements: BlackBerry Professional Software in an IBM Lotus Domino messaging environment.............. 14
System requirements: Client computers in an IBM Lotus Domino environment............................................................... 16
3 Configuring a Microsoft Exchange version 5.5, 2000, or 2003 messaging environment.................................... 17
Create a Microsoft Windows account and mailbox................................................................................................................ 17
Configure permissions for the Microsoft Windows account................................................................................................. 18
Configuring Microsoft Exchange permissions for the Microsoft Windows account......................................................... 18
Configure Microsoft Exchange version 5.5 permissions for the Microsoft Windows account.................................... 18
Configure Microsoft Exchange 2000 or 2003 permissions for the Microsoft Windows account............................... 19
Start the MAPI subsystem.......................................................................................................................................................... 19
Identify and address Microsoft Exchange known issues for wireless calendar synchronization.................................... 19
4 Configuring a Microsoft Exchange 2007 messaging environment.......................................................................... 21
Create a Microsoft Exchange 2007 account and mailbox.................................................................................................... 21
Configure Microsoft Windows permissions for the Microsoft Exchange 2007 account................................................... 21
Configure Microsoft Exchange 2007 permissions for the Microsoft Exchange account................................................. 22
Enable BlackBerry device users to send messages in a Microsoft Exchange 2007 environment................................... 22
5 Configuring an IBM Lotus Domino messaging environment..................................................................................... 23
Create a group for BlackBerry Professional Software administrators................................................................................. 23
Configure the server document to allow administrators to move users in a BlackBerry Domain................................... 23
Configure the local system account for Microsoft Windows authentication..................................................................... 24
Configure the local system account for database authentication....................................................................................... 24
6 Setting up the database connection............................................................................................................................... 25
Specifying permissions when connecting to the BlackBerry Configuration Database using Microsoft Windows
authentication.............................................................................................................................................................................. 25
Assign Microsoft SQL Server permissions............................................................................................................................... 25

7 Installing the BlackBerry Professional Software......................................................................................................... 27
Prerequisites: Installing the BlackBerry Professional Software........................................................................................... 27
Install the BlackBerry Professional Software in a Microsoft Exchange messaging environment................................... 27
Configure the BlackBerry Professional Software in a Microsoft Exchange messaging environment............................ 28
Create a Public Folders storage group and database for a Microsoft Exchange 2007 messaging environment
.................................................................................................................................................................................................... 29
Install the BlackBerry Professional Software in an IBM Lotus Domino messaging environment................................... 30
Configure the BlackBerry Professional Software in an IBM Lotus Domino messaging environment............................ 31
8 Troubleshooting the installation process...................................................................................................................... 33
A third-party tool did not install successfully and the BlackBerry Professional Software setup application closed
........................................................................................................................................................................................................ 33
Failed to write License Key to the Database........................................................................................................................... 33
Previous version detected but no database available............................................................................................................ 33
The setup application prompts for access to the installation media for Microsoft .NET Framework version 1.1.......... 34
The setup application did not prompt you to change or confirm the MAPI profile.......................................................... 34
Could not open ID file................................................................................................................................................................. 35
Service failed to start, generating error 5305........................................................................................................................ 35
BlackBerry Router and BlackBerry Dispatcher do not install during the migration or upgrade process...................... 38
I am experiencing an issue after I install the BlackBerry Professional Software on the Windows Small Business
Server............................................................................................................................................................................................. 39
Microsoft Outlook Web Access no longer works after I install the BlackBerry Professional Software.......................... 39
9 Adding user accounts......................................................................................................................................................... 41
Preconfigured IT policies in the BlackBerry Professional Software..................................................................................... 41
Add a user account...................................................................................................................................................................... 43
10 Legal notice.......................................................................................................................................................................... 45

BlackBerry Professional Software overview 1
The BlackBerry® Professional Software is designed for organizations with up to 30 BlackBerry device users who collaborate
using the organization’s messaging server. From their BlackBerry devices, users can send and receive email messages,
manage calendar and address book contacts, and organize their workloads using tasks and memos. Users can also browse
the Internet or work with applications that are available for their BlackBerry devices.
The BlackBerry Professional Software has been designed to streamline administration, with a simplified BlackBerry Manager
to help you set up and manage user accounts and administer the BlackBerry Professional Software. The design is intended
to make it easier for administrators in small organizations to manage the BlackBerry Professional Software in addition to
their main responsibilities.
You can install the BlackBerry Professional Software on your messaging server or on a separate server. Installing the
BlackBerry Professional Software and adding your first user account usually takes less than two hours.
If the number of BlackBerry device users in your organization increases, or if you find that users need access to more data
or to a broader range of applications, you can upgrade from the BlackBerry Professional Software to BlackBerry® Enterprise
Server version 4.1 SP5 or later.
Architecture: BlackBerry Professional Software in a Microsoft Exchange
messaging environment
The BlackBerry® Professional Software components are designed to perform the following actions:
• provide productivity tools and data from your organization's applications to your BlackBerry device users
• monitor other BlackBerry Professional Software components
• process, route, compress, and encrypt data
• communicate with the wireless network
Getting Started Guide BlackBerry Professional Software overview
3

Component Description
BlackBerry Attachment Service The BlackBerry Attachment Service converts supported message attachments
into a format that users can view on their BlackBerry devices.
BlackBerry Configuration Database The BlackBerry Configuration Database is a relational database that contains
configuration information that the components of the BlackBerry Professional
Software use. The BlackBerry Configuration Database stores the following
information:
• information about the connection from the BlackBerry Professional
Software to the wireless network
• user list
Getting Started Guide Architecture: BlackBerry Professional Software in a Microsoft Exchange messaging environment
4

Component Description
•address mappings between PINs and email addresses for BlackBerry® MDS
Connection Service push features
• read-only copy of the master encryption key for each BlackBerry device
BlackBerry Controller The BlackBerry Controller monitors the components of the BlackBerry
Professional Software and restarts them if they stop responding.
BlackBerry Dispatcher The BlackBerry Dispatcher compresses and encrypts the data that it sends to
and receives from BlackBerry devices. It sends the data through the BlackBerry
Router to and from the wireless network.
BlackBerry Manager The BlackBerry Manager connects to the BlackBerry Configuration Database.
You use the BlackBerry Manager to manage user accounts and BlackBerry
devices.
BlackBerry MDS Connection Service The BlackBerry MDS Connection Service allows users to access web content, the
Internet, or your organization's intranet, and also allows applications on the
BlackBerry device to connect to your organization's application or content
servers for data and application updates.
BlackBerry Messaging Agent The BlackBerry Messaging Agent connects to the messaging server to provide
services for messaging, calendar management, address lookup, attachment
viewing, and wireless generation of encryption keys. The BlackBerry Messaging
AgentalsoactsasagatewayfortheBlackBerrySynchronizationServicetoaccess
organizer data on the messaging server. In a Microsoft® Exchange messaging
environment, the BlackBerry Messaging Agent also synchronizes configuration
data between the BlackBerry Configuration Database and user mailboxes.
BlackBerry Policy Service The BlackBerry Policy Service performs administration services over the wireless
network, such as sending IT policies and IT administration commands and
provisioning service books. IT policies and IT administration commands define
BlackBerry device security, settings for wireless data synchronization, and other
configuration settings on the BlackBerry device. Service books define feature
and component settings on the BlackBerry device.
BlackBerry Router The BlackBerry Router connects to the wireless network to send data to and
receive data from BlackBerry devices. It also sends data within your
organization's network to BlackBerry devices that are connected to computers
using the BlackBerry® Device Manager.
Getting Started Guide Architecture: BlackBerry Professional Software in a Microsoft Exchange messaging environment
5

Component Description
BlackBerry Synchronization Service The BlackBerry Synchronization Service synchronizes organizer data between
BlackBerry devices and the messaging server over the wireless network.
messaging server The messaging server stores email accounts.
user computer with the BlackBerry
Device Manager
Theuser computerwith theBlackBerry DeviceManager enablesusers toconnect
their BlackBerry devices to their computers using a serial connection or USB
connection. The BlackBerry Professional Software uses this connection to send
data to and receive data from BlackBerry devices.
Data traffic from BlackBerry devices bypasses the wireless network while a
BlackBerry device is connected to a user’s computer. The BlackBerry Device
Manager connects to the BlackBerry Router, which sends data directly to the
BlackBerry device.
Users can install the BlackBerry Device Manager separately or with the
BlackBerry® Desktop Manager as part of the full BlackBerry® Desktop
Software installation. The BlackBerry Device Manager is an optional component,
but the BlackBerry Router requires it to support connections to the BlackBerry
Router that bypass the BlackBerry® Infrastructure.
Architecture: BlackBerry Professional Software in an IBM Lotus Domino
messaging environment
The BlackBerry® Professional Software components are designed to perform the following actions:
• provide productivity tools and data from your organization's applications to your BlackBerry device users
• monitor other BlackBerry Professional Software components
• process, route, compress, and encrypt data
• communicate with the wireless network
Getting Started Guide Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment
6

Component Description
BlackBerry Attachment Service The BlackBerry Attachment Service converts supported message attachments
into a format that users can view on their BlackBerry devices.
BlackBerry Configuration Database The BlackBerry Configuration Database is a relational database that contains
configuration information that the components of the BlackBerry Professional
Software use. The BlackBerry Configuration Database stores the following
information:
•details about the connection from the BlackBerry Professional Software to
the wireless network
• user list
Getting Started Guide Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment
7

Component Description
•address mappings between PINs and email addresses for BlackBerry® MDS
Connection Service push features
• read-only copy of the master encryption key for each BlackBerry device
BlackBerry Controller The BlackBerry Controller monitors the components of the BlackBerry
Professional Software and restarts them if they stop responding.
BlackBerry Dispatcher The BlackBerry Dispatcher compresses and encrypts the data that it sends to
and receives from BlackBerry devices. It sends the data through the BlackBerry
Router to and from the wireless network.
BlackBerry Manager The BlackBerry Manager connects to the BlackBerry Configuration Database.
You use the BlackBerry Manager to manage user accounts and BlackBerry
devices.
BlackBerry MDS Connection Service The BlackBerry MDS Connection Service allows users to access web content, the
Internet, or your organization's intranet, and also allows applications on the
BlackBerry device to connect to your organization's application or content
servers for data and application updates.
BlackBerry Messaging Agent The BlackBerry Messaging Agent connects to the messaging server to provide
services for messaging, calendar management, address lookups, attachment
viewing, and generation of wireless encryption keys. The BlackBerry Messaging
Agentalsoactsasa gateway fortheBlackBerrySynchronizationServicetoaccess
organizer data on the messaging server. The BlackBerry Messaging Agent
synchronizes configuration data between the BlackBerry Configuration
Database and the BlackBerry profiles database.
BlackBerry Policy Service The BlackBerry Policy Service performs administration services over the wireless
network, such as sending IT policies and IT administration commands, and
provisioning service books. IT policies and IT administration commands define
BlackBerry device security, settings for wireless data synchronization, and other
configuration settings on the BlackBerry device. Service books are also used to
define settings on the BlackBerry device.
BlackBerry profiles database The BlackBerry profiles database is an IBM® Lotus® Domino® database that
contains configuration information for user accounts.
Getting Started Guide Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment
8