BlackBerry Enterprise Server for IBM Lotus Domino Version 4.1.
BlackBerry Enterprise Server Version 4.1.4 for IBM Lotus Domino Upgrade Guide Last modified: 25 June 2007 Document ID: 13055714 Version 4 At the time of publication, this documentation is based on BlackBerry Enterprise Server Version 4.1.4 for IBM Lotus Domino. Send us your comments on product documentation: https://www.blackberry.com/DocsFeedback. ©2007 Research In Motion Limited. All Rights Reserved.
warranty or guarantee whatsoever in relation to the Third-Party Information and RIM assumes no liability whatsoever in relation to the ThirdParty Information even if RIM has been advised of the possibility of such damages or can anticipate such damages.
Contents 1 Planning to upgrade your BlackBerry environment.......................................................................................9 Upgrading to BlackBerry Enterprise Server Version 4.1.4.......................................................................... 9 Confirm the version from which you are upgrading ............................................................................ 9 Changes to the BlackBerry Enterprise Server Version 2.2 environment.....................................
Checklist: BlackBerry MDS Connection Service system requirements........................................... 27 Checklist: BlackBerry Collaboration Service system requirements ................................................. 28 3 Preparing your BlackBerry Enterprise Server environment for upgrade..................................................29 Preparing to upgrade from BlackBerry Enterprise Server Version 2.2 ...................................................29 Perform system maintenance .............
Migrate the user accounts.............................................................................................................................45 Stop the old BlackBerry Enterprise Server..................................................................................................46 Improve the startup performance of the BlackBerry Enterprise Server .................................................46 Start the new BlackBerry Enterpriser Server .....................................................
Assign a software configuration to a user (optional).........................................................................59 Upgrade the BlackBerry Device Software ...........................................................................................59 Confirm that the upgrade is successful ...............................................................................................60 Sending the BlackBerry Device Software upgrade to user computers..................................................
1 Planning to upgrade your BlackBerry environment Upgrading to BlackBerry Enterprise Server Version 4.1.4 Choosing a BlackBerry Enterprise Server upgrade option Upgrading to BlackBerry Device Software Version 4.1 and later Choosing a BlackBerry Device Software upgrade option Additional upgrade resources Upgrading to BlackBerry Enterprise Server Version 4.1.4 When you upgrade to BlackBerry® Enterprise Server Version 4.1.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide • updates to the BlackBerry Enterprise Server software, including any BlackBerry components that you installed separately (for example, the BlackBerry Manager) • upgrades to the schema of the BlackBerry Configuration Database Before you upgrade to BlackBerry Enterprise Server Version 4.1.4, make sure that all BlackBerry Enterprise Servers in your environment that share a BlackBerry Configuration Database are Version 4.0.3 or higher.
1: Planning to upgrade your BlackBerry environment Upgrade option Description Upgrade the BlackBerry Enterprise Server using a cutover process. The cutover upgrade • process installs BlackBerry Enterprise Server Version 4.1.4 on a new computer and migrates user accounts and server information from the old BlackBerry Enterprise • Server to the new one. Advantages After you migrate the user accounts and server information, you stop the • old BlackBerry Enterprise Server and start the new one.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Upgrading to BlackBerry Device Software Version 4.1 and later When you upgrade the BlackBerry Enterprise Server you might also want to upgrade the BlackBerry Device Software so that users can use the BlackBerry Enterprise Server Version 4.1.4 features. You are not required to upgrade the BlackBerry Device Software. The BlackBerry Enterprise Server Version 4.1.4 supports BlackBerry devices that are running BlackBerry Device Software Version 4.
1: Planning to upgrade your BlackBerry environment Upgrade option Description Advantages Upgrade the BlackBerry This upgrade process uses • Device Software at a software configurations to central computer or kiosk. help control the BlackBerry Device Software upgrade process for each BlackBerry device at a central administration • computer or kiosk.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Additional upgrade resources The following upgrade options might apply to your BlackBerry environment. Use the resources listed in the following table to plan and perform the upgrade. Upgrade option Description Resource Change to a new license model during the upgrade.
2 System requirements Hardware requirements System requirements for the BlackBerry Enterprise Server System requirements for your corporate environment System requirements for remote components Hardware requirements Visit www.blackberry.com/knowledgecenterpublic to read the BlackBerry Enterprise Server Version 4.1 for IBM Lotus Domino Server Capacity Calculator and the BlackBerry Enterprise Server Version 4.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade GuideUpgrade Guide Checklists Description Checklist: Additional software requirements This checklist describes the additional software that is required on the See page 18. computer on which you plan to install the BlackBerry Enterprise Server, if you want to read the documentation and help file, or if you want to implement multiple BlackBerry devices from a single computer.
2: System requirements Checklist: Messaging and collaboration server software requirements Warning: Do not install IBM® Lotus® Notes® client software on the same computer as the BlackBerry Enterprise Server. Considerations Install one of the following messaging and collaboration servers on the computer on which you plan to install the BlackBerry Enterprise Server: • • • • IBM® Lotus® Domino® server Version 5.0.3 or later (Version 5.0.12 recommended) IBM Lotus Domino server Version 6.0.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade GuideUpgrade Guide Checklist: Multidomain support requirements Considerations Verify that the IBM Lotus Domino server contains connection documents from the IBM Lotus Domino servers in the domains from which it replicates. Verify that the IBM Lotus Domino server is a member of the LocalDomainServers group in all the domains in your environment.
2: System requirements Checklists Description Checklist: Instant messaging environment settings This checklist describes the software and settings that are required on See page 20. your instant messaging server. Reference Checklist: Terminal service settings This checklist describes the supported software and settings for See page 20. installing the BlackBerry Enterprise Server using a terminal or remote desktop session.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade GuideUpgrade Guide Checklist: Instant messaging environment settings Considerations Your instant messaging server must be one of the following: • • • • • • • • Sametime Version 3.0 Community Server Sametime Version 3.1 Community Server Sametime Version 6.5.1 Community Server (Version 6.5.1 or later is required to support dormant mode.) Sametime Version 7.0 Community Server Sametime Version 7.
2: System requirements Checklist: Database environment settings Considerations Install one of the following database programs on the computer on which you plan to install the BlackBerry Configuration Database: • • • • Microsoft SQL Server 2000 Desktop Engine (MSDE 2000) Microsoft SQL Server 2000 SP3a Microsoft SQL Server 2005 (Standard, Enterprise, or Express) DB2 UDB Version 8.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade GuideUpgrade Guide Considerations If you are installing the BlackBerry MDS Services, you must use SQL authentication to create the BlackBerry MDS Services databases. If you are using SQL authentication to create the BlackBerry Configuration Database, you must use a different SQL account to create the BlackBerry MDS Services databases.
2: System requirements Checklist: BlackBerry MDS Services system requirements System requirement Considerations operating system Install one of the following operating systems on the computer on which you plan to install the BlackBerry MDS Services: • • • Microsoft Windows 2000 (Server or Advanced Server editions) Microsoft Windows Server 2003 (Standard, Enterprise or Small Business Server) Microsoft Windows XP Verify that the operating system is installed in one of English, French, German, Italian,
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade GuideUpgrade Guide System requirement Considerations messaging and Install one of the following messaging servers on the computer on which you plan to install the BlackBerry collaboration Enterprise Server with BlackBerry MDS Services: server software • IBM Lotus Domino server Version 5.0.3 or later (Version 5.0.12 recommended) • IBM Lotus Domino server Version 6.0.
2: System requirements System requirement Considerations additional software If you run a USB hub to implement BlackBerry devices that are connected to the BlackBerry Manager, verify that the USB driver supports USB1.1-compliant hubs. Install Adobe Acrobat Reader Version 3.0 or later so that you can view the product guides. Set Microsoft Internet Explorer Version 4.0 or later with Java or JavaScript enabled as your default browser so that you can view the online help.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade GuideUpgrade Guide Checklist: BlackBerry Manager system requirements System requirement Considerations operating system Install one of the following operating systems on the computer on which you plan to install the BlackBerry Manager: • • • Microsoft Windows 2000 (Professional, Server, or Advanced Server editions) Microsoft Windows Server 2003 Microsoft Windows XP Professional Install Microsoft .NET Framework Version 1.1 SP1.
2: System requirements Checklist: BlackBerry Router system requirements System requirement Considerations operating system Install one of the following operating systems on the computer on which you plan to install the BlackBerry Router: • • • Microsoft Windows 2000 (Server or Advanced Server editions) Microsoft Windows Server 2003 Microsoft Windows XP additional software Install Adobe Acrobat Reader Version 3.0 or later so that you can view the product guides.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade GuideUpgrade Guide Checklist: BlackBerry Collaboration Service system requirements System requirement Considerations operating system Install one of the following operating systems on the computer on which you plan to install the BlackBerry Collaboration Service: • • • Microsoft Windows 2000 (Server or Advanced Server editions) Microsoft Windows Server 2003 SP1 (required for Microsoft Windows Messenger support) Microsoft Windows XP Install M
3 Preparing your BlackBerry Enterprise Server environment for upgrade Preparing to upgrade from BlackBerry Enterprise Server Version 2.2 Preparing to upgrade from BlackBerry Enterprise Server Version 4.0 Preparing to upgrade from BlackBerry Enterprise Server Version 2.2 When you upgrade from BlackBerry Enterprise Server Version 2.2, you migrate BlackBerry Enterprise Server and user configuration information from BlackBerry-related IBM Lotus Domino databases into a relational database.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Back up system information > Perform the following actions: Action Procedure Document your current IT policy settings. The default wireless IT policy in the BlackBerry Enterprise Server Version 4.1.2 and later replaces the serial IT policies in the BlackBerry Enterprise Server Version 2.2, so you must re-create the IT policies. Back up BlackBerry-related IBM Lotus Domino databases and database templates.
3: Preparing your BlackBerry Enterprise Server environment for upgrade 5. Click OK. Preview the user migration Use the CreateDB tool to create the BlackBerry Configuration Database. By default, the CreateDB tool writes the details of the database creation in the DBInstallV log file. After you create the BlackBerry Configuration Database, you can test the user migration by running the NBESMigration tool in preview mode.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide 5. Type any of the following parameters, in the order in which they appear: Parameter Procedure -2 > Include this parameter if your BlackBerry Configuration Database is running on DB2 UDB. -d > Type the computer name and the database name of the BlackBerry Configuration Database. -l > Type the name of and the path to the log file.
3: Preparing your BlackBerry Enterprise Server environment for upgrade Before you upgrade to BlackBerry Enterprise Server Version 4.1.4, make sure that all BlackBerry Enterprise Servers in your environment that share a BlackBerry Configuration Database are Version 4.0.3 or higher. Certain components in earlier versions of the BlackBerry Enterprise Server are not optimized for use with the BlackBerry Enterprise Server Version 4.1.4.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide 3. Type any of the following parameters, in the order in which they appear: Parameter Procedure -d > Type the database name. -f > Type the folder in which the backup file is saved. By default, this parameter is set to the current location. Note: If you specify a different location, the folder must already exist. -S > Type the name of the server on which the database is located. By default, this parameter is set to the local server.
4 Configuring your environment Setting database permissions Configure remote authentication for the local system account Create Windows groups to support administrative roles Setting database permissions When you run the setup program, the account that you use must have permissions on the database server.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Set Microsoft SQL Server permissions > Perform one of the following actions: Action Procedure Create or upgrade the BlackBerry Configuration Database on the same > computer as the BlackBerry Enterprise Server, and register the database notification system. Assign System Administrator permission. Create or upgrade the BlackBerry Configuration Database on a remote > database server during the BlackBerry Enterprise Server installation.
4: Configuring your environment Action Procedure Configure the local system account for database authentication. 1. On the computer on which you plan to upgrade the BlackBerry Enterprise Server, open the Registry Editor. 2. In the left pane, browse to HKEY_USERS\.DEFAULT. 3. Create the following nested keys (if they do not already exist): • Software • Research In Motion • BlackBerry Enterprise Server • Database 4.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide 38
5 Upgrading the BlackBerry Enterprise Server using an in-place process Checklist: Confirm the upgrade requirements Upgrade the BlackBerry Enterprise Server Improve the startup performance of the BlackBerry Enterprise Server Troubleshooting the BlackBerry Enterprise Server upgrade process Checklist: Confirm the upgrade requirements Use the following checklist to confirm that you are ready to start the upgrade: Step Verify that you have met all the system requirements.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Upgrade the BlackBerry Enterprise Server 1. Log in to the computer using the BlackBerry Enterprise Server administrative account with the appropriate database permissions. 2. Double-click the setup.exe file. 3. Complete the instructions on the screen. 4. When prompted to restart the computer, click Yes. 5. Log in using the same account that you used for the setup program. 6. Complete the instructions on the screen. 7.
5: Upgrading the BlackBerry Enterprise Server using an in-place process Symptom Possible solution You encounter errors while upgrading the BlackBerry Configuration Database. 1. Browse to the C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Logs\Installer folder, or to the location that you defined in the setup program. 2. Locate the DB_InstallV.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Resolving issues after the upgrade process Symptom Possible solution The BlackBerry Collaboration Service is not connecting to the If you are using TLS as the communication protocol, verify that authentication Microsoft Live Communications Server. is configured. 1. Visit www.microsoft.com/downloads to download Microsoft Office Communicator 2005 Trial Edition. 2.
6 Upgrading the BlackBerry Enterprise Server using a cutover process Checklist: Confirm the upgrade preparation on the existing BlackBerry Enterprise Servers Installing the IBM Lotus Domino server on the new computer Create replicas of IBM Lotus Domino databases Checklist: Confirm the installation requirements on the new computer Install and configure the BlackBerry Enterprise Server Version 2.2 on the new computer Upgrade to BlackBerry Enterprise Server Version 4.1.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide When you install the new BlackBerry Enterprise Server, use the same name and SRP credentials as one of the BlackBerry Enterprise Servers that you plan to replace. You must prevent the IBM Lotus Domino server from starting automatically during the upgrade process using these same SRP credentials.
6: Upgrading the BlackBerry Enterprise Server using a cutover process Step Confirm that you have the following credentials for the BlackBerry Enterprise Server Version 4.1.4 installation: • • computer name and port of the instant messaging server computer name and port of the proxy server Note: If you are using a .pac file to configure the connection, you can specify the file after the installation completes. Install and configure the BlackBerry Enterprise Server Version 2.2 on the new computer 1.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide 4. Type any of the following parameters, in the order in which they appear: Parameter Procedure -2 > Include this parameter if the BlackBerry Configuration Database is running on DB2 UDB. -d > Type the computer name and the database name of the BlackBerry Configuration Database. -l > Type the name of and the path to the log file.
6: Upgrading the BlackBerry Enterprise Server using a cutover process Start the new BlackBerry Enterpriser Server Verify that the BlackBerry Enterprise Server from which you copied the SRP credentials is stopped before starting the new BlackBerry Enterprise Server. 1. In the Windows Services panel, start the BlackBerry services in the following order: • BlackBerry Controller • BlackBerry Router • BlackBerry Dispatcher • all remaining services 2.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Symptom Possible solution You encounter errors when migrating users. 1. Browse to the location you specified for the migration log file. 2. Check the log file for errors. 3. Preview the user migration again, using the -g parameter to print properties retrieved from the user’s mailbox to the migration log file. You cannot resolve errors that occur when migrating users. 1.
7 Upgrading the BlackBerry Enterprise Server using a phased process Phased upgrades Example 1: Upgrade BlackBerry Enterprise Servers at Version 4.0.3 using a phased process Example 2: Upgrade BlackBerry Enterprise Servers at Version 4.0 and earlier using a phased process Example 3: Upgrade BlackBerry Enterprise Servers at Version 2.2 using a phased process Phased upgrades You can upgrade your BlackBerry Enterprise Servers to Version 4.1.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide In a mixed-version environment that includes BlackBerry Enterprise Server Version 2.2 and BlackBerry Enterprise Server Version 4.0 or later, you require two BlackBerry Mobile Data Service push servers. BlackBerry Enterprise Server Version 2.2 uses the BlackBerry Directory database to store the BlackBerry Mobile Data Service configuration and access details. When you upgrade to BlackBerry Enterprise Server Version 4.
7: Upgrading the BlackBerry Enterprise Server using a phased process BlackBerry Enterprise Server Version 4.1.0 BlackBerry Manager Version 4.1.2 BlackBerry Configuration Database Version 4.1.1 BlackBerry Enterprise Server Version 4.1.1 BlackBerry Enterprise Server Version 4.1.2 Sample unsupported mixed-version environment New features in the BlackBerry Enterprise Server Version 4.1.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Before you upgrade to BlackBerry Enterprise Server Version 4.1.4, make sure that all BlackBerry Enterprise Servers in your environment that share a BlackBerry Configuration Database are Version 4.0.3 or higher. Certain components in earlier versions of the BlackBerry Enterprise Server 4.0 are not optimized for use with the BlackBerry Enterprise Server Version 4.1.4. When you install the BlackBerry Enterprise Server Version 4.1.
7: Upgrading the BlackBerry Enterprise Server using a phased process Example 2: Upgrade BlackBerry Enterprise Servers at Version 4.0 and earlier using a phased process The following tasks show how to upgrade several BlackBerry Enterprise Servers at Version 4.0 and earlier including the optional creation of a new BlackBerry Configuration Database. Upgrade the BlackBerry Enterprise Server at Version 4.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Upgrade the BlackBerry Enterprise Server at Version 4.0 and earlier and keep the existing BlackBerry Configuration Database 1. Create a new BlackBerry Enterprise Server Version 4.1.4 and upgrade the BlackBerry Configuration Database to Version 4.1.4. 2. Upgrade the BlackBerry Manager to Version 4.1.4. 3. Move user accounts to the new BlackBerry Enterprise Server. 4. Upgrade the empty BlackBerry Enterprise Server.
8 Upgrading BlackBerry Device Software Enabling users to upgrade the BlackBerry Device Software at their computers Upgrading the BlackBerry Device Software at a central computer or kiosk Sending the BlackBerry Device Software upgrade to user computers Troubleshooting the BlackBerry device upgrade Enabling users to upgrade the BlackBerry Device Software at their computers Use this upgrade method to provide a link to the BlackBerry Device Software on a shared network drive.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide 3. On the network drive, double-click the .exe file. 4. Complete the installation. 5. Verify that the files are in \Program Files\Common Files\Research In Motion\Shared\Loader Files\. Confirm that the BlackBerry Application Loader Version 4.1 appears in the network drive (recommended) 1. On the network drive, browse to \Program Files\Common Files\Research In Motion\AppLoader. 2. Right-click loader.exe. Click Properties. 3.
8: Upgrading BlackBerry Device Software 2. Copy the BlackBerry Desktop Software installation files to a network drive. 3. If applicable, extract the BlackBerry Desktop Software files from the .exe file to the network drive. 4. On the network drive, open the setup.ini file. 5. At the bottom of the setup.ini file, type [INSTALL_OPTIONS]. 6. Use the install.txt file, which is included with the BlackBerry Desktop Software, as a reference to configure the installation settings. 7. Save the setup.ini file. 8.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Confirm that the BlackBerry Device Software upgrade is successful > Perform one of the following actions: Action Procedure Confirm the upgrade for users who are running the BlackBerry Device Software Version 3.6. > Instruct users to confirm the BlackBerry Device Software version installed on the BlackBerry device. • In the BlackBerry device options, click About. • Confirm the wireless handheld version.
8: Upgrading BlackBerry Device Software 4. In the Device Software Location field, click the Change button. 5. Browse to the network location in which you installed the BlackBerry Device Software. 6. In the Application Name list, select the check box beside the BlackBerry device series for which to upgrade the BlackBerry Device Software. 7. Expand the application tree. 8. Select the check box beside additional components or programs that you want to install. 9. Click OK.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Confirm that the upgrade is successful > Perform one of the following actions: Action Procedure Confirm the upgrade for users who are running the BlackBerry Device Software Version 3.6. > Instruct users to confirm the BlackBerry Device Software version installed on the BlackBerry device. • In the BlackBerry device options, click About. • Confirm the wireless handheld version.
8: Upgrading BlackBerry Device Software 5. At the bottom of the setup.ini file, type [INSTALL_OPTIONS]. 6. Use the install.txt file, which is included with the BlackBerry Desktop Software, as a reference to configure the installation settings. 7. Save the setup.ini file. Add the BlackBerry Device Software installation files to the network drive 1. Obtain the BlackBerry Device Software installation file from your service provider. 2.
BlackBerry Enterprise Server for IBM Lotus Domino Upgrade Guide Confirm that BlackBerry Device Software upgrade was successful > Perform one of the following actions: Action Procedure Confirm the upgrade for users who are running the BlackBerry Device Software Version 3.6. > Instruct users to confirm the BlackBerry Device Software version installed on the BlackBerry device. • In the BlackBerry device options, click About. • Confirm the wireless handheld version.
©2007 Research In Motion Limited Published in Canada.
