BlackBerry Enterprise Server for Microsoft Exchange

BlackBerry Enterprise Server for Microsoft Exchange
BlackBerry Enterprise Server for Microsoft Exchange
Version: 5.0
Installation and Configuration Guide
SWD-512046-0330012902-001
Contents
1
Overview: BlackBerry Enterprise Server..................................................................................................................................
5
2 Planning a BlackBerry Enterprise Server installation............................................................................................................
Installing all BlackBerry Enterprise Server components on one computer..............................................................................
Installing the BlackBerry Administration Service........................................................................................................................
Installing the BlackBerry Attachment Service.............................................................................................................................
Installing the BlackBerry Collaboration Service..........................................................................................................................
Installing the BlackBerry MDS Connection Service....................................................................................................................
Installing the BlackBerry MDS Integration Service....................................................................................................................
Installing the BlackBerry Monitoring Service..............................................................................................................................
Installing the BlackBerry Router...................................................................................................................................................
6
6
6
7
7
8
8
9
9
3 Hardware requirements: BlackBerry Enterprise Server.........................................................................................................
10
4 System requirements..................................................................................................................................................................
System requirements: BlackBerry Enterprise Server..................................................................................................................
System requirements: BlackBerry Administration Service and BlackBerry Web Desktop Manager.....................................
System requirements: BlackBerry Enterprise Server databases................................................................................................
System requirements: BlackBerry Attachment Service..............................................................................................................
System requirements: BlackBerry Collaboration Service...........................................................................................................
System requirements: BlackBerry MDS Connection Service.....................................................................................................
System requirements: BlackBerry MDS Integration Service......................................................................................................
System requirements: BlackBerry Monitoring Service...............................................................................................................
System requirements: BlackBerry Router.....................................................................................................................................
System requirements: Computers for BlackBerry Web Desktop Manager users....................................................................
System requirements: Messaging server.....................................................................................................................................
System requirements: Firewall......................................................................................................................................................
System requirements: Instant messaging server........................................................................................................................
Supported features and environments.........................................................................................................................................
Unsupported environments...........................................................................................................................................................
11
11
12
12
14
14
15
15
16
17
17
18
18
18
19
19
5 Preinstallation tasks....................................................................................................................................................................
Configuring a Microsoft Exchange 2007 messaging environment..........................................................................................
Create a Microsoft Exchange 2007 account and mailbox.................................................................................................
Configure Local Security Policy permissions for the Microsoft Exchange 2007 account..............................................
20
20
20
20
Configure Microsoft Exchange 2007 permissions for the Microsoft Exchange account...............................................
Enable BlackBerry device users to send email messages in a Microsoft Exchange 2007 environment......................
Configuring a Microsoft Exchange 2003 messaging environment..........................................................................................
Create a Windows account and mailbox..............................................................................................................................
Configure permissions for the Windows account...............................................................................................................
Configure Microsoft Exchange 2003 permissions for the Windows account.................................................................
Resolve the Microsoft Exchange known issues for wireless calendar synchronization.................................................
Verify if the Windows account can access a user account in Microsoft Exchange.................................................................
Configuring connections for the BlackBerry Enterprise Server databases..............................................................................
Specifying permissions when connecting to the BlackBerry Enterprise Server databases using Windows
authentication.........................................................................................................................................................................
Configuring authentication to the BlackBerry MDS Integration Service database.......................................................
Create a BlackBerry Configuration Database.....................................................................................................................
Configuring the LDAP information for the BlackBerry Administration Service......................................................................
Configure permissions for the administrator account on the LDAP server that the BlackBerry Administration Service
uses..........................................................................................................................................................................................
Find the LDAP information that the BlackBerry Administration Service requires..........................................................
Configure the BlackBerry Administration Service to authenticate user accounts from multiple Microsoft Active
Directory domains..................................................................................................................................................................
Install the SNMP service for monitoring by the BlackBerry Monitoring Service.....................................................................
Creating a BlackBerry Administration Service pool using DNS round robin that includes the BlackBerry Web Desktop
Manager...........................................................................................................................................................................................
Creating a BlackBerry MDS Integration Service pool.................................................................................................................
Create the DNS record for a BlackBerry Administration Service instance or BlackBerry MDS Integration Service instance
...........................................................................................................................................................................................................
Configuring the setup application to use a non-default static port number for the database server..................................
Create an alias to the database server using the Microsoft SQL Server Configuration Manager................................
Create an alias to the database server using the cliconfg.exe tool..................................................................................
Persistent socket connections for the BlackBerry Collaboration Service.................................................................................
Applications that are installed with the BlackBerry Enterprise Server components..............................................................
6 Installing the BlackBerry Enterprise Server software............................................................................................................
Prerequisites: Installing the BlackBerry Enterprise Server software........................................................................................
Install the BlackBerry Enterprise Server software.......................................................................................................................
Specifying a name for the BlackBerry Administration Service pool during the installation process...........................
21
21
22
22
22
23
23
24
24
25
25
26
27
27
28
29
29
30
30
31
32
32
32
33
33
35
35
35
37
Install a BlackBerry Enterprise Server component on a separate computer...........................................................................
Install the BlackBerry Monitoring Service software....................................................................................................................
37
39
7 Installing a standby BlackBerry Enterprise Server.................................................................................................................
Install a standby BlackBerry Enterprise Server............................................................................................................................
41
41
8 Postinstallation tasks..................................................................................................................................................................
Test the BlackBerry Enterprise Server installation......................................................................................................................
Install the BlackBerry database notification system...................................................................................................................
Best practice: Running the BlackBerry Enterprise Server..........................................................................................................
Configure support for Unicode languages...................................................................................................................................
Configure support for Unicode text in calendars on BlackBerry devices in a Microsoft Exchange 2003 environment
...........................................................................................................................................................................................................
Log in to the BlackBerry Administration Service for the first time............................................................................................
Configuring a computer for monitoring.......................................................................................................................................
Configure the SNMP service for monitoring.......................................................................................................................
Configure the BlackBerry Monitoring Service to monitor a BlackBerry Enterprise Server............................................
Configuring communication with distributed components.......................................................................................................
Connecting to a BlackBerry Attachment Service...............................................................................................................
Connecting to a BlackBerry Router......................................................................................................................................
Configure multiple BlackBerry Enterprise Server instances to use the same BlackBerry MDS Integration Service
..................................................................................................................................................................................................
Restrict database permissions for the BlackBerry Attachment Service...................................................................................
Configuring minimum Microsoft SQL Server permissions for the Windows account.............................................................
Configure minimum Microsoft SQL Server permissions for the Windows account........................................................
Changing the BlackBerry Configuration Database.....................................................................................................................
Configuring a Hosted BlackBerry services environment............................................................................................................
Configure how users search for email addresses in a Hosted BlackBerry services environment.................................
Configure the BlackBerry Enterprise Server to search for email addresses using LDAP...............................................
Configure the BlackBerry Enterprise Server to search for email addresses using a custom LDAP field.....................
44
44
44
45
46
9 Adding or removing BlackBerry Enterprise Server components..........................................................................................
Add or remove a BlackBerry Enterprise Server component.......................................................................................................
Remove BlackBerry Enterprise Server component information from the BlackBerry Configuration Database..................
57
59
61
10 Removing the BlackBerry Enterprise Server software...........................................................................................................
62
46
47
47
47
48
48
48
51
52
53
53
54
55
55
55
56
56
Remove the BlackBerry Enterprise Server software....................................................................................................................
Delete registry keys........................................................................................................................................................................
BlackBerry Enterprise Server registry keys..........................................................................................................................
Removing the BlackBerry database notification system............................................................................................................
Remove the BlackBerry database notification system from one BlackBerry Configuration Database........................
Remove the BlackBerry database notification system from all BlackBerry Configuration Database instances.........
62
62
62
63
63
63
11 Troubleshooting the BlackBerry Enterprise Server installation process.............................................................................
Failed to write License Key to the Database................................................................................................................................
Previous version detected but no database available................................................................................................................
A third-party tool did not install and the BlackBerry Enterprise Server setup application closed........................................
The setup application did not prompt you to change or confirm the MAPI profile................................................................
The BlackBerry Monitoring Service cannot monitor events.......................................................................................................
You cannot determine the BlackBerry Attachment Connector that the BlackBerry Enterprise Server or the BlackBerry
MDS Connection Service uses.......................................................................................................................................................
Users experience unexpected behavior with message lists and calendars on BlackBerry devices......................................
Various BlackBerry Enterprise Server components do not start...............................................................................................
Could not create a user account in the BlackBerry Administration Service............................................................................
The BlackBerry Administration Service pool name is the same as the FQDN of the host computer...................................
65
65
65
66
66
66
67
68
69
69
70
12 Glossary.........................................................................................................................................................................................
71
13 Provide feedback.........................................................................................................................................................................
74
14 Legal notice..................................................................................................................................................................................
75
Installation and Configuration Guide
Overview: BlackBerry Enterprise Server
Overview: BlackBerry Enterprise Server
1
The BlackBerry® Enterprise Server is designed to be a secure, centralized link between an organization's wireless network,
communications software, applications, and BlackBerry devices. The BlackBerry Enterprise Server integrates with your
organization's existing infrastructure, which can include messaging and collaboration software, calendar and contact information,
wireless Internet and intranet access, and custom applications, to provide BlackBerry device users with mobile access to your
organization's resources.
The BlackBerry Enterprise Server supports AES and Triple DES encryption to protect and ensure the integrity of wireless data
that is transmitted between the BlackBerry Enterprise Server components and BlackBerry devices. You can select from more than
450 IT policy rules that you can configure to control the features of the BlackBerry devices that are used in your organization's
environment.
The BlackBerry Enterprise Server supports several optional components and configurations to meet your organization's
requirements. The BlackBerry Collaboration Service integrates with supported third-party instant messaging servers to permit
users to access your organization's instant messaging system from their BlackBerry devices using the BlackBerry instant
messaging client. The BlackBerry MDS Integration Service supports custom application development and distribution. You can
configure the BlackBerry Enterprise Server and the BlackBerry Enterprise Server components to support high availability to
enhance the consistency and reliability of your organization's environment.
You can manage the BlackBerry Enterprise Server, BlackBerry devices, and user accounts using the BlackBerry Administration
Service, a web application that is accessible from any computer that can access to the computer that hosts the BlackBerry
Administration Service. You can use the BlackBerry Administration Service to manage a BlackBerry Domain, which consists of
multiple BlackBerry Enterprise Server instances that use a single BlackBerry Configuration Database.
5
Installation and Configuration Guide
Planning a BlackBerry Enterprise Server installation
Planning a BlackBerry Enterprise Server installation
2
You can install all BlackBerry® Enterprise Server components on one computer, or you can install specific components on separate
computers. You should consider any impact to system resources before you decide where to install the components.
You install all components on one computer if you do not plan to activate many BlackBerry devices, if you determine that the
computer can manage the volume of traffic for the BlackBerry Enterprise Server components, or if it is acceptable that the
computer has direct access to the wireless network, without being located in the DMZ.
If you want to configure high availability, you must install a duplicate BlackBerry Enterprise Server on a computer that is separate
from the computer that hosts the primary BlackBerry Enterprise Server. During the installation process, you specify that the
duplicate BlackBerry Enterprise Server is the standby BlackBerry Enterprise Server.
For performance information, see the BlackBerry Enterprise Server Performance Benchmarking Guide.
For more information about high availability, see the BlackBerry Enterprise Server Planning Guide.
Installing all BlackBerry Enterprise Server components on one computer
If you want to evaluate the BlackBerry® Enterprise Server or complete a BlackBerry Enterprise Server installation 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 the BlackBerry Administration Service, BlackBerry Collaboration Service,
BlackBerry MDS Integration Service, BlackBerry Monitoring Service, and BlackBerry® Web Desktop Manager with the BlackBerry
Enterprise Server. All of the other BlackBerry Enterprise Server components are installed automatically when you install the
BlackBerry Enterprise Server. The BlackBerry MDS Integration Service is an optional component that you require only if you want
users to use BlackBerry® MDS Runtime Applications on BlackBerry devices.
Installing the BlackBerry Administration Service
The BlackBerry® Administration Service permits you to manage a BlackBerry Domain through a web-based application. A
BlackBerry Domain consists of one BlackBerry Configuration Database and all BlackBerry® Enterprise Server instances that use
the BlackBerry Configuration Database.
You can install the BlackBerry Administration Service with other BlackBerry Enterprise Server components or by itself on a separate
computer. You can install the BlackBerry Administration Service on a separate computer to limit the impact that the BlackBerry
Administration Service might have on system resources and to prevent administrators in your organization from accessing any
part of the computer that hosts the BlackBerry Enterprise Server. If you install the BlackBerry Administration Service before you
install a BlackBerry Enterprise Server, the installation process can create and populate the BlackBerry Configuration Database.
6
Installation and Configuration Guide
Installing the BlackBerry Attachment Service
When you install the BlackBerry Administration Service, you can install the BlackBerry® Web Desktop Manager and select whether
you want administrators to use Windows® authentication or BlackBerry Administration Service authentication to log in to the
BlackBerry Administration Service. You must verify that all administrators have access to the BlackBerry Administration Service
web address (https://<computer_name>:<port>/webconsole/app).
Installing the BlackBerry Attachment Service
The BlackBerry® Attachment Service converts supported attachments into a format that users can view on their BlackBerry
devices. By default, the BlackBerry® Enterprise Server includes the BlackBerry Attachment Service.
The BlackBerry Attachment Service might use increased system resources when it processes numerous conversion requests
simultaneously. If you want to increase the number of conversion requests that can occur concurrently without impacting message
delivery, you can install a BlackBerry Attachment Service on a computer that is separate from the computer that hosts the
BlackBerry Enterprise Server.
You can connect multiple BlackBerry® Enterprise Server instances and BlackBerry MDS Connection Service instances to a
BlackBerry Attachment Service instance.
When you install the BlackBerry Attachment Service on a computer that is separate from the computer that hosts the BlackBerry
Enterprise Server, the installation process installs the BlackBerry Attachment Service and 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 so that users can start and manage instant messaging conversations on
their BlackBerry devices.
If you want to maximize the number of sockets available so that the BlackBerry Collaboration Service can respond to more requests
from the collaboration clients, you can install the BlackBerry Collaboration Service by itself on a computer that is separate from
the computer that hosts the BlackBerry® Enterprise Server.
If you install the BlackBerry Collaboration Service on a separate computer, the installation process installs the BlackBerry
Collaboration Service and BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry Collaboration Service and
restarts it if it stops responding.
You can connect multiple BlackBerry Enterprise Server instances to a BlackBerry Collaboration Service instance.
A different type of BlackBerry Collaboration Service exists for each instant messaging environment. For example, a BlackBerry
Collaboration Service exists for Microsoft® Office Communications Server 2007, and a different BlackBerry Collaboration Service
exists for IBM® Lotus® Sametime®. You can install only one type of BlackBerry Collaboration Service in your organization's
environment. Users can use only one type of collaboration client on their BlackBerry devices.
7
Installation and Configuration Guide
Installing the BlackBerry MDS Connection Service
Installing the BlackBerry MDS Connection Service
The BlackBerry® MDS Connection Service provides users with access to online content and applications on your organization's
intranet or the Internet. By default, the BlackBerry® Enterprise Server includes the BlackBerry MDS Connection Service.
The BlackBerry MDS Connection Service might use increased system resources when it processes content requests. If you want
to minimize the impact this has on message delivery, you can install the BlackBerry MDS Connection Service by itself on a
computer that is separate from the computer that hosts the BlackBerry Enterprise Server.
You can connect multiple BlackBerry® Enterprise Server instances to a BlackBerry MDS Connection Service instance.
When you install the BlackBerry MDS Connection Service on a separate computer, you must assign at least one BlackBerry
Enterprise Server instance to it during the installation process. The BlackBerry MDS Connection Service uses the BlackBerry
Enterprise Server information to connect to the BlackBerry Attachment Service.
When you install the BlackBerry MDS Connection Service on a separate computer, the installation process installs the BlackBerry
MDS Connection Service and 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 connects the BlackBerry MDS Runtime Application on BlackBerry devices to enterprise
applications.
The BlackBerry MDS Integration Service might use increased system resources when it processes content requests. If you want
to minimize the impact this has on message delivery, you can install the BlackBerry MDS Integration Service by itself on a computer
that is separate from the computer that hosts the BlackBerry Enterprise Server.
When you install the BlackBerry MDS Integration Service, you must select whether to create a BlackBerry MDS Integration Service
pool, or add the BlackBerry MDS Integration Service instance to an existing pool. The BlackBerry MDS Integration Service pool
permits multiple BlackBerry MDS Integration Service instances to balance the volume of traffic between them. For more
information on BlackBerry MDS Integration Service pools, see the BlackBerry Enterprise Server Planning Guide.
When you install the BlackBerry MDS Integration Service on a separate computer, the installation process installs the BlackBerry
MDS Integration Service and BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry MDS Integration Service
and restarts it if it stops responding.
The BlackBerry MDS Integration Service stores application data in the BlackBerry MDS Integration Service database. The setup
application installs the BlackBerry MDS Integration Service database on the same database server that hosts the BlackBerry
Configuration Database. You can install multiple BlackBerry MDS Integration Service instances that can use the same BlackBerry
MDS Integration Service database.
8
Installation and Configuration Guide
Installing the BlackBerry Monitoring Service
During the installation process, you create the administrator account and publisher account for the BlackBerry MDS Integration
Service. The BlackBerry MDS Integration Service uses the administrator account and publisher account when it publishes
applications.
Installing the BlackBerry Monitoring Service
The BlackBerry® Monitoring Service monitors BlackBerry® Enterprise Server component activity, and, if configured, sends
notification messages to administrators.
You can install only one BlackBerry Monitoring Service in your organization's environment. The BlackBerry Monitoring Service
stores its data in its own database. The BlackBerry Monitoring Service can monitor all BlackBerry Enterprise Server instances in
your organization's environment, but it does not monitor remote components.
You can install the BlackBerry Monitoring Service database on the same computer as the BlackBerry Monitoring Service, on the
same database server that hosts the BlackBerry Configuration Database, or on another database server. You can install the
BlackBerry Monitoring Service database on another database server if you do not want the BlackBerry Monitoring Service database
to be unavailable at the same time that the BlackBerry Configuration Database is unavailable, if your organization's system
resources are limited, or if you plan to run reports frequently.
Installing the BlackBerry Router
The BlackBerry® Router connects to the wireless network and sends data to and from BlackBerry devices.
You can install a BlackBerry Router with other BlackBerry® Enterprise Server components or by itself on a separate computer.
You can install the BlackBerry Router on a computer that is separate from the computer that hosts the BlackBerry Enterprise
Server if you want to install the BlackBerry Router in the DMZ, or to install standby BlackBerry Router instances as failover
components in case the primary BlackBerry Router is unavailable.
You can connect multiple BlackBerry Enterprise Server instances to a BlackBerry Router instance.
If you install the BlackBerry Router on a separate computer, the installation process installs the BlackBerry Router and BlackBerry
Controller. The BlackBerry Controller monitors the BlackBerry Router and restarts it if it stops responding.
9
Hardware requirements: BlackBerry Enterprise Server
Installation and Configuration Guide
Hardware requirements: BlackBerry Enterprise Server
3
The following are requirements for a BlackBerry® Enterprise Server and the BlackBerry Enterprise Server components that you
install on a single computer, and excludes the BlackBerry Collaboration Service and the BlackBerry MDS Integration Service. The
requirements are for a BlackBerry Enterprise Server environment that includes users that receive 100 to 200 email messages
each day.
You can improve the performance and reliability of the BlackBerry Enterprise Server by installing the BlackBerry Enterprise Server
components on multiple computers. If your BlackBerry Enterprise Server environment supports up to 1000 users, install the
BlackBerry Configuration Database on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server.
If your BlackBerry Enterprise Server environment supports up to 2000 users, install the BlackBerry Configuration Database and
the BlackBerry Administration Service on computers that are separate from the computer that hosts the BlackBerry Enterprise
Server.
Item
Requirement
BlackBerry Enterprise Server that
supports up to 200 users
•
•
•
Single processor, 2.0 GHz Intel® Xeon® (two processors recommended)
2 GB of memory
2 drives, RAID 1
BlackBerry Enterprise Server that
supports up to 500 users
•
•
•
Two processors, 2.0 GHz Intel Xeon
2 GB of memory
2 drives, RAID 1
BlackBerry Enterprise Server that
supports up to 1000 users
•
•
•
Two processors, 2.0 GHz Intel Xeon
3 GB of memory
2 drives, RAID 1
BlackBerry Enterprise Server that
supports up to 2000 users
•
Two processors, 2.8 GHz Intel Xeon or two processors, 1.86 GHz Intel Xeon
5100 Series (Dual Core)
4 GB of memory
2 drives, RAID 1 or 4 drives, RAID 1+0
•
•
10
System requirements
Installation and Configuration Guide
System requirements
4
For information about calculating hardware requirements, visit www.blackberry.com/go/serverdocs to see the BlackBerry
Enterprise Server Capacity Calculator and BlackBerry Enterprise Server Performance Benchmarking Guide.
System requirements: BlackBerry Enterprise Server
Item
Requirement
operating system
Any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
Microsoft® Exchange system tools
Any of the following system tools:
•
Microsoft Exchange 2003 SP2 System Manager
•
Microsoft Exchange Server MAPI client and CDO 1.2.1
Microsoft Exchange organization of the
system tools for the messaging server
CDO library
The same Microsoft Exchange organization that the messaging server uses
Unicode support for calendars
To support the latest Microsoft Exchange version in your organization's
environment, the latest version of the CDO library that applies to that version
To support Microsoft Exchange 2003, the following Microsoft hotfixes:
•
913643 on the messaging server
•
923537 on the computer that hosts the BlackBerry® Enterprise Server
Internet Service Manager
To support Microsoft Exchange 2007 when using Microsoft Exchange 2003 SP2
System Manager, the Internet Service Manager component of Microsoft® IIS
database conditions for the BlackBerry® A database server that hosts the BlackBerry Configuration Database
MDS Integration Service
static IP address for the computer
To install the BlackBerry MDS Integration Service or the BlackBerry Administration
Service in a pool, a static IP address for the computer
browser
Windows® Internet Explorer® version 6.0 or later with the following settings:
11
System requirements: BlackBerry Administration Service and BlackBerry Web Desktop Manager
Installation and Configuration Guide
Item
Requirement
•
•
media player
network proximity
monitoring
Java® or JavaScript® turned on
language preferences configured to display encoded web pages
To support audio attachments, Windows Media® Player version 9 or later
A high-speed, switched connection between the BlackBerry Enterprise Server and
messaging servers
To support the BlackBerry Monitoring Service, the SNMP service must be running
System requirements: BlackBerry Administration Service and BlackBerry
Web Desktop Manager
The following system requirements apply when you install the BlackBerry® Administration Service and BlackBerry® Web Desktop
Manager on a computer that is separate from the computer that hosts the BlackBerry® Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
memory
browser
A minimum of 1.2 GB of memory
Windows® Internet Explorer® version 6.0 or later with the following settings:
•
Java® or JavaScript® turned on
•
language preferences configured to display encoded web pages
System requirements: BlackBerry Enterprise Server databases
Item
Requirement
database management system
Any of the following database management systems:
12
System requirements: BlackBerry Enterprise Server databases
Installation and Configuration Guide
Item
Requirement
•
•
•
•
collation setting
MSDE 2000 SP4
Microsoft® SQL Server® 2000 SP3 or SP4
Microsoft SQL Server 2005 Standard, Enterprise, or Express
Microsoft SQL Server 2005 (64-bit)
For all versions of the Microsoft SQL Server earlier than Microsoft SQL Server 2005 SP3,
Microsoft Security Bulletin MS09-004 (for more information, visit http://
technet.microsoft.com to read article KB960082).
The following conditions on the database server:
•
collation set to default case-insensitive
•
BlackBerry® Configuration Database collation set to default case-insensitive
remote database conditions
database mirroring
Named pipes and TCP/IP network protocols turned on
To support database mirroring for the BlackBerry Configuration Database or BlackBerry
MDS Integration Service database, the following conditions:
•
the database server must be Microsoft SQL Server 2005 SP2 (32-bit or 64-bit)
•
the database server that hosts the mirror database must use the same version and
build as the principal database
•
a separate database server for the mirror database
•
static port with the same port number for both database servers
•
Microsoft SQL Server Browser running on both database servers
database transactional
replication
To support database transactional replication for the BlackBerry Configuration Database
or the BlackBerry MDS Integration Service database, the following conditions:
•
the database server must be Microsoft SQL Server 2000 SP3a or later
•
the database server that hosts the replicated database must use the same version
and build as the primary database
•
if your organization's database server is Microsoft SQL Server 2000 SP3a, the "FIX:
Distribution Agent Fails with 'Violation of Primary Key Constraint' Error Message"
hotfix installed. For more information about installing the hotfix, visit
www.support.microsoft.com to read article 813494.
13
System requirements: BlackBerry Attachment Service
Installation and Configuration Guide
System requirements: BlackBerry Attachment Service
The following system requirements apply when you install the BlackBerry® Attachment Service on a computer that is separate
from the computer that hosts the BlackBerry® Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
media player
browser
To support audio attachments, Windows Media® Player version 9 or later
Windows® Internet Explorer® version 6.0 or later with the following settings:
•
Java® or JavaScript® turned on
•
language preferences configured to display encoded web pages
System requirements: BlackBerry Collaboration Service
Item
Requirement
operating system
Any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
IBM® Lotus® Sametime®
IP address of the BlackBerry® Collaboration Service computer added to the
CommunityConnectivity document on the IBM Lotus Sametime server
SSL authentication turned on for the Novell GroupWise Messenger agents on the Novell
GroupWise Messenger server
Novell® GroupWise® Messenger
14
System requirements: BlackBerry MDS Connection Service
Installation and Configuration Guide
Item
Requirement
Microsoft® Office Live
Communications Server 2005 or
Microsoft® Office
Communications Server 2007
The latest Microsoft hotfixes installed.
System requirements: BlackBerry MDS Connection Service
The following system requirements apply when you install the BlackBerry® MDS Connection Service on a computer that is separate
from the computer that hosts the BlackBerry® Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
RSA® Authentication Agent
To support enhanced network authentication, RSA® Authentication Agent version
5.0 for Windows®
One of the following:
•
if you install a central push server and less than a thousand user accounts, a
minimum of 1024 MB
•
if you install a central push server and more than a thousand user accounts,
a minimum of 3 GB
•
if you do not install a central push server, a minimum of 512 MB
memory
System requirements: BlackBerry MDS Integration Service
The following system requirements apply when you install the BlackBerry® MDS Integration Service on a computer that is separate
from the computer that hosts the BlackBerry® Enterprise Server.
15
System requirements: BlackBerry Monitoring Service
Installation and Configuration Guide
Item
Requirement
operating system
Any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
database conditions
static IP address
A database server that also hosts the BlackBerry Configuration Database
To support the BlackBerry MDS Integration Service pool, a static IP address for the
computer
System requirements: BlackBerry Monitoring Service
The following system requirements apply when you install the BlackBerry® Monitoring Service on a computer that is separate
from the computer that hosts the BlackBerry® Enterprise Server.
Item
Requirement
operating system
Any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
SNMP
browser
The SNMP service running on the computer that hosts the BlackBerry Enterprise Server
Windows® Internet Explorer® version 6.0 or later with the following conditions:
•
support for JavaScript®
•
cookies turned on
wireless modem
To send SMS messages to BlackBerry devices, an SMS wireless modem connected to the
computer that accepts the AT command set
16
System requirements: BlackBerry Router
Installation and Configuration Guide
System requirements: BlackBerry Router
To install the BlackBerry® Router on a computer that is separate from the computer that hosts the BlackBerry® Enterprise
Server, any of the following operating systems:
•
Windows Server® 2003 SP1 or later
•
Windows Server 2003 R2
•
Windows Server 2003 (64-bit)
•
Windows Server 2003 R2 SP2 (64-bit)
•
Windows Server® 2008 or later
•
Windows Server 2008 (64-bit)
System requirements: Computers for BlackBerry Web Desktop Manager
users
Item
Requirement
operating system
Any of the following operating systems:
•
Windows® 2000 Professional SP4 or later
•
Windows® XP Professional SP2
•
Windows Vista™
browser
browser settings
Microsoft® Internet Explorer® version 6.0 or later
To support BlackBerry® Web Desktop Manager, the following conditions must be
met:
•
the BlackBerry Web Desktop Manager web address added as a trusted site or
local intranet site
•
the following settings turned on to support Microsoft® ActiveX®:
•
Automatic prompting for ActiveX controls
•
Download signed Microsoft ActiveX controls
•
Run ActiveX controls and plug-ins
•
Script ActiveX controls marked safe for scripting
•
•
•
support for JavaScript®
support for TLS or SSL
the SSL certificate installed to permit trusted connections with the BlackBerry
Administration Service
17
System requirements: Messaging server
Installation and Configuration Guide
Item
Requirement
•
if using Windows Vista or Windows Server® 2008, the BlackBerry
Administration Service web address added as a trusted site and Enable
protected mode cleared
System requirements: Messaging server
Any of the following messaging servers that is located in close proximity to where you want to install the primary BlackBerry®
Enterprise Server:
•
Microsoft® Exchange 2003 or later
•
Microsoft Exchange 2007 or later
•
Microsoft Exchange mixed environment (Microsoft Exchange 2003 and 2007)
System requirements: Firewall
To install the BlackBerry® Enterprise Server, a firewall or proxy firewall with the following conditions:
•
exclusive use of port 3101 to open and maintain an outgoing, two-way TCP/IP connection to an external server
•
support for the resolution of Internet addresses that use DNS
•
for proxy firewalls, transparency of the proxy server
System requirements: Instant messaging server
To install the BlackBerry® Enterprise Server, any of the following instant messaging servers:
•
IBM® Lotus® Sametime® version 6.5.1 Community Server
•
IBM Lotus Sametime version 7.0 Community Server
•
IBM Lotus Sametime version 7.5 Community Server
•
IBM Lotus Sametime version 8.0 Community Server
•
Microsoft® Office Live Communications Server 2005 SP1 Standard or Enterprise
•
Microsoft® Office Communications Server 2007 Standard or Enterprise
•
Novell® GroupWise® Messenger version 2.0 or later
18
Supported features and environments
Installation and Configuration Guide
Supported features and environments
Item
Description
virtual environment
The BlackBerry® Enterprise Server and BlackBerry Enterprise Server components
support the following virtual environments:
•
VMware® ESX Server version 2.5.2 or later
•
VMware ESX Server version 3.0.0, 3.0.1, 3.0.2, or 3.5
enhanced network authentication
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components
support RSA® Authentication Agent version 5.0 for Windows®.
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components
support the SNMP service.
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components
support remote access by administrators who use Remote Desktop Connection.
SNMP monitoring
remote access
Unsupported environments
Item
Description
DMZ
The BlackBerry® Enterprise Server and BlackBerry Enterprise Server components,
with the exception of the BlackBerry Router, do not support installation in a DMZ.
messaging server
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components do
not support installation on the same computer as the messaging server.
email application
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components do
not support the installation of email applications on the same computer.
instant messaging server
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components do
not support more than one type of instant messaging server in the BlackBerry
Domain. For example, you cannot install the BlackBerry Collaboration Service for
use with Microsoft® Office Communications Server 2007 and the BlackBerry
Collaboration Service for IBM® Lotus® Sametime® in the same BlackBerry Domain.
BlackBerry database notification system The BlackBerry database notification system does not support installation on a
computer that runs Windows Server® 2008.
19
Installation and Configuration Guide
Preinstallation tasks
Preinstallation tasks
5
Configuring a Microsoft Exchange 2007 messaging environment
Create a Microsoft Exchange 2007 account and mailbox
Before you begin:
•
You must configure Microsoft® Exchange 2007 to support versions of Microsoft® Outlook® earlier than 2007 by creating
the public folder database. For more information about supporting earlier versions of Microsoft Outlook, visit http://
support.microsoft.com to read article 555851 and visit http://technet.microsoft.com to read articles 123694, 124270,
397221, and 691120.
•
You must be an administrator with permission to create accounts.
1.
2.
3.
4.
On the computer that hosts Microsoft Exchange, log in using an administrator account that has the correct permission to
create accounts.
Open the Microsoft Exchange Management Console.
Create a Microsoft Exchange account that you name BESAdmin.
To allow the BlackBerry Enterprise Server to check if a user has permissions to a public folder, assign this account the Owner
permission to all public folders.
After you finish:
•
Verify that users have Read and Visible permissions to public folders.
•
To permit checks for meeting invitee availability for BlackBerry® Device Software version 4.5 or later, configure the Schedule
+ free and busy information for the system public folder. For more information, visit http://technet.microsoft.com to read
articles 629523 and 691129.
Configure Local Security Policy permissions for the Microsoft Exchange 2007 account
On each computer that you want to install the BlackBerry® Enterprise Server on, you must configure the Local Security Policy
permissions for the Microsoft® Exchange account that you want to use to complete the installation process and run the services
for the BlackBerry Enterprise Server.
Without the correct permissions, the BlackBerry Enterprise Server cannot run.
1.
2.
3.
4.
20
Right-click My Computer. Click Manage.
In the left pane, expand Local Users and Groups.
Navigate to the Groups folder.
In the right pane, double-click Administrators.
Installation and Configuration Guide
5.
6.
7.
8.
9.
Configuring a Microsoft Exchange 2007 messaging environment
Click Add.
In the Enter the object names to select field, type the account name that you want the services for the BlackBerry Enterprise
Server to use (for example, BESAdmin).
Click OK.
Click Apply.
Click OK.
Configure Microsoft Exchange 2007 permissions for the Microsoft Exchange account
1.
2.
On a computer that hosts the Microsoft® Exchange Management Shell, open the Microsoft Exchange Management Shell.
Perform one of the following actions:
• If you want to execute the command on the Microsoft Exchange 2007 server, type add-exchangeadministrator
"BESAdmin" –role ViewOnlyAdmin.
• If you want to execute the command from another computer, type get-mailboxserver "<messaging_server_name>"
| add-exchangeadministrator "BESAdmin" –role ViewOnlyAdmin.
3.
Type the following command: get-mailboxserver "<messaging_server_name>" | add-adpermission –user "BESAdmin"
–accessrights ExtendedRight –extendedrights Send-As, Receive-As, ms-Exch-Store-Admin.
Enable BlackBerry device users to send email messages in a Microsoft Exchange 2007
environment
1.
On any computer in the Windows® domain, on the taskbar, click Start > Administrative Tools > Active Directory Users
and Computers.
2. On the View menu, click Advanced Features.
3. Right-click the domain root. Click Properties.
4. On the Security tab, click Advanced.
5. Click Add.
6. Type the name of the Microsoft® Exchange account that you created (for example, BESAdmin).
7. Click Check Names.
8. Click OK.
9. In the Apply drop-down list, click User Objects.
10. In the Allow column, select the Send As check box.
11. Click Apply.
12. Click OK.
21
Installation and Configuration Guide
Configuring a Microsoft Exchange 2003 messaging environment
Configuring a Microsoft Exchange 2003 messaging environment
Create a Windows account and mailbox
You must create and configure a Windows® account and mailbox in Microsoft® Active Directory® for the BlackBerry® Enterprise
Server so that the account can authenticate to the Microsoft® Exchange messaging server.
1. On any computer within the Windows domain, on the taskbar, click Start > Programs > Microsoft Exchange > Active
Directory Users and Computers.
2. Create an account that has following attributes:
• Name: BESAdmin
• Group membership: Domain User
3.
4.
5.
Create a Microsoft Exchange mailbox for the account.
Assign the account the Send As permission for all user accounts in the User container of the Microsoft Active Directory
domain.
To activate the new mailbox, send a test email message.
After you finish:
You might not be able to see the Windows account in the Microsoft Active Directory to verify that you created it. To verify that
you created the Windows account, log in to a computer using the Windows account.
For more information about the Send As permission and BlackBerry Enterprise Server, visit www.blackberry.com to read KB04707.
For more information about assigning the Send As permission to multiple user accounts, visit www.support.microsoft.com to read
article 912918.
Configure permissions for the Windows account
On each computer that you want to install the BlackBerry® Enterprise Server components on, you must configure the permissions
for the Windows® account that you want to use to install the BlackBerry Enterprise Server components.
1. On the taskbar, click Start > Programs > Administrative Tools > Local Security Policy.
2. Configure the following permissions for the Windows account:
• log on locally with local permissions (if not assigned by default)
• log on as a service
3.
4.
22
On the taskbar, click Start > Programs > Administrative Tools > Computer Management.
Add the Windows account to the local administrators group.
Installation and Configuration Guide
Configuring a Microsoft Exchange 2003 messaging environment
Configure Microsoft Exchange 2003 permissions for the Windows account
On each computer that you want to install the BlackBerry® Enterprise Server or BlackBerry Administration Service on, you must
configure the Microsoft® Exchange permissions of the Windows® account that you want to use to complete the installation
process.
Without the correct permissions, the BlackBerry Enterprise Server cannot run after you complete the installation process.
1.
2.
3.
Using Microsoft Exchange 2003 System Manager, configure the Exchange View Only Administrator permission with the
minimum access level of Administrative Groups.
At the server level, configure the following permissions:
• Send As
• Receive As
• Administer Information Store
To permit the BlackBerry Enterprise Server to check if users have permissions to access a public folder, assign the Owner
permission on all public folders to the account.
After you finish: Verify that the users have Read and Visible permissions to public folders.
Resolve the Microsoft Exchange known issues for wireless calendar synchronization
Some known issues for Microsoft® Exchange impact how the BlackBerry® Enterprise Server synchronizes calendars over the
wireless network. To resolve the known issues, you can read about the Microsoft Exchange known issues that might impact your
organization's messaging environment and install the hotfixes for them. If your organization's messaging environment includes
multiple messaging servers, you can resolve the known issues that apply to the latest Microsoft Exchange software version in
your organization's environment.
If you do not install the correct hotfixes, the BlackBerry Enterprise Server cannot run.
1.
2.
3.
4.
Visit http://support.microsoft.com to read articles 823343 and 894470.
Verify that your organization's environment meets the requirements described in the applicable known issues.
Download the hotfixes for the known issues on the computers that you want to install the BlackBerry Enterprise Server or
BlackBerry Administration Service on.
Install the hotfixes.
23
Installation and Configuration Guide
Verify if the Windows account can access a user account in Microsoft Exchange
Verify if the Windows account can access a user account in Microsoft
Exchange
The BlackBerry® Enterprise Server uses the Windows® account to run its services. The IEMSText.exe tool runs a test on Microsoft®
Active Directory® to verify whether the Windows account has Send As permission to the mailbox of a BlackBerry device user in
Microsoft® Exchange. The BlackBerry Enterprise Server requires permission to access the user's mailbox and process messages.
1. On the computer that you want to install the BlackBerry Enterprise Server, open a command prompt window.
2. Type "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Utility\IEMSTest.exe".
3. In the Profile Name drop-down list, select the profile names for the user accounts.
4. Click OK.
5. In the left pane, select the user accounts that you want to check.
6. Click Select.
7. Click OK.
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.
24
Installation and Configuration Guide
Configuring connections for the BlackBerry Enterprise Server databases
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 same computer as the BlackBerry Enterprise Server
and require the setup application to install Microsoft® SQL Server® Express during the installation process, you do not
need 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 same computer as 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, also assign the system administrator permission to the Windows account.
• If you create the BlackBerry Enterprise Server databases on another computer, assign the database creator permission
to the Windows account that you want to 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.
25
Configuring connections for the BlackBerry Enterprise Server databases
Installation and Configuration Guide
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
DATABASE_NAME
CMD
This property specifies the name of the BlackBerry® Configuration Database.
This property specifies the type of action that the CreateDB executable must
complete (for example, whether to install or upgrade the BlackBerry Configuration
Database).
If you use database authentication, this property specifies the user name of the
database account that has server administrator permission and database creator
permission.
If you use database authentication, this property specifies the password for the
database account.
This property specifies the path to the DBInstallScripts folder.
USERID
PASSWORD
SCRIPT_ROOT
26
Configuring the LDAP information for the BlackBerry Administration Service
Installation and Configuration Guide
Property
Description
LOG_DIR
By default, this folder is in the same root folder that the CreateDB.exe file is located
in.
This property specifies the path to the folder that you want to create log files in.
DBMS
DB_FILE_DIR
BACKUP_DIR
By default, this folder is in the same root folder that the CreateDB.exe file is located
in.
This property specifies the database management system that your organization
uses.
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.
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.
Configuring the LDAP information for the BlackBerry Administration Service
The BlackBerry® Administration Service requires access to the LDAP server so that the BlackBerry Administration Service can
read user information in Microsoft® Active Directory® when it authenticates the BlackBerry® Web Desktop Manager users. To
access the LDAP server, the BlackBerry Administration Service requires the URL of the LDAP server, the search base to find where
the user accounts are stored, and the administrator's LDAP credentials.
During the installation process and upgrade process, the setup application populates the LDAP information automatically. You
must verify this information to ensure that it reflects the requirements of the BlackBerry Administration Service.
Configure permissions for the administrator account on the LDAP server that the BlackBerry
Administration Service uses
To authenticate a user account, you must configure permissions for an adminstrator account on the LDAP server so that the
BlackBerry® Administration Service can read LDAP attributes in the Microsoft® Active Directory®.
Before you begin: Create an administrator account for the BlackBerry Administration Service.
1.
In Microsoft Active Directory, in the search base container and all subcontainers that user accounts are located in, add the
following permissions to the administrator account:
27
Installation and Configuration Guide
Configuring the LDAP information for the BlackBerry Administration Service
• for containers, the List Contents permission
• for user objects, the Read All Properties permission
2.
Configure the administrator account so that the account has the correct permission to read the attributes of the crossRef
objects that represent domains in the Partitions container of the Microsoft Active Directory configuration partition.
Find the LDAP information that the BlackBerry Administration Service requires
You can use the ldp support tool to access the domain controller in your organization's environment and locate the LDAP
information before you install the BlackBerry® Administration Service.
Before you begin:
•
Verify that you have a domain administrator account.
•
Download and install the Windows® support tools. For more information about installing the support tools, visit
www.microsoft.com to read articles 892777 and 301423.
1.
2.
3.
4.
5.
6.
On the Start menu, click Run.
Type ldp.
Click OK.
On the Connection menu, click Connect.
Connect to the domain controller.
To set the LDAP search base to the BaseDN and permit the BlackBerry Administration Service to search the entire directory
tree for user accounts, perform the following actions:
a. In the ldp window, on the View menu, click Tree.
b. In the drop-down list, select the first option.
c. Copy the BaseDN to a text file (for example, DC=yourDepartment,DC=yourCompany,DC=net).
7.
To permit the BlackBerry Administration Service to access only the part of the directory tree that includes present and
prospective BlackBerry device users, specify a specific area in the directory tree as the LDAP search base (for example,
OU=Users,DC=yourDepartment,DC=yourCompany,DC=net).
To locate the administrator account information, in the Microsoft® Active Directory® Users and Computers console, find
the user logon name for the administrator account. If you use Windows Server® 2003, verify that the administrator account
has a password.
Transfer the text file to the computer that you want to install the BlackBerry Administration Service on.
8.
9.
28
Installation and Configuration Guide
Install the SNMP service for monitoring by the BlackBerry Monitoring Service
Configure the BlackBerry Administration Service to authenticate user accounts from multiple
Microsoft Active Directory domains
During the installation process, the setup application prompts you to specify the LDAP server URL, search base, and the credentials
for an LDAP administrator so that the BlackBerry® Administration Service can access the LDAP server and authenticate user
accounts.
If the user accounts in your organization's environment are stored in more than one domain in a Microsoft® Active Directory®
forest, you must configure the LDAP settings that the BlackBerry Administration Service uses so that the BlackBerry Administration
Service can search the global catalog.
1.
2.
3.
During the installation process, specify the DNS host name of a global catalog server as the LDAP server name that is
included in the LDAP server URL.
Specify the LDAP port number to be 3268.
Specify the LDAP user name and password to be the user name and password of an administrator account that has permission
to read user attributes from the global catalog.
Install the SNMP service for monitoring by the BlackBerry Monitoring Service
To permit the BlackBerry® Monitoring Service to monitor the BlackBerry® Enterprise Server activity, you must install the SNMP
service on the computer that you want to install the BlackBerry Enterprise Server on.
Before you begin: Verify that the computer has access to the Windows® installation media.
1.
2.
3.
4.
5.
6.
7.
On the taskbar, click Start > Settings > Control Panel > Add/Remove Programs > Add/Remove Windows Components.
Double-click Management and Monitoring Tools.
Select the Simple Network Management Protocol check box.
Click OK.
When prompted, install the files from the Windows installation media.
Complete the installation wizard.
In the Windows Services, verify that the SNMP service is running.
After you finish: To complete the SNMP service installation process, after you install the BlackBerry Enterprise Server or
BlackBerry Enterprise Server components, configure the SNMP service to monitor the activity of the BlackBerry Enterprise Server
or BlackBerry Enterprise Server components.
29
Installation and Configuration GuideCreating a BlackBerry Administration Service pool using DNS round robin that includes the BlackBerry Web Desktop Manager
Creating a BlackBerry Administration Service pool using DNS round robin
that includes the BlackBerry Web Desktop Manager
When you install a BlackBerry® Administration Service, you install the BlackBerry Administration Service services automatically,
and you can choose to install the BlackBerry Administration Service console, BlackBerry® Web Desktop Manager, or both. The
BlackBerry Administration Service console and BlackBerry Web Desktop Manager require the BlackBerry Administration Service
services so that they can run.
If you create a BlackBerry Administration Service pool using DNS round robin, you can install the BlackBerry Administration
Service console and BlackBerry Web Desktop Manager on each computer in the pool, or you can install the BlackBerry
Administration Service console or BlackBerry Web Desktop Manager on some of the computers in the pool. If you install the
BlackBerry Administration Service console and BlackBerry Web Desktop Manager on each computer in the pool, you can use the
pool name that you specified during the installation process in the URLs for the BlackBerry Administration Service console and
BlackBerry Web Desktop Manager (for example, https://<pool_name>/webconsole/login or https://<pool_name>/webdesktop/
login).
If you do not install both components on each computer in the pool, and you try to access one of the URLs using the pool name,
the web browser might display an HTTP 404 error message if it tries to connect to a computer in the pool that you did not install
the component on that you are trying to access. For example, you can install the BlackBerry Administration Service console on
two of the computers in the pool, and the BlackBerry Web Desktop Manager on two different computers in the pool, and the
HTTP 404 error message might occur when you use the pool name in the URLs.
To make sure that the web browser does not display HTTP 404 error messages, you can choose one of the following options:
•
You can create separate pools within the BlackBerry Administration Service pool for the BlackBerry Administration Service
console and the BlackBerry Web Desktop Manager. These pools contain a subset of the BlackBerry Administration Service
instances that exist in the BlackBerry Administration Service pool. You can provide your organization's administrators and
users with URLs that include the specific pool names.
•
You can provide administrators and users in your organization's environment with URLs that include the FQDNs of the
computers that you installed the BlackBerry Administration Service console or BlackBerry Web Desktop Manager on (for
example, https://<FQDN_of_computer>/webconsole/login or https://<FQDN_of_computer>/webdesktop/login).
Creating a BlackBerry MDS Integration Service pool
You can create a BlackBerry® MDS Integration Service pool using the setup application during the installation processes for the
BlackBerry MDS Integration Service instances that you want to include in the pool. During the installation process for the first
BlackBerry MDS Integration Service instance, you must type a unique FQDN or DNS name that identifies the pool. During the
installation processes for the subsequent BlackBerry MDS Integration Service instances, you must select the existing pool name
from the list so that you can add the instances to the pool. After you complete the installation processes, BlackBerry MDS
Integration Service clients can access the BlackBerry MDS Integration Service instances in the pool using the unique DNS name.
30
Installation and Configuration Guide Create the DNS record for a BlackBerry Administration Service instance or BlackBerry MDS Integration Service instance
Create the DNS record for a BlackBerry Administration Service instance or
BlackBerry MDS Integration Service instance
To configure multiple BlackBerry® Administration Service instances or BlackBerry MDS Integration Service instances for high
availability using DNS round robin, you must create a DNS record. The DNS record permits the clients of the BlackBerry
Administration Service pool or BlackBerry MDS Integration Service pool to access the instances using a single DNS name. You
must create the DNS record in the same domain as the computers that host the BlackBerry Administration Service instances or
BlackBerry MDS Integration Service instances.
Before you begin:
•
You must configure a static IP address for each computer that you want to install a BlackBerry MDS Integration Service
instance or BlackBerry Administration Service instance on.
•
You must have permission to manage the DNS.
•
If you configure DNS round robin, you must configure clients to resolve the DNS name into a list of IP addresses and
distribute traffic equally across the BlackBerry Administration Service or BlackBerry MDS Integration Service instances in
the pool.
1.
2.
3.
4.
Log in to the DNS server.
In the DNS management console, access the forward lookup zone that you want to add the BlackBerry Administration
Service instance or BlackBerry MDS Integration Service instance to.
To create a new host, type the following information:
•
In the Name field, type the name of the BlackBerry Administration Service pool or BlackBerry MDS Integration Service
pool that you want to use.
•
In the IP Address1 field, type the IP address of the computer that you want to host a BlackBerry Administration Service
instance or BlackBerry MDS Integration Service instance on.
•
Select the Create associated pointer (PTR) record check box.
Repeat step 3 for each BlackBerry Administration Service instance or BlackBerry MDS Integration Service instance that you
want to install. When you add entries to the same pool, you must use the same pool name for all BlackBerry Administration
Service instances or BlackBerry MDS Integration Service instances.
After you finish: To remove a BlackBerry Administration Service instance or BlackBerry MDS Integration Service instance from
a pool, delete the entry for the IP address of the BlackBerry Administration Service instance or BlackBerry MDS Integration Service
instance from the DNS server.
31
Installation and Configuration Guide
Configuring the setup application to use a non-default static port number for the database server
Configuring the setup application to use a non-default static port number
for the database server
If the Microsoft® SQL Server® in your organization's environment does not use the default static port number (port 1433), the
BlackBerry® Enterprise Server setup application cannot connect to the database server. Before you run the setup application,
you must create an alias to the database server that specifies the port number that the database server is using. To configure an
alias, you can use Microsoft SQL Server Configuration Manager or the cliconfg.exe tool. You can configure the name of the alias
so that it is the same name as the Microsoft SQL Server. You must use the cliconfg.exe tool if the database server is Microsoft
SQL Server 2000.
Create an alias to the database server using the Microsoft SQL Server Configuration Manager
Before you begin: Verify that you installed the client components of the Microsoft® SQL Server® on the computer.
1.
2.
3.
4.
5.
6.
7.
8.
On the computer that you want to install a BlackBerry® Enterprise Server on, click Start > All Programs > Microsoft SQL
Server 2005 > Configuration Tools > SQL Server Configuration Manager.
Expand SQL Native Client Configuration.
Right-click Aliases. Click New Alias.
In the Alias Name field, type the database server name.
In the Port No field, type the static port number.
In the Protocol drop-down list, click TCP/IP.
In the Server field, type the database server name.
Click OK.
Create an alias to the database server using the cliconfg.exe tool
1.
2.
3.
4.
5.
6.
7.
8.
9.
32
On the computer that you want to install a BlackBerry® Enterprise Server on, click Start > Run.
Type cliconfg.exe.
Click OK.
On the Alias tab, click Add.
In the Server alias field, type the database server name.
In Network libraries, select TCP/IP.
In the Connection Parameters, Server name field, type the database server name.
Clear the Dynamically determine port check box.
In the Port number field, type the port number.
Persistent socket connections for the BlackBerry Collaboration Service
Installation and Configuration Guide
10. Click OK.
Persistent socket connections for the BlackBerry Collaboration Service
Instant messaging environment
BlackBerry Collaboration Service requirements
Microsoft® Office Live Communications Server 2005 or
Microsoft® Office Communications Server 2007, and TLS
communication protocol
Microsoft Office Live Communications Server 2005 or
Microsoft Office Communications Server 2007, and TCP
communication protocol
Microsoft Office Live Communications Server 2005 or
Microsoft Office Communications Server 2007, and HTTPS
communication protocol
IBM® Lotus® Sametime®
one persistent socket connection for each instant messaging
session
Novell® GroupWise® Messenger
three persistent socket connections for each instant
messaging session
one persistent socket connection and multiple sequential
socket connections for each instant messaging session
three persistent socket connections to create one TCP
connection; all instant messaging sessions use that TCP
connection
one persistent socket connection for each instant messaging
session
Applications that are installed with the BlackBerry Enterprise Server
components
The BlackBerry® Enterprise Server installation process can include the installation of third-party applications.
Application
BlackBerry Enterprise Server components that the application is
installed with
JDK with JRE™ version 1.5.15
•
•
•
BlackBerry Administration Service
BlackBerry MDS Integration Service
BlackBerry Monitoring Service
JDK with JRE version 1.6.05
•
•
BlackBerry Collaboration Service
BlackBerry MDS Connection Service
33
Applications that are installed with the BlackBerry Enterprise Server components
Installation and Configuration Guide
Application
BlackBerry Enterprise Server components that the application is
installed with
Microsoft® XML Parser version 6.0.1
Microsoft® SQL Server® Express 2005 (if
selected)
all components except the BlackBerry Router
•
•
•
•
BlackBerry Administration Service
BlackBerry Enterprise Server
BlackBerry MDS Integration Service
BlackBerry Monitoring Service
Microsoft® .NET Framework version 2.0
•
•
•
•
BlackBerry Administration Service
BlackBerry Enterprise Server
BlackBerry MDS Integration Service
BlackBerry Monitoring Service
(if you are installing Microsoft SQL Server
Express)
34
Installation and Configuration Guide
Installing the BlackBerry Enterprise Server software
Installing the BlackBerry Enterprise Server software
6
Prerequisites: Installing the BlackBerry Enterprise Server software
•
•
•
•
•
•
Verify that the Windows® account that you want to use to install the BlackBerry® Enterprise Server software is assigned
the required permissions to complete the installation process.
In a Microsoft® Exchange 2003 environment, to start the MAPI subsystem, open the Microsoft Exchange System Manager.
Obtain the following information:
•
BlackBerry® Client Access License key
•
SRP host
•
SRP identifier
•
SRP key
•
computer name and port number of the instant messaging server (use the virtual server name and port number where
the AJAX Service is installed, if applicable)
•
computer name and port number of the proxy server (if applicable)
Add the blackberry.net domain to the permitted lists in the antivirus and anti-spam applications that the messaging server
or gateway uses.
Verify that the computer has access to www.blackberry.com (optional).
If your organization uses a proxy server for Internet access, obtain the credentials for the proxy server.
Install the BlackBerry Enterprise Server software
During the installation process, you must restart the computer.
Note: To administer the BlackBerry® Enterprise Server, you must install the BlackBerry® Administration Service. You can install
the BlackBerry Administration Service on the same computer as the BlackBerry Enterprise Server or on a separate computer. The
first BlackBerry Administration Service or BlackBerry Enterprise Server that you install creates and populates the BlackBerry
Configuration Database, if you did not create the BlackBerry Configuration Database previously using the SQL scripts.
1. Log in to the computer using the Windows® account that you created and that has the proper permissions. This account
will run the services for the BlackBerry Enterprise Server.
2. On the BlackBerry Enterprise Server installation media, double-click setup.exe.
3. In the Setup type dialog box, select one of the following options:
• If this installation process is the first installation of BlackBerry Enterprise Server software in a BlackBerry Domain, select
I would like the installation process to create a BlackBerry Configuration Database.
• For all other installations of the BlackBerry Enterprise Server software, select I would like the installation process to
use an existing BlackBerry Configuration Database .
4.
In the Setup options dialog box, consider the following information:
• You can select or remove BlackBerry Enterprise Server components from the Additional Components list.
35
Installation and Configuration Guide
Install the BlackBerry Enterprise Server software
• To install the BlackBerry Administration Service only during the first installation, click Remote component. In the
Additional components list, expand BlackBerry administration. Click BlackBerry Adminstration Service.
• To permit administrators to log in to the BlackBerry Administration Service and BlackBerry Monitoring Service using
their Microsoft® Active Directory® credentials, in the BlackBerry administration list, click Use Active Directory
authentication.
5.
6.
7.
8.
9.
In the Accounts and Folders dialog box, in the Name field, type the name of the BlackBerry Enterprise Server that you
want the BlackBerry Administration Service to display.
When the setup application prompts you to restart the computer, click Yes.
Log in to the computer using the same account that you used in step 1.
In the Advanced database options dialog box, consider the following information:
• If you want to configure database mirroring, you can select Add support for database mirroring and type the name of
the database server that hosts the mirror database in the Name of the mirror database server field. The setup
application does not create the BlackBerry Configuration Database on the mirror Microsoft® SQL Server®; it adds a
registry key to the computer that includes the name of the mirror Microsoft SQL Server.
• If you configured the database server to use static ports, you must clear the Use dynamic ports check box. If the static
port number is not 1433, type the port number in the Port field.
In the Application extensibility information dialog box, consider the following information:
• You can type a FQDN to create a new BlackBerry MDS Integration Service pool, or add the BlackBerry MDS Integration
Service instance to a pool that you created during a previous installation process.
• To configure a hardware load-balancer for the BlackBerry MDS Integration Service pool, you can type a FQDN that
corresponds to an DNS record in the DNS server that maps the FQDN into the IP address of the virtual server that you
configured on the hardware load-balancer.
• The setup application creates the BlackBerry MDS Integration Service database on the database server that hosts the
BlackBerry Configuration Database.
• If you add the BlackBerry MDS Integration Service instance to an existing pool, the setup application selects the existing
BlackBerry MDS Integration Service database and existing administrator account and publisher account.
10. In the Administration settings dialog box, consider the following information:
• You must type a valid FQDN in the Pool name field. The setup application uses the FQDN to create the BlackBerry
Administration Service web address.
• You must type the password for the SSL certificate that the BlackBerry Administration Service uses for authentication
with browsers.
11.
36
In the LDAP settings dialog box, consider the following information:
• You can type the URL of the LDAP server that hosts the BlackBerry device users using the following format: ldap://
<computer_name>:<port>; where <computer_name> is the DNS name of the LDAP server, and <port> is the port number
that the LDAP server listens for connections on (by default, port 389).
• You can type the distinguished name of the search base URL for the area of the directory tree that contains the BlackBerry
device users.
Installation and Configuration Guide
Install a BlackBerry Enterprise Server component on a separate computer
• You can type the name and password for the administrator account that has permissions to log in to and search the
LDAP server. You can type the name for the administrator account as the login name, also known as the security account
manager name (for example, besadmin).
12. Start the services for the BlackBerry Enterprise Server. If you installed the BlackBerry Administration Service, the setup
application waits until the BlackBerry Administration Service services are running before the setup application continues.
13. In the Console addresses dialog box, copy the web addresses for the BlackBerry Enterprise Server components. You can
use the web addresses to log in to the BlackBerry Enterprise Server components that you installed.
After you finish:
•
If required, add the name of the BlackBerry MDS Integration Service pool to the DNS server and change the name of the
computer.
•
To verify that the BlackBerry Configuration Database on a Microsoft SQL Server uses the appropriate collation setting, check
that the collation setting for the BlackBerry Configuration Database is default case-insensitive.
•
If you reinstalled the BlackBerry Administration Service, in Microsoft® Internet Explorer®, delete the cache.
•
If the setup application installed Microsoft SQL Server Express 2003, install the hotfix for Microsoft Security Bulletin
MS09-004 (for more information, visit www.technet.microsoft.com to read article KB960082).
Specifying a name for the BlackBerry Administration Service pool during the installation
process
During the installation process, the setup application prompts you to specify the name of the BlackBerry® Administration
Service pool.
The BlackBerry Administration Service instances use the pool name for interprocess communication and when you configure
BlackBerry Administration Service high availability using DNS round robin. You must specify a valid DNS host name during the
installation process, even if you do not configure BlackBerry Administration Service high availability using DNS round robin.
The setup application uses the FQDN of the computer that you install the first BlackBerry Administration Service instance on as
the default value for the pool name. If you keep the default value and configure BlackBerry Administration Service high availability
using DNS round robin at a later time, you must use the BlackBerry Configuration Panel to change the pool name to the host
name for the pool.
The name for the BlackBerry Administration Service pool does not impact BlackBerry Administration Service high availability
that uses a hardware load balancer.
For more information about BlackBerry Administration Service high availability, see the BlackBerry Enterprise Server Planning
Guide.
Install a BlackBerry Enterprise Server component on a separate computer
Before you begin:
37
Installation and Configuration Guide
Install a BlackBerry Enterprise Server component on a separate computer
•
•
Install a BlackBerry® Enterprise Server and the BlackBerry Administration Service in your organization's environment.
Verify that the BlackBerry Administration Service is running on an account that has permissions to access and modify the
Windows® registry on the computer that you want to install the BlackBerry Enterprise Server component.
1.
Using the Windows® account that you created, log in to the computer. This account runs the services for the BlackBerry
Enterprise Server components.
On the BlackBerry Enterprise Server installation media, double-click setup.exe.
In the Setup type dialog box, select I would like the installation process to use an existing BlackBerry Configuration
Database.
In the Database information dialog box, type the names of the database server and BlackBerry Configuration Database
that the BlackBerry Enterprise Server uses.
In the Advanced database options dialog box, consider the following information:
• If you want to configure database mirroring, you can select Add support for database mirroring and type the name of
the database server that hosts the mirror database in the Name of the mirror database server field. The setup
application does not create the BlackBerry Configuration Database on the mirror Microsoft® SQL Server®; it adds a
registry key to the computer that includes the name of the mirror Microsoft SQL Server.
• If you configured the database server to use static ports, you must clear the Use dynamic ports check box. If the static
port number is not 1433, type the port number in the Port field.
2.
3.
4.
5.
6.
In the Setup options dialog box, consider the following information:
• You can select or remove BlackBerry Enterprise Server components from the Additional Components list.
• To permit administrators to log in to the BlackBerry Administration Service and BlackBerry Monitoring Service using
their Microsoft® Active Directory® credentials, in the BlackBerry administration list, click Use Active Directory
authentication.
7.
8.
9.
When the setup application prompts you to restart the computer, click Yes.
Log in to the computer using the same account that you used in step 1.
In the Application extensibility information dialog box, consider the following information:
• You can type a valid FQDN or IP address to create a new BlackBerry MDS Integration Service pool, or add the BlackBerry
MDS Integration Service instance to a pool that you created during a previous installation process.
• The setup application creates the BlackBerry MDS Integration Service database on the database server that hosts the
BlackBerry Configuration Database.
• If you add the BlackBerry MDS Integration Service instance to an existing pool, the setup application selects the existing
BlackBerry MDS Integration Service database and the existing administrator account and publisher account.
10. In the Administration settings dialog box, consider the following information:
• You must type a valid FQDN or IP address in the Pool name field. The setup application uses the FQDN or IP address
to create the BlackBerry Administration Service web address.
• You must type the password for the SSL certificate that the BlackBerry Administration Service uses for authentication
with browsers.
38
Installation and Configuration Guide
11.
Install the BlackBerry Monitoring Service software
In the LDAP Settings dialog box, consider the following information:
• You can type the URL of the LDAP server that hosts the BlackBerry device users using the following format: ldap://
<computer_name>:<port>; where <computer_name> is the DNS name of the LDAP server, and <port> is the port number
that the LDAP server listens for connections on (by default , port 389).
• You can type the distinguished name of the search base URL for the area of the directory tree that contains the BlackBerry
device users.
• You can type the name and password for the administrator account that has permissions to log in to and search the
LDAP server. You can type the name for the administrator account as the login name, also known as the security account
manager name (for example, besadmin).
12. Start the services for the BlackBerry Enterprise Server components.
13. In the Console addresses dialog box, copy the web addresses for the BlackBerry Enterprise Server components. You can
use the web addresses to log in to the BlackBerry Enterprise Server components.
After you finish:
•
If required, add the name of the BlackBerry MDS Integration Service pool to the DNS server, and change the name of the
computer.
•
To view the BlackBerry Enterprise Server component in the BlackBerry Administration Service, restart the BlackBerry
Administration Service.
•
If you reinstalled the BlackBerry Administration Service, in Microsoft® Internet Explorer®, delete the cache.
Install the BlackBerry Monitoring Service software
You can install the BlackBerry® Monitoring Service so that you can monitor BlackBerry® Enterprise Server activity and BlackBerry
device user activity.
You can complete the following steps if you want to install the BlackBerry Monitoring Service on a computer that is separate
from the computer that hosts the BlackBerry Enterprise Server.
Before you begin: Install a BlackBerry Enterprise Server and a BlackBerry Administration Service.
1.
2.
3.
4.
5.
Log in to the computer using the Windows® account that you want to use to run the BlackBerry Monitoring Service services.
In the Setup type dialog box, select I would like the installation process to use an existing BlackBerry Configuration
Database.
In the Database information dialog box, type the names of the database server and BlackBerry Configuration Database
that the BlackBerry Enterprise Server uses.
In the Advanced database options dialog box, consider the following information:
• The BlackBerry Monitoring Service does not support database mirroring.
• If you configured the database server to use static ports, you must clear the Use dynamic ports check box. If the static
port number is not 1433, type the port number in the Port field.
In the Setup options dialog box, perform the following actions:
39
Installation and Configuration Guide
Install the BlackBerry Monitoring Service software
• Select Remote component and BlackBerry Monitoring Service.
• If you do not want to install the BlackBerry Administration Service on the same computer as the BlackBerry Monitoring
Service, in the Setup Type dialog box, clear the BlackBerry Administration Service check box.
6.
7.
When the setup application prompts you to restart the computer, click Yes.
In the Monitoring service dialog box, perform the following actions:
• If there are a large number of BlackBerry device users in your organization, or if you create a large number of reports
from the BlackBerry Monitoring Service, install the BlackBerry Monitoring Service database on a database server that is
separate from the database server that hosts the BlackBerry Configuration Database.
• Type the names of the database server and BlackBerry Monitoring Service database.
8.
9.
Start the services for the BlackBerry Monitoring Service.
In the Console addresses dialog box, copy the BlackBerry Monitoring Service web address. You can use this web address
to log in to the BlackBerry Monitoring Service.
40
Installation and Configuration Guide
Installing a standby BlackBerry Enterprise Server
Installing a standby BlackBerry Enterprise Server
7
To configure the BlackBerry® Enterprise Server for high availability and disaster recovery, you install a standby BlackBerry
Enterprise Server on a separate computer from your organization's primary BlackBerry Enterprise Server. During the installation
process, you assign a standby BlackBerry Enterprise Server to a primary BlackBerry Enterprise Server. You can assign only one
standby BlackBerry Enterprise Server to each primary BlackBerry Enterprise Server. The setup application assigns the SRP
credentials of the primary BlackBerry Enterprise Server to the standby BlackBerry Enterprise Server automatically.
When you install a standby BlackBerry Enterprise Server, you can install the same BlackBerry Enterprise Server components that
are installed on the primary BlackBerry Enterprise Server, or different components. For example, you might want to install
additional components with the standby BlackBerry Enterprise Server if you want to use the system resources on the computer
to distribute the performance load.
You cannot change a primary BlackBerry Enterprise Server to a standby BlackBerry Enterprise Server by running the setup
application again.
By default, the standby BlackBerry Enterprise Server enables you to fail over the following components if they stop responding
on the primary BlackBerry Enterprise Server:
•
BlackBerry Attachment Service
•
BlackBerry Collaboration Service
•
BlackBerry Dispatcher
•
BlackBerry MDS Connection Service
•
BlackBerry Messaging Agent
•
BlackBerry Policy Service
•
BlackBerry Router
•
BlackBerry Synchronization Service
After you complete the installation process, the setup application does not start all the services for the standby BlackBerry
Enterprise Server components. For example, the setup application does not start the BlackBerry MailStore Service, BlackBerry
Synchronization Service, or BlackBerry Policy Service. The failover process starts the services when the standby BlackBerry
Enterprise Server promotes itself.
For more information about high availability in a large-scale environment, see the BlackBerry Enterprise Server Planning Guide.
Install a standby BlackBerry Enterprise Server
During the installation process, you must restart the computer.
Before you begin:
•
Install a primary BlackBerry® Enterprise Server.
41
Installation and Configuration Guide
Install a standby BlackBerry Enterprise Server
•
Verify that the BlackBerry Administration Service is running on an account that has permissions to access and modify the
Windows® registry on the computer that you want to install the standby BlackBerry Enterprise Server on.
1.
Log in to the computer using the Windows® account that you used to install the primary BlackBerry Enterprise Server. This
account will run the services for the standby BlackBerry Enterprise Server.
On the BlackBerry Enterprise Server installation media, double-click setup.exe.
In the Setup type dialog box, select I would like the installation process to use an existing BlackBerry Configuration
Database.
In the Database information dialog box, type the names of the database server and BlackBerry Configuration Database
that the primary BlackBerry Enterprise Server uses.
In the Advanced database options dialog box, consider the following information:
• If you want to configure database mirroring, you can select Add support for database mirroring and type the name of
the database server that hosts the mirror database in the Name of the mirror database server field. The setup
application does not create the BlackBerry Configuration Database on the mirror Microsoft® SQL Server®; it adds a
registry key to the computer that includes the name of the mirror Microsoft SQL Server.
• If you configured the database server to use static ports, you must clear the Use dynamic ports check box. If the static
port number is not 1433, type the port number in the Port field.
2.
3.
4.
5.
6.
7.
In the Setup options dialog box, perform the following actions:
• Click Install a standby BlackBerry Enterprise Server to set up high availability.
• In the Additional components list, select any components that you want to install with the standby BlackBerry Enterprise
Server.
• To permit administrators to log in to the BlackBerry Administration Service and BlackBerry Monitoring Service using
their Microsoft® Active Directory® credentials, in the BlackBerry administration list, click Use Active Directory
authentication.
In the High availability settings dialog box, select the primary BlackBerry Enterprise Server that you want to assign the
standby BlackBerry Enterprise Server to.
8. When the setup application prompts you to restart the computer, click Yes.
9. Log in to the computer using the same account that you used in step 1. The setup application continues the installation
process automatically.
10. In the Application extensibility information dialog box, consider the following information:
• You can type a FQDN to create a new BlackBerry MDS Integration Service pool, or add the BlackBerry MDS Integration
Service instance to a pool that you created during a previous installation process.
• To configure a hardware load balancer for the BlackBerry MDS Integration Service pool, you can type a FQDN that
corresponds to a DNS record in the DNS server that maps the FQDN into the IP address of the virtual server that you
configured on the hardware load balancer.
• The setup application creates the BlackBerry MDS Integration Service database on the database server that hosts the
BlackBerry Configuration Database.
42
Installation and Configuration Guide
Install a standby BlackBerry Enterprise Server
• If you add the BlackBerry MDS Integration Service instance to an existing pool, the setup application selects the existing
BlackBerry MDS Integration Service database and existing administrator account and publisher account.
11.
In the Administration settings dialog box, consider the following information:
• You must type a valid FQDN or IP address in the Pool name field. The setup application uses the FQDN or IP address
to create the BlackBerry Administration Service web address.
• You must type the password for the SSL certificate that the BlackBerry Administration Service uses for authentication
with browsers.
12. In the LDAP settings dialog box, consider the following information:
• You can type the URL of the LDAP server that hosts the BlackBerry device users using the following format: ldap://
<computer_name>:<port>; where <computer_name> is the DNS name of the LDAP server, and <port> is the port number
that the LDAP server listens for connections on (by default, port 389).
• You can type the distinguished name of the search base URL for the area of the directory tree that contains the BlackBerry
device users.
• You can type the name and password for the administrator account that has permissions to log in to and search the
LDAP server. You can type the name for the administrator account as the login name, also known as the security account
manager name (for example, besadmin).
13. Start the services for the BlackBerry Enterprise Server.
14. In the Console addresses dialog box, copy the BlackBerry Administration Service web address. You can use the web address
to log in to the BlackBerry Administration Service.
After you finish:
•
As required, add the name of the BlackBerry MDS Integration Service pool to the DNS server, and change the name of the
computer.
•
To view the standby BlackBerry Enterprise Server information in the BlackBerry Administration Service, restart the BlackBerry
Administration Service.
•
If you reinstalled the BlackBerry Administration Service, in Microsoft® Internet Explorer®, delete the cache contents.
43
Installation and Configuration Guide
Postinstallation tasks
Postinstallation tasks
8
Test the BlackBerry Enterprise Server installation
1.
2.
3.
4.
In the Windows® Services, verify that the services for the BlackBerry® Enterprise Server are running.
In the Windows Event Viewer and log files that are located in <drive>:\Program Files\Research In Motion\BlackBerry
Enterprise Server\Logs, check for error messages.
In the BlackBerry Administration Service, add a test user account.
If you can add a test user account, the connection from the BlackBerry Enterprise Server to the BlackBerry Configuration
Database and the messaging server is open.
If you installed the BlackBerry MDS Connection Service, browse to http://<BES_host>:8080.
If the status page appears, the BlackBerry MDS Connection Service is running.
After you finish: For troubleshooting information, visit www.blackberry.com/support.
Install the BlackBerry database notification system
The BlackBerry® database notification system is designed to reduce the number of database queries that a BlackBerry® Enterprise
Server makes to the BlackBerry Configuration Database.
If you create the BlackBerry Configuration Database on the computer that hosts the BlackBerry Enterprise Server, the BlackBerry
database notification system installs automatically.
If you create the BlackBerry Configuration Database on a database server that is installed on a computer that is separate from
the computer that hosts the BlackBerry Enterprise Server, you can install the BlackBerry database notification system manually
after you complete the BlackBerry Enterprise Server installation process.
Before you begin:
•
You must have the system administrator permission for the database.
•
Your database server must run on Windows Server® 2003.
1.
2.
On the database server, open the BlackBerry Enterprise Server installation media.
Perform one of the following actions:
• If 32-bit Microsoft® SQL Server® 2003 is running in your organization's environment, in the Tools\DBNS folder, copy
the RimEsp.dll file to C:\Program Files\Microsoft SQL Server\MSSQL\Binn.
• If a64-bit Microsoft SQL Server 2003 is running in your organization's environment, in the Tools\DBNS\x64 folder,
copy the RimEsp.dll file to C:\Program Files\Microsoft SQL Server\MSSQL\Binn.
3.
Open the Microsoft® SQL Query Analyzer.
44
Best practice: Running the BlackBerry Enterprise Server
Installation and Configuration Guide
4.
Use the Microsoft SQL Query Analyzer console, navigate to Database\DBInstallScripts\SQLServer\5.0 on the BlackBerry
Enterprise Server installation media.
5. Open the NotifyMasterInstall.sql file.
6. Run the script.
7. Open the NotifyInstall.sql file.
8. Change <_DATABASENAME_> to the name of the BlackBerry Configuration Database (for example, BesMgmt).
9. Run the script.
10. Confirm that the Microsoft SQL Query Analyzer displays the "Function dbo.xp_RIMxxxx registered" message.
11. To create additional BlackBerry Configuration Database instances in your organization's environment, repeat steps 7 to 10.
Best practice: Running the BlackBerry Enterprise Server
Best practice
Description
Do not change the startup type for the
BlackBerry® Enterprise Server services.
When you install or upgrade the BlackBerry Enterprise Server, the setup application
configures the startup type for the BlackBerry Enterprise Server services to
automatic or manual. For example, the setup application configures the startup type
for the BlackBerry MailStore Service, BlackBerry Policy Service, and BlackBerry
Synchronization Service to manual.
To avoid errors in the BlackBerry Enterprise Server, do not change the startup type
for the BlackBerry Enterprise Server services.
Do not change the account information When you install or upgrade the BlackBerry Enterprise Server, the setup application
for BlackBerry Enterprise Server
configures the account information for the BlackBerry Enterprise Server services.
services.
Do not change the account information for the BlackBerry Enterprise Server unless
the BlackBerry Enterprise Server documentation specifies that you can.
Run the BlackBerry Configuration Panel Consider the following guidelines if you are running the BlackBerry Configuration
as an administrator.
Panel on Windows Server® 2008:
•
Log in to the computer with a user account that is in the Administrator group
on the Windows Server.
•
Right-click the BlackBerry Configuration Panel icon and click Run as
administrator.
45
Installation and Configuration Guide
Configure support for Unicode languages
Configure support for Unicode languages
You can make sure that the messaging application can display the Unicode messages that the BlackBerry® device sends by
configuring the BlackBerry® Enterprise Server to support Unicode languages (for example, Japanese, Korean, or Simplified
Chinese).
1. On the computer that hosts the BlackBerry Enterprise Server, on the taskbar, click Start > Run.
2. Type regedit.
3. Click OK.
4. Go to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Enterprise Server\Agents.
5. If the MAPIEncoding registry key exists, perform one of the following actions:
• Delete the key.
• Change the value of the key to 1.
6.
7.
Go to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Enterprise Server\Setup.
Verify that the ConfigKeystoreCountry registry key is set to one of the following values, depending on your organization's
environment:
• CN for Simplified Chinese
• JP for Japanese
• KR for Korean
8.
In the Windows® Services, restart the BlackBerry Dispatcher.
Configure support for Unicode text in calendars on BlackBerry devices in a
Microsoft Exchange 2003 environment
Before you begin: You must install the hotfixes for wireless calendar synchronization for Microsoft® Exchange 2003.
1.
2.
3.
4.
5.
6.
7.
46
On the BlackBerry® Enterprise Server, on the Start menu, click Run.
Type regedit.
Click OK.
In the left pane, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
Create a DWORD value that is named SetLocaleIDs.
Set the value to 1.
In the Windows® Services, restart the BlackBerry Messaging Agent.
Installation and Configuration Guide
Log in to the BlackBerry Administration Service for the first time
Log in to the BlackBerry Administration Service for the first time
To open the BlackBerry® Administration Service, you can use a browser on any computer that has access to the computer that
hosts the BlackBerry Administration Service.
Before you begin: To manage a BlackBerry device using the BlackBerry Administration Service while the BlackBerry device is
connected to the computer, the browser must permit Microsoft® ActiveX® controls.
1.
2.
3.
4.
5.
In the browser, type https://<server_name>/webconsole/app, where <server_name> is the name of the computer that
hosts the BlackBerry Administration Service.
In the User name field, type admin.
In the Password field, type the password that you created during the installation process.
In the Log in using drop-down list, click BlackBerry Administration Service.
Click Log in.
Configuring a computer for monitoring
Configure the SNMP service for monitoring
You can configure the SNMP service on the computer that hosts the BlackBerry® Enterprise Server so that the BlackBerry
Monitoring Service can monitor BlackBerry Enterprise Server activity.
Before you begin: Verify that the SNMP service is installed and running.
1.
2.
3.
4.
5.
6.
7.
8.
9.
On a computer that hosts the BlackBerry Enterprise Server or BlackBerry Enterprise Server components, in the Windows®
Services, right-click SNMP Service. Click Properties.
On the General tab, change the startup type to Automatic.
On the Traps tab, in the Community name field, type the community name for the SNMP service. The field is case-sensitive.
In the Trap Destinations section, add the IP address of the computer that hosts the BlackBerry Monitoring Service.
On the Security tab, in the Accepted community names section, add the community name that you typed in step 3. The
SNMP community name is read-only.
Select the Accept SNMP packets from any host or Accept SNMP packets from these hosts option, depending on your
organization's environment.
If you selected Accept SNMP packets from these hosts, type the IP address of the computer that hosts the BlackBerry
Monitoring Service.
Click Apply.
In the Services list, right-click SNMP Service. Click Restart.
47
Installation and Configuration Guide
Configuring communication with distributed components
Configure the BlackBerry Monitoring Service to monitor a BlackBerry Enterprise Server
Before you begin: Verify that the computer that hosts the BlackBerry® Enterprise Server has access to the computer that hosts
the BlackBerry Monitoring Service.
1.
2.
3.
4.
5.
6.
7.
8.
9.
In a browser, type https://<server_name>:8443/webconsole/app, where <server_name> is the FQDN of the computer
that hosts the BlackBerry Monitoring Service.
Log in as an administrator that has permissions to access the BlackBerry Monitoring Service.
On the Configuration menu, expand Servers.
Click Manage Servers.
Click the Edit icon for the BlackBerry Enterprise Server that you want the BlackBerry Monitoring Service to monitor.
In the SNMP Configuration section, type the SNMP port number that the SNMP service on the BlackBerry Enterprise
Server computer uses.
In the SNMP Configuration section, type the SNMP community name that the SNMP service on the BlackBerry Enterprise
Server computer uses.
In the SNMP Configuration section, select the Monitoring status check box.
Click Save.
Configuring communication with distributed components
Connecting to a BlackBerry Attachment Service
Perform the following actions if you installed the BlackBerry® Attachment Service on a computer that is separate from the
computer that host the BlackBerry® Enterprise Server or BlackBerry Enterprise Server components that connect to the BlackBerry
Attachment Service. These actions ensure that BlackBerry Enterprise Server components can connect to the BlackBerry
Attachment Service.
Connect a BlackBerry MDS Connection Service to a remote BlackBerry Attachment Service
Perform the following task if you did not install the BlackBerry® Attachment Service on the same computer as the BlackBerry
MDS Connection Service.
1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology
> BlackBerry Domain > Component view > Attachment > Connector.
2. Click the BlackBerry Attachment Connector that is installed with the BlackBerry MDS Connection Service.
3. Click Edit instance.
48
Installation and Configuration Guide
4.
5.
6.
7.
8.
Configuring communication with distributed components
On the Supported Attachment Server instances tab, in the Name drop-down list, select the BlackBerry Attachment
Service instance that you want to connect the BlackBerry MDS Connection Service to.
In the Results query period(s) field, type the number of seconds that you want the BlackBerry MDS Connection Service
to wait for a response before it sends a request to another BlackBerry Attachment Service instance.
In the Dedicated server drop-down list, click yes if you want the BlackBerry Attachment Service instance to process specific
content types only for the BlackBerry MDS Connection Service.
In the Pool drop-down list, perform one of the following actions:
• To include the BlackBerry Attachment Service instance in the primary group of instances in a pool, select Primary. You
must include at least one BlackBerry Attachment Service instance in the primary group. If you are not configuring high
availability, select Primary.
• To include the BlackBerry Attachment Service instance in the secondary group, select Secondary.
Perform the following actions:
• To turn on support for an attachment file format, in the Extensions section, type the file extension of the format. Click
the Add icon beside the extension that you typed.
• To turn off support for an attachment file format, in the Extensions section, click the Delete icon beside the file extension.
9. Click the Add icon.
10. Click Save All.
11. Repeat steps 2 to 10 for each BlackBerry MDS Connection Service instance in your organization's environment that requires
the BlackBerry Attachment Service instance.
Connect the BlackBerry Collaboration Service to a remote BlackBerry Attachment Service
Using the BlackBerry® Client for IBM® Lotus® Sametime®, users can send files to contacts in their contact lists. To optimize files
for viewing on BlackBerry devices, the BlackBerry Collaboration Service must connect to a BlackBerry Attachment Service instance.
If you did not install the BlackBerry Attachment Service instance on the same computer as the BlackBerry Collaboration Service,
you must connect the BlackBerry Collaboration Service to a remote BlackBerry Attachment Service.
1. On the computer that hosts the BlackBerry Collaboration Service, navigate to C:\Program Files\Research In Motion
\BlackBerry Enterprise Server\BBIM\Servers\<server_name>\config.
2. In a text editor, open the rimpublic.property file.
3. At the end of the file, type the following text on separate lines:
Attachment.Server.host=<attachment_server_host_name>
Attachment.Server.port.asp=1900
4.
5.
Attachment.Server.port.rqp=2000
To connect another BlackBerry Collaboration Service to the BlackBerry Attachment Service instance, type the text that
appears in step 3 for this BlackBerry Collaboration Service instance.
Save and close the file.
49
Installation and Configuration Guide
6.
7.
8.
9.
Configuring communication with distributed components
In the Windows® Services, restart the BlackBerry Collaboration Service.
On the computer that hosts the BlackBerry Attachment Service, in the Registry Editor, navigate to HKEY_LOCAL_MACHINE
\SOFTWARE\Research In Motion\BBAttachServer\BBAttachBESExtension.
Change AllowRemoteServices to 1.
In the Windows Services, restart the BlackBerry Attachment Service.
Connect a BlackBerry Enterprise Server to a remote BlackBerry Attachment Service
Perform the following actions if you did not install the BlackBerry® Attachment Service on the same computer as the BlackBerry®
Enterprise Server. The BlackBerry Messaging Agent requires access to the remote BlackBerry Attachment Service so that it can
process attachment requests.
1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology
> BlackBerry Domain > Component view > Attachment > Connector.
2. Click the BlackBerry Attachment Connector that is installed with the BlackBerry Enterprise Server.
3. Click Edit instance.
4. On the Supported Attachment Server instances tab, in the Name drop-down list, select the BlackBerry Attachment
Service instance that you want to connect to the BlackBerry Enterprise Server.
5. In the Results query period(s) field, type the number of seconds that you want the BlackBerry Enterprise Server to wait
for a response before it sends a request to another BlackBerry Attachment Service instance.
6. In the Dedicated server drop-down list, click yes if you want the BlackBerry Attachment Service instance to process specific
content types only for the BlackBerry Enterprise Server.
7. In the Pool drop-down list, perform one of the following actions:
• To include the BlackBerry Attachment Service instance in the primary group of instances in a pool, select Primary. You
must include at least one BlackBerry Attachment Service instance in the primary group. If you are not configuring
BlackBerry Attachment Service high availability, select Primary.
• To include the BlackBerry Attachment Service instance in the secondary group, select Secondary.
8.
Perform the following actions:
• To turn on support for an attachment file format, in the Extensions section, type the file extension of the format. Click
the Add icon beside the extension that you typed.
• To turn off support for an attachment file format, in the Extensions section, click the Delete icon beside the file extension.
9. Click the Add icon.
10. Click Save All.
11. Repeat steps 2 to 10 for each BlackBerry Enterprise Server instance in your organization's environment that requires the
BlackBerry Attachment Service instance.
12. Restart the BlackBerry Enterprise Server.
a. In the Component view, expand BlackBerry Enterprise Server.
b. Click the BlackBerry Enterprise Server instance.
50
Installation and Configuration Guide
c.
Configuring communication with distributed components
Click Restart instance.
Connect a remote BlackBerry Attachment Service to a BlackBerry Enterprise Server
Perform the following actions if you did not install the BlackBerry® Attachment Service on the same computer as the BlackBerry®
Enterprise Server. The BlackBerry Messaging Agent requires access to the remote BlackBerry Attachment Service so that it can
process attachment requests.
1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology
> BlackBerry Domain > Component view > Attachment > Server.
2. Click the name of the remote BlackBerry Attachment Service.
3. Click Edit instance.
4. On the Supported Attachment Connector instances tab, add the BlackBerry Attachment Connector that is installed with
the BlackBerry Enterprise Server.
5. Click Save All.
6. To restart the BlackBerry Attachment Service, on the Instance information tab, in the Status list, click Restart instance.
Connecting to a BlackBerry Router
Perform the following tasks if you installed the BlackBerry® Router on a computer that is separate from the computer that hosts
the BlackBerry® Enterprise Server. These tasks ensure that the BlackBerry Enterprise Server can connect to the BlackBerry Router.
Permit a BlackBerry Enterprise Server to connect to a remote BlackBerry Router
If you installed a BlackBerry® Router on a computer that is separate from the computer that hosts a BlackBerry® Enterprise
Server, you must permit the BlackBerry Dispatcher that you installed with the BlackBerry Enterprise Server to connect to the
BlackBerry Router. The BlackBerry Router that you installed on a separate computer can send BlackBerry traffic from the
BlackBerry Enterprise Server to BlackBerry devices.
1. On the computer that hosts the BlackBerry Router, click Start > Run.
2. Type regedit.
3. Click OK.
4. Change the registry entry value for \\HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerryRouter
\AllowRemoteServices from 0 to 1.
5. In the Windows® Services, restart the BlackBerry Router service.
Connect a BlackBerry Enterprise Server to a remote BlackBerry Router
1.
In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology
> BlackBerry Domain > Component view > BlackBerry Enterprise Server.
51
Installation and Configuration Guide
2.
3.
4.
5.
6.
7.
8.
Click the BlackBerry Enterprise Server instance or BlackBerry Enterprise Server pair that you want to assign the BlackBerry
Router to.
Click Edit instance.
In the Router address section, type the FQDN of the computer that hosts the BlackBerry Router.
If the BlackBerry Router uses a port number other than port number 3101, in the Port override field, type the port number.
Click the Add icon.
Click Save All.
Restart the BlackBerry Enterprise Server using one of the following methods:
• If you changed a BlackBerry Enterprise Server instance, on the Instance tab, click Restart instance.
• If you changed a BlackBerry Enterprise Server pair, click one of the instances and on the Instance tab, click Restart
instance. Repeat this step for the other instance.
• In the Windows® Services, restart the BlackBerry Dispatcher.
Configure multiple BlackBerry Enterprise Server instances to use the same BlackBerry MDS
Integration Service
If you installed a BlackBerry® MDS Integration Service instance on a computer that is separate from a computer that hosts a
BlackBerry® Enterprise Server, you must connect the BlackBerry MDS Integration Service instance to a BlackBerry Enterprise
Server so that you can use the BlackBerry MDS Integration Service to send BlackBerry® MDS Runtime Applications and updates
to BlackBerry devices.
You can also connect the BlackBerry MDS Integration Service to multiple BlackBerry Enterprise Server instances if you want to
make the BlackBerry MDS Runtime Applications that are stored in the BlackBerry MDS Application Repository available to users
that are associated with multiple BlackBerry Enterprise Server instances.
1.
2.
3.
4.
5.
6.
7.
52
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology
> BlackBerry Domain > Component view > MDS Integration Service.
Click the instance that you want to change.
Click Edit instance.
On the Supported Dispatcher instances tab, in the Available Dispatcher instances list, click the BlackBerry Enterprise
Server instance that you want to configure to use the BlackBerry MDS Integration Service.
Click Add.
Repeat steps 4 and 5 for each BlackBerry Enterprise Server instance that you want to configure to use the BlackBerry MDS
Integration Service.
Click Save all.
Installation and Configuration Guide
Restrict database permissions for the BlackBerry Attachment Service
Restrict database permissions for the BlackBerry Attachment Service
The BlackBerry® Attachment Service accesses the BlackBerry Configuration Database to read attachment data using a
Windows® account or a SQL authentication account. To limit the access that the BlackBerry Attachment Service account has to
the tables in the BlackBerry Configuration Database, you can configure a BlackBerry Attachment Service account that has limited
database permissions. This account is not the same as the account that the BlackBerry® Enterprise Server uses to access the
BlackBerry Configuration Database.
Before you begin:
•
Create a Windows® account for the BlackBerry Attachment Service.
•
To use database authentication, create a SQL authentication account for the BlackBerry Attachment Service.
1.
2.
3.
In the Microsoft® SQL Server® management console, create a SQL login for the Windows account or SQL authentication
account.
Assign the account to the rim_db_AttachmentServer role in the BlackBerry Configuration Database.
If you want the BlackBerry Attachment Service to use a SQL authentication account to access the BlackBerry Configuration
Database, perform the following actions:
a. On the computer that you installed the BlackBerry Attachment Service on, log in using the Windows account that the
BlackBerry Attachment Service is running on.
b. Click Start > Run.
c. Type regedit. Click OK.
d. Navigate to HKEY_CURRENT_USER\SOFTWARE\Research In Motion.
e. Create the BBAttachServer\Database keys.
f. In the Database key, create the Login and Password string values for the SQL authentication account.
After you finish: After you complete the BlackBerry Attachment Service installation process, in the Windows Services, verify that
the service for the BlackBerry Attachment Service is using the Windows account that you configured. If you need to change the
account information, restart the BlackBerry Attachment Service.
Configuring minimum Microsoft SQL Server permissions for the Windows
account
The BlackBerry® Enterprise Server setup application requires the Windows® account that it uses during the installation process
or upgrade process to have Microsoft® SQL Server® permissions to create or upgrade the BlackBerry Configuration Database.
The setup application requires the Windows account to have more Microsoft SQL Server permissions to install the BlackBerry
Enterprise Server than the BlackBerry Enterprise Server requires to run.
53
Configuring minimum Microsoft SQL Server permissions for the Windows account
Installation and Configuration Guide
After the installation or upgrade process completes, you can change the Microsoft SQL Server permissions of the Windows account
to the Microsoft SQL Server permissions that the BlackBerry Enterprise Server requires to run. When you change the Microsoft
SQL Server permissions of the Windows account, you can use Microsoft SQL Server security to minimize the operations that the
Windows account can perform on the BlackBerry Configuration Database.
The following table describes the Microsoft SQL Server permissions for the setup application and the Windows account that the
BlackBerry Enterprise Server uses to run.
Server and database roles
Description
db_owner
The setup applicaton requires this role to install and upgrade the BlackBerry
Configuration Database, BlackBerry MDS Integration Service database, and
BlackBerry Monitoring Service database.
rim_db_bes_server
You can remove this role from the Windows account that the BlackBerry Enterprise
Server uses to run after the setup application creates or upgrades the BlackBerry
Configuration Database.
The BlackBerry Enterprise Server requires this role to run the BlackBerry Enterprise
Server services. The setup application or the createDB executable creates the role
automatically when it creates the BlackBerry Configuration Database.
This role is the minimum Microsoft SQL Server permission for running the BlackBerry
Enterprise Server.
Configure minimum Microsoft SQL Server permissions for the Windows account
You can configure the minimum Microsoft® SQL Server® permissions for the Windows® account that the BlackBerry® Enterprise
Server uses to run.
1. Open the Microsoft SQL Server console.
2. Expand Microsoft SQL Server > Security > Logins.
3. Right-click the Windows account that the BlackBerry Enterprise Server uses to run. Click Properties.
4. Map the Windows account to the BlackBerry Configuration Database.
5. Change the Database role membership to rim_db_bes_server.
6. Remove all other database role memberships.
7. Apply your changes.
54
Installation and Configuration Guide
Changing the BlackBerry Configuration Database
Changing the BlackBerry Configuration Database
If you want a BlackBerry® Enterprise Server to use a different BlackBerry Configuration Database, you must run the setup
application and specify the BlackBerry Configuration Database that you want the BlackBerry Enterprise Server to use.
When you change the BlackBerry Configuration Database, the BlackBerry Enterprise Server becomes unavailable and users cannot
send or receive messages on their BlackBerry devices. Organizer data synchronization occurs after you have changed the
BlackBerry Configuration Database.
Configuring a Hosted BlackBerry services environment
Hosted BlackBerry® services permit you to make the BlackBerry® Enterprise Server available to other organizations (for example,
small or medium-sized businesses). When you use the Hosted BlackBerry services in your organization's environment, one or
more organizations can subscribe to your organization's BlackBerry Enterprise Server.
If your organization hosts a BlackBerry Enterprise Server and multiple organizations subscribe to the Hosted BlackBerry services,
you must customize the contact lookup feature so that users can access their organization’s contact list and download the
information to their BlackBerry devices. When you customize how users search for email addresses, you restrict the users from
accessing the contact information of another organization that also subscribes to the Hosted BlackBerry service.
You must make sure that the organization name for each user is listed accurately and consistently in the contact list. For example,
if the organization name appears as an acronym in some entries but in full in others, the address search results might be inaccurate.
If a user tries to look up contact information for a user whose organization name is not specified, no search results appear.
When users try to look up contact information, they must type the entire email address.
To configure Hosted BlackBerry services, you must use a different licensing model for the BlackBerry Enterprise Server.
If you do not want to use the contact lookup feature, you can configure the BlackBerry Enterprise Server to look up email addresses
using LDAP. With LDAP, users can perform more comprehensive searches for email addresses in the contact list. The BlackBerry
Enterprise Server does not search for a user’s organization name in the contact list. Instead, it uses an LDAP field as a filter for
retrieving email addresses with a specific organization name. You can select an existing LDAP field or you can create a custom
LDAP field.
Configure how users search for email addresses in a Hosted BlackBerry services environment
1.
2.
3.
4.
5.
On the computer that hosts the BlackBerry® Enterprise Server, click Start > Run.
Type regedit. Click OK.
Navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
If it exists, verify that the DWORD value for AllowAddressLookup is 1.
Create a DWORD value named HostedServer.
55
Installation and Configuration Guide
6.
7.
Configuring a Hosted BlackBerry services environment
Change the value to 1.
In the Windows® Services, restart the BlackBerry Controller.
Configure the BlackBerry Enterprise Server to search for email addresses using LDAP
1.
2.
3.
4.
5.
6.
7.
8.
On the computer that hosts the BlackBerry® Enterprise Server, click Start > Run.
Type regedit. Click OK.
Navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
Create a DWORD value named LDAPSearch.
Change the value to 1.
Create a DWORD value named LDAPALPSearch.
Change the value to 1.
In the Windows® Services, restart the BlackBerry Controller.
Configure the BlackBerry Enterprise Server to search for email addresses using a custom
LDAP field
1.
2.
3.
4.
5.
6.
56
On the computer that hosts the BlackBerry® Enterprise Server, click Start > Run.
Type regedit. Click OK.
Navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
Create a string value named LDAPCompanyField.
Specify the custom LDAP field that you want to use as the organization name field as the value.
In the Windows® Services, restart the BlackBerry Controller.
Adding or removing BlackBerry Enterprise Server components
Installation and Configuration Guide
Adding or removing BlackBerry Enterprise Server
components
9
If you installed a BlackBerry® Enterprise Server previously, you can add one or more BlackBerry Enterprise Server components
to the existing BlackBerry Enterprise Server, or you can remove existing BlackBerry Enterprise Server components from the
BlackBerry Enterprise Server.
To add or remove a BlackBerry Enterprise Server component, you must run the setup application again. The setup application
removes the existing BlackBerry Enterprise Server software from the computer, and installs only the BlackBerry Enterprise Server
components that you select. You can also choose to install either a BlackBerry Enterprise Server or install one or more remote
components.
If you installed a BlackBerry Enterprise Server and, when you run the setup application again you select the remote component
setup option, the setup application removes the existing BlackBerry Enterprise Server software. If you installed one or more
remote components and you select the BlackBerry Enterprise Server setup option, the setup application removes the existing
remote components.
You can add or remove the following BlackBerry Enterprise Server components.
Component
Options
BlackBerry Enterprise Server
You can choose one of the following options:
•
You can remove a BlackBerry Enterprise Server (which includes a BlackBerry
Attachment Service, BlackBerry Dispatcher, BlackBerry MDS Connection
Service, BlackBerry Messaging Agent, BlackBerry Policy Service, BlackBerry
Router, and BlackBerry Synchronization Service) and install one or more
remote components instead.
•
You can remove any remote components and install a BlackBerry Enterprise
Server instead.
BlackBerry Administration Service
You can choose one of the following options:
•
If you installed a BlackBerry Administration Service with a BlackBerry
Enterprise Server, you can remove the BlackBerry Administration Service.
•
If you installed a BlackBerry Enterprise Server, you can add a BlackBerry
Administration Service.
•
If you installed a BlackBerry Administration Service as a remote component,
you can remove it.
57
Adding or removing BlackBerry Enterprise Server components
Installation and Configuration Guide
Component
Options
•
If you installed remote components, you can add a BlackBerry Administration
Service.
BlackBerry Attachment Service
You can choose one of the following options:
•
If you installed a BlackBerry Attachment Service as a remote component, you
can remove it.
•
You can add a BlackBerry Attachment Service to an existing installation of
another remote component.
BlackBerry Collaboration Service
You can choose one of the following options:
•
If you installed a BlackBerry Collaboration Service with a BlackBerry Enterprise
Server, you can remove the BlackBerry Collaboration Service.
•
If you installed a BlackBerry Enterprise Server, you can add a BlackBerry
Collaboration Service.
•
If you installed a BlackBerry Collaboration Service as a remote component,
you can remove it.
•
If you installed remote components, you can add a BlackBerry Collaboration
Service.
BlackBerry MDS Connection Service
You can choose one of the following options:
•
If you installed a BlackBerry MDS Connection Service as a remote component,
you can remove it.
•
You can add a BlackBerry MDS Connection Service to an existing installation
of another remote component.
BlackBerry MDS Integration Service
You can choose one of the following options:
•
If you installed a BlackBerry MDS Integration Service with a BlackBerry
Enterprise Server, you can remove the BlackBerry MDS Integration Service.
•
If you installed a BlackBerry Enterprise Server, you can add a BlackBerry MDS
Integration Service.
•
If you installed a BlackBerry MDS Integration Service as a remote component,
you can remove it.
•
If you installed remote components, you can add a BlackBerry MDS Integration
Service.
BlackBerry Monitoring Service
You can choose one of the following options:
58
Add or remove a BlackBerry Enterprise Server component
Installation and Configuration Guide
Component
Options
•
•
BlackBerry Router
If you installed a BlackBerry Monitoring Service as a remote component, you
can remove it.
You can add a BlackBerry Monitoring Service to an existing installation of
another remote component.
Only one BlackBerry Monitoring Service instance can exist in your organization's
BlackBerry Domain.
You can choose one of the following options:
•
If you installed a BlackBerry Router as a remote component, you can remove it.
•
You can add a BlackBerry Router to an existing installation of another remote
component.
Add or remove a BlackBerry Enterprise Server component
When you perform this tasks, any BlackBerry® Enterprise Server components on the computer are unavailable for use.
The process includes a restart of the computer.
Before you begin:
•
If you configured high availability, and you want to add or remove a BlackBerry Enterprise Server component from a computer
that hosts a primary BlackBerry Enterprise Server, perform a manual failover to the standby BlackBerry Enterprise Server
so that this task does not affect users.
•
If you want to remove a BlackBerry Router, BlackBerry Attachment Service, BlackBerry MDS Connection Service, BlackBerry
Collaboration Service, or BlackBerry MDS Integration Service, use the BlackBerry Administration Service to remove the
component from the list of component instances that the BlackBerry Enterprise Server uses.
1.
2.
3.
4.
5.
6.
Log in to the computer using the Windows® account that you used to install the BlackBerry Enterprise Server components.
Stop the services for the BlackBerry Enterprise Server.
On the BlackBerry Enterprise Server installation media, double-click setup.exe.
In the Setup type dialog box, select I would like the installation process to use an existing BlackBerry Configuration
Database.
In the Database information dialog box, verify the names of the database server and BlackBerry Configuration Database.
In the Advanced database options dialog box, consider the following information:
• If you want to configure database mirroring, you can select Add support for database mirroring and type the name of
the database server that hosts the mirror database in the Name of the mirror database server field. The setup
application does not create the BlackBerry Configuration Database on the mirror Microsoft® SQL Server®; it adds a
registry key to the computer that includes the name of the mirror Microsoft SQL Server.
59
Installation and Configuration Guide
Add or remove a BlackBerry Enterprise Server component
• If you configured the database server to use static ports, you must clear the Use dynamic ports check box. If the static
port number is not 1433, type the port number in the Port field.
7.
In the Setup options dialog box, select the components that you want to add, and clear the checkboxes for the components
that you want to remove.
8. When the setup application prompts you to restart the computer, click Yes.
9. Log in to the computer using the same account that you used in step 1.
10. In the Application extensibility information dialog box, consider the following information:
• You can type a FQDN to create a BlackBerry MDS Integration Service pool, or add the BlackBerry MDS Integration
Service instance to a pool that you created during a previous installation process.
• To configure a hardware load-balancer for the BlackBerry MDS Integration Service pool, you can type a FQDN that
corresponds to an DNS record in the DNS server that maps the FQDN into the IP address of the virtual server that you
configured on the hardware load-balancer.
• The setup application creates the BlackBerry MDS Integration Service database on the same database server as the
BlackBerry Configuration Database.
• If you add the BlackBerry MDS Integration Service instance to an existing pool, the setup application selects the existing
BlackBerry MDS Integration Service database and existing administrator account and publisher account.
11.
In the Administration settings dialog box, consider the following information:
• You must type a valid FQDN or IP address in the Pool name field. The setup application uses the FQDN or IP address
to create the BlackBerry Administration Service web address.
• You must type the password for the SSL certificate that the BlackBerry Administration Service uses for authentication
with browsers.
12. In the LDAP Settings dialog box, consider the following information:
• You can type the URL of the LDAP server that hosts the BlackBerry device users using the following format: ldap://
<computer_name>:<port>; where <computer_name> is the DNS name of the LDAP server, and <port> is the port number
that the LDAP server listens for connections on (by default , port 389).
• You can type the distinguished name of the search base URL for the area of the directory tree that contains the BlackBerry
device users.
• You can type the name and password for the administrator account that has permissions to log in to and search the
LDAP server. You can type the name for the administrator account as the login name, also known as the security account
manager name (for example, besadmin).
13. Start the services for the BlackBerry Enterprise Server.
14. In the Console addresses dialog box, copy the web addresses for the BlackBerry Enterprise Server components. You can
use the web addresses to log in to the BlackBerry Enterprise Server components.
After you finish:
•
If you added a component, to view the component information in the BlackBerry Administration Service, restart the
BlackBerry Administration Service.
60
Installation and Configuration Guide
•
•
Remove BlackBerry Enterprise Server component information from the BlackBerry Configuration Database
If you removed a component other than the BlackBerry Router, to delete the component information from the BlackBerry
Configuration Database, use the BlackBerry Administration Service.
If you reinstalled the BlackBerry Administration Service, in Microsoft® Internet Explorer®, delete the cache content.
Remove BlackBerry Enterprise Server component information from the
BlackBerry Configuration Database
If you remove the software for a BlackBerry® Enterprise Server component from a computer, the software removal process does
not delete the component information from the BlackBerry Configuration Database. You must delete the information manually
using the BlackBerry Administration Service so that the BlackBerry Administration Service does not display the information for
the component that you removed.
Before you begin: Remove the software for the BlackBerry Enterprise Server component from the computer.
1.
2.
3.
4.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology
> BlackBerry Domain.
Click Component view.
Beside the component that you removed, click the Delete icon.
Click Yes - Delete the instance until you return to the main page.
61
Removing the BlackBerry Enterprise Server software
Installation and Configuration Guide
Removing the BlackBerry Enterprise Server software
10
Remove the BlackBerry Enterprise Server software
1.
2.
3.
4.
On the taskbar, click Start > Settings > Control Panel > Add/Remove Programs.
Click BlackBerry Enterprise Server.
Click Remove.
Click Yes.
After you finish: To remove third-party software that the setup application installed during the BlackBerry Enterprise Server
installation process, you can remove the JRE™ software and Java® Web Start software from the computer.
Delete registry keys
The BlackBerry® Enterprise Server setup application might not remove all of the registry keys from the Windows® registry when
you remove the BlackBerry Enterprise Server software. You can remove the registry keys from the Windows registry manually
after the process to remove the BlackBerry Enterprise Server software completes successfully.
1. On the computer that you removed the BlackBerry Enterprise Server software from, on the Start menu, click Run.
2. Type regedit.
3. Click OK.
4. Delete the remaining registry keys.
BlackBerry Enterprise Server registry keys
The setup application might not remove the following BlackBerry® Enterprise Server registry keys from the Windows® Registry
when you remove the BlackBerry Enterprise Server software.
Key
Location
Research In Motion
BBAttachServer and any keys that start with BAS, BB, or
BlackBerry
BBAttachServer and any keys that start with BAS, BB, or
BlackBerry
BBAttachServer and any keys that start with BAS, BB, or
BlackBerry
HKEY_LOCAL_MACHINE\SOFTWARE
HKEY_LOCAL_MACHINE\System\CurrentControlSet
\Services
HKEY_LOCAL_MACHINE\System\ControlSet001\Services
62
HKEY_LOCAL_MACHINE\System\ControlSet00n\Services
Removing the BlackBerry database notification system
Installation and Configuration Guide
Key
Location
Research In Motion
any keys that are named BlackBerryServer, or are named the
name of the BlackBerry Enterprise Server in your organization
Research In Motion
BESManmmc.dll
HKEY_CURRENT_USER\Software
HKEY_CURRENT_USER\Software\Microsoft\Windows NT
\CurrentVersion\Windows Messaging SubSystem\Profiles
HKEY_USERS\.DEFAULT\Software
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
\CurrentVersion\App Paths
HKEY_CLASSES_ROOT\Installer\Products
any key where ProductName is BlackBerry Enterprise Server
Removing the BlackBerry database notification system
You must remove the BlackBerry® database notification system manually if you installed it manually. You can remove the
BlackBerry database notification system from one BlackBerry Configuration Database instance or all BlackBerry Configuration
Database instances.
Remove the BlackBerry database notification system from one BlackBerry Configuration
Database
1.
2.
3.
4.
5.
6.
Open the Microsoft® SQL Query Analyzer.
Using the console, navigate to Database\DBInstallScripts\SQLServer\5.0 on the BlackBerry® Enterprise Server installation
media.
Open the NotifyUnInstall.sql file.
Delete all commands after --- delete notification stored procedures and -- delete notification tables.
Run the script.
Perform one of the following actions:
• Restart Microsoft® SQL Server®.
• In Windows® Explorer, navigate to C:\Program Files\Microsoft SQL Server\MSSQL\Binn. Rename the RimEsp.dll file
(for example, RimEspXXX.tmp).
Remove the BlackBerry database notification system from all BlackBerry Configuration
Database instances
1.
2.
Open the Microsoft® SQL Query Analyzer.
Using the console, navigate to Database\DBInstallScripts\SQLServer\5.0 on the BlackBerry® Enterprise Server installation
media.
63
Installation and Configuration Guide
3.
4.
5.
6.
64
Removing the BlackBerry database notification system
Open the NotifyUnInstall.sql file.
Run the script.
Using Windows® Explorer, navigate to <drive>:\Program Files\Microsoft SQL Server\MSSQL\Binn.
Delete the RimEsp.dll file.
Installation and Configuration Guide
Troubleshooting the BlackBerry Enterprise Server installation process
Troubleshooting the BlackBerry Enterprise Server
installation process
11
Failed to write License Key to the Database
This error message appears when you try to add the BlackBerry® Client Access License key during the installation process.
Possible solution
After you restart the computer during the BlackBerry® Enterprise Server installation process, you must log in using the same
Windows® account that you used to start the installation process.
1.
2.
3.
4.
Close the setup application.
Log out of the computer.
Log in to the computer.
Restart the setup application.
Previous version detected but no database available
This error message appears when you cannot start the setup application or the setup application stops responding.
Possible solution
Verify that the registry keys that identify the BlackBerry® Configuration Database exist in the Windows® registry.
1.
2.
3.
4.
5.
6.
7.
8.
On the computer that you want to install or upgrade the BlackBerry® Enterprise Server on, on the Start menu, click Run.
Type regedit.
Click OK.
In the left pane, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server
\Database.
If necessary, create case-sensitive strings that you name DatabaseName and DatabaseServerMachineName.
Specify the name of the BlackBerry Configuration Database as the value for DatabaseName.
Specify the FQDN name of the database server as the value for DatabaseServerMachineName.
Restart the setup application.
65
Installation and Configuration Guide
A third-party tool did not install and the BlackBerry Enterprise Server setup application closed
A third-party tool did not install and the BlackBerry Enterprise Server setup
application closed
Possible solution
1.
2.
3.
4.
On the BlackBerry® Enterprise Server installation media, open the Tools folder.
Double-click the setup application file for the tool that you want to install.
Complete the instructions on the screen.
Restart the BlackBerry Enterprise Server setup application.
The setup application did not prompt you to change or confirm the MAPI
profile
Possible solution
Create and change the MAPI profile manually.
1.
2.
3.
4.
5.
6.
7.
8.
On the BlackBerry® Enterprise Server installation media, open the Tools folder.
Double-click the Fixmapisvc.exe file.
Verify that mapisvc.inf is installed in C:\winnt\system32\ or C:\windows\system32\.
On the taskbar, click Start > All Programs > BlackBerry Enterprise Server > BlackBerry Server Configuration..
On the BlackBerry Server tab, click Edit MAPI profile.
Type the Microsoft® Exchange server name.
Click the Windows® account that is associated with the MAPI profile.
Click OK.
The BlackBerry Monitoring Service cannot monitor events
Possible cause
The SNMP service was not installed before the BlackBerry® Enterprise Server software was installed.
Possible solution
To permit the BlackBerry Monitoring Service to monitor a BlackBerry Enterprise Server activity, you can install the SNMP service
on the computer after you install a BlackBerry Enterprise Server.
1.
66
Verify that the computer has access to the Windows® installation media.
Installation and Configuration Guide You cannot determine the BlackBerry Attachment Connector that the BlackBerry Enterprise Server or the BlackBerry MDS
Connection Service uses
2.
3.
4.
5.
6.
7.
On the computer that hosts the BlackBerry Enterprise Server or BlackBerry Enterprise Server components, on the taskbar,
click Start > Settings > Control Panel > Add/Remove Programs > Add/Remove Windows Components.
Double-click Management and Monitoring Tools.
Select the Simple Network Management Protocol check box.
Click OK.
When the installation wizard prompts you, install the files from the Windows installation media.
Complete the installation wizard.
To complete the installation process, configure the SNMP service to monitor the BlackBerry Enterprise Server activity.
You cannot determine the BlackBerry Attachment Connector that the
BlackBerry Enterprise Server or the BlackBerry MDS Connection Service uses
If you install a BlackBerry® Enterprise Server, the setup application also installs two BlackBerry Attachment Connector instances
automatically. One of the BlackBerry Attachment Connector instances connects the BlackBerry Enterprise Server to the
BlackBerry Attachment Service. The other instance connects the BlackBerry MDS Connection Service to the BlackBerry
Attachment Service. During the installation process, the setup application gives both BlackBerry Attachment Connector instances
a name that includes the computer name (for example, <computer_name>_AC).
The BlackBerry Administration Service displays the names of both the BlackBerry Attachment Connector instances. By default,
you cannot determine easily which instance connects to the BlackBerry Enterprise Server or the BlackBerry MDS Connection
Service so that you can change the display names of both the BlackBerry Attachment Connector instances to make them easier
to identify.
1.
2.
3.
4.
5.
6.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology
> BlackBerry Domain > Component view > Attachment > Connector.
Click one of the BlackBerry Attachment Connector instances.
On the Instance information tab, locate either the Supported MDS Connection Service instance names section or the
Supported Email instances names section. Consider the following naming conventions:
•
If you locate the section that is named Supported MDS Connection Service instance names, the BlackBerry MDS
Connection Service connects to this BlackBerry Attachment Connector instance.
•
If you locate the section that is named Supported Email instances names, the BlackBerry Enterprise Server connects
to this BlackBerry Attachment Connector instance.
Click Edit instance.
Perform one of the following actions:
•
If the BlackBerry MDS Connection Service connects to the BlackBerry Attachment Connector instance, in the Instance
information section, in the Friendly name field, type a unique name (for example, <server_name>_AC_MDSCS).
•
If the BlackBerry Enterprise Server uses the BlackBerry Attachment Connector instance, in the Instance
information section, in the Friendly name field, type a unique name (for example, <server_name>_AC_BES).
Click Save all.
67
Installation and Configuration Guide
Users experience unexpected behavior with message lists and calendars on BlackBerry devices
The BlackBerry Administration Service updates the list of BlackBerry Attachment Connector instances automatically to use the
names that you typed.
Users experience unexpected behavior with message lists and calendars on
BlackBerry devices
Possible cause
If the MAPI and CDO client version 6.5.8022 was installed without uninstalling previous versions of the MAPI and CDO client
(including the associated .DLL files), users might experience unexpected behavior with message lists and calendars on
BlackBerry® devices.
Possible solution
For more information about Microsoft® Exchange Server MAPI Client and CDO version 1.2.1, visit www.microsoft.com.
1.
2.
3.
4.
5.
6.
In the Windows® Services, stop the services for the BlackBerry® Enterprise Server and any processes that use the MAPI and
CDO client.
Remove the MAPI and CDO client version 6.5.8022.
Verify that the following files are not present in C:\Windows\System32 or any other directory in the environment path:
•
CDO.DLL
•
EMSABP32.DLL
•
EMSMDB32.DLL
•
EMSUI32.DLL
•
EMSUIX32.DLL
•
GAPI32.DLL
•
MAPISP32.EXE
•
MSPST32.DLL
•
WMSUI32.DLL
In C:\Windows\System32, run the FixMapi.exe application.
Install the MAPI and CDO client version 6.5.8022.
Restart the services for the BlackBerry Enterprise Server and any processes that use the MAPI and CDO client.
If you run the BlackBerry Enterprise Server setup application after you complete the possible solution, when the setup application
displays the preinstallation checklist, an error message indicates that the setup application could not detect the MAPI and CDO
client. The setup application displays this error message because you installed the MAPI and CDO client version 6.5.8022 in a
different directory than the directory that you installed it in for previous versions. The error mesage does not prevent the BlackBerry
Enterprise Server setup application from completing the installation process successfully.
68
Various BlackBerry Enterprise Server components do not start
Installation and Configuration Guide
Various BlackBerry Enterprise Server components do not start
Possible cause
Possible solution
The BlackBerry® Administration
Service, BlackBerry MDS Connection
Service, BlackBerry MDS Integration
Service, or BlackBerry Collaboration
Service is configured to use a dynamic
port when it connects to the BlackBerry
Configuration Database, but the
database server uses a static port.
Configure a static port for the BlackBerry Configuration Database.
1.
On the computer that hosts the BlackBerry® Enterprise Server component, on
the taskbar, click Start > Programs > BlackBerry Enterprise Server >
BlackBerry Server Configuration.
2.
On the Database Connectivity tab, clear the Use dynamic ports or specify
SQL port check box.
3.
Type the port number in the Use dynamic ports or specify SQL port field.
4.
Click OK.
5.
In the Windows® Services, restart the services for the BlackBerry Enterprise
Server component.
The BlackBerry Administration Service, Configure the component to use the correct port number.
BlackBerry MDS Connection Service,
BlackBerry MDS Integration Service, or 1. On the computer that hosts the BlackBerry Enterprise Server component, on
the taskbar, click Start > Programs > BlackBerry Enterprise Server >
BlackBerry Collaboration Service is
BlackBerry Server Configuration.
configured to use an incorrect static port
2. Type the correct port number in the Use dynamic ports or specify SQL
number when it connects to the
port field.
BlackBerry Configuration Database.
3. Click OK.
4.
In the Windows Services, restart the services for the BlackBerry Enterprise
Server component.
Could not create a user account in the BlackBerry Administration Service
Possible cause
The BlackBerry® Administration Service is configured to use static ports when it connects to the BlackBerry Configuration
Database server, but the BlackBerry Configuration Database server uses a dynamic port.
Possible solution
Configure the BlackBerry Administration Service to use a dynamic port for the BlackBerry Configuration Database.
69
Installation and Configuration Guide
1.
2.
3.
4.
The BlackBerry Administration Service pool name is the same as the FQDN of the host computer
On the computer that hosts the BlackBerry® Enterprise Server or BlackBerry Enterprise Server components, on the taskbar,
click Start > Programs > BlackBerry Enterprise Server > BlackBerry Server Configuration.
On the Database Connectivity tab, select the Use dynamic ports or specify SQL port check box.
Click OK.
In the Windows® Services, restart the services for the BlackBerry Administration Service.
The BlackBerry Administration Service pool name is the same as the FQDN
of the host computer
Possible cause
A DNS record was not created before a BlackBerry® Administration Service instance was installed.
Possible solution
1. Create the DNS record for the BlackBerry Administration Service instance.
2. On the computer that hosts the BlackBerry Administration Service instance, on the taskbar, click Start > Programs >
BlackBerry Enterprise Server > BlackBerry Server Configuration.
3. On the Administration Service - High Availability tab, in the Pool name field, type the name of the BlackBerry
Administration Service pool.
4. In the Windows® Services, restart the services for the BlackBerry Administration Service.
70
Installation and Configuration Guide
Glossary
Glossary
12
AJAX
Asynchronous JavaScript® and XML
BlackBerry Client Access License
A BlackBerry® Client Access License (BlackBerry CAL) limits how many users you can add to a BlackBerry® Enterprise Server.
BlackBerry Domain
A BlackBerry Domain consists of the BlackBerry Configuration Database with its users and any BlackBerry® Enterprise Server
instances that connect to it.
BlackBerry Enterprise Server databases
The BlackBerry® Enterprise Server databases are the BlackBerry Configuration Database, the BlackBerry MDS Integration
Service database, and the BlackBerry Monitoring Service database.
BlackBerry MDS
BlackBerry® Mobile Data System
CDO
Collaboration Data Object
DMZ
A demilitarized zone (DMZ) is a neutral subnetwork outside of an organization's firewall. It exists between the trusted LAN
of the organization and the untrusted external wireless network and public Internet.
DNS
Domain Name System
FQDN
fully qualified domain name
HTTPS
Hypertext Transfer Protocol over Secure Sockets Layer
IIS
Internet Information Services
IP
Internet Protocol
IP address
71
Installation and Configuration Guide
Glossary
An Internet Protocol (IP) address is an identification number that each computer or mobile device uses when it sends or
receives information over a network, such as the Internet. This identification number identifies the specific computer or
mobile device on the network.
ISAPI
Internet Server Application Programming Interface
JDK
Java® Development Kit
JRE
Java® Runtime Environment
LAN
local area network
LDAP
Lightweight Directory Access Protocol
MAPI
Messaging Application Programming Interface
messaging server
A messaging server sends and processes messages and provides collaboration services, such as updating and communicating
calendar and address book information.
MSDE
Microsoft® SQL Server® Desktop Engine
MTLS
Mutual Transport Layer Security
SMS
Short Message Service
SNMP
Simple Network Management Protocol
SQL
Structured Query Language
SRP
Server Routing Protocol
SSL
72
Installation and Configuration Guide
Glossary
Secure Sockets Layer
TCP/IP
Transmission Control Protocol/Internet Protocol (TCP/IP) is a set of communication protocols that is used to transmit data
over networks, such as the Internet.
TLS
Transport Layer Security
XML
Extensible Markup Language
73
Installation and Configuration Guide
Provide feedback
To provide feedback on this deliverable, visit www.blackberry.com/docsfeedback.
74
Provide feedback
13
Installation and Configuration Guide
Legal notice
Legal notice
14
©2009 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType®, SurePress™ and
related trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S.
and countries around the world.
IBM, Lotus, and Sametime are trademarks of International Business Machines Corporation. Java, JavaScript, and JRE are
trademarks of Sun Microsystems, Inc. Microsoft, Active Directory, ActiveX, Internet Explorer, Outlook, SQL Server, Windows,
Windows Media, and Windows Server are trademarks of Microsoft Corporation. Novell and GroupWise are trademarks of Novell,
Inc. RSA is a trademark of RSA Security. VMware is a trademark of VMware, Inc. All other trademarks are the property of their
respective owners.
The BlackBerry smartphone and other devices 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 the U.S. and in various countries around the world.
Visit www.rim.com/patents for a list of RIM (as hereinafter defined) patents.
This documentation including all documentation incorporated by reference herein such as documentation provided or made
available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition,
endorsement, guarantee, representation, or warranty of any kind by Research In Motion Limited and its affiliated companies
("RIM") and RIM assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this
documentation. In order to protect RIM proprietary and confidential information and/or trade secrets, this documentation may
describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information that
is contained in this documentation; however, RIM makes no commitment to provide any such changes, updates, enhancements,
or other additions to this documentation to you in a timely manner or at all.
This documentation might contain references to third-party sources of information, hardware or software, products or services
including components and content such as content protected by copyright and/or third-party web sites (collectively the "Third
Party Products and Services"). RIM does not control, and is not responsible for, any Third Party Products and Services including,
without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency,
links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services
in this documentation does not imply endorsement by RIM of the Third Party Products and Services or the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS,
ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF
DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE QUALITY, NONINFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING
OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE
OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN, ARE
HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR PROVINCE. SOME JURISDICTIONS
MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT
75
Installation and Configuration Guide
Legal notice
PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT
THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM
THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL RIM BE LIABLE
FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NONPERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED
HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY,
INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES,
FAILURE TO REALIZE ANY EXPECTED SAVINGS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF
BUSINESS OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS
ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM PRODUCTS OR SERVICES, DOWNTIME COSTS,
LOSS OF THE USE OF RIM PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF
SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR PECUNIARY
LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF RIM HAS BEEN ADVISED
OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL HAVE NO OTHER
OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING ANY LIABILITY
FOR NEGLIGENCE OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF THE
CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT, NEGLIGENCE,
TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES
OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN; AND (B)
TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS, SUPPLIERS (INCLUDING AIRTIME
SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR
RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR, EMPLOYEE,
AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY
ARISING FROM OR RELATED TO THE DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your
airtime service provider has agreed to support all of their features. Some airtime service providers might not offer Internet browsing
functionality with a subscription to the BlackBerry® Internet Service. Check with your service provider for availability, roaming
arrangements, service plans and features. Installation or use of Third Party Products and Services with RIM's products and services
may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party
rights. You are solely responsible for determining whether to use Third Party Products and Services and if any third party licenses
are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and
Services until all necessary licenses have been acquired. Any Third Party Products and Services that are provided with RIM's
products and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions,
endorsements, guarantees, representations, or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relation
thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of separate
licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other
agreement with RIM.
76
Installation and Configuration Guide
Legal notice
Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® Desktop
Software, and/or BlackBerry® Device Software.
The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto.
NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES
PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.
Certain features outlined in this documentation might require additional development or Third Party Products and Services for
access to corporate applications.
This product contains a modified version of HTML Tidy. Copyright © 1998-2003 World Wide Web Consortium (Massachusetts
Institute of Technology, European Research Consortium for Informatics and Mathematics, Keio University). All Rights Reserved.
This product includes software developed by the Apache Software Foundation (www.apache.org/) and/or is licensed pursuant
to one of the licenses listed at (www.apache.org/licenses/). For more information, see the NOTICE.txt file included with the
software.
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
Published in Canada
77
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement