Blackbe;rry AH0QIKO - Lotus Domino Enterprise Server Installation and operation manual

BlackBerry Enterprise Server for
IBM Lotus Domino
Version: 5.0 | Service Pack: 3
Upgrade Guide

Published: 2011-07-29
SWDT561575-1649561-0729024836-001

Contents
1 Revision history................................................................................................................................................. 5
2 Overview: BlackBerry Enterprise Server........................................................................................................... 6
3Planning a BlackBerry Enterprise Server upgrade............................................................................................ 7
Supported BlackBerry Enterprise Server versions that you can upgrade......................................................... 7
Replacing the BlackBerry Manager with the BlackBerry Administration Service............................................. 7
Upgrade implications for the BlackBerry Configuration Database................................................................... 8
Synchronizing data over the wireless network automatically.......................................................................... 8
Upgrade application for BlackBerry Enterprise Server..................................................................................... 8
Upgrading the BlackBerry Enterprise Server if your organization's environment includes BlackBerry Mobile
Voice System 4.6............................................................................................................................................... 9
4Hardware requirements: BlackBerry Enterprise Server.................................................................................... 10
5 System requirements........................................................................................................................................ 12
System requirements: BlackBerry Enterprise Server........................................................................................ 12
System requirements: BlackBerry Administration Service and BlackBerry Web Desktop Manager................ 13
System requirements: BlackBerry Enterprise Server databases....................................................................... 14
System requirements: BlackBerry Attachment Service.................................................................................... 15
System requirements: BlackBerry Collaboration Service.................................................................................. 16
System requirements: BlackBerry MDS Connection Service............................................................................ 18
System requirements: BlackBerry Monitoring Service..................................................................................... 19
System requirements: BlackBerry Router......................................................................................................... 19
System requirements for your organization's environment............................................................................. 20
System requirements: Browsers for BlackBerry Web Desktop Manager, BlackBerry Administration Service,
and BlackBerry Monitoring Service users......................................................................................................... 20
System requirements: Messaging server.......................................................................................................... 21
System requirements: Email applications for users.......................................................................................... 22
System requirements: Firewall......................................................................................................................... 22
System requirements: Instant messaging server.............................................................................................. 22
Supported features and environments............................................................................................................. 23
Unsupported environments.............................................................................................................................. 23
6 Preupgrade tasks.............................................................................................................................................. 25
Configuring a messaging environment............................................................................................................. 25
Configure a group for the BlackBerry Enterprise Server........................................................................... 25

Configure the Server document to permit the BlackBerry Enterprise Server to move user accounts
within a BlackBerry Domain...................................................................................................................... 25
Configuring connections for the BlackBerry Enterprise Server databases....................................................... 25
Specifying permissions when you connect to the BlackBerry Enterprise Server databases using
Windows authentication or Microsoft SQL Server authentication............................................................ 26
Configuring the local system account in an IBM Lotus Domino environment.......................................... 27
Resolving IT policy and application control policy conflicts in a mixed version environment.......................... 27
Resolve IT policy and application control policy conflicts in a mixed version environment...................... 28
Backing up the BlackBerry Enterprise Server databases.................................................................................. 28
Back up the BlackBerry Enterprise Server databases................................................................................ 28
Removing the BlackBerry MDS Integration Service.......................................................................................... 29
Run the CreateDB executable to remove the BlackBerry MDS Integration Service.................................. 31
Upgrade implications for VoIP profiles............................................................................................................. 33
Delete a VoIP profile.................................................................................................................................. 34
Install the SNMP service for monitoring by the BlackBerry Monitoring Service.............................................. 34
Creating a BlackBerry Administration Service pool using DNS round robin that includes the BlackBerry
Web Desktop Manager..................................................................................................................................... 34
Create the DNS record for a BlackBerry Administration Service instance........................................................ 35
Preparing the computer that hosts the BlackBerry Collaboration Service for use with Microsoft Office
Communications Server 2007 R2...................................................................................................................... 36
Preparing the computer that hosts the BlackBerry Collaboration Service for use with Microsoft Lync
Server 2010....................................................................................................................................................... 37
Applications that are installed with the BlackBerry Enterprise Server components........................................ 38
Prerequisites: Upgrading the BlackBerry Enterprise Server software.............................................................. 38
Performing a test upgrade of the BlackBerry Configuration Database............................................................ 40
Perform a test upgrade of the BlackBerry Configuration Database.......................................................... 40
7 Upgrading the BlackBerry Enterprise Server software by using the in-place upgrade process........................ 42
Upgrade the BlackBerry Enterprise Server software by overwriting the existing version and using the
existing BlackBerry Configuration Database..................................................................................................... 42
Specifying a name for the BlackBerry Administration Service pool during the installation process......... 44
Upgrade the BlackBerry Enterprise Server instances that you configured for disaster recovery..................... 45
8 Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrade the existing
BlackBerry Configuration Database.................................................................................................................. 46
Upgrade a BlackBerry Configuration Database................................................................................................. 46
BESMgmt.cfg properties............................................................................................................................ 47
Install the BlackBerry Enterprise Server on a new computer and upgrade the existing BlackBerry
Configuration Database.................................................................................................................................... 48

Specifying a name for the BlackBerry Administration Service pool during the installation process......... 50
Move user accounts to a new BlackBerry Enterprise Server using the BlackBerry Administration Service..... 50
Prevent the previous BlackBerry Enterprise Server from connecting to the BlackBerry Infrastructure........... 51
Start the new BlackBerry Enterprise Server...................................................................................................... 51
9 Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and create a BlackBerry
Configuration Database.................................................................................................................................... 52
Create a BlackBerry Configuration Database.................................................................................................... 52
BESMgmt.cfg properties............................................................................................................................ 53
Install the BlackBerry Enterprise Server on a new computer and create a new BlackBerry Configuration
Database........................................................................................................................................................... 54
Specifying a name for the BlackBerry Administration Service pool during the installation process......... 56
10 Upgrading the BlackBerry Enterprise Server software in phases..................................................................... 57
Upgrade multiple BlackBerry Enterprise Server instances in phases............................................................... 57
Upgrade a standalone BlackBerry Router......................................................................................................... 58
Test the connection from the BlackBerry Router to the BlackBerry Infrastructure.................................. 59
11 Postupgrade tasks............................................................................................................................................. 60
Resend the database mirroring parameters to BlackBerry Enterprise Server components............................. 60
Restore the BlackBerry MDS Connection Service configuration files............................................................... 60
Upgrade the BlackBerry database notification system..................................................................................... 61
Best practice: Running the BlackBerry Enterprise Server................................................................................. 62
Configure the BlackBerry Administration Service instances in a pool to communicate across network
subnets............................................................................................................................................................. 63
Log in to the BlackBerry Administration Service for the first time................................................................... 63
There is a problem with this website's security certificate....................................................................... 63
Change applications to support BlackBerry MDS Connection Service failover................................................. 64
Configuring support for new attachments....................................................................................................... 65
Configure an upgraded BlackBerry Enterprise Server to support new attachment extensions................ 65
Configure an upgraded BlackBerry Attachment Service to support new attachment distillers................ 65
Assigning an IT policy to a group...................................................................................................................... 66
Remove an IT policy from a user account.................................................................................................. 66
Restrict database permissions for the BlackBerry Attachment Service............................................................ 66
Configuring minimum Microsoft SQL Server permissions for the Windows account....................................... 67
Configure minimum Microsoft SQL Server permissions for the Windows account.................................. 68
Configuring a computer for monitoring............................................................................................................ 68
Configure the SNMP service for monitoring.............................................................................................. 68
Configure the BlackBerry Monitoring Service to monitor a BlackBerry Enterprise Server........................ 69

Configure the BlackBerry Mail Store Service to use a local system account.................................................... 69
Store database credentials for the local system account................................................................................. 70
Provisioning the BlackBerry Collaboration Service as a trusted application.................................................... 70
Manually provision the BlackBerry Collaboration Service as a trusted application.................................. 71
Turn off automatic provisioning of the BlackBerry Collaboration Service as a trusted application.......... 71
12 Troubleshooting the BlackBerry Enterprise Server upgrade process............................................................... 73
Failed to write License Key to the Database..................................................................................................... 73
Previous version detected but no database available...................................................................................... 73
Could not open ID file....................................................................................................................................... 73
Attempt to establish connection failed with security reason "3"..................................................................... 74
You encounter errors when you try to upgrade the BlackBerry Configuration Database................................ 74
You cannot resolve errors that occur when you move users........................................................................... 74
A third-party tool did not install and the BlackBerry Enterprise Server setup application closed................... 74
The BlackBerry Monitoring Service cannot monitor events............................................................................. 75
Restore a BlackBerry Configuration Database.................................................................................................. 75
Various BlackBerry Enterprise Server components do not start...................................................................... 76
You cannot access the BlackBerry Administration Service............................................................................... 76
You cannot create a user account in the BlackBerry Administration Service................................................... 77
The BlackBerry Administration Service pool name is the same as the FQDN of the host computer................ 77
IBM Lotus Domino takes a long time to complete cluster replication.............................................................. 78
Some web services do not function correctly after upgrading the BlackBerry Enterprise Server for IBM
Lotus Domino.................................................................................................................................................... 78
13 Glossary............................................................................................................................................................ 79
14 Provide feedback.............................................................................................................................................. 83
15 Legal notice....................................................................................................................................................... 84

Revision history 1
Date Description
29 July 2011 Updated the following topics:
• Unsupported environments
• Upgrade the BlackBerry Enterprise Server software by overwriting the
existing version and using the existing BlackBerry Configuration
Database
• Install the BlackBerry Enterprise Server on a new computer and
upgrade the existing BlackBerry Configuration Database
9 May 2011 Updated the following topics:
• 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 Monitoring Service
• System requirements: BlackBerry Router
• Supported features and environments
• Preparing the computer that hosts the BlackBerry Collaboration
Service for use with Microsoft Lync Server 2010
• Upgrade the BlackBerry Enterprise Server software by overwriting the
existing version and using the existing BlackBerry Configuration
Database
• Install the BlackBerry Enterprise Server on a new computer and
upgrade the existing BlackBerry Configuration Database
• Install the BlackBerry Enterprise Server on a new computer and create
a new BlackBerry Configuration Database
11 March 2011 Initial version
Upgrade Guide Revision history
5

Overview: BlackBerry Enterprise Server 2
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 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 devices. You can select
from more than 450 IT policy rules that you can configure to control the features of the 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 devices using
the BlackBerry instant messaging client. You can use the BlackBerry Monitoring Service to monitor and troubleshoot
issues with BlackBerry Enterprise Server instances and monitor the activity of device users. 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, devices, and user accounts using the BlackBerry Administration
Service, a web application that is accessible from any computer that can access the computer that hosts the BlackBerry
Administration Service. You can use the BlackBerry Administration Service to manage a BlackBerry Domain, which
consists of one or more BlackBerry Enterprise Server instances and remote components that use a single BlackBerry
Configuration Database.
Upgrade Guide Overview: BlackBerry Enterprise Server
6

Planning a BlackBerry Enterprise Server
upgrade
3
If your organization's environment includes only one BlackBerry® Enterprise Server that is version 4.1 SP7 or later,
you can upgrade the BlackBerry Enterprise Server to the latest version by overwriting it or by installing it on a different
computer and moving the user data to the upgraded BlackBerry Enterprise Server.
If your organization's environment includes more than one BlackBerry Enterprise Server that is version 4.1 SP7 or
later, you can upgrade each BlackBerry Enterprise Server instance to the latest version in phases to reduce the risk
to your organization's environment and minimize the number of users that the upgrade might affect at the same
time.
For information about upgrading more than one BlackBerry Enterprise Server, see the BlackBerry Enterprise Server
Upgrade Planning Guide.
Supported BlackBerry Enterprise Server versions that you
can upgrade
You can upgrade the following BlackBerry® Enterprise Server versions to the latest version:
• BlackBerry Enterprise Server 5.0 or later
• BlackBerry Enterprise Server 4.1 SP7
If your organization has a BlackBerry Enterprise Server version that is not listed, you must first upgrade to one of the
BlackBerry Enterprise Server versions in the list above before you can upgrade to the latest version.
Replacing the BlackBerry Manager with the BlackBerry
Administration Service
In BlackBerry® Enterprise Server versions later than version 4.1, the BlackBerry Administration Service replaces the
BlackBerry Manager as the BlackBerry Enterprise Server component that you use to manage the BlackBerry Enterprise
Server and BlackBerry device users.
During the BlackBerry Enterprise Server upgrade process, the setup application removes the BlackBerry Manager. If
you installed a standalone BlackBerry Manager, you can remove the BlackBerry Manager after you install the
BlackBerry Administration Service.
After the BlackBerry Enterprise Server upgrade process completes, you must create administrator accounts for the
administrators in your organization and provide the administrators with new login information and the BlackBerry
Administration Service web address. If you try to run the BlackBerry Manager, it displays the "DB version greater
than maximum currently supported" message and closes.
Upgrade Guide Planning a BlackBerry Enterprise Server upgrade
7

Upgrade implications for the BlackBerry Configuration
Database
When you upgrade the BlackBerry® Enterprise Server to the latest version, you must also upgrade the BlackBerry
Configuration Database to the latest version. You can use the setup application to install or upgrade BlackBerry
Enterprise Server components such as the BlackBerry Configuration Database. The installation or upgrade process
upgrades the BlackBerry Configuration Database automatically so that the database and components run the same
version. If you do not want to use the setup application to upgrade the BlackBerry Configuration Database, you can
run the database upgrade scripts on the database server.
You cannot manage the BlackBerry Enterprise Server until you install the BlackBerry Administration Service version
that is the same as the BlackBerry Configuration Database version or upgrade the BlackBerry Administration Service
so that it is the same version as the BlackBerry Configuration Database.
You must move an MSDE database such as a BlackBerry Configuration Database from MSDE to a version of Microsoft®
SQL Server® that Microsoft fully supports. To upgrade a BlackBerry Configuration Database and move it from MSDE
to Microsoft SQL Server, you must create a copy of the BlackBerry Configuration Database, move the copy to Microsoft
SQL Server, and then upgrade the BlackBerry Configuration Database on the Microsoft SQL Server to the latest version.
BlackBerry® Enterprise Server for IBM® Lotus® Domino® versions 5.0 SP1 or later do not support the IBM® DB2® UDB.
Synchronizing data over the wireless network
automatically
When you upgrade the BlackBerry® Enterprise Server, the BlackBerry Synchronization Service sends updated service
books to the BlackBerry devices that can synchronize data over the wireless network. BlackBerry® Device Software
versions 4.0 and later can synchronize data automatically if the BlackBerry Enterprise Server is running.
If the data does not synchronize automatically, you must use the BlackBerry Administration Service to resend the
service books and synchronize the data.
Upgrade application for BlackBerry Enterprise Server
You can install or upgrade the BlackBerry® Enterprise Server, including service packs, by running the setup application.
You can also upgrade the BlackBerry Enterprise Server to a service pack by running the upgrade application for
BlackBerry Enterprise Server, which is available for download from www.blackberry.com/support.
If the BlackBerry Configuration Database is version 5.0 or later in the BlackBerry Domain, you can use the upgrade
application for BlackBerry Enterprise Server 5.0 SP3 to perform any of the following tasks:
• upgrade a BlackBerry Enterprise Server that is version 4.1 SP7 or later to version 5.0 SP3
• install a BlackBerry Enterprise Server or BlackBerry Enterprise Server components on a computer in the
BlackBerry Domain that does not already host a BlackBerry Enterprise Server instance or component
Upgrade Guide Upgrade implications for the BlackBerry Configuration Database
8