Blackbe;rry ENTERPRISE SERVER FOR IBM LOTUS DOMINO Installation and operation manual

BlackBerry Enterprise Server for IBM Lotus Domino
Version: 4.1 | Service Pack: 6
Upgrade Guide

SWD-427926-1105015340-001

Contents
1 Choosing a BlackBerry Enterprise Server upgrade option.................................................................................................... 5
Upgrading the BlackBerry Enterprise Server software by overwriting the existing version.................................................. 5
Upgrading the BlackBerry Enterprise Server by using a new computer.................................................................................. 5
Upgrading the BlackBerry Enterprise Server software in phases............................................................................................. 6
Verify the BlackBerry Enterprise Server version from which you are upgrading.................................................................... 7
2System requirements.................................................................................................................................................................. 8
System requirements: BlackBerry Enterprise Server.................................................................................................................. 8
System requirements: BlackBerry Attachment Service.............................................................................................................. 11
System requirements: BlackBerry Manager................................................................................................................................ 11
System requirements: BlackBerry MDS Connection Service..................................................................................................... 13
System requirements: BlackBerry MDS Integration Service...................................................................................................... 13
System requirements: BlackBerry Router..................................................................................................................................... 13
System requirements for optional environments and features................................................................................................. 14
Unsupported environments........................................................................................................................................................... 17
3 Preparing to upgrade from BlackBerry Enterprise Server Version 4.0............................................................................... 18
Back up the BlackBerry Enterprise Server registry settings....................................................................................................... 18
Back up the BlackBerry Enterprise Server log files..................................................................................................................... 18
Back up the BlackBerry Configuration Database........................................................................................................................ 18
BlackBerry Configuration Database Backup Tool parameters.......................................................................................... 19
4 Preparing to upgrade from BlackBerry Enterprise Server Version 2.2................................................................................ 20
Compact IBM Lotus Domino databases....................................................................................................................................... 20
Document your current IT policy settings.................................................................................................................................... 20
Back up IBM Lotus Domino databases and database templates.............................................................................................. 20
Back up IBM Lotus Domino server information........................................................................................................................... 21
Back up the BlackBerry Enterprise Server registry settings....................................................................................................... 21
Back up the BlackBerry Enterprise Server log files..................................................................................................................... 21
Consolidate user license keys........................................................................................................................................................ 21
Testing the transfer of user information during the upgrade process..................................................................................... 22
Create a preview BlackBerry Configuration Database....................................................................................................... 22
Test the transfer of user information to the preview BlackBerry Configuration Database........................................... 23
Configure wireless data synchronization for BlackBerry devices.............................................................................................. 24

5 Setting up the database connection........................................................................................................................................ 25
Specifying permissions when connecting to the BlackBerry Configuration Database using Microsoft Windows
authentication................................................................................................................................................................................. 25
Specifying MSDE 2000 permissions for the Microsoft Windows account...................................................................... 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..................................................... 27
Configure authentication to the BlackBerry Configuration Database in an IBM DB2 UDB environment........................... 28
6 Upgrading the BlackBerry Enterprise Server software by overwriting the existing version........................................... 29
Prerequisites: Upgrading the BlackBerry Enterprise Server software...................................................................................... 29
Upgrade the BlackBerry Enterprise Server software.................................................................................................................. 30
Improve the startup performance of the BlackBerry Enterprise Server................................................................................... 31
7 Upgrading the BlackBerry Enterprise Server by using a new computer............................................................................ 32
Prerequisites: Upgrading the BlackBerry Enterprise Server software...................................................................................... 32
Install and configure BlackBerry Enterprise Server Version 2.2 on the new computer.......................................................... 33
Upgrade to BlackBerry Enterprise Server Version 4.1 SP5 on the new computer.................................................................. 33
Move user accounts to the new BlackBerry Enterprise Server.................................................................................................. 34
NBESMigration Tool parameters.......................................................................................................................................... 35
Prevent the old BlackBerry Enterprise Server from connecting to the BlackBerry Infrastructure........................................ 35
Improve the startup performance of the BlackBerry Enterprise Server................................................................................... 36
Start the new BlackBerry Enterprise Server................................................................................................................................. 36
8 Upgrading the BlackBerry Enterprise Server software in phases........................................................................................ 37
Managing a mixed-version environment..................................................................................................................................... 37
Upgrade the BlackBerry Enterprise Server Version 4.0 SP3 in phases.................................................................................... 38
Upgrade BlackBerry Enterprise Server Version 4.0 and earlier versions in phases and create a new BlackBerry
Configuration Database................................................................................................................................................................. 38
Upgrading BlackBerry Enterprise Server Version 4.0 and earlier versions in phases............................................................ 39
Upgrade BlackBerry Enterprise Server Version 4.0 and earlier versions in phases and create a new BlackBerry
Configuration Database........................................................................................................................................................ 39

Upgrade BlackBerry Enterprise Server Version 4.0 and earlier versions in phases and upgrade the existing
BlackBerry Configuration Database..................................................................................................................................... 40
Upgrade BlackBerry Enterprise Server Version 2.2 in phases................................................................................................... 40
9 Troubleshooting the BlackBerry Enterprise Server upgrade process.................................................................................. 41
A third-party tool did not install successfully and the BlackBerry Enterprise Server setup application closed.................. 41
Previous version detected but no database available................................................................................................................ 41
The BlackBerry Collaboration Service does not connect to Microsoft Office Live Communications Server 2005............. 41
You cannot resolve errors that occur when you move users...................................................................................................... 42
You encounter errors when you try to upgrade the BlackBerry Configuration Database...................................................... 42
The setup application prompts you for access to the installation media for Microsoft .NET Framework version 1.1.......... 42
Restore a BlackBerry Configuration Database............................................................................................................................ 43
10 Upgrading the BlackBerry Device Software............................................................................................................................ 44
Permitting users to upgrade the BlackBerry Device Software at their computers................................................................. 44
Upgrading the BlackBerry Device Software at a central computer.......................................................................................... 44
Pushing the BlackBerry Device Software and the BlackBerry Desktop Software to users' computers................................ 45
11 Permitting users to upgrade the BlackBerry Device Software at their computers........................................................... 46
Configure a network drive.............................................................................................................................................................. 46
Install the BlackBerry Device Software on the network drive................................................................................................... 46
Verify the version of the application loader tool......................................................................................................................... 47
Sending the BlackBerry Desktop Software or BlackBerry Device Manager installation files to users' computers............. 47
Send the BlackBerry Device Manager installation file to users' computers.................................................................... 47
Send the BlackBerry Desktop Software installation file to users' computers................................................................. 48
Synchronizing wireless data automatically.................................................................................................................................. 48
Create the BlackBerry Device Software upgrade instructions for BlackBerry device users................................................... 48
Confirming that the BlackBerry Device Software upgrade process completed successfully................................................ 49
Verify that the upgrade from BlackBerry Device Software Version 4.0 or later completed successfully.................... 49
Verify that the upgrade from BlackBerry Device Software Version 2.2 or earlier completed successfully................. 49
Save the BlackBerry Device Software installation files to the network drive.......................................................................... 49
12 Upgrading the BlackBerry Device Software at a central computer.................................................................................... 50
Configure a network drive.............................................................................................................................................................. 50
Save the BlackBerry Device Software installation files to the network drive.......................................................................... 50
Create a software configuration for the BlackBerry Device Software...................................................................................... 51

Assign the software configuration to a user................................................................................................................................ 51
Upgrade the BlackBerry Device Software at a central computer............................................................................................. 51
Verify that the BlackBerry Device Software upgrade at a central computer completed successfully.................................. 52
Save the BlackBerry Device Software installation files to the network drive.......................................................................... 52
13 Pushing the BlackBerry Device Software and the BlackBerry Desktop Software to users' computers......................... 53
Configure a network drive.............................................................................................................................................................. 53
Save the BlackBerry Desktop Software installation files to the network drive........................................................................ 53
Install the BlackBerry Device Software on the network drive................................................................................................... 54
Synchronizing wireless data automatically.................................................................................................................................. 54
Send the installation files for the BlackBerry Desktop Software and the BlackBerry Device Software to users using a
third-party application................................................................................................................................................................... 54
Confirming that the BlackBerry Device Software upgrade process completed successfully................................................ 55
Verify that the upgrade from BlackBerry Device Software Version 4.0 or later completed successfully.................... 55
Verify that the upgrade from BlackBerry Device Software Version 2.2 or earlier completed successfully................. 55
14 Troubleshooting the BlackBerry Device Software upgrade process.................................................................................... 56
When users click the link to the application loader tool in the upgrade instructions, the upgrade process does not start
........................................................................................................................................................................................................... 56
15 Glossary......................................................................................................................................................................................... 57
16 Legal notice.................................................................................................................................................................................. 59

Choosing a BlackBerry Enterprise Server upgrade option 1
Upgrading the BlackBerry Enterprise Server software by overwriting the
existing version
The in-place upgrade process upgrades the BlackBerry® Enterprise Server software by replacing the existing version of the
software.
Advantages Disadvantages
•You do not require additional computers to perform this
upgrade.
•When the upgrade process completes, user accounts are
active, and no additional administrative action is
required.
•You cannot remove the BlackBerry Enterprise Server and
return to the earlier version of the software
automatically.
•YoumustturnofftheBlackBerryEnterpriseServerduring
the upgrade process, so the interruption to services for
BlackBerry devices lasts as long as it takes the upgrade
process to complete.
If you are upgrading from BlackBerry Enterprise Server Version 2.2 or Version 4.0 SP3 or later, use this upgrade process.
When you use the in-place upgrade process, the following events occur:
•BlackBerrydevices thatare runningBlackBerry® DeviceSoftware Version4.0 orlater receivenew servicebooks, andwireless
data synchronization occurs
• all BlackBerry devices receive new IT policies
Upgrading the BlackBerry Enterprise Server by using a new computer
The cutover upgrade process installs the BlackBerry® Enterprise Server on a new computer and moves user accounts and server
information from the old BlackBerry Enterprise Server to the new one.
If you are upgrading from BlackBerry Enterprise Server Version 2.2, use this upgrade process.
Advantages Disadvantages
• You can move user accounts back to the old BlackBerry
Enterprise Server if you encounter any problems with the
new one.
• You require one extra computer.
Upgrade Guide Choosing a BlackBerry Enterprise Server upgrade option
5

Advantages Disadvantages
•You can use new server hardware and start with a clean
environment.
•Users experience minimal service interruptions because
user accounts remain active on the old BlackBerry
Enterprise Server until you start the new one.
• If you upgrade from a version earlier than BlackBerry
Enterprise Server Version 4.0, the BlackBerry Enterprise
Servertakes longer tostart thanit did previouslybecause
itsends new servicebooks to allof the BlackBerrydevices
that are capable of wireless data synchronization.
This upgrade process uses the same SRP credentials on both the old and the new BlackBerry Enterprise Server instances.
When you use the cutover process, the following events occur:
•BlackBerrydevices thatare runningBlackBerry® DeviceSoftware Version4.0 orlater receivenew servicebooks, andwireless
data synchronization occurs
• all BlackBerry devices receive new IT policies
Upgrading the BlackBerry Enterprise Server software in phases
The phased upgrade process maintains earlier versions of the BlackBerry® Enterprise Server software so that you can gradually
create new BlackBerry Enterprise Server instances and move user accounts to them.
Advantages Disadvantages
• You can move user accounts to the new BlackBerry
Enterprise Server instances gradually, for example, to
limit the number of service books and IT policies that the
BlackBerry Policy Service sends at one time.
• You can monitor system performance as you add user
accounts.
• You can reorganize your BlackBerry Enterprise Server
environment during the upgrade process by changing
user distribution patterns.
• You require additional computers.
• You require additional SRP credentials.
• If you move user accounts from one BlackBerry
Configuration Database to another, you lose the
BlackBerry device options that you backed up in the
BlackBerry Configuration Database.
•You cannot use some new features (for example, one-to-
many relationships between a BlackBerry MDS
Connection Service or a BlackBerry Collaboration
Service and multiple BlackBerry Enterprise Server
instances) in the BlackBerry Enterprise Server software
until all BlackBerry Enterprise Server components are at
the same version.
When you upgrade the BlackBerry Enterprise Server software in phases, the following events occur:
Upgrade Guide Upgrading the BlackBerry Enterprise Server software in phases
6

•BlackBerrydevices thatare runningBlackBerry® DeviceSoftware Version4.0 orlater receivenew servicebooks, andwireless
data synchronization occurs
• all BlackBerry devices receive new IT policies
•when moving user accounts, the BlackBerry Messaging Agent copies user state databases to the new BlackBerry Enterprise
Server
VerifytheBlackBerryEnterpriseServerversionfromwhichyouareupgrading
Perform this task to verify the version that you are upgrading from so that you can choose a supported upgrade process.
1. On the taskbar, click Start > Settings > Control Panel.
2. Double-click Add/Remove Programs.
3. Click BlackBerry Enterprise Server.
4. Click Support Information.
Upgrade Guide Verify the BlackBerry Enterprise Server version from which you are upgrading
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 Anyofthefollowingapplicationsinstalledonthecomputer thathoststheBlackBerry
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
8

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 To support Microsoft SQL Server, the following conditions on the database server:
• 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
9

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
10

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
messaging server application Any of the following applications:
Upgrade Guide System requirements: BlackBerry Attachment Service
11

Item Requirement
• 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
• IBM Lotus Notes version 7.0 (required to support encrypted message display
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
USB hub To support BlackBerry device implementation that uses a hub, a USB driver that
supports USB 1.1-compliant hubs
Upgrade Guide System requirements: BlackBerry Manager
12

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
System requirements: BlackBerry Router
The following system requirements apply when installing the BlackBerry® Router on a computer separate from the BlackBerry®
Enterprise Server.
Upgrade Guide System requirements: BlackBerry MDS Connection Service
13

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
System requirements for optional environments and features
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
• VMware ESX Server version 3.5
Windows® Messenger The BlackBerry Collaboration Service supports Windows Messenger if MSMQ
version 3.0 is installed. If installed separately from Windows Server® 2003, the
defaultMicrosoft®ActiveDirectory®IntegrationandTriggerssubcomponentsmust
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:
• if your organization's instant messaging server is Microsoft® Office Live
Communications Server 2005, an MTLS certificate
• if your organization's instant messaging server is Microsoft Office Live
Communications Server 2005 SP1, a server authentication certificate for the
computer account
Upgrade Guide System requirements for optional environments and features
14

Item Description
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
Novell GroupWise Messenger server.
Microsoft® Office Communicator Web
Access server with TLS
The BlackBerry Collaboration Service supports the Microsoft Office Communicator
Web Access server with TLS if one of the following certificates is installed on the
computer that hosts the BlackBerry Collaboration Service:
• if your organization's instant messaging server is Microsoft Office Live
Communications Server 2005 or Microsoft Office Communications Server
2007, an MTLS certificate
• if your organization's instant messaging server is Microsoft Office Live
Communications Server 2005 SP1, a server authentication certificate for the
computer account
Microsoft Office Communicator Web
Access 2007 and AJAX Service
The BlackBerry Collaboration Service supports the Microsoft Office Communicator
Web Access 2007 server and the AJAX Service if you have installed a virtual server
on your organization's Microsoft Office Communicator Web Access server, with the
following conditions:
• all IP addresses must be unassigned
• optionally, support for an HTTPS browser connection
• internal access only
Microsoft Office Communicator Web
Access 2005 server and AJAX Service
The BlackBerry Collaboration Service supports the Microsoft Office Communicator
Web Access 2005 server and the AJAX Service, with the following conditions:
•the following Microsoft hotfixes from http://support.microsoft.com installed:
• 911996 on your organization's Microsoft Office Live Communications
Server
• 915066 on your organization's Microsoft Office Communicator Web
Access server
•avirtualserver installed onyourorganization'sMicrosoftOfficeCommunicator
Web Access server, with the following conditions:
• all IP addresses must be unassigned
• forms-based authentication only
Upgrade Guide System requirements for optional environments and features
15

Item Description
• optionally, support for an HTTPS browser connection
• an ISAPI filter for the cwaauth.dll file and the ajax.dll file
• internal access only
enhanced network authentication The BlackBerry Enterprise Server and its components support RSA® Authentication
Agent version 5.0 for Windows®.
multiple IBM® Lotus® Domino®
domains
The BlackBerry Messaging Agent supports multiple IBM Lotus Domino domains
with the following conditions:
•IBM Lotus Domino server installed on the computer that hosts the BlackBerry
Enterprise Server with the following conditions:
• connection documents from the IBM Lotus Domino servers in the
domains that the server replicates from
•membership in the LocalDomainServers group in all the domains in your
organization's environment
• cross-certification established between the messaging servers and directory
servers in other domains
native notes encryption The BlackBerry Enterprise Server supports native notes encryption with IBM Lotus
Domino server version 8.0.1.
remote searching for email messages The BlackBerry Enterprise Server supports remote searching for email messages
when the mail files are full-text indexed. For more information, visit
www.blackberry.com/support to read article KB15161.
searching for free and busy times in
calendar
The BlackBerry Enterprise Server supports searching for free and busy times in the
calendar when you install the Calendar Connector service (ncalconn.exe) on the
computer.
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 Windows Server 2000, installed using Remote
Administration mode
• Microsoft® Remote Desktop Connection for use with Windows Server 2003
Upgrade Guide
16

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.
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
17

Preparing to upgrade from BlackBerry Enterprise Server
Version 4.0 3
Back up the BlackBerry Enterprise Server registry settings
Perform this task to maintain a record of the registry entries.
1. On the computer that hosts the BlackBerry® Enterprise Server software, open the Registry Editor.
2. In the left pane, navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion.
3. Right-click Research In Motion. Click Export.
4. Save the file.
Back up the BlackBerry Enterprise Server log files
Performthis task tomaintain a recordof existing logs,and so thatyou can troubleshoot the upgrade process if it does not complete
successfully.
1. On the computer on which you plan to upgrade the BlackBerry® Enterprise Server, navigate to C:\Program Files\Research
In Motion\BlackBerry Enterprise Server\Logs.
2. Copy the log files to a backup location.
Back up the BlackBerry Configuration Database
Back up the BlackBerry® Configuration Database so that you can restore it if the upgrade process does not complete successfully.
If your database environment is Microsoft® SQL Server®, use the backup and restore tools that Microsoft Corporation provides.
If your database environment is MSDE 2000, you can use the BlackBerry Configuration Database Backup Tool that is included
with the BlackBerry® Enterprise Server installation media. By default, the backup file is named <database name>
<YYYYMMDDHHMMSS>.bak.
1. On the computer that hosts the BlackBerry Configuration Database, at the command prompt, change to the Tools folder
on the BlackBerry Enterprise Server installation media.
2. Run BlackBerryDbBackup.exe.
Example
To back up a BlackBerry Configuration Database named "BESMgmt" to a folder named "DB_backup_folder" when you use the
database credentials "sqlusername" and "sqlpassword", type
BlackBerryDBBackup.exe -d BESMgmt -f C:\DB_backup_folder -U sqlusername -P sqlpassword
Upgrade Guide Preparing to upgrade from BlackBerry Enterprise Server Version 4.0
18