Getting Started Guide BlackBerry Professional Software Version: 4.
SWDT305427-305427-0912091433-001
Contents 1 BlackBerry Professional Software overview.................................................................................................................. Architecture: BlackBerry Professional Software in a Microsoft Exchange messaging environment............................. Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment............................. 3 3 6 2 System requirements........................................................................
7 Installing the BlackBerry Professional Software......................................................................................................... Prerequisites: Installing the BlackBerry Professional Software........................................................................................... Install the BlackBerry Professional Software in a Microsoft Exchange messaging environment...................................
Getting Started Guide BlackBerry Professional Software overview BlackBerry Professional Software overview 1 The BlackBerry® Professional Software is designed for organizations with up to 30 BlackBerry device users who collaborate using the organization’s messaging server. From their BlackBerry devices, users can send and receive email messages, manage calendar and address book contacts, and organize their workloads using tasks and memos.
Getting Started Guide Component Description BlackBerry Attachment Service The BlackBerry Attachment Service converts supported message attachments into a format that users can view on their BlackBerry devices. The BlackBerry Configuration Database is a relational database that contains configuration information that the components of the BlackBerry Professional Software use.
Architecture: BlackBerry Professional Software in a Microsoft Exchange messaging environment Getting Started Guide Component Description • • BlackBerry Controller BlackBerry Dispatcher BlackBerry Manager BlackBerry MDS Connection Service BlackBerry Messaging Agent BlackBerry Policy Service BlackBerry Router address mappings between PINs and email addresses for BlackBerry® MDS Connection Service push features read-only copy of the master encryption key for each BlackBerry device The BlackBerry Con
Getting Started Guide Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment Component Description BlackBerry Synchronization Service The BlackBerry Synchronization Service synchronizes organizer data between BlackBerry devices and the messaging server over the wireless network. The messaging server stores email accounts.
Getting Started Guide Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment Component Description BlackBerry Attachment Service The BlackBerry Attachment Service converts supported message attachments into a format that users can view on their BlackBerry devices. The BlackBerry Configuration Database is a relational database that contains configuration information that the components of the BlackBerry Professional Software use.
Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment Getting Started Guide Component Description • • BlackBerry Controller BlackBerry Dispatcher BlackBerry Manager BlackBerry MDS Connection Service BlackBerry Messaging Agent BlackBerry Policy Service BlackBerry profiles database 8 address mappings between PINs and email addresses for BlackBerry® MDS Connection Service push features read-only copy of the master encryption key for each BlackBerry device The B
Getting Started Guide Architecture: BlackBerry Professional Software in an IBM Lotus Domino messaging environment Component Description BlackBerry Router The BlackBerry Router connects to the wireless network to send data to and receive data from the BlackBerry device. It also sends data within your organization's network to BlackBerry devices that are connected to computers using the BlackBerry® Device Manager.
System requirements Getting Started Guide 2 System requirements You can install the BlackBerry® Professional Software on the server that hosts your organization's messaging server or on a separate host server. If you might upgrade to the BlackBerry® Enterprise Server in the future, consider installing the BlackBerry Professional Software on a separate host server. Installation of the BlackBerry Enterprise Server on the messaging server is not a supported environment.
Getting Started Guide System requirements: BlackBerry Professional Software in a Microsoft Exchange messaging environment Item Requirement operating system On the host server for the BlackBerry Professional Software, install one of the following operating systems in English, French, German, Italian, Spanish, or Brazilian Portuguese: • Windows Server® 2000 SP4 • Windows Server 2003 SP1 or SP2 • Windows Server 2003 (64-bit) • Windows Small Business Server SP2 messaging server Install one of the followi
Getting Started Guide Item Requirement data access components Install one of the following data access components on the host servers for the BlackBerry Professional Software and the BlackBerry Configuration Database: • Microsoft Data Access Component (MDAC) version 2.8 with Security Patch MS04-003 (version 2000.85.1025.00) • MDAC version 2.8 SP2 (version 2000.86.1830.
Getting Started Guide System requirements: Client computers in a Microsoft Exchange messaging environment System requirements: Client computers in a Microsoft Exchange messaging environment Item Requirement email client software Your email client software must be one of the following: • Microsoft® Outlook® 2000 • Microsoft Outlook 2003 • Microsoft Outlook 2003 SP2 • Microsoft Outlook 2007 System requirements: BlackBerry Professional Software in an IBM Lotus Domino messaging environment Item Requireme
Getting Started Guide Item System requirements: BlackBerry Professional Software in an IBM Lotus Domino messaging environment Requirement • • messaging server Windows Server 2003 SP1 or SP2 Windows Server 2003 (64-bit) Install one of the following messaging servers with all Daylight Saving Time patches: • IBM® Lotus® Domino® version 6.5.5 • IBM Lotus Domino version 7.0.0 • IBM Lotus Domino version 7.0.1 • IBM Lotus Domino version 7.0.2 • IBM Lotus Domino version 8.0.
System requirements: Client computers in an IBM Lotus Domino environment Getting Started Guide Item Requirement • • Microsoft® .NET Framework virtual environment (optional) network environment settings remote Microsoft SQL Server 2005 (Standard or Enterprise) remote Microsoft SQL Server 2005 (64-bit) You require Microsoft .NET Framework version 1.1 SP1. If this is not present, it is installed as part of the installation process. You can use VMware® ESX Server version 2.5.
Getting Started Guide Configuring a Microsoft Exchange version 5.5, 2000, or 2003 messaging environment Configuring a Microsoft Exchange version 5.5, 2000, or 2003 messaging environment 3 To configure a Microsoft® Exchange version 5.5, 2000, or 2003 messaging environment, you perform the following tasks: • • • • • Create a Microsoft® Windows® account and mailbox.
Getting Started Guide 7. Configure permissions for the Microsoft Windows account For more information about the Send As permission, visit www.support.microsoft.com to read article KB04707. For more information about assigning the Send As permission for multiple user accounts, visit www.support.microsoft.com to read article KB912918. Send a test message to activate the new mailbox.
Start the MAPI subsystem Getting Started Guide Configure Microsoft Exchange 2000 or 2003 permissions for the Microsoft Windows account On the server that you plan to use to host the BlackBerry® Professional Software, configure the Microsoft® Exchange permissions for the Microsoft® Windows® account that you plan to use to install the BlackBerry Professional Software. 1. 2. 3. 4. 5. On the taskbar, click Start > All Programs > Microsoft Exchange > System Manager. Expand Administrative groups.
Getting Started Guide Microsoft Exchange 2003 System Manager 2. 3. 20 Identify and address Microsoft Exchange known issues for wireless calendar synchronization • • 823343 894470 Identify the hotfixes that are required for your organization's messaging environment. Download and install the hotfixes on the server that hosts the BlackBerry® Professional Software.
Getting Started Guide Configuring a Microsoft Exchange 2007 messaging environment Configuring a Microsoft Exchange 2007 messaging environment 4 To configure a Microsoft® Exchange 2007 environment, you perform the following tasks: • • • • • Create a Microsoft Exchange 2007 account and mailbox. The account and mailbox are required so that the components of the BlackBerry® Professional Software can authenticate to the Microsoft Exchange server.
Getting Started Guide Configure Microsoft Exchange 2007 permissions for the Microsoft Exchange account Configure Microsoft Exchange 2007 permissions for the Microsoft Exchange account 1. 2. Open the Microsoft® Exchange Management Shell.
Getting Started Guide Configuring an IBM Lotus Domino messaging environment Configuring an IBM Lotus Domino messaging environment 5 To configure an IBM® Lotus® Domino® environment, you perform the following tasks: • • • • Create a group for BlackBerry® Professional Software administrators. Configure the server document to allow administrators to move users in the BlackBerry Domain. Configure the local system account for Microsoft® Windows® authentication.
Getting Started Guide Configure the local system account for Microsoft Windows authentication 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® Professional Software, install the BlackBerry Configuration Database on another computer, and use Microsoft® Windows® authentication to connect to the BlackBerry Configuration Database.
Getting Started Guide Setting up the database connection Setting up the database connection 6 The BlackBerry® Professional Software can connect to the BlackBerry Configuration Database on the Microsoft® SQL Server® using either Microsoft® Windows® authentication or database authentication. If you use Microsoft Windows authentication, the BlackBerry Manager logs in to the BlackBerry Configuration Database using the Microsoft Windows account that is already logged in to the computer.
Installing the BlackBerry Professional Software Getting Started Guide Installing the BlackBerry Professional Software 7 In the first step of the installation process, the setup application runs a preinstallation tool to verify that your organization's environment meets the following requirements: • • • • • • • operating system requirements on the host computer for the BlackBerry® Professional Software messaging server software and environment requirements network environment requirements database softw
Getting Started Guide 2. 3. 4. 5. Configure the BlackBerry Professional Software in a Microsoft Exchange messaging environment In the BlackBerry Professional Software installation media, double-click the setup.exe file. Complete the BlackBerry Professional Software license agreement. Click Next. Complete the Apache Tomcat™ license agreement. Click Next. At the Preinstallation Checklist screen, perform one of the following actions: • To continue, click Next.
Getting Started Guide Configure the BlackBerry Professional Software in a Microsoft Exchange messaging environment 9. On the License Key screen, type the CAL key that you received with your installation package. 10. On the SRP Setting screen, type the SRP identifier and SRP authentication key that you received with your installation package. 11. Click Validate SRP Key and ID to confirm the information is correct. Click OK and click Next. 12.
Getting Started Guide 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. Install the BlackBerry Professional Software in an IBM Lotus Domino messaging environment Navigate to HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\BlackBerryServer. Locate the subkey named 00036604. Right-click the subkey. Click Modify. In the Value data, change the second pair of digits to 80. Click OK.
Getting Started Guide Configure the BlackBerry Professional Software in an IBM Lotus Domino messaging environment 10. On the Installation Information screen, type your administration account password and the name of the host server for the BlackBerry Professional Software. Click Next. 11. On the SQL Server Option screen, specify whether you want the setup application to install Microsoft® SQL Server® 2005 Express on your server. Click Next. 12.
Getting Started Guide • • • • • Configure the BlackBerry Professional Software in an IBM Lotus Domino messaging environment BlackBerry MDS Connection Service BlackBerry Policy Service BlackBerry Attachment Service BlackBerry Synchronization Service BlackBerry Alert 13. Click Finish. 14. On the server that hosts the BlackBerry Professional Software, on the taskbar, click Start > Lotus Domino Server. 15. Click Start Domino as a Windows service.
Getting Started Guide Troubleshooting the installation process Troubleshooting the installation process 8 A third-party tool did not install successfully and the BlackBerry Professional Software setup application closed Possible solution 1. 2. 3. 4. In the BlackBerry® Professional Software installation media, double-click the Tools folder. Double-click the setup application file for the tool. Complete the instructions on the screen. Restart the BlackBerry Professional Software setup application.
Getting Started Guide The setup application prompts for access to the installation media for Microsoft .NET Framework version 1.1 • 5. DatabaseServerMachineName: Right-click the new value. Click Modify. Set the Value data to the computer name of the server that hosts the BlackBerry Configuration Database. Restart the setup application. The setup application prompts for access to the installation media for Microsoft .NET Framework version 1.
Could not open ID file Getting Started Guide Could not open ID file This message appears when you start the BlackBerry® Professional Software setup application. The setup application then closes. Possible solution 1. If you installed the IBM® Lotus® Domino® server but have not started it yet, start it and stop it. 2. Restart the setup application.
Service failed to start, generating error 5305 Getting Started Guide Possible cause Possible solution The security settings in the MAPI properties are configured to prompt for a password, but Distributed Password Authentication is configured. Change the MAPI authentication method to Windows NT Password Authentication. 1. On the server that hosts the BlackBerry Professional Software, on the taskbar, click Start > Programs > BlackBerry Professional Software > BlackBerry Server Configuration. 2.
Service failed to start, generating error 5305 Getting Started Guide Possible cause Possible solution 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 Uninstall and then re-install the BlackBerry Professional in Exchange 5.
Getting Started Guide Possible cause BlackBerry Router and BlackBerry Dispatcher do not install during the migration or upgrade process Possible solution The Microsoft Windows account that is used to run the 1. BlackBerry Professional Software does not have access to the Global Address List or if the account is not visible in the Global Address List. 2. This is typical in hosted environments, in which the Global Address List is isolated for each organization that uses the hosted services.
Getting Started Guide • • I am experiencing an issue after I install the BlackBerry Professional Software on the Windows Small Business 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.
Adding user accounts Getting Started Guide 9 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 Getting Started Guide IT policy rule Default IT Basic policy password security IT policy Password policy group Maximum — Password History Security policy group Disallow Third False Party Application Download Force Lock When False Holstered Content — Protection Strength Disable USB False Mass Storage External File 0 System Encryption level Bluetooth policy group Disable Serial False Port Profile Disable False Discoverable Mode 42 Medium
Add a user account Getting Started Guide IT policy rule Default IT Basic policy password security IT policy Disable Address False Book Transfer Disable File False Transfer Require LED False Connection Indicator WLAN policy group WLAN Allow True Handheld Changes Medium password security IT policy Medium password security (disallow application download) IT policy Advanced Advanced security IT policy security (disallow application downloads) IT policy False False False True True False False Fals
Getting Started Guide 9. 44 Click Done.
Getting Started Guide Legal notice Legal notice 10 ©2008 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType® and related trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world. Adobe, Acrobat, and Reader are trademarks of Adobe Systems Incorporated. Apache Tomcat is a trademark of Apache Software Foundation. Intel and Pentium are trademarks of Intel Corporation.
Getting Started 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.
Getting Started Guide Legal notice The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.