Migration Guide
BlackBerry Professional Software for Microsoft Exchange
Version 4.1 SP4
SWD-314931-1222122316-001
Contents
About the BlackBerry Professional Software...................................................................................................................................................................................3
Migrating to the BlackBerry Professional Software.....................................................................................................................................................................................3
Migrate to the BlackBerry Professional Software...........................................................................................................................................................................5
Troubleshooting the installation process.........................................................................................................................................................................................7
A third-party tool did not install successfully and the BlackBerry Professional Software setup application closed .......................................................................7
"Failed to write License key to the Database. Refer to the installation log file for more information." .............................................................................................7
"Previous version detected but no database available"..............................................................................................................................................................................7
The setup application prompts for access to the installation media for Microsoft .NET Framework Version 1.1...............................................................................8
The setup application did not prompt you to change or confirm the MAPI profile................................................................................................................................8
"Service failed to start, generating error 5305"...........................................................................................................................................................................................8
BlackBerry Router and BlackBerry Dispatcher do not install during the migration or upgrade process...........................................................................................11
Adding user accounts..........................................................................................................................................................................................................................13
Preconfigured IT policies in the BlackBerry Professional Software.........................................................................................................................................................13
Add a user account..........................................................................................................................................................................................................................................14
Legal notice........................................................................................................................................................................................................................................... 17
2
About the BlackBerry Professional Software
The BlackBerry® Professional Software is designed to provide the core wireless communications and collaboration features and the security
that you have in your current BlackBerry small business solution, in a smaller package.
The BlackBerry Professional Software supports up to 30 BlackBerry device users.
The BlackBerry Manager that ships with the BlackBerry Professional Software has been redesigned to provide streamlined access to
management and configuration tools. You can use the same IT policy rules that you use to protect your existing BlackBerry small business
solution. In addition, you can now choose from preconfigured IT policies that are designed to make IT policy management easier.
Because group-based administration and role-based administration are designed for larger organizations with multiple IT departments
and administrators, these management options have been removed from the BlackBerry Professional Software.
Support for applications has also been simplified. You can install BlackBerry® Java® Applications and BlackBerry Browser applications on
the BlackBerry devices in your organization, but existing or new BlackBerry MDS Runtime Applications are not supported.
Users can communicate with instant messaging applications such as Google Talk™ or Yahoo!® Messenger, but the BlackBerry Professional
Software does not support server-based enterprise instant messaging applications, such as IBM® Lotus® Sametime® or Microsoft® Office
Live Communications Server.
If the number of BlackBerry device users in your organization increases, or if you find that users need access to more data or to a broader
range of applications, you can upgrade from the BlackBerry Professional Software to BlackBerry® Enterprise Server Version 4.1 SP5 or
later.
Migrating to the BlackBerry Professional Software
You can migrate to the BlackBerry® Professional Software from BlackBerry® Enterprise Server – Small Business Edition Version 4.0 or
later. If you have a small business solution that is earlier than Version 4.0, you must upgrade to Version 4.0 or later before you migrate to
the BlackBerry Professional Software.
You can install the BlackBerry Professional Software either on the current host server for your BlackBerry small business solution or on
your mail server. If your present environment is up and running, no additional setup tasks are required. You do not have to remove the
software for your existing BlackBerry small business solution before you begin the migration.
During the migration, you can configure the BlackBerry Professional Software to connect to an existing Microsoft® SQL Server™ database.
Alternatively, the setup application can automatically install a Microsoft® SQL Server™ 2005 Express database.
The setup application runs a preinstallation tool that verifies that your environment meets the minimum system requirements for the
BlackBerry Professional Software. The tool displays the results of the analysis on the screen. It also writes the results in the log files in the
following location: <drive>:\Program Files\Research In Motion\Blackberry Enterprise Server\logs\installer. The file names begin with
DetectionLog_ .
If components of your existing BlackBerry small business solution, such as the BlackBerry Router or the BlackBerry Attachment Service,
are currently installed on separate computers, the components remain installed, but the BlackBerry Professional Software uses the
components that the setup application installs during the migration process.
By default, the BlackBerry Professional Software uses the CAL key from your existing BlackBerry small business solution. If you have a
new CAL key, you can replace the existing CAL key during the installation.
3
For more information, see the BlackBerry Professional Software documentation at www.blackberry.com/go/serverdocs.
4
Migrate to the BlackBerry Professional Software
Note: You must restart your server during the installation process. The restart can take several minutes.
1. Log in to the host server for the BlackBerry® Professional Software using the account that you use to administer your existing
BlackBerry small business solution.
2. In the BlackBerry Professional Software installation media, double-click the setup.exe file.
3. Complete the instructions on the screen. Consider the following information:
• If you must resolve any issues that the preinstallation tool detects, click Cancel. You can restart the migration after you resolve
the issues.
• If you want to install a Microsoft® SQL Server™ 2005 Express database on your server, click Local, and then type the Microsoft
SQL Server name, the database name, and the authentication type.
• If you want to connect to an existing local database, click Local, and then type the name or IP address of the host computer for
the existing database and the name of the existing database.
• If you want to connect to an existing remote database, click Remote, and then type the name or IP address of the host computer
for the existing database and the name of the existing database.
4. When you are prompted to restart your server, click Yes.
5. Log in to the host server for the BlackBerry Professional Software using the account that you use to administer your existing
BlackBerry small business solution. Wait for the setup application to restart.
6. Complete the instructions on the screen. Consider the following information:
• The BlackBerry Professional Software uses the CAL key from your existing BlackBerry small business solution. To change the
CAL key, type the new information in the CAL key field.
7. To complete the migration and start the BlackBerry Professional Software, click Start Services.
8. If a MAPI error displays, perform the following actions:
• On the server that hosts the BlackBerry Professional Software, on the taskbar, click Start > Edit MAPI Profile.
• Verify the Microsoft® Exchange server name and the Microsoft Exchange administrator mailbox.
• Click OK.
5
6
Troubleshooting the installation process
A third-party tool did not install successfully and the BlackBerry Professional
Software setup application closed
Possible solution
1. In the BlackBerry® Professional Software installation media, double-click the Tools folder.
2. Double-click the setup application file for the tool.
3. Complete the instructions on the screen.
4. Restart the BlackBerry Professional Software setup application.
"Failed to write License key to the Database. Refer to the installation log file for
more information."
During the migration process to BlackBerry® Professional Software Version 4.1 SP4 from a BlackBerry® Enterprise Server small business
solution, if you change the client access license (CAL) key for the BlackBerry Enterprise Server small business solution to the CAL key for
the BlackBerry Professional Software, the BlackBerry Professional Software does not install successfully, and the following message
appears:
Failed to write License key to the Database. Refer to the installation log file for more information.
Possible cause
By default, the setup application for the BlackBerry® Professional Software does not overwrite an existing CAL key during the installation,
migration, or upgrade process.
Possible solution
Complete the installation using the existing CAL key for the BlackBerry® Enterprise Server small business solution. After you complete
the installation, change to the CAL key for the BlackBerry® Professional Software.
1. On the server that hosts the BlackBerry Professional Software, on the taskbar, click Start > BlackBerry Manager.
2. Click the Home tab.
3. In the Account section, click License Management .
4. Click Add License .
"Previous version detected but no database available"
When you start the setup application, the following message appears, and the setup application stops: ""Previous version detected but no
database available.""
Possible solution
The registry keys that identify your BlackBerry Configuration Database must exist in the Registry Editor.
7
1. On the server that hosts the BlackBerry Professional Software, open the Registry Editor. On the taskbar, click Start > Run. Type
regedit.
2. In the left pane, navigate to HKEY_LOCAL_MACHINE\Research In Motion\BlackBerry Professional Software\Database.
3. Create the following case-sensitive String values (if they do not exist):
• DatabaseName: Type the name of the BlackBerry Configuration Database.
• DatabaseServerMachineName: Type the computer name of the database server.
4. Restart the setup application.
The setup application prompts for access to the installation media for
Microsoft .NET Framework Version 1.1
Possible cause
When the BlackBerry® Professional Software setup application installs Microsoft® .NET Framework Version 1.1 SP1 on a computer that
hosts a previously installed version of Microsoft .NET Framework Version 1.1, it prompts you for access to the installation media for
Microsoft .NET Framework Version 1.1.
Possible solution
1. In the BlackBerry Professional Software installation media, double-click the Tools folder.
2. Double-click the netfx.msi file.
3. Complete the instructions on the screen.
The setup application did not prompt you to change or confirm the MAPI profile
Possible solution
You can create and change the MAPI profile manually.
1. In the BlackBerry® Professional Software installation media, double-click the Tools folder.
2. Double-click the Fixmapisvc.exe file.
3. Verify that the mapisvc.inf file is installed at C:\winnt\system32 or C:\windows\system32.
4. On the taskbar, click Start > BlackBerry Professional Software > Edit MAPI Profile.
5. Type the Microsoft® Exchange Server name.
6. Click the Microsoft® Windows® account that is associated with the MAPI profile.
7. Click OK.
"Service failed to start, generating error 5305"
When you start the Microsoft® Windows® account that runs the BlackBerry® Professional Software, the following message
appears:""Service failed to start, generating error 5305."
8
Possible cause Possible solution
The Microsoft® Exchange Information Store service was not 1. On the Microsoft Exchange Server, on the taskbar, click Start >
started on the Microsoft Exchange Server that hosts the mailbox Administrative Tools > Services.
for the Microsoft® Windows® account that runs the BlackBerry
2. Right-click Microsoft Exchange Information Store.
Professional Software.
3. Click Properties.
4. Click Start.
If a Messaging Application Programming Interface (MAPI) 1. On the server that hosts the BlackBerry Professional Software, on
profile was created using a profile wizard, this message might the taskbar, click Start > Programs > BlackBerry Professional
appear for one of the following reasons: Software > BlackBerry Server Configuration.
• The profile wizard might return more than one mailbox 2. On the BlackBerry Server tab, click Edit MAPI Profile.
for the Microsoft Windows account that runs the 3. Type the Microsoft Exchange Server name.
BlackBerry Professional Software. 4. Type the mailbox name of the Microsoft Windows account that
• The Microsoft Exchange Server might not host the runs the BlackBerry Professional Software.
mailbox for the administration account for the 5. Click OK.
BlackBerry Professional Software.
• The MAPI profile might be configured to use a method
of authentication other than NT Password
Authentication, which requires a user name, domain,
and password.
The security settings in the MAPI properties are configured to Change the MAPI authentication method to Windows NT Password
prompt for a password, but Distributed Password Authentication.
Authentication is configured.
1. On the server that hosts the BlackBerry Professional Software, on
the taskbar, click Start > Programs > BlackBerry Professional
Software > BlackBerry Server Configuration.
2. On the BlackBerry Server tab, click Edit MAPI Profile.
3. On the Advanced tab, in the Logon network security drop-down
list, click NT Password Authentication.
4. Click Apply.
The Microsoft Windows account that is used to run the Restore the Microsoft Windows account from a backup file, or create a
BlackBerry Professional Software was deleted. new account. For more information about how to create a new account,
see the BlackBerry Professional Software Getting Started Guide.
The Microsoft Windows account that is used to run the 1. On the server that hosts the BlackBerry Professional Software, on
BlackBerry Professional Software was migrated to a new server, the taskbar, click Start > Run.
and its location was not updated through directory replication.
2. Type cd\Program Files\Research In Motion\BlackBerry
Enterprise Server\Utility
3. Type handheldcleanup.exe -u
4. In the ProfileName drop-down list, click BlackBerryServer.
9
Possible cause Possible solution
5. Click OK.
6. At the command prompt, type the name of the server that hosts
the BlackBerry Professional Software as the name appears on the
Home tab of the BlackBerry Manager.
7. To exit from the command prompt window, type exit.
8. In the Microsoft Windows Services panel, restart the BlackBerry
services.
Microsoft® Outlook® is installed on the server that hosts the 1. Remove Microsoft Outlook from the host server.
BlackBerry Professional Software.
2. Install or re-apply Microsoft Exchange Administration 4.5 Service
Pack 4 or the Microsoft Exchange System Management Tools for
Microsoft Exchange 2000 or Microsoft Exchange 2003.
The Server Routing Protocol (SRP) identifier is not listed in Uninstall and then re-install the BlackBerry Professional Software using
Exchange 5.5 Administrator > Configuration > BlackBerry the same configuration information that you used in the original
Servers > System Info. installation.
Do not click the Remove Server button at BlackBerry Servers. Removing
the server eliminates any possibility of restoring existing user accounts
that are serviced by the BlackBerry Professional Software.
In a Microsoft Exchange 2000 or Microsoft Exchange 2003 1. Grant all required permissions to the Microsoft Windows account
environment, this message might appear for one of the following that is used to run the BlackBerry Professional Software. For more
reasons: information, see the BlackBerry Professional Software Getting
Started Guide.
• permissions for the Microsoft Windows account that is
used to run the BlackBerry Professional Softwareare 2. When you are prompted for the MAPI profile name, type the
not correctly specified or are missing MAPIProfile name that is in the registry at
HKEY_CURRENT_USER/Software/Research In Motion/
• MAPI profile for the Microsoft Windows account is
BlackBerry Enterprise Server/Management.
incorrect or is not specified
The Microsoft Exchange Server was upgraded to Microsoft 1. Install Microsoft Exchange 2003 System Manager on the server
Windows 2003 with Microsoft Exchange2003, but the that hosts the BlackBerry Professional Software.
BlackBerry Professional Software is installed on a computer that
2. On the server that hosts the BlackBerry Professional Software, on
is running Microsoft Windows Server 2000 and Microsoft
the taskbar, click Start > Programs > BlackBerry Professional
Exchange 2000 System Manager.
Software > BlackBerry Server Configuration.
3. On the BlackBerry Server tab, click Edit MAPI Profile.
4. Type the Microsoft Exchange Server name.
5. In the Mailbox field, type the name of the Microsoft Windows
account that is used to run the BlackBerry Professional Software.
6. Click Apply.
10
Possible cause Possible solution
The Microsoft Windows account that is used to run the 1. Make the Microsoft Windows account that is used to run the
BlackBerry Professional Software does not have access to the BlackBerry Professional Software visible in the Global Address List.
Global Address List or if the account is not visible in the Global
2. Grant the account unrestricted access to the Global Address List
Address List.
so that it can resolve its own mailbox location and those of all
This is typical in hosted environments, in which the Global BlackBerry device users, regardless of the organization they
Address List is isolated for each organization that uses the belong to.
hosted services.
The Microsoft Windows account that is used to run the Re-create the Microsoft Windows account that is used to run the
BlackBerry Professional Software is corrupted and cannot BlackBerry Professional Software, and grant the account all required
access mailboxes for BlackBerry device users. permissions. For more information about how to create a new account,
see the BlackBerry Professional Software Getting Started Guide.
A Public Folder storage group and database were not created Create a Public Folder storage group and database on the Microsoft
during the installation of Microsoft Exchange 2007 Server. Exchange 2007 Server. For more information, see the BlackBerry
Professional Software Getting Started Guide.
BlackBerry Router and BlackBerry Dispatcher do not install during the migration
or upgrade process
When you migrate or upgrade to the BlackBerry® Professional Software from BlackBerry® Enterprise Server - Small Business Edition or
BlackBerry Enterprise Server Express, the BlackBerry Router and BlackBerry Dispatcher do not install, and the BlackBerry Professional
Software does not run.
The log files for the setup application do not display any error messages for the migration or upgrade process.
Possible solution
Remove and then re-install the BlackBerry Professional Software.
When you re-install the BlackBerry Professional Software, you must specify both the name of the Microsoft® SQL Server™ that hosts your
existing BlackBerry Configuration Database and the name of the original database (the default name is BESMgmt).
To point your database to the correct Microsoft SQL Server and database name, at the Database Settings step of the migration or upgrade
process, consider the following information:
• In the Database Location section, specify whether your existing BlackBerry Configuration Database is running on a locally hosted
MicrosoftSQL Server or on a remote server.
• In the Database Information section, type either the computer name or the IP address of the MicrosoftSQL Server.
• In the Database Information section, type the name of the existing database.
• In the Database authentication section, select the authentication type for your existing database. If you are installing a new
database, select Windows (trusted) authentication.
11
12
Adding user accounts
You create and manage user accounts for the BlackBerry® Professional Software using the BlackBerry Manager.
In the BlackBerry Manager, you can use the Add New Users Wizard to create each user account, or you can create each user account
manually. For information about creating a user account manually, see the BlackBerry Professional Software Administration Guide.
Preconfigured IT policies in the BlackBerry Professional Software
The BlackBerry® Professional Software provides preconfigured IT policies that you can apply when you set up a user account. You can
configure additional IT policy rules in these IT policies or change any settings that are shown in the following table.
IT policy rule Default IT Basic Medium Medium Advanced security Advanced security
policy password password password IT policy (disallow
security IT security IT security application
policy policy (disallow downloads) IT
application policy
download) IT
policy
Device-Only Items policy group
Password Required False True True True True True
User Can Disable True False False False False False
Password
Maximum Security — 30 min. 10 min. 10 min. 10 min. 10 min.
Timeout
Maximum Password — 60 days 30 days 30 days 30 days 30 days
Age
User Can Change True True True True True True
Timeout
Password Pattern 0 0 at least 1 alpha and at least 1 alpha and at least 1 alpha and 1 at least 1 alpha and 1
Checks 1 numeric 1 numeric character numeric character numeric character
character
Enable Long-term — — True True True True
Timeout
Password policy group
Maximum Password — — 6 6 6 6
History
Security policy group
Disallow Third Party — — — True True True
Application
Download
Force Lock When — — True True True True
Holstered
13
IT policy rule Default IT Basic Medium Medium Advanced security Advanced security
policy password password password IT policy (disallow
security IT security IT security application
policy policy (disallow downloads) IT
application policy
download) IT
policy
Content Protection — — — — Strong Strong
Strength
Disable USB Mass — — — — True True
Storage
External File System — — — — Encrypt to user Encrypt to user
Encryption level password (excluding password (excluding
multimedia multimedia
directories) directories)
Bluetooth policy group
Disable Serial Port — — — — True True
Profile
Disable Discoverable — — True True True True
Mode
Disable Address — — — — True True
Book Transfer
Disable File Transfer — — — — True True
Require LED — — — — True True
Connection Indicator
WLAN policy group
WLAN Allow — False False False False False
Handheld Changes
Add a user account
You must set up user accounts on your messaging server before you set up user accounts in the BlackBerry® Professional Software.
When you create a user account, you can assign an IT policy to control settings for the account. You can select one of the preconfigured
IT policies, or create your own and select it. For more information about the IT policy rule settings, see the Policy Reference Guide.
1. On the server that hosts the BlackBerry Professional Software, on the taskbar, click Start > BlackBerry Manager.
2. In the BlackBerry Manager, click the Home tab.
3. In the Account section, click Add New Users Wizard.
4. In the user list, click the name of the user whose BlackBerry Professional Software user account you want to create.
5. Click Select.
6. Click OK.
7. On the Select IT policy screen, specify the IT policy setting for the user account.
14
8. On the Device Deployment screen, specify how to activate the BlackBerry device.
9. Click Done.
15
16
Legal notice
©2007 Research In Motion Limited. All Rights Reserved. The BlackBerry and RIM families of related marks, images, and symbols are the
exclusive properties of Research In Motion Limited. RIM, Research In Motion, BlackBerry, "Always On, Always Connected" and the "envelope
in motion" symbol are registered with the U.S. Patent and Trademark Office and may be pending or registered in other countries.
Google Talk is a trademark of Google Inc. Java is a trademark of Sun Microsystems, Inc. Microsoft is a trademarks of Microsoft Inc. Yahoo!
is a trademark of Yahoo! Inc. All other brands, product names, company names, trademarks, and service marks are the properties of their
respective owners.
The BlackBerry device and/or associated software are protected by copyright, international treaties, and various patents, including one
or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428; D433,460; D416,256. Other
patents are registered or pending in various countries around the world. Visit www.rim.com/patents for a list of RIM (as hereinafter defined)
patents.
This document is provided "as is" and Research In Motion Limited and its affiliated companies ("RIM") assume no responsibility for any
typographical, technical, or other inaccuracies in this document. In order to protect RIM proprietary and confidential information and/or
trade secrets, this document may describe some aspects of RIM technology in generalized terms. RIM reserves the right to periodically
change information that is contained in this document; however, RIM makes no commitment to provide any such changes, updates,
enhancements, or other additions to this document to you in a timely manner or at all. RIM MAKES NO REPRESENTATIONS, WARRANTIES,
CONDITIONS, OR COVENANTS, EITHER EXPRESS OR IMPLIED (INCLUDING WITHOUT LIMITATION, ANY EXPRESS OR IMPLIED
WARRANTIES OR CONDITIONS OF FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, MERCHANTABILITY, DURABILITY,
TITLE, OR RELATED TO THE PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE REFERENCED HEREIN OR PERFORMANCE
OF ANY SERVICES REFERENCED HEREIN). IN CONNECTION WITH YOUR USE OF THIS DOCUMENTATION, NEITHER RIM NOR ITS
RESPECTIVE DIRECTORS, OFFICERS, EMPLOYEES, OR CONSULTANTS SHALL BE LIABLE TO YOU FOR ANY DAMAGES WHATSOEVER
BE THEY DIRECT, ECONOMIC, COMMERCIAL, SPECIAL, CONSEQUENTIAL, INCIDENTAL, EXEMPLARY, OR INDIRECT DAMAGES, EVEN
IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, INCLUDING WITHOUT LIMITATION, LOSS OF BUSINESS
REVENUE OR EARNINGS, LOST DATA, DAMAGES CAUSED BY DELAYS, LOST PROFITS, OR A FAILURE TO REALIZE EXPECTED SAVINGS.
This document might contain references to third-party sources of information, hardware or software, products or services and/or third-
party web sites (collectively the "Third-Party Information"). RIM does not control, and is not responsible for, any Third-Party Information,
including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency,
links, or any other aspect of Third-Party Information. The inclusion of Third-Party Information in this document does not imply endorsement
by RIM of the Third-Party Information or the third party in any way. Installation and use of Third-Party Information with RIM's products
and services may require one or more patent, trademark, or copyright licenses in order to avoid infringement of the intellectual property
rights of others. Any dealings with Third-Party Information, including, without limitation, compliance with applicable licenses and terms
and conditions, are solely between you and the third party. You are solely responsible for determining whether such third-party licenses
are required and are responsible for acquiring any such licenses relating to Third-Party Information. To the extent that such intellectual
property licenses may be required, RIM expressly recommends that you do not install or use Third-Party Information until all such applicable
licenses have been acquired by you or on your behalf. Your use of Third-Party Information shall be governed by and subject to you agreeing
to the terms of the Third-Party Information licenses. Any Third-Party Information that is provided with RIM's products and services is
provided "as is". RIM makes no representation, warranty or guarantee whatsoever in relation to the Third-Party Information and RIM
assumes no liability whatsoever in relation to the Third-Party Information even if RIM has been advised of the possibility of such damages
or can anticipate such damages.
Last modified: December 21, 2007
17
Research In Motion Limited
295 Phillip Street
Waterloo, ON N2L 3W8
Canada
Research In Motion UK Limited
200 Bath Road
Slough, Berkshire SL1 3XE
United Kingdom
Published in Canada
18
