Blackbe;rry Enterprise Server User manual

BlackBerry Enterprise Server for IBM
Lotus Domino
Version 4.1.4
Installation Guide

BlackBerry Enterprise Server Version 4.1.4 for IBM Lotus Domino Installation Guide
Last modified: 25 June 2007
Document ID: 12787735 Version 6
At the time of publication, this documentation is based on BlackBerry Enterprise Server Version 4.1.4 for IBM Lotus Domino.
Send us your comments on product documentation: https://www.blackberry.com/DocsFeedback.
©2007 Research In Motion Limited. All Rights Reserved. The BlackBerry and RIM families of related marks, images, and symbols are the
exclusive properties of Research In Motion Limited. RIM, Research In Motion, BlackBerry, “Always On, Always Connected” and the “envelope in
motion” symbol are registered with the U.S. Patent and Trademark Office and may be pending or registered in other countries.
Adobe, Acrobat, and Reader are trademarks of Adobe Systems Incorporated. IBM, Lotus, Domino, Lotus Notes, DB2 Universal Database, and
Sametime are trademarks of International Business Machines Corporation. Internet Explorer, Microsoft, SQL Server, Windows, Windows Media,
Windows Server, and Live Communications Server 2005 are trademarks of Microsoft Corporation. Novell and GroupWise are trademarks of
Novell, Inc. Ace/Agent is a trademark of Security Dynamics Technologies, Inc. RSA and SecurID are trademarks of RSA Security Inc. Java,
JavaScript, and J2SE are trademarks of Sun Microsystems, Inc. VMware is a trademark of VMware. All other brands, product names, company
names, trademarks and service marks are the properties of their respective owners.
The BlackBerry device and/or associated software are protected by copyright, international treaties, and various patents, including one or more
of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428; D433,460; D416,256. Other patents are
registered or pending in various countries around the world. Visit www.rim.com/patents for a list of RIM [as hereinafter defined] patents.
This document is provided “as is” and Research In Motion Limited and its affiliated companies (“RIM”) assume no responsibility for any
typographical, technical, or other inaccuracies in this document. In order to protect RIM proprietary and confidential information and/or trade
secrets, this document may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change
information that is contained in this document; however, RIM makes no commitment to provide any such changes, updates, enhancements, or
other additions to this document to you in a timely manner or at all. RIM MAKES NO REPRESENTATIONS, WARRANTIES, CONDITIONS, OR
COVENANTS, EITHER EXPRESS OR IMPLIED (INCLUDING WITHOUT LIMITATION, ANY EXPRESS OR IMPLIED WARRANTIES OR
CONDITIONS OF FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, MERCHANTABILITY, DURABILITY, TITLE, OR RELATED TO
THE PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE REFERENCED HEREIN OR PERFORMANCE OF ANY SERVICES
REFERENCED HEREIN). IN CONNECTION WITH YOUR USE OF THIS DOCUMENTATION, NEITHER RIM NOR ITS RESPECTIVE DIRECTORS,
OFFICERS, EMPLOYEES, OR CONSULTANTS SHALL BE LIABLE TO YOU FOR ANY DAMAGES WHATSOEVER BE THEY DIRECT, ECONOMIC,
COMMERCIAL, SPECIAL, CONSEQUENTIAL, INCIDENTAL, EXEMPLARY, OR INDIRECT DAMAGES, EVEN IF RIM HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES, INCLUDING WITHOUT LIMITATION, LOSS OF BUSINESS REVENUE OR EARNINGS, LOST DATA,
DAMAGES CAUSED BY DELAYS, LOST PROFITS, OR A FAILURE TO REALIZE EXPECTED SAVINGS.
This document might contain references to third-party sources of information, hardware or software, products or services and/or third-party
web sites (collectively the “Third-Party Information”). RIM does not control, and is not responsible for, any Third-Party Information, including,
without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any
other aspect of Third-Party Information. The inclusion of Third-Party Information in this document does not imply endorsement by RIM of the
Third-Party Information or the third-party in any way. Installation and use of Third-Party Information with RIM's products and services may
require one or more patent, trademark, or copyright licenses in order to avoid infringement of the intellectual property rights of others. Any
dealings with Third-Party Information, including, without limitation, compliance with applicable licenses and terms and conditions, are solely
between you and the third-party. You are solely responsible for determining whether such third-party licenses are required and are responsible
for acquiring any such licenses relating to Third-Party Information. To the extent that such intellectual property licenses may be required, RIM
expressly recommends that you do not install or use Third-Party Information until all such applicable licenses have been acquired by you or on
your behalf. Your use of Third-Party Information shall be governed by and subject to you agreeing to the terms of the Third-Party Information
licenses. Any Third-Party Information that is provided with RIM's products and services is provided “as is”. RIM makes no representation,

warranty or guarantee whatsoever in relation to the Third-Party Information and RIM assumes no liability whatsoever in relation to the Third-
Party Information even if RIM has been advised of the possibility of such damages or can anticipate such damages.
Published in Canada
Research In Motion Limited
295 Phillip Street
Waterloo, ON N2L 3W8
Canada
Research In Motion UK Limited
Centrum House, 36 Station Road
Egham, Surrey TW20 9LF
United Kingdom

Contents
1Planning your BlackBerry environment ........................................................................................................... 7
Choosing a BlackBerry Enterprise Server setup type...................................................................................7
Upgrading the BlackBerry Enterprise Server ............................................................................................... 9
2System requirements .......................................................................................................................................... 11
Hardware requirements...................................................................................................................................11
System requirements for the BlackBerry Enterprise Server .......................................................................11
Checklist: Operating system requirements .........................................................................................12
Checklist: Messaging and collaboration server software requirements .........................................13
Checklist: Security support requirements ............................................................................................13
Checklist: Multidomain support requirements ....................................................................................14
Checklist: Multilanguage support requirements.................................................................................14
Checklist: Virtual machine support requirements...............................................................................14
Checklist: Additional software requirements.......................................................................................14
System requirements for your corporate environment ..............................................................................14
Checklist: Network environment settings ............................................................................................15
Checklist: Messaging and collaboration environment settings ........................................................15
Checklist: Instant messaging environment settings...........................................................................16
Checklist: Terminal service settings ......................................................................................................16
Checklist: Database environment settings........................................................................................... 17
System requirements for remote components ............................................................................................18
Checklist: BlackBerry MDS Services system requirements ...............................................................19
Checklist: BlackBerry Enterprise Server with the BlackBerry MDS Services system requirements
19
Checklist: BlackBerry Attachment Service system requirements .....................................................21
Checklist: BlackBerry Manager system requirements ....................................................................... 22
Checklist: BlackBerry Router system requirements ........................................................................... 23
Checklist: BlackBerry MDS Connection Service system requirements........................................... 23
Checklist: BlackBerry Collaboration Service system requirements.................................................24
3Configuring your environment.........................................................................................................................25
Enabling the messaging environment to communicate with the BlackBerry Enterprise Server........ 25
Create the BlackBerryAdmins group.................................................................................................... 25

Modify the server document to permit moving users within a BlackBerry Domain......................25
Setting database permissions.......................................................................................................................26
Set Microsoft SQL Server permissions ................................................................................................. 27
Set DB2 UDB permissions...................................................................................................................... 27
Configure remote authentication for the local system account.............................................................. 27
Create Windows groups to support administrative roles..........................................................................28
Enable authentication for administrative roles on remote BlackBerry Managers ........................28
4Installing the BlackBerry Enterprise Server software...................................................................................31
Checklist: Confirm BlackBerry Enterprise Server installation requirements..........................................31
Install the BlackBerry Enterprise Server...................................................................................................... 32
Install a BlackBerry component on a remote computer............................................................................ 32
Install the database notification system ..................................................................................................... 32
Installing the Hosted BlackBerry for IBM Lotus Domino.......................................................................... 33
Troubleshooting the BlackBerry Enterprise Server installation process ................................................ 33
Resolving issues during the installation process................................................................................33
Resolving issues after the installation process completes................................................................34
Postinstallation tasks .....................................................................................................................................35
Configure the connection between the BlackBerry MDS Connection Service and a remote Black-
Berry Attachment Service ......................................................................................................................35
5Removing the BlackBerry Enterprise Server software................................................................................. 37
Remove the BlackBerry Enterprise Server software .................................................................................. 37
Remove registry entries from your computer ............................................................................................. 37
Remove the database notification system ..................................................................................................38

1
Planning your BlackBerry environment
Choosing a BlackBerry Enterprise Server setup type
The BlackBerry® Enterprise Server consists of services and components. The BlackBerry services are designed to
provide productivity tools—such as email, instant messaging, and organizer functionality—and data from
enterprise applications to mobile users. The BlackBerry components are designed to monitor BlackBerry services;
process, route, compress, and encrypt data; and communicate with the wireless network.
You can install all BlackBerry components on one computer, or you can install particular components on separate
computers. Consider any impacts on system resources when deciding where to install a component.
You can choose only one setup type for each computer in your environment.
Choosing a BlackBerry Enterprise Server setup type
Upgrading the BlackBerry Enterprise Server
Warning: After you choose a setup type, you cannot modify it. You must remove one setup type before you can install
another.
Setup type Description Considerations
BlackBerry
Enterprise Server
This setup type installs all BlackBerry components, except
the BlackBerry MDS Services.
—
BlackBerry MDS
Services
This setup type installs the BlackBerry Controller and the
following BlackBerry MDS Services on a remote computer:
•BlackBerry MDS Application Integration Service
•BlackBerry MDS Data Optimization Service
•BlackBerry MDS Provisioning Service
•BlackBerry MDS Administrative and Management
Service
•BlackBerry® MDS Studio Application Repository
A remote instance of the BlackBerry MDS Services can
support multiple BlackBerry Enterprise Servers and one
BlackBerry MDS Studio Application Repository.
The BlackBerry MDS Services might use increased system
resources when it processes content requests. Install an
instance of the BlackBerry MDS Services on a remote
computer to minimize the impact on message delivery.
You must install the BlackBerry MDS Studio Application
Repository on the same database server as the BlackBerry
Configuration Database.
BlackBerry
Enterprise Server
with BlackBerry
MDS Services
This setup type installs all BlackBerry components,
including the BlackBerry MDS Services.
—
BlackBerry
Attachment
Service
This setup type installs the BlackBerry Attachment Service
and the BlackBerry Controller on a remote computer.
A remote BlackBerry Attachment Service can support
multiple BlackBerry Enterprise Servers.
The BlackBerry Attachment Service might use increased
system resources when it processes concurrent conversion
requests. Install the BlackBerry Attachment Service on a
remote computer to increase the number of concurrent
conversions without impacting message delivery.

8
BlackBerry Enterprise Server for IBM Lotus Domino Installation Guide
BlackBerry
Manager
This setup type installs the BlackBerry Manager on a
remote computer.
A remote BlackBerry Manager enables you to manage
multiple BlackBerry Domains from your computer.
BlackBerry Router This setup type installs the BlackBerry Router and the
BlackBerry Controller on a remote computer.
A remote BlackBerry Router can support multiple
BlackBerry Enterprise Servers and is designed to provide
wireless network bypass to BlackBerry devices.
The BlackBerry Router does not use many system resources,
but it is a critical connection point for the BlackBerry®
Enterprise Solution. You can install several standby
BlackBerry Routers as failover locations in case your
primary BlackBerry Router is unavailable.
BlackBerry MDS
Connection
Service
This setup type installs the BlackBerry MDS Connection
Service and the BlackBerry Controller on a remote
computer.
A remote BlackBerry MDS Connection Service can support
multiple BlackBerry Enterprise Servers.
The BlackBerry MDS Connection Service might use
increased system resources when it processes content
requests. Install the BlackBerry MDS Connection Service on
a remote computer to minimize the impact on message
delivery.
Setup type Description Considerations

9
1: Planning your BlackBerry environment
Upgrading the BlackBerry Enterprise Server
See the BlackBerry Enterprise Server Version 4.1.4 Upgrade Guide for more information.
BlackBerry
Collaboration
Service
This setup type installs the BlackBerry Collaboration
Service, the BlackBerry Instant Messaging Connector, and
the BlackBerry Controller on a remote computer.
A remote BlackBerry Collaboration Service can support
multiple BlackBerry Enterprise Servers.
Your instant messaging environment can be IBM® Lotus®
Sametime®, Microsoft® Live Communications Server
2005™, or Novell® GroupWise® Messenger. Your choice is
not limited by your messaging server.
You can install only one type of the BlackBerry
Collaboration Service, and users can use only one type of
enterprise instant messaging application on the BlackBerry
device.
The BlackBerry Collaboration Service requires the following
persistent connections, based on your instant messaging
environment:
•If your instant messaging server is Microsoft Live
Communications Server 2005 and you are using
Transport Layer Security (TLS) as the communication
protocol, you require one persistent socket connection
for each instant messaging session.
•If your instant messaging server is Microsoft Live
Communications Server 2005 and you are using
Transmission Control Protocol (TCP) as the
communication protocol, you require three persistent
socket connections for each instant messaging session.
•If your instant messaging server is Microsoft Live
Communications Server 2005 and you are using
Hypertext Transfer Protocol over Secure Sockets Layer
(HTTPS) as the communication protocol, you require
three persistent socket connections to create one TCP
connection, and all instant messaging sessions use that
connection.
•If your instant messaging server is Sametime, you
require three persistent socket connections to create
one TCP connection, and all instant messaging sessions
use that connection.
•If your instant messaging server is GroupWise
Messenger, you require one persistent socket
connection for each instant messaging session.
Install the BlackBerry Collaboration Service on a remote
computer to maximize the number of available sockets.
Setup type Description Considerations

10
BlackBerry Enterprise Server for IBM Lotus Domino Installation Guide

2
System requirements
Hardware requirements
Visit www.blackberry.com/knowledgecenterpublic to read the BlackBerry Enterprise Server Version 4.1 for IBM
Lotus Domino Server Capacity Calculator and the BlackBerry Enterprise Server Version 4.1 for IBM Lotus Domino
Performance Benchmarking for more information about calculating hardware requirements based on the expected
use of the BlackBerry Enterprise Server in your environment.
System requirements for the BlackBerry Enterprise Server
You must confirm that the computer on which you plan to install the BlackBerry Enterprise Server meets the
system requirements.
Hardware requirements
System requirements for the BlackBerry Enterprise Server
System requirements for your corporate environment
System requirements for remote components
Checklists Description Reference
Checklist: Operating system requirements This checklist describes the operating system software and settings
that are required on the computer on which you plan to install the
BlackBerry Enterprise Server.
See page 12.
Checklist: Messaging and collaboration
server software requirements
This checklist describes the messaging server software and settings
that are required on the computer on which you plan to install the
BlackBerry Enterprise Server.
See page 13.
Checklist: Security support requirements This checklist describes the security software that is required on the
computer on which you plan to install the BlackBerry Enterprise Server,
if you want to support specific security features.
See page 13.
Checklist: Multidomain support requirements This checklist describes the configuration that is required on the
computer on which you plan to install the BlackBerry Enterprise Server,
if you have a multidomain messaging environment.
See page 14.
Checklist: Multilanguage support
requirements
This checklist describes the configuration that is required on the
computer on which you plan to install the BlackBerry Enterprise Server,
if you want to support localized message content.
See page 14.
Checklist: Virtual computer support
requirements
This checklist describes the configuration that is required on the
computer on which you plan to install the BlackBerry Enterprise Server,
if you have a virtual computer environment.
See page 14.

12
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide
Checklist: Operating system requirements
Checklist: Additional software requirements This checklist describes the additional software that is required on the
computer on which you plan to install the BlackBerry Enterprise Server,
if you want to read the documentation and help file, or if you want to
implement multiple BlackBerry devices from a single computer.
See page 14.
Note:You must install the most current service pack for each Microsoft product.
Considerations
Install one of the following operating systems on the computer on which you plan to install the BlackBerry Enterprise Server:
•Microsoft® Windows® 2000 Service Pack (SP) 4 (Server or Advanced Server editions)
•Microsoft® Windows Server® 2003 (SP1 is required for Microsoft Windows Messenger support)

Install Microsoft Messaging Queue (MSMQ) Version 3.0 (required for Microsoft Windows Messenger support).
Note: If you install MSMQ separately from Windows Server 2003, clear the default Active Directory Integration and Triggers
subcomponents and select only the Common subcomponent.

Install Microsoft® .NET Framework Version 1.1 (SP1 is required for Microsoft Windows Messenger support). You can install this
program during the BlackBerry Enterprise Server installation.

If Microsoft .NET Framework Version 2.0 is installed, the setup program still installs Version 1.1 or Version 1.1 SP1. 
If Microsoft .NET Framework Version 1.1 is installed in a language other than English, you must download and install SP1 in the
appropriate language.
Visit www.microsoft.com/netframework/downloads/ for more information.

Install one of the following Microsoft Data Access Component (MDAC) versions on the computer on which you plan to install the
BlackBerry Enterprise Server:
•MDAC Version 2.8 with Security Patch MS04-003 (Version 2000.85.1025.00)
•MDAC Version 2.8 SP2 (Version 2000.86.1830.00)
Note: MDAC Version 2.8 SP2 is shipped only with Microsoft Windows Server 2003 SP1.

Install Java® 2 Platform, Standard Edition (J2SE™) Runtime Environment Version 5.0 update 9. You can install this program during
the BlackBerry Enterprise Server installation.

If you are using IBM® DB2® Universal Database (DB2 UDB), install the IBM DB2 Universal Database Runtime Client Lite. You can
install this program during the BlackBerry Enterprise Server installation.

Checklists Description Reference

13
2: System requirements
Checklist: Messaging and collaboration server software requirements
Checklist: Security support requirements
Warning:Do not install IBM® Lotus® Notes® client software on the same computer as the BlackBerry Enterprise Server.
Considerations
Install one of the following messaging and collaboration servers on the computer on which you plan to install the BlackBerry
Enterprise Server:
•IBM® Lotus® Domino® server Version 5.0.3 or later (Version 5.0.12 recommended)
•IBM Lotus Domino server Version 6.0.1 Critical Fixpack 2 or later (Primary Domino Directory required)
•IBM Lotus Domino server Version 6.5 or later (Primary Domino Directory required; Version 6.5.1 required to support organizer
data synchronization for roaming users)
•IBM Lotus Domino server Version 7.0 (required to support encrypted message display)
Note: Do not install the BlackBerry Enterprise Server on a partitioned IBM Lotus Domino server.

Verify that the Notes.ini file has read/write permission. 
Verify that the Notes.ini file does not include the full path information for the SERVERKEYFILENAME value. You require only the
name of the server.id.

Verify that the IBM Lotus Domino server is a member of the LocalDomainServers group. 
Verify that the IBM Lotus Domino server has permission to run agents. 
Verify that the IBM Lotus Domino server has manager-level access to the mail files for BlackBerry users (required to display read
or unread message status on the BlackBerry device).

If your instant messaging environment supports Microsoft Windows Messenger and you are using TLS as the communication
protocol, you must install or import one of the following certificates on the computer on which you plan to install the BlackBerry
Enterprise Server:
•If your instant messaging server is Microsoft Live Communications Server 2005, you must install or import a Mutual TLS
(MTLS) certificate.
•If your instant messaging server is Microsoft Live Communications Server 2005 SP1, you must install or import a server
authentication certificate under the computer account.
Visit www.office.microsoft.com/en-us/FX011526591033.aspx for more information about configuring certificates on Microsoft
Live Communications Server 2005.

If your instant messaging server is , you must add the IP address of each computer on which you plan to install the BlackBerry
Collaboration Service to the CommunityConnectivity document on the Sametime server.

If your instant messaging server is Messenger, you must turn on support for Secure Sockets Layer (SSL) authentication of the
Novell GroupWise Messenger agents on the computer on which you plan to install the BlackBerry Collaboration Service. Visit
www.novell.com/documentation to read the Messenger 1.0 Administration Guide for more information.

Considerations
If you are using RSA® SecurID® authentication, you must install the Security Dynamics Technologies Ace/Agent® for Microsoft
Windows Version 5.0 on the computer on which you plan to install the BlackBerry MDS Connection Service.


14
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide
Checklist: Multidomain support requirements
Checklist: Multilanguage support requirements
Checklist: Virtual machine support requirements
Checklist: Additional software requirements
System requirements for your corporate environment
You must confirm that settings in your network, messaging and collaboration, instant messaging, and database
environments are configured to support the BlackBerry Enterprise Server.
Considerations
Verify that the IBM Lotus Domino server contains connection documents from the IBM Lotus Domino servers in the domains from
which it replicates.

Verify that the IBM Lotus Domino server is a member of the LocalDomainServers group in all the domains in your environment. 
Establish cross-certification (at a server or organization level) between the messaging and directory servers in other domains. 
Considerations
Set your language preferences in Microsoft® Internet Explorer® to display encoded web pages correctly. 
Considerations
Install VMware® ESX Server Version 2.5.2 on the computer on which you plan to install the BlackBerry Enterprise Server. 
Considerations
If you run a Universal Serial Bus (USB) hub to implement BlackBerry devices while connected to the BlackBerry Manager, verify
that the USB driver supports USB1.1-compliant hubs.

Install Adobe® Acrobat® Reader® Version 3.0 or later so that you can view the product guides. 
Set Microsoft Internet Explorer Version 4.0 or later with Java or JavaScript® enabled as your default browser so that you can view
the online help.

Install Microsoft® XML Parser Version 4.0 SP2 or later. You can install this program during the BlackBerry Enterprise Server
installation.

If you are using SNMP monitoring, you must install the SNMP service before you install the BlackBerry Enterprise Server. Visit
www.microsoft.com/technet/itsolutions/network/deploy/confeat/snmp.mspx for more information about installing and
configuring the SNMP service.

Install Microsoft® Windows Media® Player Version 9 or later to support audio attachments. 
Checklists Description Reference
Checklist: Network environment settings This checklist describes how your BlackBerry Enterprise Server must
connect to your firewall.
See page 15.
Checklist: Messaging and collaboration
environment settings
This checklist describes the software and settings that are required on
your messaging server and your desktop email program.
See page 15.

15
2: System requirements
Checklist: Network environment settings
Checklist: Messaging and collaboration environment settings
Checklist: Instant messaging environment
settings
This checklist describes the software and settings that are required on
your instant messaging server.
See page 16.
Checklist: Terminal service settings This checklist describes the supported software and settings for
installing the BlackBerry Enterprise Server using a terminal or remote
desktop session.
See page 16.
Checklist: Database environment settings This checklist describes the software and settings that are required on
your database server.
See page 17.
Considerations
Verify that the BlackBerry Enterprise Server is physically close to the messaging servers. Use a high-speed switched connection
between the BlackBerry Enterprise Server and the messaging servers. Network latency impacts the performance of the BlackBerry
Enterprise Server.

Verify that the BlackBerry Enterprise Server is not installed in a perimeter network (demilitarized zone). Visit
www.blackberry.com/knowledgecenterpublic to read article TAE-00038 for more information.

Verify that you have configured the corporate firewall or proxy to permit the BlackBerry Enterprise Server to initiate and maintain
an outbound connection to the BlackBerry® Infrastructure on TCP port 3101.

Verify that the corporate firewall can resolve Internet addresses using the Domain Name System (DNS). 
Verify that the proxy server is transparent, if you are using a proxying firewall. 
Considerations
Your messaging environment must be one of the following:
•IBM Lotus Domino server Version 5.0.3 or later (Version 5.0.12 recommended)
•IBM Lotus Domino server Version 6.0 or later (required to support encrypted message display; Version 6.0.4 and higher or
Version 6.5.4 and higher are required to display read or unread message status on the BlackBerry device)
•IBM Lotus Domino server Version 6.5 or later
•IBM Lotus Domino server Version 7.0

Your client software must be one of the following:
•IBM Lotus Notes Version 5.0.3 or later (Version 5.0.12 recommended)
•IBM Lotus Notes Version 6.0 or later
•IBM Lotus Notes Version 6.5 or later
•IBM Lotus Notes Version 7.0 (required to support encrypted message display when the user.id file is stored in the BlackBerry
Desktop Manager Version 4.1)

Checklists Description Reference

16
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide
Checklist: Instant messaging environment settings
Checklist: Terminal service settings
Considerations
Your instant messaging server must be one of the following:
•Sametime Version 3.0 Community Server
•Sametime Version 3.1 Community Server
•Sametime Version 6.5.1 Community Server (Version 6.5.1 or later is required to support dormant mode.)
•Sametime Version 7.0 Community Server
•Sametime Version 7.5 Community Server
•Microsoft Live Communications Server 2005 (SP1 is required to support Microsoft Office Communicator and dormant mode.)
•Novell GroupWise Messenger Server Version 1.0.2 or later
•Novell GroupWise Messenger Server Version 2.0

If your instant messaging environment supports Microsoft Office Communicator, your environment must also include a Microsoft
Office Communicator Web Access Server.
Verify that your Communicator Web Access Server meets the following criteria:
•includes the MTLS and HTTPS certificates required for communication with your Microsoft Live Communications Server
Visit office.microsoft.com/en-us/assistance/HA100240791033.aspx for more information.

If your instant messaging environment supports Microsoft Office Communicator, you must download and install the following
hotfixes to support the AJAX Service:
•visit www.support.microsoft.com/kb/911996 to install the hotfix on your Microsoft Live Communications Server
•visit www.support.microsoft.com/kb/915066 to install the hotfix on your Communicator Web Access server

If your instant messaging environment supports Microsoft Office Communicator, you must install or configure an additional
virtual server to support the AJAX Service on your Communicator Web Access server that meets the following criteria:
•uses all unassigned IP addresses
•uses forms-based authentication only (RIM does not recommend using integrated authentication when supporting HTTPS
connections)
•supports HTTPS browser connections
•contains an Internet Server API (ISAPI) filter for both the cwaauth.dll file and the ajax.dll file
Visit office.microsoft.com/en-us/assistance/HA100240791033.aspx to read the Microsoft Office Communicator Web Access
Planning and Deployment Guide for more information about enabling the AJAX Service for Communicator Web Access.

Considerations
If your operating system is Microsoft Windows Server 2000, you can install and access the BlackBerry Enterprise Server using the
Terminal Services program.
You must install the Terminal Services program using Remote Administration mode. Visit www.support.microsoft.com/kb/306624
for more information.
Note: RIM does not recommend using Application Server mode. If you install the Terminal Services program using Application
Server mode and then install the BlackBerry Enterprise Server, unpredictable results might occur.

If your operating system is Microsoft Windows Server 2003, you can install and access the BlackBerry Enterprise Server using the
Microsoft Remote Desktop Connection program that is included with Microsoft Windows Server 2003.
Note: Do not install the Terminal Services program. If you install the Terminal Services program on Microsoft Windows Server
2003, the Terminal Services program installs in Application Server mode automatically, which RIM does not recommend.


17
2: System requirements
Checklist: Database environment settings
Considerations
Install one of the following database programs on the computer on which you plan to install the BlackBerry Configuration
Database:
•Microsoft SQL Server 2000 Desktop Engine (MSDE 2000)
•Microsoft SQL Server 2000 SP3a
•Microsoft SQL Server 2005 (Standard, Enterprise, or Express)
•DB2 UDB Version 8.2 (Express or Enterprise)
Notes: If you are installing BlackBerry MDS Services, you cannot use Microsoft SQL Server 2005 Express as your database
program.
You can install MSDE 2000 during the BlackBerry Enterprise Server installation.

Install one of the following MDAC versions on the computer on which you plan to install the BlackBerry Configuration Database:
•MDAC Version 2.8 with Security Patch MS04-003 (Version 2000.85.1025.00)
•MDAC Version 2.8 SP2 (Version 2000.86.1830.00)
MDAC Version 2.8 SP2 is shipped only with Microsoft Windows Server 2003 SP1.

You must manage the BlackBerry Configuration Database using a BlackBerry Manager that is configured to support the database
management system (DBMS) type. You select the DBMS type of the BlackBerry Manager during the BlackBerry Enterprise Server
installation.

The version of MSDE 2000 (MSDE 2000 Release A) provided with the BlackBerry Enterprise Server does not support upgrading
from a previous version of MSDE. Visit www.support.microsoft.com/kb/829925 for more information.

If you are using Microsoft SQL Server, install the program using the default case-insensitive collation setting. The collation setting
for the BlackBerry Configuration Database must be the same as the collation setting for the database server.

If you are using Microsoft SQL Server, you can install the BlackBerry Configuration Database on a nondefault instance. During
the installation process, you can specify servername\instancename.

If you are using Microsoft SQL Server and if you are using Windows authentication between the BlackBerry Enterprise Server and
the BlackBerry Configuration Database, you must set the Microsoft SQL Server to run under the Local System account.

If you are using DB2 UDB, do not install the database program on a mainframe computer. 
If you are using DB2 UDB and you want to create the BlackBerry Configuration Database using an account name that is longer
than the database schema name (by default, BESADMIN), you must first apply DB2 UDB Version 8.2 FixPak 5 to your database
server. Visit www-1.ibm.com/support/docview.wss?uid=swg1LI70002 for more information.

If the BlackBerry Configuration Database is on a remote computer or you want to use a remote BlackBerry Manager, you must
enable named pipes and TCP/IP network protocols.

If you are installing the BlackBerry MDS Services, you must install the BlackBerry MDS Services databases on the same DBMS and
on the same database server as the BlackBerry Configuration Database.

If you are installing the BlackBerry MDS Services and if you are using Microsoft SQL Server, the Microsoft SQL Server must support
mixed-mode authentication. If you install the BlackBerry Configuration Database on MSDE 2000, you receive a prompt to accept
this change in authentication.

If you are installing the BlackBerry MDS Services and if you are using DB2 UDB, you must create the database user account before
you create the BlackBerry MDS Services databases.


18
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide
System requirements for remote components
If you plan to install BlackBerry components on remote computers, you must confirm that those computers meet
the system requirements.
If you are installing the BlackBerry MDS Services, you must use SQL authentication to create the BlackBerry MDS Services
databases.
If you are using SQL authentication to create the BlackBerry Configuration Database, you must use a different SQL account to
create the BlackBerry MDS Services databases.
Note: The BlackBerry MDS Services store their BlackBerry MDS Services database access credentials in plain text form in
<installation directory>\MDSS\jakarta-tomcat-5.5.9\conf\server.xml. To protect the access credentials in that storage location,
you must limit read and write control to that location.

Checklists Description Reference
Checklist: BlackBerry MDS Services system
requirements
This checklist describes the software and settings that are required on
the computer on which you plan to install the BlackBerry MDS Services.
See page 19.
Checklist: BlackBerry Enterprise Server with
the BlackBerry MDS Services system
requirements
This checklist describes the software and settings that are required on
the computer on which you plan to install the BlackBerry Enterprise
Server with BlackBerry MDS Services.
See page 19.
Checklist: BlackBerry Attachment Service
system requirements
This checklist describes the software and settings that are required on
the computer on which you plan to install the BlackBerry Attachment
Service.
See page 21.
Checklist: BlackBerry Manager system
requirements
This checklist describes the software and settings that are required on
the computer on which you plan to install the BlackBerry Manager.
See page 22.
Checklist: BlackBerry Router system
requirements
This checklist describes the software and settings that are required on
the computer on which you plan to install the BlackBerry Router.
See page 23.
Checklist: BlackBerry MDS Connection
Service system requirements
This checklist describes the software and settings that are required on
the computer on which you plan to install the BlackBerry MDS
Connection Service.
See page 23.
Checklist: BlackBerry Collaboration Service
system requirements
This checklist describes the software and settings that are required on
the computer on which you plan to install the BlackBerry Collaboration
Service.
See page 24.
Considerations

19
2: System requirements
Checklist: BlackBerry MDS Services system requirements
Checklist: BlackBerry Enterprise Server with the BlackBerry MDS Services
system requirements
System
requirement Considerations
operating
system
Install one of the following operating systems on the computer on which you plan to install the BlackBerry MDS
Services:
•Microsoft Windows 2000 (Server or Advanced Server editions)
•Microsoft Windows Server 2003 (Standard, Enterprise or Small Business Server)
•Microsoft Windows XP
Verify that the operating system is installed in one of English, French, German, Italian, or Spanish.
If you are using DB2 UDB, install the IBM DB2 Universal Database Runtime Client Lite. You can install this
program during the BlackBerry Enterprise Server installation.

additional
software
Install Adobe Acrobat Reader Version 3.0 or later so that you can view the product guides. 
System
requirement Considerations
operating
system
Install one of the following operating systems on the computer on which you plan to install the BlackBerry
Enterprise Server with BlackBerry MDS Services:
•Microsoft Windows 2000 SP4 (Server or Advanced Server editions)
•Microsoft Windows Server 2003 (Standard, Enterprise or Small Business Server)
Install MSMQ Version 3.0 (required for Microsoft Windows Messenger support).
Note: If you install MSMQ separately from Windows Server 2003, clear the default Active Directory Integration
and Triggers subcomponents and select only the Common subcomponent.
Install Microsoft .NET Framework Version 1.1 SP1. You can install this program during the BlackBerry Enterprise
Server installation.
If Microsoft .NET Framework Version 2.0 is installed, the setup program still installs Version 1.1 or Version 1.1 SP1.
If Microsoft .NET Framework Version 1.1 is installed in a language other than English, you must download and
install SP1 in the appropriate language. Visit www.microsoft.com/netframework/downloads/ for more
information.
Install one of the following MDAC versions:
•MDAC Version 2.8 with Security Patch MS04-003 (Version 2000.85.1025.00)
•MDAC Version 2.8 SP2 (Version 2000.86.1830.00)
Note: MDAC Version 2.8 SP2 is shipped only with Microsoft Windows Server 2003 SP1.
Install J2SE Runtime Environment Version 5.0 update 9. You can install this program during the BlackBerry
Enterprise Server installation.
If you are using DB2 UDB, install the IBM DB2 Universal Database Runtime Client Lite. You can install this
program during the BlackBerry Enterprise Server installation.


20
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide
messaging and
collaboration
server software
Install one of the following messaging servers on the computer on which you plan to install the BlackBerry
Enterprise Server with BlackBerry MDS Services:
•IBM Lotus Domino server Version 5.0.3 or later (Version 5.0.12 recommended)
•IBM Lotus Domino server Version 6.0.1 Critical Fixpack 2 or later (Primary Domino Directory required)
•IBM Lotus Domino server Version 6.5 or later (Primary Domino Directory required; Version 6.5.1 required to
support organizer synchronization for roaming users)
•IBM Lotus Domino server Version 7.0 (required to support encrypted message display)
Note: Do not install the BlackBerry Enterprise Server on a partitioned IBM Lotus Domino server.
Verify that the Notes.ini file has read/write permission.
Verify that the Notes.ini file does not include the full path information for the SERVERKEYFILENAME value. You
require only the name of the server.id.
Verify that the IBM Lotus Domino server is a member of the LocalDomainServers group.
Verify that the IBM Lotus Domino server has permission to run agents.
•Verify that the IBM Lotus Domino server has manager-level access to the mail files for BlackBerry device
user accounts (required to display read or unread message status on the BlackBerry device).

If your instant messaging environment supports Microsoft Windows Messenger and you are using TLS as the
communication protocol, you must install or import one of the following certificates on the computer on which
you plan to install the BlackBerry Collaboration Service:
•If your instant messaging server is Microsoft Live Communications Server 2005, you must install or
import an MTLS certificate.
•If your instant messaging server is Microsoft Live Communications Server 2005 SP1, you must install or
import a server authentication certificate under the computer account.
Visit www.office.microsoft.com/en-us/FX011526591033.aspx for more information about configuring
certificates on Microsoft Live Communications Server 2005.
If your instant messaging server is Sametime, you must add the IP address of each computer on which you plan
to install the BlackBerry Collaboration Service to the CommunityConnectivity document on the Sametime
server.
If your instant messaging server is Novell GroupWise Messenger, you must turn on support for SSL
authentication of the Novell GroupWise Messenger agents on the computer on which you plan to install the
BlackBerry Collaboration Service. Visit www.novell.com/documentation to read the Messenger 1.0
Administration Guide for more information.

multilanguage
support
Set your language preferences in Microsoft Internet Explorer to display encoded web pages correctly. 
security
support
If you are using RSA SecurID authentication, you must install the Security Dynamics Technologies Ace/Agent
for Microsoft Windows Version 5.0 on the computer on which you plan to install the BlackBerry MDS Connection
Service.

System
requirement Considerations