3 Preparing to upgrade from the BlackBerry Professional Software to the BlackBerry Enterprise Server..Obtain the BlackBerry Enterprise Server software files......................Verify and record the name of the existing host computer for the BlackBerry Professional Software......Verify and record the name of the administration account for the BlackBerry Professional Software......
Page 4
Stop the BlackBerry Professional Software services......................Stop the IBM Lotus Domino server............................Upgrade from the BlackBerry Professional Software to the BlackBerry Enterprise Server on a new host computer ........................................Improve the startup performance of the BlackBerry Enterprise Server after the upgrade..........
Page 5
Save the BlackBerry Desktop Software installation files to the network drive............. Synchronizing wireless data automatically......................... Send the installation files for the BlackBerry Desktop Software and the BlackBerry Device Software to users using a third-party application................................ Confirming that the BlackBerry Device Software upgrade process completed successfully........
Upgrading from the BlackBerry Professional Software to the BlackBerry Enterprise Server 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: •...
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.
Page 9
Host server and database upgrade scenarios 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.
System requirements System requirements 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: •...
Page 12
A messaging server application with the following permissions: application • 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 •...
Page 13
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 •...
Upgrade Guide System requirements: BlackBerry Attachment Service 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: •...
Page 15
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 a nonpartitioned messaging server application...
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...
Upgrade Guide System requirements: BlackBerry Router 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: •...
Page 18
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...
Server 2003 Unsupported environments Item Description 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...
Page 20
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 The BlackBerry MDS Integration Service databases do not support the Microsoft database SQL Server 2005 Express database.
Download the current version of the BlackBerry® Enterprise Server software. Double-click the downloaded .zip file. Extract the files to a folder on the local drive of the computer that you plan to use to host the BlackBerry Enterprise Server. Verify and record the name of the existing host computer for the BlackBerry Professional Software If you plan to upgrade to the BlackBerry®...
Verify the names of the existing BlackBerry Configuration Database and its host computer If you plan to use the existing BlackBerry® Configuration Database on its existing computer after upgrading to the BlackBerry® Enterprise Server, you record the database and computer names so that you can configure the database connection during the upgrade process.
You can back up the BlackBerry® Configuration Database so that you can restore it, if necessary, after an installation, migration, or upgrade. You can also back up the BlackBerry Configuration Database if you plan to restore it to a different computer.
Page 24
Type the following commands: backup database <databasename> to disk = 'C: \<databasename>.bak' quit Back up using the BlackBerry At the command prompt, change to the Tools folder on the BlackBerry Configuration Database Backup Tool Professional Software or the BlackBerry Enterprise Server installation media.
Run the BlackBerryDbBackup.exe file, using the parameters that are explained in Blackberry Configuration Database Backup Tool parameters. After you finish: Restore the BlackBerry Configuration Database to the same location or to a different computer. BlackBerry Configuration Database Backup Tool parameters The parameters listed in brackets are optional.
Upgrade Guide Back up IBM Lotus Domino server information Back up IBM Lotus Domino server information Back up the IBM® Lotus® Domino® server information to maintain a record of the information. Navigate to Lotus\Domino\Data. Back up the following files: • server.ID •...
Using the existing BlackBerry Configuration Database after the upgrade to the BlackBerry Enterprise Server If you plan to use the existing BlackBerry® Configuration Database on its existing computer when you upgrade to the BlackBerry® Enterprise Server, no setup is required before you begin the upgrade process.
Configure the local system account for Microsoft Windows authentication Perform this task if you want to use a local system account to access the BlackBerry® Enterprise Server, install the BlackBerry Configuration Database on a separate computer, and use Microsoft® Windows® authentication to connect to the BlackBerry Configuration Database.
Configuring the local system account for database authentication If you want to use a local system account for the BlackBerry® Enterprise Server, install the BlackBerry Configuration Database on a computer separate from the BlackBerry Enterprise Server, and use database authentication to connect to the BlackBerry Configuration Database, perform one of the following actions: •...
Create Microsoft Windows groups for administrators in an IBM DB2 UDB environment If you use IBM® DB2® UDB, you cannot create BlackBerry® Enterprise Server administrator accounts by using the BlackBerry Manager. You must create Microsoft® Windows® groups on the database server for each BlackBerry Enterprise Server administrative role.
Back up the BlackBerry Configuration Database. • If you plan to move the existing BlackBerry Configuration Database to a different computer or to a new Microsoft® SQL Server®, perform the move before you begin the upgrade process. Verify that you have the following information available: •...
Stop the IBM® Lotus® Domino® server. If the IBM Lotus Domino server is running as a Windows service, change the Startup Type to Manual. Log in to the computer that you plan to use to host the BlackBerry Enterprise Server using an administrative account with the appropriate database permissions.
After an upgrade, the BlackBerry® Enterprise Server might send new service books to every BlackBerry device. If it sends all the new service books at the same time, the BlackBerry Enterprise Server startup time might be affected. You can improve the startup performance of the BlackBerry Enterprise Server by configuring the number of service books that the BlackBerry Enterprise Server sends each hour.
During the installation, use the existing CAL key information for the BlackBerry Professional Software. • If you plan to move the existing BlackBerry Configuration Database to a different computer or to a new Microsoft® SQL Server®, perform the move before you begin the upgrade process.
During the upgrade process, you must restart the computer. The restart can take several minutes. Before you begin: Verify that the BlackBerry® Professional Software is installed on the computer that you plan to use to host the BlackBerry® Enterprise Server. If you plan to install one or more BlackBerry Enterprise Server components on separate computers, you must install the BlackBerry Professional Software on each computer before you begin the upgrade process.
After an upgrade, the BlackBerry® Enterprise Server might send new service books to every BlackBerry device. If it sends all the new service books at the same time, the BlackBerry Enterprise Server startup time might be affected. You can improve the startup performance of the BlackBerry Enterprise Server by configuring the number of service books that the BlackBerry Enterprise Server sends each hour.
The registry keys that identify the BlackBerry® Configuration Database must exist in the Registry Editor. On the server that hosts the BlackBerry® Enterprise Server, on the taskbar, click Start > Run. Type regedit. In the left pane, navigate to HKEY_LOCAL_MACHINE\Research In Motion\BlackBerry Enterprise Server\Database.
You cannot resolve errors that occur when you move users Possible solution Delete the user accounts from the BlackBerry® Enterprise Server before you start the upgrade process. Add the user accounts to the BlackBerry Enterprise Server when the upgrade process completes.
Complete the instructions on the screen. Restore the BlackBerry Configuration Database You can use the backup and restore process to return to a previous version of the BlackBerry® Configuration Database after an installation, migration, or upgrade. You can also use the restore process to move an existing BlackBerry Configuration Database to a different computer. You must first create an empty database on the new computer and then restore the existing database to the new location.
Page 42
In the From database list, click the name of the database that you want to restore. Click OK. Restore from a command prompt. On the computer that hosts the BlackBerry Configuration Database, at the command prompt, type the following command: osql -E Press ENTER.
Page 43
Upgrade Guide Restore the BlackBerry Configuration Database Task Steps Type the same parameters that you used when you backed up the database. Press ENTER.
Upgrading the BlackBerry Device Software If you want to make the new features of the BlackBerry® Enterprise Server available to users in your organization, you can upgrade the BlackBerry® Device Software and the BlackBerry® Desktop Software when you upgrade the BlackBerry Enterprise Server.
Save the required BlackBerry Device Software files to the folder. Verify the version of the application loader tool Perform this task to verify that the application loader tool can support the version of the BlackBerry® Device Software that you plan to install.
Push the BlackBerry Device Manager installation file to users' computers You can push the BlackBerry® Device Manager to users' computers so that they can perform tasks such as charging their BlackBerry devices, synchronizing organizer items through the BlackBerry Router, and upgrading the BlackBerry® Device Software at their computers.
When you upgrade the BlackBerry Device Software, the version of the BlackBerry Device Software on the BlackBerry device does not update immediately in the BlackBerry Manager. You might have to wait for a short period of time while the BlackBerry Configuration Database synchronizes the version of the BlackBerry Device Software that displays in the BlackBerry Manager with the version of the BlackBerry Device Software that is installed on the BlackBerry device.
In the Device Software Location field, click the Change button. Navigate to the network location where you installed the BlackBerry® Device Software. In the Application Name list, select the check box for the BlackBerry device series that you want to upgrade the BlackBerry Device Software for.
Upgrading the BlackBerry Device Software at a central computer Assign the software configuration to a user account If you add the BlackBerry® Device Software to a software configuration and then assign the software configuration to a user acount, you can monitor when the upgrade process occurs.
When you upgrade the BlackBerry Device Software, the version of the BlackBerry Device Software on the BlackBerry device does not update immediately in the BlackBerry Manager. You might have to wait for a short period of time while the BlackBerry Configuration Database synchronizes the version of the BlackBerry Device Software that displays in the BlackBerry Manager with the version of the BlackBerry Device Software that is installed on the BlackBerry device.
Send the installation files using a third-party application for software distribution. After you finish: If you want to make sure that users upgrade the BlackBerry Device Software, set the Force Load Count IT policy rule and the Force Load Message IT policy rule. For more information, see the BlackBerry Enterprise Server Policy...
When you upgrade the BlackBerry Device Software, the version of the BlackBerry Device Software on the BlackBerry device does not update immediately in the BlackBerry Manager. You might have to wait for a short period of time while the BlackBerry Configuration Database synchronizes the version of the BlackBerry Device Software that displays in the BlackBerry Manager with the version of the BlackBerry Device Software that is installed on the BlackBerry device.
The application loader might not be shared. Possible solution Connect a BlackBerry® device to a computer on which the BlackBerry Manager is installed. At the command prompt, type \\<shared network drive>\Research In Motion\Apploader\loader.exe If the application loader tool starts, the tool is shared successfully.
BlackBerry MDS BlackBerry® Mobile Data System A client access license (CAL) limits how many users you can add to the BlackBerry® Enterprise Server. A demilitarized zone (DMZ) is a neutral subnetwork outside of an organization's firewall. It exists between the trusted LAN of the organization and the untrusted external wireless network and public Internet.
Page 58
Upgrade Guide Glossary BlackBerry Mobile Data Service After you upgrade to BlackBerry® Enterprise Server Version 4.1 or later, the BlackBerry® Mobile Data Service name changes to the BlackBerry MDS Connection Service. MSDE Microsoft® SQL Server® Desktop Engine MSMQ Microsoft® Message Queuing...
Page 60
Upgrade Guide Legal notice DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
Page 61
WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION. Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server Software, BlackBerry® Desktop Software, and/or BlackBerry® Device Software and may require additional development or Third Party Products and Services for access to corporate applications.