Blackbe;rry PROFESSIONAL SOFTWARE FOR IBM LOTUS DOMINO Installation and operation manual

Upgrade Guide
BlackBerry Professional Software for IBM Lotus Domino
Version: 4.1 | Service Pack: 4

SWD-355976-0912085220-001

Contents
1Upgrading from the BlackBerry Professional Software to the BlackBerry Enterprise Server............................ 5
Feature comparison for the BlackBerry Professional Software and the BlackBerry Enterprise Server......................... 5
Host server and database upgrade scenarios......................................................................................................................... 6
2System requirements.......................................................................................................................................................... 9
System requirements: BlackBerry Enterprise Server............................................................................................................. 9
System requirements: BlackBerry Attachment Service......................................................................................................... 12
System requirements: BlackBerry Manager............................................................................................................................ 12
System requirements: BlackBerry MDS Connection Service................................................................................................ 14
System requirements: BlackBerry MDS Integration Service................................................................................................ 14
System requirements: BlackBerry Router................................................................................................................................ 15
Supported environments............................................................................................................................................................ 15
Unsupported environments....................................................................................................................................................... 17
3 Preparing to upgrade from the BlackBerry Professional Software to the BlackBerry Enterprise Server......... 19
Obtain the BlackBerry Enterprise Server software files........................................................................................................ 19
Verify and record the name of the existing host computer for the BlackBerry Professional Software.......................... 19
Verify and record the name of the administration account for the BlackBerry Professional Software......................... 19
Verify the names of the existing BlackBerry Configuration Database and its host computer........................................ 20
Verify the existing SRP authentication information.............................................................................................................. 20
Verify the existing CAL key........................................................................................................................................................ 20
Back up the BlackBerry Professional Software registry settings......................................................................................... 21
Back up the BlackBerry Professional Software log files........................................................................................................ 21
Back up the BlackBerry Configuration Database................................................................................................................... 21
BlackBerry Configuration Database Backup Tool parameters......................................................................................... 23
Back up IBM Lotus Domino server information...................................................................................................................... 24
4 Setting up the database connection............................................................................................................................... 25
Using the existing BlackBerry Configuration Database after the upgrade to the BlackBerry Enterprise Server........ 25
Specifying permissions when connecting to the BlackBerry Enterprise Server databases using Windows
authentication.............................................................................................................................................................................. 25
Assign Microsoft SQL Server permissions to the Microsoft Windows account.............................................................. 25
Assign IBM DB2 UDB permissions to a local system account.......................................................................................... 26
Configuring authentication to the BlackBerry MDS Integration Service database.......................................................... 26

Configuring the local system account...................................................................................................................................... 26
Configure the local system account for Microsoft Windows authentication................................................................. 26
Configuring the local system account for database authentication............................................................................... 27
Create Microsoft Windows groups for administrators in an IBM DB2 UDB environment............................................... 28
Configure authentication to the BlackBerry Configuration Database and BlackBerry MDS Integration Service
database in an IBM DB2 UDB environment............................................................................................................................ 28
5Performing the upgrade from the BlackBerry Professional Software to the BlackBerry Enterprise Server on
the existing host computer............................................................................................................................................... 29
Prerequisites: Upgrading from the BlackBerry Professional Software to the BlackBerry Enterprise Server on the
existing host computer............................................................................................................................................................... 29
Stop the BlackBerry Professional Software services.............................................................................................................. 29
Stop the IBM Lotus Domino server........................................................................................................................................... 30
Upgrade from the BlackBerry Professional Software to the BlackBerry Enterprise Server on the existing host
computer....................................................................................................................................................................................... 30
Improve the startup performance of the BlackBerry Enterprise Server after the upgrade.............................................. 31
6Performing the upgrade from the BlackBerry Professional Software to the BlackBerry Enterprise Server on
a new host computer.......................................................................................................................................................... 33
Prerequisites: Upgrading from the BlackBerry Professional Software to the BlackBerry Enterprise Server on a new
host computer.............................................................................................................................................................................. 33
Moving the BlackBerry Configuration Database to the new host computer..................................................................... 33
Stop the BlackBerry Professional Software services.............................................................................................................. 34
Stop the IBM Lotus Domino server........................................................................................................................................... 34
Upgrade from the BlackBerry Professional Software to the BlackBerry Enterprise Server on a new host computer
........................................................................................................................................................................................................ 34
Improve the startup performance of the BlackBerry Enterprise Server after the upgrade.............................................. 35
7 Troubleshooting the BlackBerry Enterprise Server upgrade process...................................................................... 37
A third-party tool did not install successfully and the BlackBerry Enterprise Server setup application closed.......... 37
Previous version detected but no database available............................................................................................................ 37
The BlackBerry Collaboration Service does not connect to Microsoft Office Live Communications Server 2005...... 38
You cannot resolve errors that occur when you move users................................................................................................. 38
You encounter errors when you try to upgrade the BlackBerry Configuration Database............................................... 38
The setup application prompts you for access to the installation media for Microsoft .NET Framework version 1.1
........................................................................................................................................................................................................ 39

Restore the BlackBerry Configuration Database.................................................................................................................... 39
8 Upgrading the BlackBerry Device Software.................................................................................................................. 43
Permitting users to upgrade the BlackBerry Device Software from their computers....................................................... 43
Configure a network drive...................................................................................................................................................... 44
Save the BlackBerry Device Software installation files to the network drive................................................................ 44
Verify the version of the application loader tool................................................................................................................ 44
Pushing the BlackBerry Desktop Software or BlackBerry Device Manager installation files to users' computers
.................................................................................................................................................................................................... 44
Synchronizing wireless data automatically......................................................................................................................... 45
Create the BlackBerry Device Software upgrade instructions for BlackBerry device users........................................ 45
Confirming that the BlackBerry Device Software upgrade process completed successfully...................................... 46
Upgrading the BlackBerry Device Software at a central computer.................................................................................... 46
Configure a network drive...................................................................................................................................................... 47
Save the BlackBerry Device Software installation files to the network drive................................................................ 47
Create a software configuration for the BlackBerry Device Software............................................................................ 47
Assign the software configuration to a user account........................................................................................................ 48
Upgrade the BlackBerry Device Software at a central computer.................................................................................... 48
Verify that the BlackBerry Device Software upgrade at a central computer completed successfully....................... 48
Pushing the BlackBerry Device Software and the BlackBerry Desktop Software to users' computers......................... 49
Configure a network drive...................................................................................................................................................... 49
Save the BlackBerry Device Software installation files to the network drive................................................................ 49
Save the BlackBerry Desktop Software installation files to the network drive............................................................. 50
Synchronizing wireless data automatically......................................................................................................................... 50
Send the installation files for the BlackBerry Desktop Software and the BlackBerry Device Software to users using
a third-party application........................................................................................................................................................ 50
Confirming that the BlackBerry Device Software upgrade process completed successfully...................................... 51
9 Troubleshooting the BlackBerry Device Software upgrade process........................................................................ 53
When users click the link to the application loader tool in the upgrade instructions, the upgrade process does not
start................................................................................................................................................................................................ 53
10 Glossary................................................................................................................................................................................ 55
11 Legal notice.......................................................................................................................................................................... 57

Upgrading from the BlackBerry Professional Software to
the BlackBerry Enterprise Server 1
Your organization can upgrade from the BlackBerry® Professional Software to a supported higher version of the BlackBerry®
Enterprise Server. The decision to upgrade might be influenced by factors such as the following:
• The number of BlackBerry device users in your organization is approaching the maximum of 30 users.
• The number of users or administrators in your organization requires group-based or role-based administration.
• Users need access to applications that were developed using the BlackBerry® MDS Studio or the BlackBerry® Plug-
in for Microsoft® Visual Studio®.
• Users want to use collaboration clients, such as the BlackBerry® Client for IBM® Lotus® Connections.
Feature comparison for the BlackBerry Professional Software and the
BlackBerry Enterprise Server
Feature BlackBerry Professional Software BlackBerry Enterprise Server
supported database engines • Microsoft® SQL Server®
• Microsoft® SQL Server® 2005
Express
• MSDE 2000
• Microsoft SQL Server
• Microsoft SQL Server 2005
Express (not supported by the
BlackBerry® MDS Integration
Service)
• MSDE 2000
• IBM® DB2® UDB
installationpossibleonmessagingserver yes no
support for remote components no yes
BlackBerry MDS Runtime Application
support
no yes
support for collaboration clients no yes
BlackBerry Manager highlights the tasks that administrators
in smaller organizations most
frequently perform
full enterprise administration
number of users maximum of 30 users limited only by the scalability of the
system configuration
users Add Users wizard add users manually
Upgrade Guide Upgrading from the BlackBerry Professional Software to the BlackBerry Enterprise Server
5

Feature BlackBerry Professional Software BlackBerry Enterprise Server
groups user administration only group administration or user
administration
roles user administration only role-based administration
IT policy predefined IT policy bundles custom IT policies only
domains single domain only multiple domain administration
support for Wi-Fi® connections no yes
support for BlackBerry® Enterprise
Server Resource Kit
no yes
Host server and database upgrade scenarios
Hardware Scenario
host server The BlackBerry® Professional Software must be installed on the computer where you plan
to install the BlackBerry® Enterprise Server software.
• If the BlackBerry Professional Software is currently installed on a computer that is
separate from the messaging server, you can upgrade to the BlackBerry Enterprise
Server on the same computer.
• If the BlackBerry Professional Software is currently installed on the computer that
hoststhemessagingserver,youmustfirstinstallthe BlackBerry Professional Software
on the computer where you plan to install the BlackBerry Enterprise Server software.
You can then upgrade to the BlackBerry Enterprise Server on this computer.
•If you plan to install the BlackBerry Enterprise Server components on more than one
computer, you must install the BlackBerry Professional Software on each computer
that you plan to use. You can then upgrade to the BlackBerry Enterprise Server on
each computer.
database • If the computer that hosts the messaging server currently also hosts the BlackBerry
Configuration Database, you do not have to move the BlackBerry Configuration
Database when you upgrade to the BlackBerry Enterprise Server.
• If you plan to move the existing BlackBerry Configuration Database to a new
Microsoft® SQL Server®, you must perform the move before you begin the upgrade
process.
Upgrade Guide Host server and database upgrade scenarios
6

Hardware Scenario
•If the BlackBerry Configuration Database is currently installed on a computer that is
separate from the messaging server, you can configure the connection to the
BlackBerry Configuration Database during the BlackBerry Enterprise Server upgrade
process.
• If you are adding a large number of users, or if you expect a significant increase in
the number of email messages that users send and receive, consider moving the
BlackBerry Configuration Database to its own host computer. You perform this move
before you begin the upgrade process.
For information about moving the BlackBerry Configuration Database, visit
www.blackberry.com/support to read article KB03112.
Upgrade Guide Host server and database upgrade scenarios
7

System requirements 2
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.
System requirements: BlackBerry Enterprise Server
Item Requirement
operating system Any of the following operating systems:
• Windows® 2000 SP4 Server or Advanced Server
• Windows Server® 2003 or later
• Windows Server 2003 or later (64-bit)
• Windows Server 2003 R2 SP2
• Windows Server 2003 R2 SP2 (64-bit)
messaging server Any of the following messaging servers installed physically close to where you
plan to install the BlackBerry® Enterprise Server:
• IBM® Lotus® Domino® version 5.0.12
• IBM Lotus Domino version 6.0.4 or later
• IBM Lotus Domino version 6.5.1 or later
• IBM Lotus Domino version 7.0 or later (version 7.0.2 or later required for
HTML email)
• IBM Lotus Domino version 8.0 and 8.0.1
• IBM Lotus Domino Express version 7.0
• IBM Lotus Domino Express version 8.0
notes.ini file A notes.ini file with the following conditions:
• read/write permissions
• SERVERKEYFILENAME value set to the server.id name
messaging server application Any of the following applications installed on the computer that hosts the
BlackBerry Enterprise Server:
• IBM Lotus Domino version 5.0.12 or later
• IBM Lotus Domino version 6.0.1 Critical Fixpack 2 or later with a primary
Domain Directory
Upgrade Guide System requirements
9

Item Requirement
• IBM Lotus Domino version 6.5.4 or later with a primary Domain Directory
• IBM Lotus Domino version 7.0 with a primary Domino Directory (version
7.0.2 or later required for Windows Server 2003 (64-bit))
• IBM Lotus Domino version 8.0 with a primary Domino Directory
• IBM Lotus Domino Express version 7.0
• IBM Lotus Domino Express version 8.0
partitioning of the messaging client a nonpartitioned messaging client
permissions for the messaging server
application
A messaging server application with the following permissions:
• membership in the LocalDomainServers group
•manager-level access to the mail files for BlackBerry device user accounts
email application Any of the following email applications for your organization's users:
• IBM® Lotus Notes® version 5.0.12 or later
• IBM Lotus Notes version 6.0 or later
• IBM Lotus Notes version 6.5 or later
• IBM Lotus Notes version 7.0 (to support encrypted message display when
the user.id file is stored in BlackBerry® Desktop Manager version 4.1)
• IBM Lotus Notes version 8.0
database management system Any of the following database management systems:
• MSDE 2000
• Microsoft® SQL Server® 2000 SP4
• Microsoft SQL Server 2005 or later Professional, Enterprise, or Express
• Microsoft SQL Server 2005 or later (64-bit)
• IBM® DB2® UDB version 8.2 Express or Enterprise Fixpack 5
collation setting Tosupport MicrosoftSQLServer, thefollowingconditionson thedatabaseserver:
• collation setting is default case-insensitive
• BlackBerry Configuration Database collation setting is default case-
insensitive
remote database conditions named pipes and TCP/IP network protocols turned on
data access components Any of the following data access components on the computers that host the
BlackBerry Enterprise Server or the BlackBerry Configuration Database:
• MDAC version 2.8 with Security Patch MS04-003 (version
2000.85.1025.00)
Upgrade Guide System requirements: BlackBerry Enterprise Server
10

Item Requirement
• MDAC version 2.8.2 (version 2000.86.1830.00), included with Windows
Server 2003 SP1
database conditions for the BlackBerry
MDS Integration Service
A database server with the following conditions:
• host for the BlackBerry Configuration Database
• support for mixed-mode authentication
Microsoft® .NET Framework to support languages other than English, localized version of Microsoft .NET
Framework version 1.1 SP1
instant messaging server Any of the following instant messaging servers:
• IBM® Lotus® Sametime® version 6.5.1 Community Server (version 6.5.1 or
later required to support dormant mode)
• 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 required to
support Microsoft® Office Communicator and dormant mode)
• Microsoft® Office Communications Server 2007 Standard or Enterprise
• Novell® GroupWise® Messenger version 2.0.1 or later
browser Microsoft® Internet Explorer® with the following settings:
• Java® or JavaScript® turned on
• language preferences configured to display encoded web pages
media player to support audio attachments, Windows Media® Player version 9 or later
network proximity high-speed, switched connection between the BlackBerry Enterprise Server and
the messaging servers
firewall A firewall or proxy firewall with the following conditions:
• support for the BlackBerry Enterprise Server to initiate an outgoing, two-
way TCP/IP connection to an external server on port 3101
• support for the resolution of Internet addresses using DNS
• transparency of the proxy server for proxy firewalls
Upgrade Guide
11

System requirements: BlackBerry Attachment Service
The following system requirements apply when installing the BlackBerry® Attachment Service on a computer separate from
the BlackBerry® Enterprise Server.
Item Requirement
operating system Any of the following operating systems:
• Microsoft® Windows® 2000 SP4 (Server edition or Advanced Server
edition)
• Microsoft® Windows Server® 2003 SP1
• Microsoft® Windows® XP Professional SP2
media player To support audio attachments, Windows Media® Player Version 9 or later
web browser Microsoft® Internet Explorer® with the following settings:
• Java® or JavaScript® turned on
• language preferences configured to display encoded web pages
System requirements: BlackBerry Manager
The following system requirements apply when installing the BlackBerry® Manager on a computer separate from the
BlackBerry® Enterprise Server.
Item Requirement
operating system Any of the following operating systems:
• Windows® 2000 SP4 (Server, Advanced Server, or Professional)
• Windows Server® 2003 or later
• Windows Server 2003 or later (64-bit)
• Windows Server 2003 R2 SP2
• Windows Server 2003 R2 SP2 (64-bit)
• Windows® XP Professional SP2
notes.ini file A notes.ini file with the following conditions:
• read/write permissions
• the SERVERKEYFILENAME value set to the server.id name
Upgrade Guide System requirements: BlackBerry Attachment Service
12

Item Requirement
messaging server application Any of the following applications:
• IBM® Lotus® Domino® version 5.0.12 or later
•IBM Lotus Domino version 6.0.1 Critical Fixpack 2 or later with the primary
Domino Directory
•IBM Lotus Domino version 6.5.4 or later with the primary Domino Directory
•IBM Lotus Domino version 7.0 with the primary Domino Directory (version
7.0.2 or later required for Windows Server 2003 (64-bit))
• IBM Lotus Domino version 8.0 with a primary Domain Directory
• IBM Lotus Domino Express version 7.0
• IBM Lotus Domino Express version 8.0
• IBM® Lotus Notes® version 5.0.12 or later
• IBM Lotus Notes version 6.0 or later
• IBM Lotus Notes version 6.5 or later
•IBMLotusNotesversion7.0(required tosupportencryptedmessagedisplay
when the user.id file is stored in BlackBerry® Desktop Manager version 4.1)
partitioning of the messaging server
application
a nonpartitioned messaging server application
permissions for the messaging server A messaging server with the following permissions:
• membership in the LocalDomainServers group
• permissions to run the agent
•manager-level access to the mail files for BlackBerry device user accounts
Microsoft® .NET Framework To support languages other than English, localized version of Microsoft .NET
Framework version 1.1 SP1
browser Microsoft® Internet Explorer® with the following settings:
• Java® or JavaScript® turned on
• language preferences set to display encoded web pages
data access components Any of the following data access components:
• MDAC version 2.8 with Security Patch MS04-003 (version
2000.85.1025.00)
• MDAC version 2.8 SP2 (version 2000.86.1830.00)
printer and file sharing To support BlackBerry device implementation, printer and file sharing turned on
Upgrade Guide System requirements: BlackBerry Manager
13

Item Requirement
USB hub To support BlackBerry device implementation that uses a hub, a USB driver that
supports USB 1.1-compliant hubs
System requirements: BlackBerry MDS Connection Service
The following system requirements apply when installing the BlackBerry® MDS Connection Service on a computer separate
from the BlackBerry® Enterprise Server.
Item Requirement
operating system Any of the following operating systems:
• Microsoft® Windows® 2000 SP4 (Server edition, Advanced Server edition,
or Professional edition)
• Microsoft® Windows Server® 2003 SP1
• Microsoft® Windows® XP Professional SP2
RSA® Authentication Agent To support enhanced network authentication, RSA Authentication Agent Version
5.0 for Microsoft Windows
System requirements: BlackBerry MDS Integration Service
The following system requirements apply when installing the BlackBerry® MDS Integration Service on a computer separate
from the BlackBerry® Enterprise Server.
Item Requirement
operating system Any of the following operating systems:
• Microsoft® Windows® 2000 SP4 (Server edition or Advanced Server
edition)
• Microsoft® Windows Server® 2003 SP1
• Microsoft® Windows® XP Professional SP2
database conditions A database server with the following conditions:
• the host for the BlackBerry Configuration Database
• to support IBM® DB2® UDB, mixed-mode authentication turned on
Upgrade Guide System requirements: BlackBerry MDS Connection Service
14

System requirements: BlackBerry Router
The following system requirements apply when installing the BlackBerry® Router on a computer separate from the
BlackBerry® Enterprise Server.
Item Requirement
operating system Any of the following operating systems:
• Microsoft® Windows® 2000 SP4 (Server edition or Advanced Server
edition)
• Microsoft® Windows Server® 2003 SP1
• Microsoft® Windows® XP Professional SP2
firewall A firewall or proxy firewall with the following conditions:
•support for the BlackBerry Router to initiate an outgoing, two-way TCP/IP
connection to an external server on port 3101
• support for the resolution of Internet addresses using DNS
• transparency of the proxy server for proxy firewalls
Supported environments
Item Description
virtual environment The BlackBerry® Enterprise Server and its components support the following
virtual environments:
• VMware® ESX Server Version 2.5.2 or later
• VMware ESX Server Version 3.0.1
Windows® Messenger The BlackBerry Collaboration Service supports Windows® Messenger if MSMQ
Version 3.0 is installed. If installed separately from Microsoft® Windows
Server® 2003, the default Microsoft® Active Directory® Integration and Triggers
subcomponents must be cleared, and only the Common subcomponent must be
selected.
Windows® Messenger with TLS The BlackBerry Collaboration Service supports Windows® Messenger with TLS if
one of the following certificates is installed on the computer that hosts the
BlackBerry Collaboration Service:
Upgrade Guide System requirements: BlackBerry Router
15

Item Description
•if your instant messaging server is Microsoft® Office Live Communications
Server 2005, an MTLS certificate
• if your instant messaging server is Microsoft Office Live Communications
Server 2005 SP1, a server authentication certificate for the computer
account
IBM® Lotus® Sametime® The BlackBerry Collaboration Service supports IBM Lotus Sametime when you
add the IP address of the computer that hosts the BlackBerry Collaboration
Service to the CommunityConnectivity document on the IBM Lotus Sametime
server.
Novell® GroupWise® Messenger The BlackBerry Collaboration Service supports Novell GroupWise Messenger
when SSL authentication is turned on for the Novell GroupWise Messenger
agents on the computer that hosts the BlackBerry Collaboration Service.
Microsoft® Office Communicator The BlackBerry Collaboration Service supports Microsoft Office Communicator
when MTLS and HTTPS certificates for communication with the Microsoft Office
Live Communications Server are installed on the Microsoft® Office
Communicator Web Access server.
Microsoft Office Communicator with
TLS
The BlackBerry Collaboration Service supports Microsoft Office Communicator
withTLS if oneof the followingcertificates is installedon the computerthat hosts
the BlackBerry Collaboration Service:
• if your instant messaging server is Microsoft Office Live Communications
Server 2005, an MTLS certificate
• if your instant messaging server is Microsoft Office Live Communications
Server 2005 SP1, a server authentication certificate for the computer
account
Microsoft Office Communicator and
AJAX Service
The BlackBerry Collaboration Service supports Microsoft Office Communicator
and AJAX Service with the following conditions:
• the following Microsoft hotfixes from http://support.microsoft.com
installed:
• 911996 on your Microsoft Office Live Communications Server
• 915066 on your Microsoft Office Communicator server
• a virtual server installed on your Microsoft Office Communicator server,
with the following conditions:
• all unassigned IP addresses
Upgrade Guide Supported environments
16

Item Description
• forms-based authentication only
• support for an HTTPS browser connection
• an ISAPI filter for the cwaauth.dll file and the ajax.dll file
enhanced network authentication The BlackBerry Enterprise Server and its components support RSA®
Authentication Agent Version 5.0 for Microsoft® Windows®.
multiple IBM® Lotus® Domino®
domains
The BlackBerry Messaging Agent supports multiple IBM Lotus Domino domains
with the following conditions:
• an IBM Lotus Domino server installed on the BlackBerry Enterprise Server
computer with the following conditions:
• connection documents from the IBM Lotus Domino servers in the
domains from which the server replicates
• membership in the LocalDomainServers group in all the domains in
your environment
• cross-certification established between the messaging servers and
directory servers in other domains
SNMP monitoring The BlackBerry Enterprise Server and its components support the SNMP service.
remote access The BlackBerry Enterprise Server and its components support remote access
using any of the following applications:
• Terminal Services for use with Microsoft Windows Server 2000, installed
using Remote Administration mode
• Microsoft Remote Desktop Connection for use with Microsoft Windows
Server 2003
Unsupported environments
Item Description
DMZ The BlackBerry® Enterprise Server and its components, with the exception of the
BlackBerry Router, do not support installation in a DMZ.
email application The BlackBerry Enterprise Server and its components do not support the
installation of email applications on the same computer.
Upgrade Guide Unsupported environments
17

Item Description
IBM® DB2® UDB The BlackBerry Enterprise Server and its components do not support the
installation of IBM DB2 UDB on a mainframe computer.
Microsoft® SQL Server® 2005 Express
database
The BlackBerry MDS Integration Service databases do not support the Microsoft
SQL Server 2005 Express database.
Upgrade Guide Unsupported environments
18