blackberry enterprise server for microsoft exchange 2000/2003

260
BlackBerry Enterprise Server for Microsoft Exchange 2000/2003 Version 3.6 Service Pack 3 Installation and Getting Started Guide

Upload: others

Post on 12-Sep-2021

5 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

BlackBerry Enterprise Server for Microsoft Exchange 2000/2003Version 3.6 Service Pack 3

Installation and Getting Started Guide

Page 2: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

BlackBerry® Enterprise ServerTM version 3.6 Service Pack 3 for Microsoft® Exchange 2000/2003Installation and Getting Started GuideLast revised: 07 July 2004

Part number: PDF-03856-032

At the time of publication, this documentation complies with BlackBerry Enterprise Server version3.6 Service Pack 3 for Microsoft Exchange.

© 1997-2004 Research In Motion Limited. All Rights Reserved. The BlackBerry and RIM families ofrelated marks, images and symbols are the exclusive properties of Research In Motion Limited.RIM, Research In Motion, �Always On, Always Connected�, the �envelope in motion� symbol andthe BlackBerry logo are registered with the U.S. Patent and Trademark Office and may be pendingor registered in other countries. All other brands, product names, company names, trademarks andservice marks are the properties of their respective owners.

The handheld and/or associated software are protected by copyright, international treaties andvarious 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 invarious countries around the world. Visit www.rim.com/patents.shtml for a current listing ofapplicable patents.

While every effort has been made to achieve technical accuracy, information in this document issubject to change without notice and does not represent a commitment on the part of Research InMotion Limited, or any of its subsidiaries, affiliates, agents, licensors, or resellers. There are nowarranties, express or implied, with respect to the content of this document.

This product includes code licensed from RSA Security, Inc. Some portions licensed from IBM areavailable at http://oss.software.ibm.com/icu4j/. This product includes software developed by theApache Foundation. Such software is subject to the below conditions.

Page 3: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

This software consists of voluntary contributions made by many individuals on behalf of theApache Software Foundation and was originally based on software copyright (c) 1999, InternationalBusiness Machines, Inc., http://www.ibm.com. For more information on the Apache SoftwareFoundation, please see <http://www.apache.org/>.

Research In Motion Limited295 Phillip StreetWaterloo, ON N2L 3W8Canada

Research In Motion UK LimitedCentrum House, 36 Station RoadEgham, Surrey TW20 9LFUnited Kingdom

Published in Canada

The Apache Software License, Version 1.1Copyright (c) 1999-2000 The Apache Software Foundation. All rights reserved. Redistribution anduse in source and binary forms, with or without modification, are permitted provided that thefollowing conditions are met:1. Redistributions of source code must retain the above copyright notice, this list of conditions andthe following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditionsand the following disclaimer in the documentation and/or other materials provided with thedistribution.3. The end-user documentation included with the redistribution, if any, must include the followingacknowledgment: �This product includes software developed by the Apache Software Foundation(http://www.apache.org/).�Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear.4. The names �Xerces� and �Apache Software Foundation� must not be used to endorse or promoteproducts derived from this software without prior written permission. For written permission,please contact [email protected]. Products derived from this software may not be called �Apache�, nor may �Apache� appear intheir name, without prior written permission of the Apache Software Foundation.THIS SOFTWARE IS PROVIDED �AS IS� AND ANY EXPRESSED OR IMPLIED WARRANTIES,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITYAND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THEAPACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS ORSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVERCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICTLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAYOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCHDAMAGE.

Page 4: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003
Page 5: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

ContentsAbout this guide.............................................................................................. 9

Audience............................................................................................................10Conventions ......................................................................................................10Additional resources ........................................................................................10In your software package ................................................................................12

CHAPTER 1 Overview ........................................................................................................17BlackBerry Enterprise Server Software .........................................................18Administration software .................................................................................19Handheld compatibility ..................................................................................20Mobile Data Service .........................................................................................22Wireless email reconciliation ..........................................................................24Attachment service...........................................................................................24

CHAPTER 2 Preinstallation ...............................................................................................27System requirements........................................................................................28Firewall configuration .....................................................................................32Required CDO.dll hotfix versions..................................................................33Compatible versions of Microsoft Exchange administration and Windows software..............................................................................................................34Supported database versions..........................................................................34License keys.......................................................................................................35Evaluation version of the BlackBerry Enterprise Server.............................36Preinstallation checklist ...................................................................................38Summary of preinstallation procedures .......................................................41Defining a service account and mailbox .......................................................42Requirements for setting permissions on service accounts........................43Setting permissions ..........................................................................................44Creating a MAPI profile ..................................................................................47Installing and registering CDO.dll.................................................................48Installing database software ...........................................................................49Upgrading from Microsoft Exchange 5.5 administration extensions .......50

Installation and Getting Started Guide 5

Page 6: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

CHAPTER 3 Planning your installation ............................................................................53Overview ...........................................................................................................54Installation procedures ....................................................................................54Installation types ..............................................................................................55

CHAPTER 4 Installing BlackBerry Enterprise Server Software (Typical installation)...59Before you begin...............................................................................................60Installing BlackBerry Enterprise Server Software (Typical installation)..60Installing BlackBerry service(s) ......................................................................64Installing the attachment service and connector(s) .....................................67Installing BlackBerry Enterprise Server Management................................68Installing Mobile Data Service........................................................................75Completing the installation.............................................................................79

CHAPTER 5 Installing the attachment service on a remote computer .........................83Preinstallation steps .........................................................................................84Installing the attachment service on a remote computer............................84

CHAPTER 6 Installing and removing multiple services..................................................91Overview ...........................................................................................................92Installing multiple services .............................................................................92Removing service(s) .......................................................................................108

CHAPTER 7 Installing administration software ............................................................113Installing BlackBerry Enterprise Server Management software (standalone) .....................................................................................................114Creating a database after the BlackBerry Enterprise Server Management installation (optional).....................................................................................127

CHAPTER 8 Installing standalone BlackBerry User Administration............................131Installing BlackBerry User Administration software (standalone) .........132

CHAPTER 9 Postinstallation procedures .......................................................................147Verifying MAPI profiles ................................................................................148Configuring the BlackBerry Enterprise Server(s) ......................................150Stopping or starting the BlackBerry Enterprise Server services..............151Importing system information .....................................................................153Removing BlackBerry Enterprise Server administration extensions......154

6 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 7: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Starting BlackBerry User Administration service manually....................154Using the BlackBerry User Administration client .....................................156

CHAPTER 10 Upgrading, updating, and modifying BlackBerry Enterprise Server......159Prerequisites for upgrade..............................................................................160Upgrading overview......................................................................................160Before upgrading your software ..................................................................161Upgrading BlackBerry Enterprise Server ...................................................162Updating BlackBerry Enterprise Server ......................................................164Modifying the BlackBerry Enterprise Server..............................................185

CHAPTER 11 Removing software .....................................................................................191Removing BlackBerry Enterprise Server administration extensions......192Removing BlackBerry Enterprise Server Software....................................193Removing the attachment service and attachment connector .................196Removing the attachment connector only ..................................................200Removing BlackBerry Enterprise Server Management software ............204Removing BlackBerry User Administration Software ..............................209Removing Mobile Data Service ....................................................................213Removing BlackBerry Server utilities..........................................................218

CHAPTER 12 Error messages ............................................................................................2235301 Startup error ...........................................................................................2245302 Windows error .......................................................................................2245401 Windows error .......................................................................................2255407 error .........................................................................................................226No Service Name Error (5403 or 5404) ........................................................227BlackBerry User Administration service error codes................................227Attachment service errors .............................................................................230Mobile Data Service debug logs: Insufficient database permissions ......231MAPI error codes ...........................................................................................233

CHAPTER 13 Frequently asked questions .......................................................................235

Index.............................................................................................................249

Installation and Getting Started Guide 7

Page 8: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

8 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 9: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guideThis BlackBerry Enterprise Server for Microsoft Exchange 2000/2003 Installation and Getting Started Guide will help you

� set up the accounts, permissions, and profiles required for installation,

� install or upgrade the server software,

� answer frequently asked questions about the installation,

� and describe error messages that you might encounter during the installation.

Page 10: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guide

AudienceThe audience for this guide is information technology administrators with knowledge of implementing and managing Microsoft® Exchange.

Conventions

Additional resourcesAfter you install the software, all additional documentation is located in the Docs directory, with the installed software.

Note: Notes contain important information on the associated topic.

Warning: Warnings advise you that failure to take or avoid a specific action could result in data loss or physical damage.

Tip: Tips provide optional or time-saving information on the associated topic.

10 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 11: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guide

Installation documentation

Administration documentation

BlackBerry Enterprise Server Management software offers online Help to guide you and answer your questions. To open the online Help, click Help in the Help menu of any active window.

Stand alone IT Policy Manager documentation

The BlackBerry Enterprise Server IT Policy Getting Started Guide documents the stand alone IT Policy Manager utility (Root_directory:\itpolicy\ITPolicy.exe), which you must use only if wireless synchronization of IT policies is not supported. Refer to "Attachment service" on page 24 for more information on wireless IT policy synchronization support.

The IT Policy Manager utility offers online Help to guide you and answer your questions. To open the online Help, click Help in the Help menu of the IT Policy Manager.

Title Location on installation CD

BlackBerry Enterprise Server for Microsoft Exchange 2000/2003 Installation and Getting Started Guide

Root_directory:\Docs\Installation with Microsoft Exchange 2000_2003.pdf

BlackBerry Enterprise Server for Microsoft Exchange 5.5 Installation and Getting Started Guide

Root_directory:\Docs\Installation with Microsoft Exchange 5.5.pdf

Title Location on installation CD

BlackBerry Enterprise Server Software Administration Guide

Root_directory:\Docs\Administration Guide.pdf

Title Location on installation CD

BlackBerry Enterprise Server IT Policy Getting Started Guide

Root_directory:\itpolicy\itpolicy.pdf

Installation and Getting Started Guide 11

Page 12: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guide

API documentation

If any of these components are missing, contact the source from which you obtained your BlackBerry Enterprise Server Software.

In your software packageYour BlackBerry Enterprise Server Software package should contain the following items:

Title Location on installation CD

BlackBerry Enterprise Server Extension API Reference Guide

Root_directory:\API\docs\bes_ext_api.pdf

BlackBerry Enterprise Server Software and additional tools

Description

BlackBerryServer.exe This program redirects email from the user's Microsoft Exchange mailbox to the BlackBerry handheld.

BESAlert.exe This program monitors the Windows NT Event Log and can be configured to send notification to defined users when specified event levels are logged.

dbghelp.dll This .dll file is a helper file for debug logging.

C:\WINNT\System32\BESPerfInfo.dll

This .dll file enables administrators to view dynamic global statistics.

C:\Program Files\Research In Motion\BlackBerryEnterprise Server\BlackBerryServerSNMPAgent.dll

This .dll file enables administrators to view dynamic global statistics.

12 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 13: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guide

BESManMMC.msc (with BesManMMC.dll)

This BlackBerry Enterprise Server Management (MMC Snap-in) software is used to administer the BlackBerry Enterprise Server.

createdb.exe This program creates the BlackBerry Enterprise Server Management (MMC Snap-in) database. The database can also be created during the installation of the BlackBerry Enterprise Server Management software.

CalHelper.exe This program isolates calendar and mail processing by restricting external CDO Helper applications to all BlackBerry Enterprise Server calendar code that uses CDO.dll calls. Log messages are routed from CalHelper applications and written to the appropriate BlackBerry Enterprise Server log file.

Utilities Description

BESProfile.exe This GUI program enables you to edit the Messaging API (MAPI) profile that is used by the BlackBerry Enterprise Server.

DBConsistency.exe This utility maintains the Mobile Data Service’s database consistency. If you set the BlackBerry Enterprise Server as a push server, then DBConsistency runs automatically (every 24 hours by default) but you must reboot the server or manually start the BlackBerry Database Consistency service for the first time. If you do not set the BlackBerry Enterprise Server as a push server, then you have to run BlackBerry Database Consistency manually every time.

BBUserAdminClient.exe This program enables administrators to add, delete, or list users on a specified BlackBerry Enterprise Server.Note: To run BBUserAdminClient.exe on a computer that does not have BBUserAdminService.exe installed, copy BBUserAdminClient.exe and ce.dll to the new computer. The ce.dll file can be found at the following location:� Windows 2000 and Windows NT 4.0: C:\Winnt\System32\

� Windows 2003: C:\Windows\System32\

Copy the file to the same location on the new computer.

BBUserAdminService.exe This service runs the requests that are made by the BBUserAdminClient.

BlackBerry Enterprise Server Software and additional tools

Description

Installation and Getting Started Guide 13

Page 14: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guide

BBPerfMonInstall.exe This utility repairs the installation of the BlackBerry Enterprise Server Performance Monitor .dll file.

BBSRPTest.exe This utility tests the SRP connection to the wireless network

BlackBerryBackup.exe This utility enables backup of BlackBerry Enterprise Server and its users.

BlackBerryController.exe This utility monitors the BlackBerry Enterprise Server and restarts the BlackBerry Enterprise Server when inactive services or non-responsive threads are detected.

FBUpdate.exe This utility is a helper program used by the BlackBerry Enterprise Server to force updates to Microsoft® Outlook free/busy information.

HandheldCleanup.exe This utility enables administrators to retrieve and update configuration information for individual BlackBerry Enterprise Server users and each BlackBerry Enterprise Server.

IEMSTest.exe This utility tests the permission requirements for a BlackBerry Enterprise Server.

fixmapisvc.exe This utility should be run before you create a new Messaging API (MAPI) profile if the MAPI profile cannot be found.

ITPolicy.exe (with policy.inf and keyword.txt)

This ITPolicy.exe utility and the policy.inf and keyword.txt files enable you to apply IT policies when wireless IT policy synchronization is not supported.

SetAdminKey.exe The SetAdminKey.exe utility allows you to define the accessibility of certain Blackberry Enterprise Server functions on specific administration computers. The SetAdminKey.exe utility can enable the following three levels of access to the BlackBerry Enterprise Server administration options:� User access mode

� Policy access mode

� Full access mode

For a detailed description of the features enabled/disabled by each parameter, refer to C:\Program Files\Research In Motion\BlackBerry Enterprise Server\tools\SetAdminKey_Readme.txt for more information.

Utilities Description

14 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 15: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guide

The following BlackBerry Enterprise Server API components are provided on the CD in the API folder:

If you install the attachment service(s), the following components are available:

API components Description

BESExtension.hh This BlackBerry Enterprise Server Extension Application Programmer Interface (API) file enables you to write custom applications that process messages and attachments that are forwarded to and from the BlackBerry Wireless Handheld.

Attachment service components

Description

BBAttachEngine.dll This utility parses the attached files and constructs binary XML structure.

BBAttachServer.exe This program runs as a Windows Service and monitors conversion processes.

BBConvert.exe This process calls BBAttachEngine.dll to convert the attachments to the required format.

BBDocSubmit.dll This utility submits attachments and communicates with BBAttachServer.dll.

BBAttachBESExtension.dll This utility processes messages with attachments and calls BBDocSubmit.dll.

BBDM_Excel.dll This utility supports Microsoft Excel format files.

BBDM_pdf.dll This utility supports Adobe® PDF files.

BBDM_PowerPoint.dll This utility supports Microsoft PowerPoint format files.

BBDM_Text.dll This utility supports ASCII text format files.

BBDM_Word2000.dll This utility supports Microsoft Word format files.

BBDM_Wordperfect.dll This utility supports Corel® WordPerfect format files.

BBSM_UCS.dll This utility supports Universal Content Stream format files.

Note: Each command-line utility includes a usage parameter that provides more extensive information on each utility.

Installation and Getting Started Guide 15

Page 16: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

About this guide

16 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 17: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 1OverviewThis section provides information on the following topics:

� BlackBerry Enterprise Server Software

� Administration software

� Handheld compatibility

� Mobile Data Service

� Wireless email reconciliation

� Attachment service

Page 18: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 1: Overview

BlackBerry Enterprise Server SoftwareBlackBerry® is a mobile email solution on a wireless network. The BlackBerry solution consists of the handheld, cradle/charger or USB cable, and desktop software.

The BlackBerry Enterprise Server centralizes email redirection for handheld users in an organization. The server software performs the following functions for each user:

� monitors the user�s mailbox for new mail

� applies filters (defined by the user or the administrator) to new messages to determine if and how the BlackBerry Server Servername service relays the message to the user�s handheld

� compresses and encrypts new messages and delivers them to the handheld over the Internet

� receives, over the Internet, messages that are composed on the handheld, and then decrypts and decompresses the messages and places them in the user�s Outbox for the corporate Microsoft Exchange Server to deliver

The BlackBerry Enterprise Server runs as a Windows NT® Server, Windows® 2000 Server, or Windows Server 2003® service that can monitor many users at once over a single administrative connection to the Microsoft Exchange Server. The BlackBerry Enterprise Server maintains a direct TCP/IP connection (Server Routing Protocol or SRP) to the wireless network. This mode of connection requires that you configure your corporate firewall to enable the BlackBerry Enterprise Server to connect through port 3101. This is not a �hole� in the firewall; only an outbound connection is required.

The following illustration shows an example of events that occur when an external email message is sent to a handheld user on the BlackBerry Enterprise Server.

18 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 19: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Administration software

BlackBerry Enterprise Server message flow

Administration softwareBlackBerry Enterprise Server can be administered by BlackBerry Enterprise Server Management, whether you are installing in a Microsoft Exchange 5.5 environment, a Microsoft Exchange 2000 environment, a Microsoft Exchange 2003 environment, or a �mixed mode� environment (where any combination of Microsoft Exchange 5.5 and/or Microsoft Exchange 2000 and/or Microsoft Exchange 2003 environments exsist).

BlackBerry Enterprise Server ManagementBlackBerry Enterprise Server Management functions as a snap-in to the Microsoft Management Console.

Installation and Getting Started Guide 19

Page 20: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 1: Overview

From the BlackBerry Enterprise Server Management console, you can administer users at the server level and mailbox level. The BlackBerry Enterprise Server Management software includes the BlackBerry Enterprise Server Management console (the interface that enables administration of the BlackBerry Enterprise Server(s) and its users). The BlackBerry Enterprise Server Management software requires a Microsoft Data Engine (MSDE) or SQL database to store data relevant to the BlackBerry Enterprise Server(s) and administration mailboxes. Refer to "Supported database versions" on page 34 for more information on supported database engines.

BlackBerry User Administration softwareThe BlackBerry User Administration service client is a command prompt administration utility that enables you to remotely add, delete, or list users for a specific BlackBerry Enterprise Server. BlackBerry User Administration service client users are not required to have administration permission on a BlackBerry Enterprise Server. Before you can use the BlackBerry User Administration client, you must install the BlackBerry User Administration service on a server.

Handheld compatibilityHandhelds running with BlackBerry Desktop Software version 2.0 or later are compatible with BlackBerry Enterprise Server version 3.5 or later. However, many features are supported only with specific versions of the BlackBerry Enterprise Server, desktop software, and handheld software. Handheld software version depends on whether the handheld is C++-enabled or Java�-enabled.

� C++-enabled handhelds are BlackBerry handhelds for DataTAC® and Mobitex networks (this includes but might not be limited to RIM 850 Wireless Handheld�, RIM 857 Wireless Handheld�, RIM 950 Wireless Handheld�, and RIM 957 Wireless Handheld�)

� Java-enabled handhelds are BlackBerry handhelds for CDMA2000 1X, GSM�/GPRS, or Nextel® networks (this includes but might not be limited to BlackBerry 5800 Series, BlackBerry 6200 Series, BlackBerry 6500 Series, and BlackBerry 6700 Series of wireless handhelds)

Wireless calendar synchronization support

A handheld with software version 2.0 does not support the wireless calendar synchronization feature. To support the wireless calendar synchronization feature, you must use (at least) the following software versions in conjunction:

� BlackBerry Desktop Software version 2.1

Note: BlackBerry Enterprise Server Management can be used with the BlackBerry Enterprise Server version 2.0 or later, although some options might not be available with earlier server versions (for example, wireless IT policy synchronization).

20 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 21: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Handheld compatibility

� version 2.1 or later of the handheld software

� BlackBerry Enterprise Server version 2.1 or later

Wireless synchronization of IT policy settings and IT admin commands support

The wireless synchronization of IT policy settings and IT admin commands is available with version 3.5 or later of the BlackBerry Desktop Software, and with the following handheld software versions:

� version 2.5 or later of the handheld software for C++-enabled handhelds

� version 3.6 or later of the handheld software for Java-enabled handhelds

Remote Address Lookup support

The Remote Address Lookup feature is available with the following handheld software versions:

� version 2.5 or later of the handheld software for C++-enabled handhelds

� version 3.6 or later of the handheld software for Java-enabled handhelds

Attachment service support

The stand alone-only attachment service feature is supported with the following software versions in conjunction:

� BlackBerry Desktop Software version 2.1 or later

� version 2.1 or later of the handheld software

� BlackBerry Enterprise Server version 3.5 or later

The integrated attachment service feature is supported on the BlackBerry Enterprise Server (version 3.6 Service Pack 1 and later) with the following software versions in conjunction:

� BlackBerry Desktop Software version 2.1 or later

� version 2.1 or 2.5 of the handheld software for C++-enabled handhelds

� version 3.6 or later of the handheld software Java-enabled handhelds

� BlackBerry Enterprise Server version 3.6 or later

The integrated attachment service feature is supported on the BlackBerry Enterprise Server (version 3.6 Service Pack 1 and later) or a remote computer with the following software versions in conjunction:

� BlackBerry Desktop Software version 2.1 or later

Installation and Getting Started Guide 21

Page 22: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 1: Overview

� version 2.1 or 2.5 of the handheld software for C++-enabled handhelds

� version 3.6 or later of the handheld software Java-enabled handhelds

� BlackBerry Enterprise Server version 3.6 Service Pack 1 or later

Wireless email reconciliation support

Wireless email reconciliation support is available only with BlackBerry Enterprise Server version 3.6 or later, and is enabled only on the following handheld software versions:

� version 2.6 or later of the handheld software for C++-enabled handhelds

� version 3.6 or later of the handheld software for Java-enabled handhelds

Mobile Data ServiceThe Mobile Data Service manages and alters information so that it can pass between the intranet and the BlackBerry handheld more efficiently.

Direct flow between the handheld application and a network server does not occur; all information must pass through the Mobile Data Service first. As the intermediary agent, the Mobile Data Service can perform two functions:

� Data conversion: As a proxy, Mobile Data Service intercepts information that passes between handheld applications and the content server. Data conversion might be necessary if the content that returns from the server is not formatted appropriately.

� Data routing: As a channel, Mobile Data Service passes information back and forth between the handheld application and the content server. The content that is sent by the application and the content that is sent by the server is not altered before being passed on to its destinations.

After you install the Mobile Data Service, it must be enabled at the server and user level before it can be used on the handheld.

Note: The Mobile Data Service is a medium for data transmission. The customer is responsible for the applications on the handheld and the server that transmit and receive such data, and for the compatibility of applications with the Mobile Data Service. RIM is not responsible for the functionality or compatibility of such applications, nor for the data that passes through the Mobile Data Service.

22 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 23: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Mobile Data Service

S/MIMEThe current BlackBerry infrastructure provides secure email transport between your organization�s network and the BlackBerry Wireless Handheld using Triple Data Encryption Standard (DES) encryption technology. This means that email that is delivered to handhelds is as secure as the messages that are delivered to a personal computer on your organization�s network.

Secure Multipurpose Internet Mail Extensions (S/MIME) offers an additional layer of security between the sender and recipient of an email message. S/MIME technology enables end-to-end authentication and confidentiality, and protects data integrity and privacy from the time the originator of the message sends it over the wireless network to the time it is decoded and read by the message recipient.

S/MIME is enabled at the server level (through the BlackBerry Enterprise Server Management console) and on the handheld. The Mobile Data Service parameters for Online Certificate Status Protocol (OCSP) properties and Lightweight Directory Access Protocol (LDAP) are required for S/MIME digital signing to work. Configure Mobile Data Service parameters through the BlackBerry Enterprise Server�s Mobile Data Service Properties window in the BlackBerry Enterprise Server Management console.

BrowserOn the C++-enabled handhelds, the browser only works with the Mobile Data Service. The Mobile Data Service must be enabled for users to use the browser.

On the Java-enabled handhelds, the browser works with two types of gateways:

� a Wide Area Protocol (WAP) gateway that is operated by the network operator,

� or the Mobile Data Service.

(Refer to "Handheld compatibility" on page 20 for more information about supported networks, handheld versions, and handheld and desktop software versions.)

The Mobile Data Service must be used to access corporate intranets, but it can also be used to access the Internet. Support for WAP or Mobile Data Service depends on provisioning by the network operator.

Warning: Before users can send and receive S/MIME messages, they must install the BlackBerry Desktop Software with S/MIME Support and update their handhelds to support S/MIME services. After S/MIME is enabled, they can send and receive encrypted messages, attach a signature to outgoing messages, and perform wireless certificate searches.

Installation and Getting Started Guide 23

Page 24: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 1: Overview

The Mobile Data Service uses a protocol called the IP Proxy Protocol (IPPP) to communicate with the handheld. Communication between the handheld and the Mobile Data Service is encrypted in the same way as email.

Wireless email reconciliationWireless email reconciliation means that the user can read, move or delete email messages on either the handheld or the desktop and see these changes wirelessly synchronized between the handheld and the desktop. One-way folder synchronization means that if the user creates, deletes, renames, or moves a folder on the desktop, the change is wirelessly reconciled on the handheld. When a user moves a folder to the Deleted Items folder on the desktop, the messages in the folder are also deleted and the deletes are synchronized on the handheld.

The user is not required to connect the handheld to the computer and synchronize email using the desktop software in order for message filing, message Read/Unread status, or message deletes made on the handheld to be reflected on the desktop, or changes on the desktop to be reflected on the handheld. When a user reads, files or deletes a message on the handheld, it is automatically reflected on the desktop and vice versa.

After installation of the BlackBerry Enterprise Server version 3.6 or later, wireless email reconciliation support is enabled by default on the BlackBerry Enterprise Server and for all users on the server. When wireless email reconciliation support is enabled for a user, and the enabled user upgrades the handheld to either version 2.6 or later of the handheld software for C++-enabled handhelds or version 3.6 of the handheld software for Java-enabled handhelds, on the user�s upgraded handheld the Message List Options screen Wireless Reconcile field is automatically set to On. (Refer to "Handheld compatibility" on page 20 for more information about supported networks, handheld versions, and handheld and desktop software versions.)

Attachment serviceThe attachment service feature requires that you install an attachment connector on the BlackBerry Enterprise Server, and the attachment service on the BlackBerry Enterprise Server or a remote computer. The attachment connector on the BlackBerry Enterprise Server processes attachments converted by the local or remote attachment service for viewing on the BlackBerry handheld. Attachment service and attachment connector settings are configurable through the BlackBerry Attachment Service Configuration tool, installed by default with the attachment service.

Note: After the user upgrades the handheld to a version that supports wireless email reconciliation, changes made to messages on the user’s handheld are reflected on the user’s desktop within a short period of time. If there are pending changes on the user’s handheld that require immediate reconciliation, the user can reconcile the email messages from the handheld manually using the Reconcile Now option.

24 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 25: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Attachment service

After you install the attachment service feature, the BlackBerry Enterprise Server can deliver email attachment content to any BlackBerry handheld. The Triple-DES encryption of the BlackBerry Enterprise Server applies to the attachment content.

Using the attachment service feature, handheld users can open attachments (on supported handheld versions) with the following file name extensions: .doc, .dot, .xls, .pdf, .ppt, .wpd, .zip, .htm, .html, and .txt. The attachment service converts the file formats to the Universal Content Stream (UCS) format and delivers the files as email attachments to the handheld. The attachment service generates content which is received by the handheld based on requests by the handheld user for a Table of Contents or Full Content.

Installation and Getting Started Guide 25

Page 26: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 1: Overview

26 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 27: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2PreinstallationThis section provides information on the following topics:

� System requirements

� Firewall configuration

� Required CDO.dll hotfix versions

� Compatible versions of Microsoft Exchange administration and Windows software

� Supported database versions

� License keys

� Evaluation version of the BlackBerry Enterprise Server

� Preinstallation checklist

� Summary of preinstallation procedures

� Defining a service account and mailbox

� Requirements for setting permissions on service accounts

� Setting permissions

� Creating a MAPI profile

� Installing and registering CDO.dll

� Installing database software

� Upgrading from Microsoft Exchange 5.5 administration extensions

Page 28: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

System requirementsThe BlackBerry Enterprise Server Software requires the following hardware and software components:

Hardware� Computer with an Intel® Pentium® III processor or compatible (500 MHz or later, 256-MB

RAM, 1-GB hard drive)

SoftwareBlackBerry Enterprise Server works in the following environments:

� Microsoft Exchange 5.5 (or later) native environment

� Microsoft Exchange 2000 native environment

� Microsoft Exchange 2003 native environment

� mixed environment (any combination of Microsoft Exchange 5.5 and/or Microsoft Exchange 2000 and/or Microsoft Exchange 2003)

Note: If you are installing the attachment service on the BlackBerry Enterprise Server or a remote computer, you should use a computer with an additional 1-GB RAM available.

Note: If you are installing the Mobile Data Service on the BlackBerry Enterprise Server, you should use a computer with an additional 256-MB RAM available.

Warning: You cannot run the BlackBerry Enterprise Server service on a computer that is running Terminal Services in Application Server mode. The following configurations are supported:

� In Windows Server 2003, Terminal Server should not be installed (installation automatically activates Application Server mode) and Remote Desktop mode should be selected on the System Properties Remote tab.

� In Windows Server 2000, if Terminal Services is installed, the Remote Administration mode radio button should be selected during the installation.

If you install the BlackBerry Enterprise Server on a computer that is running Terminal Services in Application Server mode, you are only permitted to install BlackBerry Enterprise Server Management.

28 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 29: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

System requirements

BlackBerry Enterprise Server on a Microsoft Exchange 2000 Server

The following software is required for the BlackBerry Enterprise Server to function in a Microsoft Exchange 2000 environment:

� Windows 2000 Server (Service Pack 1 or later)

� Microsoft Exchange 2000 (Service Pack 2 or later) mail server environment

� Microsoft Exchange 2000 System Manager, on the same computer as the BlackBerry Enterprise Server service

� Before installing the BlackBerry Enterprise Server, install the appropriate CDO.dll hotfix on the Microsoft Exchange Server. Refer to "Required CDO.dll hotfix versions" on page 34 for more information on the correct CDO.dll hotfix for your configuration. Refer to "Installing and registering CDO.dll" on page 52 for more information on installing and registering the CDO.dll hotfix to C:/winnt/system32/.

Warning: You should install the BlackBerry Enterprise Server service on a computer without Microsoft Exchange 2000 installed.

Note: If a Service Pack of Microsoft Exchange is installed on the Microsoft Exchange Server, you should install the same Service Pack on the BlackBerry Enterprise Server to update your Microsoft Exchange administration software.

Warning: You should not have Microsoft Outlook installed on the computer on which you are installing the BlackBerry Enterprise Server. If Microsoft Outlook is present on the BlackBerry Enterprise Server computer, wireless calendar synchronization does not work because Microsoft Outlook’s versions of CDO.dll and Messaging API (MAPI) files do not support wireless calendar synchronization. If Microsoft Outlook is opened on a BlackBerry Enterprise Server, it attempts to overwrite the MAPI system. Therefore, Microsoft Outlook on a BlackBerry Enterprise Server is an unsupported configuration.

Installation and Getting Started Guide 29

Page 30: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

BlackBerry Enterprise Server on a Microsoft Exchange 2003 Server

The following software is required for the BlackBerry Enterprise Server to function in a Microsoft Exchange 2003 environment:

� Windows 2000 Server (Service Pack 1 or later) or Windows Server 2003

� Microsoft Exchange 2003 mail server environment

� Microsoft Exchange 2000 System Manager (not supported on Windows 2003) or Microsoft Exchange 2003 System Manager, on the same computer as the BlackBerry Enterprise Server service

� You should not have Microsoft Outlook installed on the computer on which you are installing the BlackBerry Enterprise Server. If Microsoft Outlook is present on the BlackBerry Enterprise Server computer, wireless calendar synchronization will not work because Microsoft Outlook�s versions of CDO.dll and MAPI files do not support wireless calendar synchronization. If Microsoft Outlook is opened on a BlackBerry Enterprise Server, it will attempt to overwrite the MAPI system. Therefore, Microsoft Outlook on a BlackBerry Enterprise Server is an unsupported configuration.

� Before installing the BlackBerry Enterprise Server, install the appropriate CDO.dll hotfix on your Microsoft Exchange Server. Refer to "Required CDO.dll hotfix versions" on page 34 for more information on the correct CDO.dll hotfix for your configuration. Refer to "Installing and registering CDO.dll" on page 52 for more information on installing and registering the CDO.dll hotfix to C:/winnt/system32/.

Warning: You should install the BlackBerry Enterprise Server service on a computer without Microsoft Exchange 2003 installed.

Note: If a Service Pack of Microsoft Exchange is installed on the Microsoft Exchange Server, you should install the same Service Pack on the BlackBerry Enterprise Server to update your Microsoft Exchange administration software.

Warning: You should not have Microsoft Outlook installed on the computer on which you are installing the BlackBerry Enterprise Server. If Microsoft Outlook is present on the BlackBerry Enterprise Server computer, wireless calendar synchronization does not work because Microsoft Outlook’s versions of CDO.dll and Messaging API (MAPI) files do not support wireless calendar synchronization. If Microsoft Outlook is opened on a BlackBerry Enterprise Server, it attempts to overwrite the MAPI system. Therefore, Microsoft Outlook on a BlackBerry Enterprise Server is an unsupported configuration.

30 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 31: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

System requirements

BlackBerry Enterprise Server Management

BlackBerry Enterprise Server Management can be installed on the BlackBerry Enterprise Server computer or on a remote computer.

The following software is required for BlackBerry Enterprise Server Management to function:

� Windows NT Server 4.0 (Service Pack 5 or later), Windows 2000 Server (Service Pack 1 or later), Windows Server 2003, Windows 2000 Professional, or Windows XP.

� A database engine must be installed before, during, or after BlackBerry Enterprise Server Management installation and a database must be created on the database server, before you can use BlackBerry Enterprise Server Management.

Install only ONE of the following tools (to get MAPI on the computer):

� Microsoft Exchange 5.5 Administrator (not supported on Windows Server 2003)

� Microsoft Exchange 2000 System Manager (not supported on Windows Server 2003)

� Microsoft Exchange 2003 System Manager (not supported on Windows NT Server 4.0)

� Microsoft Outlook 2000 (Corporate or Workgroup installation)

� Microsoft Outlook 2003 (Corporate or Workgroup installation)

� Microsoft Outlook XP (Corporate or Workgroup installation)

Warning: If you install BlackBerry Enterprise Server Management on the same computer as the BlackBerry Enterprise Server service, you are restricted by the prerequisite tools of the BlackBerry Enterprise Server, which do not include as many optional operating systems as does BlackBerry Enterprise Server Management.

Note: Refer to "Supported database versions" on page 34 for more information on supported database engines. MSDE 2000 Service Pack 3 is available on the Microsoft site through the following link: http://www.microsoft.com/downloads/details.aspx?FamilyId=90DCD52C-0488-4E46-AFBF-ACACE5369FA3&displaylang=en.

Warning: Use only one database for each organization. Refer to "What is the recommended database configuration for BlackBerry Enterprise Server?" on page 237 for more information.

Warning: Install Microsoft Outlook 2000 (Corporate or Workgroup), Microsoft Outlook 2003 (Corporate or Workgroup), or Microsoft Outlook XP (Corporate or Workgroup) only if you also install BlackBerry Enterprise Server Management on an administration-only computer, separate from the BlackBerry Enterprise Server. Microsoft Outlook is not supported on the BlackBerry Enterprise Server. If Microsoft Outlook is present on the BlackBerry Enterprise Server computer, wireless calendar synchronization does not work because the Microsoft Outlook versions of CDO and MAPI DLLs do not support wireless calendar synchronization. If Microsoft Outlook is opened on a BlackBerry Enterprise Server, it attempts to overwrite the Messaging API (MAPI) system.

Installation and Getting Started Guide 31

Page 32: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

BlackBerry Enterprise Server Management on a Windows NT Server 4.0

The following software is required for BlackBerry Enterprise Server Management to function on a Windows NT Server 4.0. These tools are built into Windows 2000/2003 Server. You only need to install them if you are running Windows NT Server 4.0:

� Active Directory Service Interfaces (ADSI) 2.5: You can download this software fromhttp://www.microsoft.com/ntserver/nts/downloads/other/ADSI25/default.asp

� Microsoft Management Console 1.2: You can download this software from http://www.microsoft.com/downloads/release.asp?ReleaseID=39918&area=search&ordinal=3

After you install Microsoft Management Console 1.2, you should complete an initial startup of the installed software (type MMC at the command prompt) before you continue.

BlackBerry User Administration

The following software is required for BlackBerry User Administration to function:

� BlackBerry User Administration has the same system requirements, but it requires different permissions from the BlackBerry Enterprise Server.

� BlackBerry Enterprise Server and Microsoft Exchange are not required on the same computer as BlackBerry User Administration.

Mobile Data Service

The following software is required for Mobile Data Service 1.1 to function:

� Open Database Connectivity (ODBC) 2.6 or later on the Mobile Data Service computer. ODBC is installed with SQL Server (7.0 or 2000) or MSDE (1.0 or 2000). If you are not installing a database tool (which is required for the BlackBerry Enterprise Server Management database), download Microsoft Data Access Components (MDAC) 2.6 or later from http://www.microsoft.com/data/download.htm

� Mobile Data Service must be able to send HTTP requests through TCP/IP port 3101 so that browsers on Mobile Data Service-enabled handhelds function properly.

Warning: Universal Serial Bus (USB) drivers are not supported in a Windows NT 4.0 Server environment.

Warning: To install BlackBerry User Administration, BlackBerry Enterprise Server Management must be installed on the same computer.

Warning: If your network uses a proxy auto-configuration (PAC) file, you must have Windows 2000 Service Pack 3 installed.

32 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 33: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Firewall configuration

� Java Runtime Environment (JRE) 1.4: This software is provided on the BlackBerry Enterprise Server CD in drive:\tools\. Launch j2re-1_4_1_02-windows-i586-i.exe and complete the installation.This version of JRE has Java Secure Socket Extension (JSSE) embedded

Remote attachment service

The following software is required for the attachment service on a remote computer to function:

� Windows NT® 4.0 Server (Service Pack 5 or later) or Windows 2000 Server (Service Pack 1 or later) or Windows Server 2003

Firewall configurationThe BlackBerry Enterprise Server initiates outbound, bidirectional connections to the wireless network. To support BlackBerry in an environment that has a firewall in place, you must configure the firewall to enable the computers running the BlackBerry Enterprise Server within the company to initiate TCP/IP connections to an outside server that is listening on port 3101. If you use a proxying firewall, the proxy must be transparent.

Verify that your firewall is configured to accommodate these types of outbound-initiated connections bidirectionally.

Note: A transparent proxy does NOT modify requests or responses through the proxy during proxy authentication and identification, whereas a non-transparent proxy (where the client specifies the host name and port number of the proxy) IS used to modify requests or responses through the proxy. If you have a non-transparent proxy, the BlackBerry Enterprise Server can be configured to access an internal proxy address which is then translated externally to the SRP Host on port 3101.

Note: Your corporate firewall must be able to resolve Internet addresses using the Domain Name System (DNS).

Installation and Getting Started Guide 33

Page 34: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

Required CDO.dll hotfix versionsMicrosoft Outlook�s versions of CDO.dll and MAPI files do not support wireless calendar synchronization. Thus, you should not have Microsoft Outlook installed on the computer on which you are installing the BlackBerry Enterprise Server, and before installing the BlackBerry Enterprise Server, you should install the appropriate CDO.dll hotfix on the Microsoft Exchange Server and copy it to the BlackBerry Enterprise Server computer.

The correct CDO.dll hotfix is based on your Microsoft Exchange installation version and the Microsoft Outlook version running on your handheld user(s) desktop(s).

Refer to the table below for the required CDO.dll hotfix version for each configuration

Microsoft Outlook 2000 or earlier Microsoft Outlook 2003

MicrosoftExchange 5.5

CDO version: 5.5.2655.79Download: http://www.microsoft.com/downloads/release.asp?ReleaseID=38967&area=search&ordinal=1,

CDO version: 5.5.2657.55Download: http://www.microsoft.com/downloads/details.aspx?FamilyID=b106c749-71f8-44cc-86cf-ab5cda169127&displaylang=en,

MicrosoftExchange 2000

CDO version: 6.0.5770.16Download: http://www.microsoft.com/downloads/release.asp?ReleaseID=38952&area=search&ordinal=2,

CDO version: 6.0.6487.2Download: http://www.microsoft.com/downloads/details.aspx?FamilyId=22DD4E2D-E061-401F-B091-6FDC400AB66E&displaylang=en

MicrosoftExchange 2003

CDO version: 6.5.6944.0This version is installed automatically with Microsoft Exchange 2003.

CDO version: 6.5.6980.3Download: http://www.microsoft.com/downloads/details.aspx?FamilyId=CA4DFFB9-4937-4DE4-B66F-9990F75C908E&displaylang=en,

Note: Refer to "Installing and registering CDO.dll" on page 48 for more information on downloading, installing, and registering the CDO.dll hotfix.

34 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 35: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Compatible versions of Microsoft Exchange administration and Windows software

Compatible versions of Microsoft Exchange administration and Windows softwareThe following table indicates supported combinations of Microsoft Exchange administration software (vertical) and Microsoft Windows operating systems (horizontal).

Supported database versionsThe BlackBerry Enterprise Server Management software requires a Microsoft Data Engine (MSDE) or SQL database to store data that is relevant to the BlackBerry Enterprise Server(s) and administration mailboxes. MSDE 2000 is provided with the BlackBerry Enterprise Server Software package to be installed (on a supported operating system only) if you do not already have an MSDE or SQL database engine installed.

Windows NT Server 4.0 or later

Windows 2000 Server Windows Server 2003

MicrosoftExchange 5.5

AdministratorSupported Supported Not Supported

MicrosoftExchange 2000

System ManagerSupported Supported Not Supported

MicrosoftExchange 2003

System ManagerNot Supported Supported Supported

Note: For database support on Windows Server 20003, you must upgrade to MSDE 2000 Service Pack 3. MSDE 2000 Service Pack 3 is available on the Microsoft site through the following link: http://www.microsoft.com/downloads/details.aspx?FamilyId=90DCD52C-0488-4E46-AFBF-ACACE5369FA3&displaylang=en.

Installation and Getting Started Guide 35

Page 36: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

Refer to the table below for more details on supported database engine and operating system configurations.

Refer to the Microsoft site http://www.microsoft.com/sql/howtobuy/windowsnetsupport.asp for further details on supported database engines and Microsoft Windows Server 2003.

License keysLicense keys enable the use of client licenses across your organization. For example, if you purchase a license key for 20 users, you can have 20 users across your organization on the BlackBerry Enterprise Server service(s) that you install with the license key. If you have multiple BlackBerry Enterprise Server services installed, the user limit applies to the total number of users on all of those BlackBerry Enterprise Server services.

To add more users after installation, you must purchase a new license key for the number of extra client licenses that you need and use BlackBerry Enterprise Server Management to enter the new license key, which adds that number to the total number of client licenses that are permitted across your organization.

Windows NT Server 4.0 or later

Windows 2000 Server Windows Server 2003

MSDE Supported Supported Not Supported

MSDE 2000 ServicePack 3

Supported Supported Supported

SQL 7.0 Supported Supported Not Supported

SQL 2000 ServicePack 3

Supported Supported Supported

Warning: If you used a temporary evaluation license key previously, you cannot reuse the temporary license key after you purchase a permanent license key. If you use a temporary license key, a warning dialog box appears when you open BlackBerry Enterprise Server Management to notify you of the number of days remaining until the key expires.

Note: The license key value listed in the registry (HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Enterprise Server\OwnerInformation\LicenseKey) is the original, permanent license key entered during installation of the BlackBerry Enterprise Server Software. The value does not update after a new license key is added in BlackBerry Enterprise Server Management to upgrade the number of client licenses.

36 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 37: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Evaluation version of the BlackBerry Enterprise Server

Evaluation version of the BlackBerry Enterprise ServerIf you have purchased an evaluation version of the BlackBerry Enterprise Server, the installation and administration of the BlackBerry Enterprise Server are the same as for a fully licensed version, with the following exceptions.

� When the evaluation period expires, the SRP connection becomes unavailable.

� An evaluation version of the BlackBerry Enterprise Server uses a temporary SRP Identifier that always begins with T.

� After installation, the BlackBerry Server Properties window indicates if the server is an evaluation version:

Evaluation version of BlackBerry Enterprise Server—BlackBerry Server Properties window

The server name appears at the top of the General tab in the following format: Servername (status, SRP status, version number installed Evaluation). This information is display only.

Note: The full version number of the evaluation BlackBerry Enterprise Server is the same as the full version number of a permanent, fully-licensed BlackBerry Enterprise Server.

Installation and Getting Started Guide 37

Page 38: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

You can view or change the following fields:

Field Description

Administration Mailbox The mailbox that you specified during installation appears, grayed out.

SRP Identifier The value is of the format T123456. The T indicates that the server is an evaluation version.If no value is assigned or you want to change the existing value, type the appropriate information (which is located on the BlackBerry Enterprise Server installation CD label). You can also click Import to retrieve the SRP Identifier from an .srp file if you created one to store your SRP identifier and SRP authentication key.

SRP Authentication Key If no value is assigned or you want to change the existing value, type the appropriate information (which is located on the evaluation BlackBerry Enterprise Server installation CD label).

Host Routing Information If host routing information was also provided on the evaluation BlackBerry Enterprise Server installation CD, define the information that is necessary to connect to the mobile network.Warning: You should only define values in this field if values are provided with the installation material. If you are using the default Network Access Node (the SRP Address value that is provided on your installation CD label), or are uncertain which values to use, leave this field blank. If you define incorrect values in this field, connection to the mobile network is not possible.

38 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 39: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Preinstallation checklist

Preinstallation checklistKeep this information in a secure environment. If you contact our support department you will require this information.

Hardware requirements (minimum)

Computer with an Intel® Pentium® processor or compatible (500 MHz or later)

256-MB RAM on the BlackBerry Enterprise Server

Additional 1-GB RAM for local or remote attachment service

Additional 256-MB RAM for Mobile Data Service

1-GB free disk space

10 Mbps LAN connection

Software requirements

BlackBerry Enterprise Server for Microsoft Exchange is in the same Microsoft Exchange domain as the mail server

Windows 2000 Server, Service Pack 1 or later or Windows 2003 Server

Installation and Getting Started Guide 39

Page 40: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

BlackBerry Enterprise Server requirements

Microsoft Exchange 2000 mail server environment (recommended installation on a separate computer from the BlackBerry Enterprise Server Service)

or

Microsoft Exchange 2003 mail server environment (recommended installation on a separate computer from the BlackBerry Enterprise Server Service)

Microsoft Exchange 2000 System Manager, on the same computer as the BlackBerry Enterprise Server service

or

Microsoft Exchange 2003 System Manager, on the same computer as the BlackBerry Enterprise Server service

Note: If a Service Pack of Microsoft Exchange is installed on the Microsoft Exchange Server, you should install the same Service Pack on the BlackBerry Enterprise Server to update your Microsoft Exchange administration software.

CDO.dll hotfix installed and registered

Remote attachment service requirements

Windows NT® 4.0 Server (Service Pack 5 or later) or Windows 2000 Server (Service Pack 1 or later) or Windows Server 2003

Mobile Data Service requirements

Mobile Data Service must be able to send HTTP requests through TCP/IP port 3101 for browsers on Mobile Data Service-enabled handhelds to function properly

Java Runtime Environment (JRE) 1.4: This software is provided on the BlackBerry Enterprise Server CD in drive:\tools\. Launch j2re-1_4_1_02-windows-i586-i.exe and complete the installation. This version of JRE has Java Secure Socket Extension (JSSE) imbedded.

If your network uses a proxy auto-configuration (PAC) file, you must have Windows 2000 Service Pack 3 or later installed.

40 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 41: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Preinstallation checklist

BlackBerry Enterprise Server Management requirements

Windows NT® Server 4.0 (Service Pack 5 or later) or Windows 2000 Server (Service Pack 1 or later) or Windows XP or Windows Server 2003 or Windows 2000 Professional

A database engine (MSDE, MSDE 2000, SQL 7.0, or SQL 2000 Service Pack 3) must be installed before, during, or after the BlackBerry Enterprise Server Management installation and you must create a database on the database server before you can use BlackBerry Enterprise Server Management. MSDE 2000 is provided on the BlackBerry Enterprise Server Software CD. You can upgrade to MSDE 2000 Service Pack 3 by downloading the service pack from the Microsoft site through the following link: http://www.microsoft.com/downloads/details.aspx?FamilyId=90DCD52C-0488-4E46-AFBF-ACACE5369FA3&displaylang=en

Install only ONE of the following tools:

� Microsoft Exchange 5.5 Administrator

� Microsoft Exchange 2000 System Manager

� Microsoft Exchange 2003 System Manager

� Microsoft Outlook 2000 (Corporate or Workgroup installation)

� Microsoft Outlook 2003 (Corporate or Workgroup installation)

� Microsoft Outlook XP (Corporate or Workgroup installation)

Warning: Install Microsoft Outlook 2000 (Corporate or Workgroup), Microsoft Outlook 2003 (Corporate or Workgroup installation), or Microsoft Outlook XP (Corporate or Workgroup installation) only if you will install BlackBerry Enterprise Server Management on an administration only computer, separate from the BlackBerry Enterprise Server. Microsoft Outlook is not supported on the BlackBerry Enterprise Server.

On a Windows NT Server 4.0 ONLY, install ALL of the following tools:

Microsoft Management Console 1.2

Active Directory Service Interfaces (ADSI) 2.5

Microsoft Internet Explorer 5.00 or later

Warning: Universal Serial Bus (USB) drivers are not supported in a Windows NT 4.0 Server environment.

Installation and Getting Started Guide 41

Page 42: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

You will be asked for the SRP Identifier and the SRP Authentication Key when you add new BlackBerry Enterprise Servers to the BlackBerry Enterprise Server Management console. You can find this information on the SRP Authentication Information label provided with your BlackBerry Enterprise Server for Microsoft Exchange installation CD. You should write down these values in the spaces provided below.

SRP information

SRP Host (the SRP Address value provided on your installation CD label):

SRP Identifier(s) (one per BlackBerry Enterprise Server service): Service #1:___________________________________________________

Service #2:___________________________________________________

Service #3:___________________________________________________

Service #4:___________________________________________________

SRP Authentication Key:

__________-__________-__________-__________-__________

Tip: To simplify installations, upgrades, and reinstalls, create an .srp file containing your SRP Identifier and SRP Authentication Key. You can import this .srp file when adding a new server to automatically add the values to the correct fields. Keep this file in a secure directory.

Other information

BlackBerry Enterprise Server Installation folder location (if not default location):

default or ___________________________________________

TCP/IP Host name of BlackBerry Enterprise Server:

Platform that your mail servers run on:

42 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 43: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Summary of preinstallation procedures

Summary of preinstallation proceduresYou must complete the following procedures before you can install the BlackBerry Enterprise Server Software.

! Define a service account and mailbox in Microsoft Exchange 2000/2003.

! Set permissions on the service account(s) for any of the following tools that you intend to install:

� BlackBerry Enterprise Server

� BlackBerry Enterprise Server Management

� BlackBerry User Administration

! Install and register CDO.dll.

! Prepare to create a MAPI profile.

! Install database software.

If you are upgrading from using Microsoft Exchange 5.5 administration extensions to using BlackBerry Enterprise Server Management, you must complete the following procedure:

! Export system information from the Microsoft Exchange 5.5 administration extensions beforeyou install the BlackBerry Enterprise Server version 3.6 or later. (Refer to "Exporting systeminformation from the Microsoft Exchange 5.5 administration extensions" on page 51 for moreinformation.)

System Attendant (name of System Administrator email address that sends email alerts in a valid SMTP address format):

Microsoft Exchange directory location:

Name of Address Book (Exchange directory):

Note: After you upgrade to BlackBerry Enterprise Server, you must import the server information that you exported from the BlackBerry Enterprise Server administration extensions. Refer to "Importing system information" on page 153 for more information. Do not remove the administration extensions until after you have installed BlackBerry Enterprise Server and imported the system information into the BlackBerry Enterprise Server Management console.

Other information

Installation and Getting Started Guide 43

Page 44: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

Defining a service account and mailboxYou must define a user service account and mailbox to be used by each of the following BlackBerry Enterprise Server Software components that you install:

� BlackBerry Enterprise Server,

� BlackBerry Enterprise Server Management,

� and BlackBerry User Administration.

Complete the following procedure, using a Windows 2000/2003 account with Microsoft Exchange 2000/2003 service account and Windows 2000/2003 administrative privileges, to create a service account and mailbox:

1. Log in to the Microsoft Exchange Server on which you intend to install the BlackBerry Enterprise Server, as a user with Microsoft Exchange permissions.

2. From the Start menu select Programs> Microsoft Exchange> Active Directory Users and Computers.

3. In the Tree view, expand the list, right-click the User folder, and select New User. The new user will act as your BlackBerry Enterprise Server service account.

4. Type a new user login name (for example, BESAdmin). Click Next. The New Object - User window appears.

5. Type a password for the user in the Password field and in the Confirm password field.

6. Select any of the password options available. Click Next. A second New Object - User window appears.

7. By default, Create an Exchange mailbox should be selected and default values should appear in the Alias, Server, and Mailbox Store fields. Change these values if necessary. Click Next. A third New Object - User window appears.

8. The new user options that you selected are listed. Click Finish to create the new user and mailbox.

Note: You do not need to install all the tools on the same computer. However, the same service account can be used by two or more of the above components if they are installed on the same computer. The same mailbox should be used by all components.

Warning: The administration service account cannot have a Terminal Services (roaming or mandatory) profile or the BlackBerry Enterprise Server will not start and “Error 0x80090024 while initializing random number generator” is logged. See the following Knowledge Base article on the Microsoft site: http://support.microsoft.com/?kbid=243850

44 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 45: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Requirements for setting permissions on service accounts

9. To initialize the mailbox, send a test message to the service account mailbox.

Requirements for setting permissions on service accountsIn this section, service account permissions are grouped according to the software component, as follows:

� BlackBerry Enterprise Server service account

� BlackBerry Enterprise Server Management service account

� BlackBerry User Administration service account

Each component does not require a separate service account; the same service account can be used for one or more of these software components. Refer to "Setting permissions" on page 47 for more information and full instructions for assigning the permissions.

BlackBerry Enterprise Server service accountYour BlackBerry Enterprise Server service account requires the following Windows 2000/2003 and Microsoft Exchange 2000/2003 permissions:

� Log on locally with local permissions: This permission is optional, but useful for troubleshooting. You can remove it after installing the BlackBerry Enterprise Server Software.

� Log on as a service: This permission should be set on the BlackBerry Enterprise Server service computer.

� Local administrator: This permission should be set on the BlackBerry Enterprise Server service computer.

� Microsoft Exchange View Only Administrator: This permission should be set to enable (at minimum) access at the Administrative Groups level in Microsoft Exchange 2000/2003 to be able to read from the Active Directory.

� Microsoft Exchange Administer Information store, Send as, and Receive as: These permissions should be set at the Mailbox store level or the Microsoft Exchange server level (to write information to the administration service account mailbox).

Warning: You might not be able to see this account to confirm that it has been created.

Installation and Getting Started Guide 45

Page 46: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

BlackBerry Enterprise Server Management service accountYour BlackBerry Enterprise Server Management service account requires the following Windows 2000/2003 and Microsoft Exchange 2000/2003 permissions:

� Log on locally with local permissions: This permission is optional, but useful for troubleshooting. You can remove it after installing the BlackBerry Enterprise Server Software.

� Log on as a service: This permission should be set on the BlackBerry Enterprise Server service computer.

� Local administrator: This permission should be set on the BlackBerry Enterprise Server service computer and the BlackBerry Enterprise Server Management computer (these can be the same computer).

� Microsoft Exchange View Only Administrator: This permission should be set to enable (at minimum) access at the Administrative Groups level in Microsoft Exchange 2000/2003 to be able to read from the Active Directory.

� Microsoft Exchange Administer Information store: This permission should be set at the Mailbox store level or the Microsoft Exchange server level (to write information to the administration service account mailbox).

BlackBerry User Administration service accountYour BlackBerry User Administration service account requires the following Windows 2000/2003 and Microsoft Exchange 2000/2003 permissions:

� Log on as a service

� Local administrator: This permission should be set on the BlackBerry Enterprise Server service computer and the BlackBerry Enterprise Server Management computer (these can be the same computer).

� Microsoft Exchange View Only Administrator: This permission should be set for (at minimum) access at the Administrative Groups level in Microsoft Exchange 2000/2003 to be able to read from the Active Directory.

� Receive as: This permission should be set within the Microsoft Exchange routing group

Note: The service account used by Mobile Data Service to access the database (the BlackBerry Enterprise Server Management service account), requires read/write access on the database.

Note: A user running the BlackBerry User Administration client does not need any permissions.

46 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 47: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Setting permissions

Setting permissionsProcedures for setting permissions are provided in the following sections:

� Assigning Windows 2000/2003 permissions on a service account

� Assigning log on as a service permissions

� Assigning local administrator permissions to service accounts

� Assigning further Microsoft Exchange permissions to service accounts

Assigning Windows 2000/2003 permissions on a service account

1. Using an account with administrative Windows 2000/2003 and Microsoft Exchange permissions, log in to the computer on which you will install BlackBerry Enterprise Server.

2. From the Start menu select Settings> Control Panel> Administrative Tools> Local Security Policy.

3. Expand the Local Policies object, and then expand User Rights Assignment. In the Policies list, double-click Log on locally. The Add window appears.

4. Click Add. On the Select Users or Groups window, select the name of the service account. Click OK to return to the Exchange Server Properties window. The service account should now appear in the Name list.

5. Assign the appropriate local policy settings to the service account, including Log on as a service.

Assigning log on as a service permissions1. Using an account with administrative Windows 2000/2003 and Microsoft Exchange permissions,

log in to the computer on which you will install BlackBerry Enterprise Server.

2. From the Start menu select Settings> Control Panel> Administrative Tools> Local Security Policy.

3. Expand the Local Policies object, and then expand User Rights Assignment. In the Policies list, double-click Log on as a service. The Add window appears.

Note: Permission to log on locally might be granted to the service account by default. Complete this procedure only if it has not been granted.

Note: Domain level settings listed under Effective Policy Settings might override Local Policy Settings.

Installation and Getting Started Guide 47

Page 48: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

4. Click Add. On the Select Users or Groups window, select the name of the service account. Click OK to return to the Exchange Server Properties window. The service account should now appear in the Name list.

Assigning local administrator permissions to service accounts

Assigning permissions consists of adding the service account to the Administrator group.

1. Using an account with administrative privileges on the local computer, log in to the server that you will be using as your BlackBerry Enterprise Server (or BlackBerry Enterprise Server Management computer or BlackBerry User Administration computer, if you are assigning permissions to the service accounts for those tools).

2. From the Start menu select Settings > Control Panel > Administrative Tools > Computer Management.

3. Expand the System Tools object, select Local Users and Groups, and then select Groups.

4. Double-click the Administrators group to open the Administrators Properties dialog box.

5. In the Administrators Properties dialog box, click Add to open the Select Users and Groups dialog box.

6. From the Name list, select the service account. Click Add. The name appears in the lower pane of the dialog box.

7. Click OK. The name appears in the Members list as confirmation that it was added to the Administrators group.

8. Click OK to return to the main Computer Management window.

Warning: You must also assign local administrator permissions on the BlackBerry Enterprise Server service computer to the service account used to run BlackBerry Enterprise Server Management. Without local administrator permissions on the BlackBerry Enterprise Server computer, you will be unable to access all of the BlackBerry Server Property pages.

48 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 49: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Setting permissions

Assigning further Microsoft Exchange permissions to service accountsBefore installing BlackBerry Enterprise Server and/or BlackBerry Enterprise Server Management software, use Microsoft Exchange 2000/2003 System Manager to set the following service account/mailbox permissions on the BlackBerry Enterprise Server administration service account AND the BlackBerry Enterprise Server Management administration service account.

� Microsoft Exchange View Only Administrator: This permission should be set to enable (at minimum) access at the Administrative Groups level in Microsoft Exchange 2000/2003 to be able to read from the Active Directory. This permission should also be set on the BlackBerry User Administration service account.

� Microsoft Exchange Administer Information store: This permission should be set at the Mailbox store level or the Microsoft Exchange server level (to write information to the administration service account mailbox).

To set View Only Administrator permissions on a service account:

1. Open Microsoft Exchange 2000/2003 System Manager.

2. Right-click an administrative group folder and select Delegate control. The Exchange Administration Delegation Wizard appears.

3. Click Next. The Users and Groups screen appears.

4. Click Add. The Delegate Control dialog box appears.

5. Click Browse. The Select Users, Computers or Groups dialog box appears. Select the correct service account from the list. Click OK.

6. On the Delegate Control dialog box, under Role, select Exchange View Only Administrator from the drop-down list. Click OK.

7. Click Next. The final screen appears. Review the change that you are making.

8. Click Finish.

To set Administer Information store permissions:

1. Open Microsoft Exchange 2000/2003 System Manager.

2. Right-click a Microsoft Exchange Server and select Properties.

Note: You can use the same service account for both BlackBerry Enterprise Server and BlackBerry Enterprise Server Management. The same service account can also be used for BlackBerry User Administration.

Installation and Getting Started Guide 49

Page 50: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

3. Click the Security tab. On the Security tab, select the service account and allow (by selecting the Allow check box) Administer Information store in the Permissions pane.

4. Assigned Send as and Receive as permissions to the service account. The BlackBerry User Administration service account (which can be the same account that you use for the other tools) requires the Receive as permission only.

5. Click OK.

Note: You can also use Microsoft Exchange 2000/2003 System Manager to set these permissions for any Microsoft Exchange 5.5 servers, if you plan to install BlackBerry Enterprise Server Management in a mixed environment.

50 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 51: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Creating a MAPI profile

Creating a MAPI profileYou must create a MAPI profile to be used by each of the service accounts that you created, which might include a BlackBerry Enterprise Server service account, a BlackBerry Enterprise Server Management service account, and a BlackBerry User Administration service account. (The same service account can be used for all of these tools.)

You can create separate MAPI profiles for each tool, or you can use one MAPI profile for all tools. The MAPI profile(s) can point to the same BlackBerry Enterprise Server administration mailbox.

To create the MAPI profile(s) during the installation of BlackBerry Enterprise Server, BlackBerry Enterprise Server Management, and BlackBerry User Administration

1. To verify that the MAPI subsystem is initialized, open Microsoft Exchange 2000/2003 System Manager.

2. On the BlackBerry Enterprise Server Software CD, open the Tools folder.

3. From the command prompt run the fixmapisvc.exe utility and specify the mapisvc.inf file as follows:"fixmapisvc.exe c:\winnt\system32\mapisvc.inf".

A DOS screen appears briefly on the screen. The mapisvc.inf file is automatically installed under C:/winnt/system32/.

Installation and Getting Started Guide 51

Page 52: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

Installing and registering CDO.dllThe CDO.dll that is supplied with Microsoft Outlook does not enable wireless calendar synchronization. You must install both the correct CDO.dll hotfix and Microsoft Exchange 2000/2003 System Manager to have the correct CDO.dll and MAPI versions.

1. Verify that you are logged in to the BlackBerry Enterprise Server computer as the Administrator.

2. If Microsoft Outlook is currently installed, remove it.

3. Copy the CDO.dll hotfix to C:/winnt/system32/.

4. Manually register the CDO.dll hotfix using one of the following methods:

� At the command prompt (C:/winnt/system32/), type regsvr32 cdo.dll

� From the Start menu, click Run. In the Run dialog box, in the Open field, type regsvr32 cdo.dll

52 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 53: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing database software

Installing database softwareOne of the following database tools must be installed if you want to host the BlackBerry Enterprise Server Management database on the BlackBerry Enterprise Server: MSDE 2000 (on the CD), MSDE, SQL 7.0, or SQL 2000. For database support on Windows Server 2003, you must upgrade to MSDE 2000 Service Pack 3.

If you do not have a copy of MSDE, SQL 7.0 or SQL 2000, you can use the copy of MSDE 2000 that is included on the BlackBerry Enterprise Server Software CD (see drive:\MSDE\SqlRun01.msi). MSDE 2000 can also be installed directly from the Microsoft Office 2000 Developer CD-ROM.

1. On the computer on which you plan to install the BlackBerry Enterprise Server Management database, go to drive:\MSDE\SqlRun01.msi on the BlackBerry Enterprise Server Software CD.

2. Click SqlRun01.msi.

3. When the installation is complete, a dialog appears indicating that you must restart the system in order for the configuration settings to take effect. Click Yes.

When the computer restarts, MSDE 2000 starts automatically. A Service Manager icon appears in the system tray. The installation does not create a shortcut to the Service Manager.

4. Verify that the SQL Server service is running before you continue with the BlackBerry Enterprise Server installation.

Note: MSDE 2000 Service Pack 3 is available on the Microsoft site through the following link: http://www.microsoft.com/downloads/details.aspx?FamilyId=90DCD52C-0488-4E46-AFBF-ACACE5369FA3&displaylang=en

Note: The following procedure is necessary only if you do not have SQL 7.0, SQL 2000, or MSDE installed and you want to install MSDE 2000.

Note: The MSDE 2000 software files are installed to C:\Program Files\Microsoft SQL Server\.

Warning: You cannot run the MSDE 2000 installation file from a Terminal Server service.

Installation and Getting Started Guide 53

Page 54: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

Upgrading from Microsoft Exchange 5.5 administration extensions

The following procedures are required to upgrade from the Microsoft Exchange 5.5 administration extensions to BlackBerry Enterprise Server Management:

1. Exporting system information from the Microsoft Exchange 5.5 administration extensions.

2. Upgrading to BlackBerry Enterprise Server version 3.6 or later.

3. Importing system information to BlackBerry Enterprise Server Management.

4. Removing BlackBerry Enterprise Server administration extensions.

You must complete these procedures in the order in which they are presented below. Complete the following procedure to export system information from the Microsoft Exchange 5.5 administration extensions before you install BlackBerry Enterprise Server version 3.6 or later.

Warning: BlackBerry Enterprise Server version 3.6 or later does not support Microsoft Exchange 5.5 administration extensions. If you are upgrading to BlackBerry Enterprise Server version 3.6 or later and previously used only the Microsoft Exchange 5.5 administration extensions, you must upgrade to BlackBerry Enterprise Server Management or the administration extensions data will be lost.

54 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 55: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Upgrading from Microsoft Exchange 5.5 administration extensions

Exporting system information from the Microsoft Exchange 5.5 administration extensionsYou can use the Export feature on the BlackBerry Servers Properties window to export server information for migration to BlackBerry Enterprise Server Management.

1. Open the Microsoft Exchange Administration window.

2. From the Configuration container, double-click the BlackBerry Servers item. The BlackBerry Server Properties window appears.

3. From the Server Config list, click Export. A Save As dialog box appears.

4. Browse to the desired directory location. Click Save. The BlackBerry Servers Properties window appears. A text file, which contains configuration information for each BlackBerry Enterprise Server in the site, is saved to the defined location.

The generated text file contains a line for each BlackBerry Enterprise Server in the site. The information includes server name, server mailbox display name, server Domain Name (DN), and BlackBerry Enterprise Server DN.

Note: After you upgrade to BlackBerry Enterprise Server, you must import the server information that you exported from the BlackBerry Enterprise Server administration extensions. Refer to "Importing system information" on page 153 for more information. You should remove the administration extensions after importing the system information. Refer to "Removing BlackBerry Enterprise Server administration extensions" on page 154 for more information.

Installation and Getting Started Guide 55

Page 56: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 2: Preinstallation

56 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 57: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 3Planning your installationThis section provides information on the following topics:

� Overview

� Installation procedures

� Installation types

� Typical

� Admin Only

� Custom

Page 58: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 3: Planning your installation

OverviewThis chapter includes information to help you plan your installation and choose the appropriate installation type.

Refer to "Summary of preinstallation procedures" on page 41 for more information on completing preinstallation procedures prior to beginning the installation process.

Installation proceduresTo complete an initial BlackBerry Enterprise Server install, you must complete the following procedures:

1. Install the BlackBerry Enterprise Server Software using the Typical installation option or the Custom installation option.

Optionally, you can complete the following procedures:

� Install administration software on a separate computer than the one running the BlackBerry Enterprise Server service using the Admin Only installation option.

� Install features that are only available using the Custom installation option.

2. Complete the post-installation procedures. (Refer to "Postinstallation procedures" on page 147 for more information.)

Note: If you are running BlackBerry Enterprise Server version 2.1 or later, you do not need to remove your current software to upgrade your BlackBerry Enterprise Server Software to version. Complete the installation procedure as shown in this chapter.

Note: If you are installing the BlackBerry Enterprise Server in a mixed mode environment (any combination of Microsoft Exchange 5.5 and/or Microsoft Exchange 2000 and/or Microsoft Exchange 2003 environments), refer to the BlackBerry Enterprise Server for Microsoft Exchange 5.5 Installation and Getting Started Guide on the BlackBerry Enterprise Server Software CD for full prerequisites for installing with Microsoft Exchange 5.5.

54 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 59: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installation types

Installation typesWhen installing, you can choose between the three installation types, Typical, Admin Only, and Custom, that help determine the tools and options you will install. The following table describes each installation type.

Installation type Description

Typical This installation type will install the following tools:

� BlackBerry Enterprise Server

� BlackBerry Service #1

� Mobile Data Service #1

� Attachment Connector #1 (see Note below this table)

� Attachment Service (see Note below this table)

� BlackBerry Enterprise Server Management

� BlackBerry Server Utilities (all)

� BlackBerry Server Documentation

Admin Only This installation type will install the following tools:

� BlackBerry Enterprise Server Management

� BlackBerry Server Utilities (all)

� BlackBerry Server Documentation

� BlackBerry User Administration, if an earlier version of it is installed on the computer already

Custom This installation type enables you to choose the specific tools you wish to install. Select this option to remove any of the Typical or Admin Only installation options or to install any of the following tools alone or in addition to the Typical or Admin Only installation options:

� BlackBerry User Administration

� BlackBerry Service #2, #3 and #4

� Mobile Data Service #2, #3 and #4(see Note below this table)

� Attachment service on a remote computer (see Note below this table)

� Attachment Connector #2, #3 and #4 (see Note below this table)

Note: The attachment connector on the BlackBerry Enterprise Server processes attachments converted by the local or remote attachment service for viewing on the BlackBerry handheld. Attachment service and attachment connector settings are configurable after installation through the BlackBerry Attachment Service Configuration tool, installed by default with the attachment service. (The BlackBerry Attachment Service Configuration tool is not listed as an installation option.)

Installation and Getting Started Guide 55

Page 60: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 3: Planning your installation

Use the installation types as follows:

TypicalUse a Typical installation to install all of the default tools, creating a BlackBerry Enterprise Server with local installations of BlackBerry Enterprise Server Management console, Mobile Data Service, attachment service, attachment connector, utilities, and documentation.

Admin OnlyUse an Admin Only installation to create a stand alone administration server. Refer to "Installing administration software" on page 113 for more information on using the Admin Only option to install the administration software on a separate computer from the BlackBerry Enterprise Server service.

CustomUse a Custom installation to install stand alone tools, or to install additional services on the existing BlackBerry Enterprise Server. The following are examples of installation configurations that are possible with a Custom installation:

BlackBerry User Administration

BlackBerry User Administration is not included by default with the Typical installation option. It is not included with the Admin Only installation option unless it is already on the target administration computer. Use the Custom installation configuration to install BlackBerry User Administration by selecting it and the other components of a Typical or Admin Only installation (depending on whether you want it on the BlackBerry Enterprise Server or a remote computer).

BlackBerry User Administration requires that BlackBerry Enterprise Server Management be installed on the same computer, but you can use the Custom installation to select on those two tools if you do not want to install all of the tools included in an Admin Only installation. Refer to "Installing standalone BlackBerry User Administration" on page 131 for more information on a custom installation that installs stand alone BlackBerry User Administration.

Remote attachment service

The attachment service feature requires that you install an attachment connector on the BlackBerry Enterprise Server, and the attachment service on the BlackBerry Enterprise Server or a remote computer.

56 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 61: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installation types

Use the Custom installation configuration to install the attachment service in a stand alone setup on a computer other than the BlackBerry Enterprise Server. You might consider this installation configuration if high resource usage of the attachment service in your environment places a heavy load on the BlackBerry Enterprise Server. Refer to Attachment Service Performance Issues on the BlackBerry support site (http://www.blackberry.com/support/) for full details on potential performance issues in a heavy load environment.

Refer to "Installing the attachment service on a remote computer" on page 83 for more information on a custom installation that installs stand alone attachment service on a remote computer.

Multiple services

Refer to "Installing and removing multiple services" on page 91 for more information on a custom installation that enables you to install multiple BlackBerry Enterprise Server, Mobile Data Service, and Attachment Connector instances. Up to four instances of each of these tools can be installed on a computer.

Selecting Custom setup options

The following generic procedure explains how to select or deselect options during a Custom installation:

1. When you select Custom, during the installation the Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

2. Items that will be installed by default are marked with a icon. Items that are not to be installed are marked with a icon.

Tip: Click Help to view a Custom Setup Tips screen with further tips about these icons.

Installation and Getting Started Guide 57

Page 62: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 3: Planning your installation

Install options—Drop-down list

3. Click an item. A drop-down list appears.

4. Select one of the following options:

� This feature will be installed on local hard drive

� This feature, and all sub-features, will be installed on local hard drive

� This feature will not be available

5. Repeat steps 3 and 4 for each item.

6. To check available disk space on the drive(s) available, click Space.

InstallShield Wizard—Disk Space Requirements screen

The Disk Space Requirements screen lists all the available local and network drives, and the disk size, available space, and required space on each drive. If a drive is highlighted, it has insufficient space to install the components that you have selected.

7. Click OK.

58 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 63: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4Installing BlackBerry Enterprise Server Software (Typical installation)This section provides information on the following topics:

� Before you begin

� Installing BlackBerry Enterprise Server Software (Typical installation)

� Installing BlackBerry service(s)

� Installing the attachment service and connector(s)

� Installing BlackBerry Enterprise Server Management

� Installing Mobile Data Service

� Completing the installation

Page 64: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

You should complete these steps in the order in which they appear in this document. All the steps are required unless otherwise stated.

Before you beginVerify that you meet all system requirements and that you completed all prerequisite procedures before you begin the installation. Refer to "Summary of preinstallation procedures" on page 41 for more information on completing preinstallation procedures prior to beginning the installation process.

Refer to "Upgrading BlackBerry Enterprise Server" on page 162 for more information if you are upgrading from an earlier installation of BlackBerry Enterprise Server version 3.6 Service Pack 2.

Installing BlackBerry Enterprise Server Software (Typical installation)1. Verify that you are logged in to the BlackBerry Enterprise Server target computer as the

BlackBerry Enterprise Server service account. Run the provided setup program to start the BlackBerry Enterprise Server installation program.

� If you have Microsoft Outlook installed, a warning dialog box appears.

Note: If you are installing in a Windows 2003 environment by executing setup.exe through Terminal Services verify that Terminal Services is in install mode before you begin installation. If Terminal Services i s in execute mode, additional screens will appear at the end of the installation. Refer to page 81 for details on the additional screens.

Note: If you are running BlackBerry Enterprise Server version 2.1 or later, you do not need to remove your current software to upgrade your BlackBerry Enterprise Server Software to version 3.6 or later. Complete the installation procedure as shown in this chapter.

Warning: If you are upgrading from the Microsoft Exchange 5.5 administration extensions to BlackBerry Enterprise Server Management, you must export your server information from the administration extensions before you install the BlackBerry Enterprise Server version 3.6 or later. Refer to "Upgrading from Microsoft Exchange 5.5 administration extensions" on page 50 for more information.

Warning: You should not have Microsoft Outlook installed on the computer on which you are installing the BlackBerry Enterprise Server. If Microsoft Outlook is present on the BlackBerry Enterprise Server computer, wireless calendar synchronization does not work because Microsoft Outlook’s versions of CDO.dll and MAPI files do not support wireless calendar synchronization. If Microsoft Outlook is opened on a BlackBerry Enterprise Server, it attempts to overwrite the MAPI system. Therefore, Microsoft Outlook on a BlackBerry Enterprise Server is an unsupported configuration.

60 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 65: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Software (Typical installation)

Warning dialog box—Microsoft Outlook must be removed

OR

If you have Microsoft Outlook XP or later installed, a warning dialog box appears.

Warning dialog box—Microsoft Outlook XP or later must be removed

� Click OK to acknowledge that you are aware that you must remove Microsoft Outlook for the BlackBerry Enterprise Server to function properly after installation. You should remove Microsoft Outlook before proceeding with the BlackBerry Enterprise Server Software installation.

� If you do not have Java Runtime Environment (JRE) 1.4 installed, a warning dialog box appears.

Warning dialog box—JRE 1.4 must be installed for Mobile Data Service

This software is provided on the BlackBerry Enterprise Server CD.

� Click OK. Install JRE 1.4. Refer to "System requirements" on page 28 for more information.

2. The Welcome screen appears.

Installation and Getting Started Guide 61

Page 66: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

InstallShield Wizard—Welcome screen

3. Click Next. The Customer Information screen appears.

InstallShield Wizard—Customer Information screen

4. Type information in the following fields:

5. Click Next. The License Agreement screen appears.

Field Action

User Name In this field, type your user name.

Organization In this field, type the name of your company or organization.

Country From this drop-down list, select the country in which you purchased your license for the BlackBerry Enterprise Server Software.

License Key In this field, type your license key to BlackBerry Enterprise Server Software.

62 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 67: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Software (Typical installation)

InstallShield Wizard—License Agreement screen

6. Verify that I accept the terms in the license agreement is selected. Click Next. The Setup Type screen appears.

InstallShield Wizard—Setup Type screen

7. Select Typical. Click Next.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Note: If you are upgrading from a BlackBerry Enterprise Server version that is earlier than 3.6, you must select Custom. Refer to "Upgrading BlackBerry Enterprise Server" on page 162 for more information.

Installation and Getting Started Guide 63

Page 68: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

Installing BlackBerry service(s)The Typical setup procedure begins with the installation of a BlackBerry service.

1. The Installation Settings for BlackBerry Service #1 screen appears.

InstallShield Wizard—Installation Setting for BlackBerry Service #1 screen

2. Click Next. The BlackBerry Server Communication Information screen appears.

InstallShield Wizard—BlackBerry Server Communication Information screen

3. In the BlackBerry Server Name field, type a unique name that identifies the BlackBerry Enterprise Server. You must provide this exact server name when you configure the BlackBerry Enterprise Server in the BlackBerry Enterprise Server Management console.

Warning: After you have assigned a server name, you cannot rename the BlackBerry Enterprise Server.

64 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 69: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry service(s)

4. In the SRP Host field, type the SRP Address. This is the Network Access Node BlackBerry Enterprise Server uses to connect to the network (for example, srp.na.blackberry.net). Use the SRP Address value provided on your installation CD label, unless you are using a proxying firewall, in which case the network access node must be the internal IP of the Proxy, not the SRP Address.

5. In the SRP Port field, type the port number for the network access node that is defined above. Unless you are using a port mapping firewall, this value should be 3101.

6. Click Test Network Connection to verify that your settings permit connection to the network.

� If the connection is unsuccessful, click OK. The Communication Information screen appears. Verify that the values are correct and retest. If the connection is still unsuccessful, a firewall configuration problem might exist.

� If the connection is successful, in the confirmation dialog box, click OK.

7. Click Next. The BlackBerry Server MAPI Profile screen appears.

InstallShield Wizard—BlackBerry Server MAPI Profile screen

8. In the Admin MAPI Profile field, type the name of the MAPI profile for the BlackBerry Enterprise Server administration service account, which the BlackBerry Enterprise Server service uses to communicate with the Microsoft Exchange Server. If you type the name of a non-existent MAPI profile, you are prompted to create a new MAPI profile. Click Yes. The Microsoft Exchange Server dialog box appears. You can also select Create/Edit MAPI Profile to open the Microsoft Exchange Server dialog box.

Installation and Getting Started Guide 65

Page 70: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names that you specified.

� After both names appear underlined, click OK. The BlackBerry Server MAPI Profile screen appears.

9. Click Next.

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

Note: If you are installing multiple BlackBerry Enterprise Server services on a single server, the installation settings screens for the next BlackBerry Enterprise Server service appears, and should be completed the same way as the installation settings were completed for BlackBerry Enterprise Server service #1. Refer to "Installing and removing multiple services" on page 91 for more information.

66 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 71: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing the attachment service and connector(s)

Installing the attachment service and connector(s)The BlackBerry Enterprise Server Software installation enables you to install the attachment service and attachment service connector(s) at this point in the installation. The attachment service feature requires that you install an attachment connector on the BlackBerry Enterprise Server, and the attachment service on the BlackBerry Enterprise Server or a remote computer.

Both the attachment service and one attachment service connector are selected by default during a Typical installation to be installed on the BlackBerry Enterprise Server computer. The attachment service connector is installed on the BlackBerry Enterprise Server (the local computer). The attachment service is installed on the BlackBerry Enterprise Server, but can also be installed on a remote computer using a Custom installation. Refer to "Installing the attachment service on a remote computer" on page 83 for more information if you want to install the attachment service on a separate computer.

1. The Installation Settings for Attachment Connectors screen appears.

InstallShield Wizard—Installation Settings for Attachment Connectors screen

Note: The attachment connector on the BlackBerry Enterprise Server processes attachments converted by the local or remote attachment service for viewing on the BlackBerry handheld. Attachment service and attachment connector settings are configurable after installation through the BlackBerry Attachment Service Configuration tool, installed by default with the attachment service.

Installation and Getting Started Guide 67

Page 72: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

2. Click Next. The Attachment Service Host screen appears.

InstallShield Wizard—Attachment Service Host screen

3. In the Server Name field, localhost or the local BlackBerry Enterprise Server name appears by default. If the attachment service is installed/will be installed on a remote computer, type the name of the remote computer.

If you are installing/have installed the attachment service on a remote server, click Test Network Connection to verify that the connection to the remote computer is working.

4. Click Next.

Installing BlackBerry Enterprise Server Management The BlackBerry Enterprise Server Software installation enables you to install BlackBerry Enterprise Server Management at this point in the installation.

1. The Installation Settings for BlackBerry Enterprise Server Management screen appears.

68 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 73: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management

InstallShield Wizard—Installation Settings for BlackBerry Enterprise Server Management screen

2. Click Next. The Database Information screen appears.

InstallShield Wizard—Database Information screen

3. In the Database Information screen, if you installed an SQL Server instance, the name of the SQL Server appears by default in the SQL Server Name field. If you do not have an SQL Server, the local computer name appears instead. You can replace the default server name with the name of another server on which you intend to install the database, or with the name of a server on which a database that you want to use already resides.

Note: If you do not want to install the database on the local computer (that is, if you change the server name to that of another computer on which you want to use a database), you cannot use the BlackBerry Enterprise Server InstallShield Wizard to install the database. You can manually install the database at any time following the BlackBerry Enterprise Server Management installation. Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information.

Installation and Getting Started Guide 69

Page 74: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

4. In the Database Information section, accept the default Database Name (BESMgmt) or type a new name in the Database Name field.

5. In the Database Authentication section, choose the database authentication type predetermined by the database installation (Windows (trusted) for Windows NT Authentication or SQL Authentication).

� If you select SQL Authentication in the SQL User Name field, accept the default user name (sa) or type a new user name; and, in the Password field, accept the default password (no password) or type a new password. The user name and password are used only to create the SQL database.

� If you select Windows (trusted), the SQL User Name field, and Password field are disabled (unavailable).

6. Click Next.

The InstallShield Wizard attempts to detect and verify an SQL Server instance if you have entered the local computer name. If a SQL Server instance is not detected, the following warning appears.

Warning dialog box—SQL Server not detected

If this warning appears, click OK. You have the option of installing MSDE from the Database Path Information screen (refer to page 71). Refer to "Supported database versions" on page 34 for more information. If a dialog box appears that prompts you to start the SQL Server service, click Yes.

7. The BlackBerry Enterprise Server Database Maintenance screen appears.

Note: If you do not know the database authentication type, ask your database administrator.

70 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 75: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management

InstallShield Wizard—BlackBerry Enterprise Server Database Maintenance screen

8. Select one of the following options:

� To create a database for BlackBerry Enterprise Server Management, select Create BlackBerry Enterprise Server Management database

� To update a database you already created, select Update BlackBerry Enterprise Server Management database

9. Click Next. The Database Path Information screen appears.

InstallShield Wizard—Database Path Information screen

Installation and Getting Started Guide 71

Page 76: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

10. Complete the following fields:

11. If you have not installed MSDE or SQL Server, you can click Install MSDE to run a silent installation at this point. (If you installed SQL Server and it is detected by the InstallShield Wizard, the Install MSDE option does not appear.) A warning dialog box appears.

Warning dialog box—Installing MSDE

12. Click Yes. A dialog box appears that enables you to select the location of MSDE on your local computer.

Dialog box—Browse to select MSDE installation file

Field Directory path

Database Program Path This field should display the root directory of your SQL files location. If the correct directory path does not appear by default, click Browse to select it from the Database Program Path dialog box, or type it in the Database Program Path field.

Database Data Path This field should display the directory of your SQL data store. If the correct directory path does not appear by default, click Browse to select it from the Database Data Path dialog box, or type it in the Database Data Path field.

72 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 77: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management

13. Browse to the location that you want to use. Click OK.

The InstallShield Wizard minimizes during the MSDE installation. The installation requires approximately three minutes.

14. Click Next. The BlackBerry Enterprise Server Management MAPI Profile screen appears.

InstallShield Wizard—BlackBerry Enterprise Server Management MAPI Profile screen

15. In the Management MAPI Profile field, type the name of the MAPI profile for the BlackBerry Enterprise Server Management administration service account, which the BlackBerry Enterprise Server Management service uses to communicate with the Microsoft Exchange Server.

If you type the name of a non-existent MAPI profile, you are prompted to create a new MAPI profile. Click Yes. The Microsoft Exchange Server dialog box appears. You can also select Create/Edit MAPI Profile to open the Microsoft Exchange Server dialog box.

Note: An hourglass might appear while this dialog box is open. Choose the location. Click OK even if an hourglass continues to appear while you complete these actions.

Note: The service account name can be the same as or different from the MAPI profile and service account that you use for the BlackBerry Enterprise Server. You can change the default MAPI profile name to match that of another MAPI profile.

Installation and Getting Started Guide 73

Page 78: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names that you specified.

� After both names appear underlined, click OK. The BlackBerry Enterprise Server Management MAPI Profile screen appears.

16. Click Next. The Installation Settings for Mobile Data Service screen appears.

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

74 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 79: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing Mobile Data Service

Installing Mobile Data ServiceThe BlackBerry Enterprise Server Software installation enables you to install Mobile Data Service at this point in the installation.

InstallShield Wizard—Installation Settings for Mobile Data Service screen

The Mobile Data Service installation is associated with BlackBerry Service #1, and includes Central Push Service by default. The push server can be enabled after installation (through the BlackBerry Enterprise Server Management console) on one BlackBerry Enterprise Server with Mobile Data Service installed.

1. Click Next. The Mobile Data Service Push Server Settings screen appears.

InstallShield Wizard—Mobile Data Service Push Server Settings screen

Installation and Getting Started Guide 75

Page 80: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

2. The BlackBerry Enterprise Server Management MAPI profile appears by default in the MAPI Profile field. Mobile Data Service should use the BlackBerry Enterprise Server Management database settings.

3. In the Database Consistency Polling Frequency field, the default value of 24 (hours) appears. This frequency is the rate at which the BlackBerry Enterprise Server Management database is checked against the data in users� mailboxes. You can change this value if you wish. It can also be changed after installation through the Mobile Data Service Properties window Push Server tab if you have set a centralized push server.

4. Click Next.

If you installed BlackBerry Enterprise Server Management and configured the database information, you can proceed to �Completing the installation� on page 79. If you did not install BlackBerry Enterprise Server Management on the local computer, you must now type the BlackBerry Enterprise Server database information that is used by Mobile Data Service.

5. The Database Information screen appears.

InstallShield Wizard—Database Information screen

6. In the Database Information section, if you installed an SQL Server instance, the name of the SQL Server appears by default in the SQL Server Name field. If you do not have an SQL Server, the local computer name appears instead. You can replace the default server name with the

Note: The service account that is used by Mobile Data Service to access the database (the BlackBerry Enterprise Server Management service account), requires read/write access on the database.

76 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 81: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing Mobile Data Service

name of another server on which you intend to install the database, or with the name of a server on which a database you want to use already resides.

7. In the Database Information section, accept the default Database Name (BESMgmt) or type a new name in the Database Name field.

8. In the Database Authentication section, choose the database authentication type that is predetermined by the database installation (Windows (trusted) for Windows NT Authentication or SQL Authentication).

� If you select SQL Authentication, in the SQL User Name field, accept the default user name (sa) or type a new user name; and, in the Password field, accept the default password (no password) or type a new password. The user name and password are used only to create the SQL database.

� If you select Windows (trusted), the SQL User Name field, and Password field are disabled (unavailable).

9. Click Next. The InstallShield Wizard attempts to detect and verify an SQL Server instance. If nothing is detected, the following warning appears.

Warning dialog box—SQL Server not detected

10. The Log Folder screen appears.

Note: If you do not want to install the database on the local computer (that is, if you change the server name to that of another computer on which you want to use a database), you cannot use the BlackBerry Enterprise Server InstallShield Wizard to install the database. You can manually install the database at any time following the BlackBerry Enterprise Server Management installation. Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information.

Note: If you do not know the database authentication type, ask your database administrator.

Installation and Getting Started Guide 77

Page 82: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

InstallShield Wizard—Log Folder screen

11. To accept the default log folder path (drive:\Program Files\Research In Motion\BlackBerry Enterprise Server\Logs\), click Next.

Or

If you wish to change the default path to which all log files are to be saved, click Browse.

The Change Current Destination Folder dialog appears.

InstallShield Wizard—Change Current Destination Folder screen

� Click the Look in drop-down list and browse to the new location, or type a directory path in the Folder name field.

Warning: You cannot configure the log files to save with a different file-name format. You can change the location to which the log files are saved (on the BlackBerry Enterprise Server Software installer Log Folder screen, during an upgrade or installation).

78 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 83: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Completing the installation

� Click OK. The Log folder screen appears.

� To accept the new log folder path, click Next.

Completing the installationThe following steps enable you to enter your Windows NT login information and verify the options you have chosen to install.

1. The Windows NT Login Information screen appears.

InstallShield Wizard—Windows NT Login Information screen

2. In the Password field, type the password for the login account displayed in the Account field. The account shown is the account that you logged in with to install the BlackBerry Enterprise Server Software. This account should be the BlackBerry Enterprise Server service account that you defined before you began the installation.

3. Click Next. The Ready to install BlackBerry Enterprise Server screen appears.

Installation and Getting Started Guide 79

Page 84: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

InstallShield Wizard—Ready to install BlackBerry Enterprise Server screen

4. Review all the settings of the Typical installation (displayed in this window) before you continue. Click Install to begin the installation.

5. The Installing BlackBerry Enterprise Server screen appears while the installation files are copied.

InstallShield Wizard—Installing BlackBerry Enterprise Server screen

After the installation is complete, the final screen of the InstallShield Wizard appears.

80 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 85: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Completing the installation

InstallShield Wizard—InstallShield Wizard Completed screen

6. You should leave the Yes, I would like to view the readme file(s) now option selected so that you can view further information about the software that you chose to install. Click Finish.

The readme file for this release of the BlackBerry Enterprise Server Software appears. It includes information about all the available software that you might have chosen to install.

7. After you read the Readme, close the file.

8. A dialog appears indicating that you must restart the system in order for the configuration settings to take effect. Click Yes.

Tip: To view all other documentation that you installed, from the Start menu, select Programs > BlackBerry Enterprise Server > Documentation.

Installation and Getting Started Guide 81

Page 86: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 4: Installing BlackBerry Enterprise Server Software (Typical installation)

82 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 87: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 5Installing the attachment service on a remote computerThis section provides information on the following topics:

� Preinstallation steps

� Installing the attachment service on a remote computer

Page 88: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 5: Installing the attachment service on a remote computer

You can choose to install the attachment service on the same computer as the BlackBerry Enterprise Server service during the installation of the BlackBerry Enterprise Server (occurs by default in a Typical installation), or you can install it separately, on a remote computer in a stand alone setup. This chapter explains how to install the attachment service on a remote computer.

You should complete these steps in the order in which they appear in this document. All the steps are required unless otherwise stated.

Preinstallation steps� Verify that you meet all system requirements (see page 28) and that you completed all

prerequisite procedures before you begin the installation.

� Verify that you have installed an attachment connector on the BlackBerry Enterprise Server(s) on which you wish to enable attachment viewing. The attachment connector(s) can be configured during or after installation to point to the remote attachment service.

� Verify that you are logged in to the target computer as an Administrator service account.

Installing the attachment service on a remote computer1. Run the provided setup program to start the installation program. The Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Customer Information screen appears.

84 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 89: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing the attachment service on a remote computer

InstallShield Wizard—Customer Information screen

3. Type information in the following fields:

4. Click Next. The License Agreement screen appears.

Field Action

User Name In this field, type your user name.

Organization In this field, type the name of your company or organization.

Country From this drop-down list, select the country in which you purchased your license for the BlackBerry Enterprise Server Software.

License Key In this field, type your license key to BlackBerry Enterprise Server Software.

Installation and Getting Started Guide 85

Page 90: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 5: Installing the attachment service on a remote computer

InstallShield Wizard—License Agreement screen

5. Verify that I accept the terms in the license agreement is selected. Click Next. The Setup Type screen appears.

InstallShield Wizard—Setup Type screen

6. Select Custom. Click Next. The Custom Setup screen appears.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

86 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 91: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing the attachment service on a remote computer

InstallShield Wizard—Custom Setup screen

Items that will be installed by default are marked with a icon. Items that are not to be installed are marked with a icon.

Install options—Drop-down list

7. Click Attachment Service. A drop-down list appears.

8. Verify that This feature will be installed on local hard drive is selected.

9. Configure all other items to not be installed as follows:

� Click the item. A drop-down list appears.

� Verify that This feature will not be available is selected.

10. Click Next. The Ready to install BlackBerry Enterprise Server screen appears.

Tip: Click Help to view a Custom Setup Tips screen with further tips about these icons.

Installation and Getting Started Guide 87

Page 92: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 5: Installing the attachment service on a remote computer

InstallShield Wizard—Ready to install BlackBerry Enterprise Server screen

11. Review all the settings that you chose (displayed in this window) before you continue. Click Install to begin the installation.

12. The Installing BlackBerry Enterprise Server screen appears while the installation files are copied.

InstallShield Wizard—Installing BlackBerry Enterprise Server screen

After the installation is complete, the final screen of the InstallShield Wizard appears.

88 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 93: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing the attachment service on a remote computer

InstallShield Wizard—InstallShield Wizard Completed screen

13. You should leave the Yes, I would like to view the readme file(s) now option selected so that you can view further information about the software that you chose to install. Click Finish.

The readme file for this release of the BlackBerry Enterprise Server Software appears. It includes information about all the available software that you might have chosen to install.

14. After you read the Readme, close the file.

Tip: To view all other documentation that you chose to install, from the Start menu, select Programs > BlackBerry Enterprise Server > Documentation.

Installation and Getting Started Guide 89

Page 94: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 5: Installing the attachment service on a remote computer

90 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 95: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6Installing and removing multiple servicesThis section provides information on the following topics:

� Overview

� Installing multiple services

� Installing multiple BlackBerry services

� Installing multiple attachment connectors

� Installing multiple Mobile Data Services

� Completing the installation of multiple services

� Removing service(s)

Page 96: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

OverviewAfter completing an initial installation of the BlackBerry Enterprise Server Software, you should have installed at least one instance of the BlackBerry Enterprise Server service. By default, BlackBerry Service #1 is selected and installed, although you might have changed your installation options to install any of the four BlackBerry services that are listed. Refer to "Installing BlackBerry Enterprise Server Software (Typical installation)" on page 59 for more information.

Using the Custom installation type, you can install up to four BlackBerry Enterprise Server services on a single computer. For each BlackBerry Enterprise Server service, you can install a Mobile Data Service instance and an Attachment Connector instance. If you install multiple Attachment Connector instances, all connectors will point to the same attachment service server, whether the attachment service is installed on the BlackBerry Enterprise Server or on a remote computer.

Warning dialog box—Attachment connector(s) required

If you install a BlackBerry Enterprise Server service and do not install the Mobile Data Service or Attachment Connector for that service, that BlackBerry Enterprise Server service will not have Mobile Data Service functionality or access to the Attachment Service.

Verify that you meet all system requirements for the tools you will install and have completed all prerequisite procedures before you begin the installation. Refer to "Preinstallation" on page 27 for more information.

Installing multiple servicesBefore beginning installation, verify that you are logged in to the BlackBerry Enterprise Server target computer as the BlackBerry Enterprise Server service account.

Warning: If you are installing the attachment service locally or on a remote computer, you must install at least one attachment connector on the BlackBerry Enterprise Server. If you select attachment service for installation and deselect all the attachment connectors, the following warning appears

92 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 97: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

1. Run the provided setup program to start the BlackBerry Enterprise Server installation program.

� If you have Microsoft Outlook installed, a warning dialog box appears.

Warning dialog box—Microsoft Outlook must be removed

OR

If you have Microsoft Outlook XP or later installed, a warning dialog box appears.

Warning dialog box—Microsoft Outlook XP or later must be removed

� Click OK to acknowledge that you are aware that you must remove Microsoft Outlook for the BlackBerry Enterprise Server to function properly after installation. You should remove Microsoft Outlook before proceeding with the BlackBerry Enterprise Server Software installation.

� If you do not have Java Runtime Environment (JRE) 1.4 installed, a warning dialog box appears.

Warning dialog box—JRE 1.4 must be installed for Mobile Data Service

This software is provided on the BlackBerry Enterprise Server CD.

� Click OK. Install JRE 1.4. Refer to "System requirements" on page 28 for more information.

Warning: You should not have Microsoft Outlook installed on the computer on which you are installing the BlackBerry Enterprise Server. If Microsoft Outlook is present on the BlackBerry Enterprise Server computer, wireless calendar synchronization does not work because Microsoft Outlook’s versions of CDO.dll and MAPI files do not support wireless calendar synchronization. If Microsoft Outlook is opened on a BlackBerry Enterprise Server, it attempts to overwrite the MAPI system. Therefore, Microsoft Outlook on a BlackBerry Enterprise Server is an unsupported configuration.

Installation and Getting Started Guide 93

Page 98: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

2. The Welcome screen appears.

InstallShield Wizard—Welcome screen

3. Click Next. The Program Maintenance screen appears.

InstallShield Wizard—Program Maintenance screen

4. Select the Modify option. Click Next. The Customer Information screen appears.

94 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 99: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

InstallShield Wizard—Customer Information screen

5. Type information in the following fields:

6. Click Next. The License Agreement screen appears.

Field Action

User Name In this field, type your user name.

Organization In this field, type the name of your company or organization.

Country From this drop-down list, select the country in which you purchased your license for the BlackBerry Enterprise Server Software.

License Key In this field, type your license key to BlackBerry Enterprise Server Software.

Installation and Getting Started Guide 95

Page 100: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

InstallShield Wizard—License Agreement screen

7. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

8. Select BlackBerry Service #2. A drop-down list appears.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

96 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 101: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

9. Click This feature will be installed on local hard drive.

10. If you want to install the Mobile Data Service for this BlackBerry Service instance, select MDS Service #2. A drop-down list appears.

InstallShield Wizard—Custom Setup screen

11. Click This feature will be installed on local hard drive.

Warning: A unique SRP Identifier is required to connect the service to the wireless network. When you add the new BlackBerry Enterprise Server service to the BlackBerry Enterprise Server Management console, you must provide the unique SRP Identifier or the server status will remain unknown and you will be unable to start the service.

Note: To add more BlackBerry services, repeat the steps above for one or both of the BlackBerry Service #3 and BlackBerry Service #4 options on the Custom Setup screen.

Note: To add more Mobile Data Service instances, first add the new BlackBerry Service and then repeat the steps above for one or both of the MDS Service #3 and MDS Service #4 options on the Custom Setup screen.

Installation and Getting Started Guide 97

Page 102: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

12. If you want to install the Attachment Connector for this BlackBerry Service instance, select Attachment Connector #2. A drop-down list appears.

InstallShield Wizard—Custom Setup screen

13. Click This feature will be installed on local hard drive.

14. Click Next. The Installation Settings for BlackBerry Service #2 screen appears.

Installing multiple BlackBerry services

InstallShield Wizard—Installation Settings for BlackBerry Service #2 screen

1. Click Next. The BlackBerry Server Communication Information screen appears.

Note: To add more Attachment Connectors, first add the new BlackBerry Service and then repeat the steps above for one or both of the Attachment Connector #3 and Attachment Connector #4 options on the Custom Setup screen.

98 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 103: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

InstallShield Wizard—BlackBerry Server Communication Information screen

2. In the BlackBerry Server Name field, type a unique name to identify the BlackBerry Enterprise Server service.

3. In the SRP Host field, type the SRP Address. This is the Network Access Node that the BlackBerry Enterprise Server uses to connect to the network (for example, srp.na.blackberry.net). Use the SRP Address value that is provided on your installation CD label, unless you are using a proxy firewall, in which case the network access node must be the internal IP of the proxy, not the SRP Address.

4. In the SRP Port field, type the port number for the network access node that is defined above. Unless you are using a port mapping firewall, this value should be 3101.

5. Click Test Network Connection to verify that your settings permit connection to the network.

� If the connection is unsuccessful, click OK. The Communication Information screen, verify the values are correct and retest. If the connection is still unsuccessful, a firewall configuration problem might exist.

� If the connection is successful, in the confirmation dialog box, click OK.

6. Click Next. The BlackBerry Server MAPI Profile screen appears.

Note: Record the server name that you define here. You must provide this exact name when you configure the BlackBerry Enterprise Server in the BlackBerry Enterprise Server Management console.

Installation and Getting Started Guide 99

Page 104: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

InstallShield Wizard—BlackBerry Server MAPI Profile screen

7. In the Admin MAPI Profile field, type the name of the MAPI profile for the BlackBerry Enterprise Server service account, which the BlackBerry Enterprise Server service uses to communicate with the Microsoft Exchange Server. If you type the name of a non-existent MAPI profile, you are prompted to create a new MAPI profile. Click Yes. The Microsoft Exchange Server dialog box appears. You can also select Create/Edit MAPI Profile to open the Microsoft Exchange Server dialog box.

Microsoft Exchange Server dialog box

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

100 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 105: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names that you specified.

� After both names appear underlined, click OK. The BlackBerry Server MAPI Profile screen appears.

8. Click Next.

Installing multiple attachment connectorsThe BlackBerry Enterprise Server Software installation enables you to install multiple attachment connectors at this point in the installation if you selected that option.

1. The Installation Settings for Attachment Connectors screen appears.

InstallShield Wizard—Installation Settings for Attachment Connectors screen

Note: If you are installing multiple BlackBerry Enterprise Server services on a single server, the installation settings screens for the next BlackBerry Enterprise Server service appear, and should be completed in the same way as the installation settings for BlackBerry Enterprise Server service #1.

Installation and Getting Started Guide 101

Page 106: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

2. Click Next. The Attachment Service Host screen appears.

InstallShield Wizard—Attachment Service Host screen

3. In the Server Name field, localhost or the local BlackBerry Enterprise Server name appears by default. To install the attachment service on a remote computer, type the name of the remote computer.

If have installed or will install the attachment service on a remote server, click Test Network Connection to verify that the connection to the remote computer is working.

4. Click Next. If you chose to install another Mobile Data Service instance, the Installation Settings for Mobile Data Service screen appears.

Installing multiple Mobile Data ServicesThe BlackBerry Enterprise Server Software installation enables you to install multiple Mobile Data Services at this point in the installation, if you selected one or more additional Mobile Data Service instances to be installed.

102 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 107: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

InstallShield Wizard—Installation Settings for Mobile Data Service screen

The Mobile Data Service installation is associated with the BlackBerry service it is grouped with, and includes Central Push Service by default. The push server can be enabled after installation (through the BlackBerry Enterprise Server Management console) on one BlackBerry Enterprise Server with Mobile Data Service installed.

1. Click Next. The Mobile Data Service Push Server Settings screen appears.

InstallShield Wizard—Mobile Data Service Push Server Settings screen

2. The BlackBerry Enterprise Server Management MAPI profile appears by default in the MAPI Profile field. Mobile Data Service should use the BlackBerry Enterprise Server Management database settings.

Note: The service account that is used by Mobile Data Service to access the database (the BlackBerry Enterprise Server Management service account), requires read/write access on the database.

Installation and Getting Started Guide 103

Page 108: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

3. In the Database Consistency Polling Frequency field, the default value of 24 (hours) appears. This frequency is the rate at which the BlackBerry Enterprise Server Management database is checked against the data in users� mailboxes. You can change this value if you wish. It can also be changed after installation through the Mobile Data Service Properties window Push Server tab if you have set a centralized push server.

4. Click Next.

If you installed BlackBerry Enterprise Server Management and configured the database information, you can proceed to �Completing the installation of multiple services� on page 105. If you did not install BlackBerry Enterprise Server Management on the local computer, you must now type the BlackBerry Enterprise Server database information that is used by Mobile Data Service.

5. The Database Information screen appears.

InstallShield Wizard—Database Information screen

6. In the Database Information section, if you installed an SQL Server instance, the name of the SQL Server appears by default in the SQL Server Name field. If you do not have an SQL Server, the local computer name appears instead. You can replace the default server name with the name of another server on which you intend to install the database, or with the name of a server on which a database you want to use already resides.

7. In the Database Information section, accept the default Database Name (BESMgmt) or type a new name in the Database Name field.

Note: If you do not want to install the database on the local computer (that is, if you change the server name to that of another computer on which you want to use a database), you cannot use the BlackBerry Enterprise Server InstallShield Wizard to install the database. You can manually install the database at any time following the BlackBerry Enterprise Server Management installation. Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information.

104 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 109: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

8. In the Database Authentication section, choose the database authentication type that is predetermined by the database installation (Windows (trusted) for Windows NT Authentication or SQL Authentication).

� If you select SQL Authentication, in the SQL User Name field, accept the default user name (sa) or type a new user name; and, in the Password field, accept the default password (no password) or type a new password. The user name and password are used only to create the SQL database.

� If you select Windows (trusted), the SQL User Name field, and Password field are disabled (unavailable).

9. Click Next. The InstallShield Wizard attempts to detect and verify an SQL Server instance. If nothing is detected, the following warning appears.

Warning dialog box—SQL Server not detected

The rest of the installation process is the same, regardless of which options you are installing.

Completing the installation of multiple services1. Click Next. The Windows NT Login Information screen appears.

Note: If you do not know the database authentication type, ask your database administrator.

Installation and Getting Started Guide 105

Page 110: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

InstallShield Wizard—Windows NT Login Information screen

2. In the Password field, type the password for the login account that is shown in the Account field. The account that is shown is the account with which you logged in to install the BlackBerry Enterprise Server Software. This account should be the BlackBerry Enterprise Server service account that you defined during the initial BlackBerry Enterprise Server Software installation (after you should have installed, at minimum, BlackBerry service #1).

3. Click Next. The password that you define is verified. You must define a valid password to proceed with the installation.

4. Click Next. The Ready to install BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Ready to install BlackBerry Enterprise Server screen

106 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 111: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing multiple services

5. Review the settings that appear in this window before you continue the installation. Click Install to begin the installation.

The Installing BlackBerry Enterprise Server screen appears while the installation files are copied.

InstallShield Wizard—Installing BlackBerry Enterprise Server screen

After the installation is complete, the final screen of the InstallShield Wizard appears.

InstallShield Wizard—InstallShield Wizard Completed screen

6. Click Finish.

Installation and Getting Started Guide 107

Page 112: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

Removing service(s)

1. Run the provided setup program to start the BlackBerry Enterprise Server installation program. The Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance screen appears.

InstallShield Wizard—Program Maintenance screen

Warning: At least one BlackBerry Enterprise Server service is required to run the BlackBerry Enterprise Server.

108 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 113: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing service(s)

3. Select the Modify option. Click Next. The Customer Information window appears.

InstallShield Wizard—Customer Information screen

4. Verify your customer information. Click Next. The License Agreement screen appears.

InstallShield Wizard—License Agreement screen

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Installation and Getting Started Guide 109

Page 114: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

5. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

6. Select BlackBerry Service #2. From the drop-down list, click This feature will not be available.

Custom Setup screen—Installation options

Note: Any installedMobile Data Service instance and/or Attachment Connector instance for this BlackBerry Service instance is automatically marked for removal when select the BlackBerry Service instance to be removed..

110 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 115: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing service(s)

7. Click Next. The Ready to modify BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Ready to modify BlackBerry Enterprise Server screen

8. Review the changes that you are about to make. Click Install. The InstallShield Wizard removes the BlackBerry Enterprise Server service(s).

A dialog appears that prompts you to choose whether or not to remove all data that is associated with the services that you are removing.

Dialog box—Removal of data that is associated with the service

9. Click Yes to remove all data associated with the service, or click No to leave data on the local computer.

Installation and Getting Started Guide 111

Page 116: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 6: Installing and removing multiple services

After the removal process is complete, the final screen of the InstallShield Wizard appears.

InstallShield Wizard—InstallShield Wizard Completed screen

10. Click Finish. The InstallShield Wizard closes.

112 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 117: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7Installing administration softwareThis section provides information on the following topics:

� Installing BlackBerry Enterprise Server Management software (standalone)

� Updating BlackBerry User Administration

� Completing the installation

� Creating a database after the BlackBerry Enterprise Server Management installation (optional)

Page 118: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

You can choose to install BlackBerry Enterprise Server Management during the installation of the BlackBerry Enterprise Server, or you can install it separately, either on the same computer as the BlackBerry Enterprise Server service, or on a different computer in a standalone setup.

Before you install BlackBerry Enterprise Server Management software, verify that you have completed the necessary preinstallation procedures. Refer to "Preinstallation" on page 27 for more information.

Installing BlackBerry Enterprise Server Management software (standalone)1. Select one of the following options:

� Log in to the BlackBerry Enterprise Server computer as the BlackBerry Enterprise Server Management service account (which can be the same as the BlackBerry Enterprise Server service account)

� Log in to a different computer running Windows NT Server 4.0 (Service Pack 5 or later) or Windows 2000 Server (Service Pack 1 or later) or Windows Server 2003 or or Windows 2000 Professional or Windows XP that has Microsoft Exchange 5.5 Administrator, Microsoft Exchange 2000 System Manager, Microsoft Exchange 2003 System Manager, Microsoft Outlook 2000 (Corporate or Workgroup installation), Microsoft Outlook 2003,or Microsoft Outlook XP installed. Refer to "System requirements" on page 28 for more information.

2. Run the setup program to start the BlackBerry Enterprise Server installation. The Welcome screen appears.

Warning: If you are upgrading from the Microsoft Exchange 5.5 administration extensions to BlackBerry Enterprise Server Management, you must export your server information from the administration extensions before you install the BlackBerry Enterprise Server version . Refer to "Upgrading from Microsoft Exchange 5.5 administration extensions" on page 50 for more information.

Note: If you are using Microsoft Exchange 2000/2003, the service account/mailbox that is used to install and run the BlackBerry Enterprise Server Management software must have the following Microsoft Exchange 2000/2003 permissions: Exchange View-only Administration, and Administer information store

Note: If you are installing BlackBerry Enterprise Server Management on a computer on which BlackBerry Enterprise Server is not installed, the InstallShield Wizard runs a new installation, enabling you to install any BlackBerry Enterprise Server Software through a Custom setup.

114 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 119: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management software (standalone)

InstallShield Wizard—Welcome screen

3. Click Next. The Customer Information screen appears.

InstallShield Wizard—Customer Information screen

4. Type information in the following fields:

5. Click Next. The License Agreement screen appears.

Field Action

User Name In this field, type your user name.

Organization In this field, type the name of your company or organization.

Country From this drop-down list, select the country in which you purchased your license for the BlackBerry Enterprise Server Software.

License Key In this field, type your license key to BlackBerry Enterprise Server Software.

Installation and Getting Started Guide 115

Page 120: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

InstallShield Wizard—License Agreement screen

6. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Setup Type screen appears.

InstallShield Wizard—Setup Type screen

7. Select Admin only setup type. The Installation Settings for BlackBerry Enterprise Server Management screen appears.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Note: Refer to "Installing BlackBerry Enterprise Server Software (Typical installation)" on page 59 for more information on the Admin only installation.

116 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 121: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management software (standalone)

InstallShield Wizard—Installation Settings for BlackBerry Enterprise Server Management screen

8. Click Next. The Database Information screen appears.

InstallShield Wizard—Database Information screen

9. In the SQL Server Name field, accept the default local server name, or type the name of a different server on which you have installed, or intend to install, a database.

10. In the Database Name field, accept the default Database Name (BESMgmt) or type a new name.

Note: If you do not want to install the database on the BlackBerry Enterprise Server Management computer (that is, if you change the server name to that of another computer on which you want to use a database), you cannot use the BlackBerry Enterprise Server InstallShield Wizard to install the database. You can manually install the database at any time after you install the BlackBerry Enterprise Server Management. Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information.

Installation and Getting Started Guide 117

Page 122: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

11. In the Database Authentication section, select the database authentication type: Windows (trusted) for Windows NT Authentication or SQL Authentication.

12. If you select SQL Authentication, complete the following steps:

� In the SQL User Name field, accept the default user name (sa) or type a new user name.

� In the Password field, accept the default password (no password) or type a new password. The user name and password are used only to create the SQL database.

13. Click Next. The BlackBerry Enterprise Server Database Maintenance screen appears (unless you have chosen to host the database on a separate computer). If you have chosen to host the database on a separate computer, proceed to step 24 on page 120.

InstallShield Wizard—BlackBerry Enterprise Server Database Maintenance screen

14. Select one of the following options:

� To create a database for BlackBerry Enterprise Server Management, select Create BlackBerry Enterprise Server Management database

� To update a database you already created, select Update BlackBerry Enterprise Server Management database

15. Click Next. The Database Path Information screen appears (unless you have chosen to host the database on a separate computer).

Note: If you do not know the database authentication type, ask your database administrator.

118 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 123: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management software (standalone)

InstallShield Wizard—Database Path Information screen

16. Confirm that the root directory of your SQL files location (as it appears in the Database Program Path field) is correct. If the correct directory path does not appear by default, click Browse to select it from the Database Program Path dialog box, or type it in the Database Program Path field.

17. Confirm that the directory of your SQL data store (as it appears in the Database Data Path field) is correct. If the correct directory path does not appear by default, click Browse to select it from the Database Data Path dialog box, or type it in the Database Data Path field.

18. If you have not installed MSDE or SQL Server yet, click Install MSDE to run a silent installation at this point. A warning dialog box appears.

Warning dialog box—Installing MSDE

19. Click Yes. A dialog box prompts you to select the location of MSDE on your local computer.

Installation and Getting Started Guide 119

Page 124: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

Dialog box—Browse to select SQL installation file

Browse to the location that you want to use. Click OK. The InstallShield Wizard minimizes while MSDE is installed. The installation requires approximately three minutes.

20. Click Next. The BlackBerry Enterprise Server Management MAPI Profile screen appears.

InstallShield Wizard—BlackBerry Enterprise Server Management MAPI Profile screen

21. In the Management MAPI Profile field, type the name of the MAPI profile for the BlackBerry Enterprise Server Management administration service account, which the BlackBerry Enterprise Server Management service uses to communicate with the Microsoft Exchange Server. This name can be the same as or different from the MAPI profile and service account that you use for the BlackBerry Enterprise Server. If you type the name of a non-existent MAPI profile, you are prompted to create a new MAPI profile. Click Yes. The Microsoft Exchange Server dialog box appears. You can also select Create/Edit MAPI Profile to open the Microsoft Exchange Server dialog box.

120 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 125: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management software (standalone)

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names that you specified.

� After both names appear underlined, click OK. The BlackBerry Enterprise Server Management MAPI Profile screen appears.

22. Click Next. One of the following occurs:

� If you did not previously install BlackBerry User Administration on the computer, proceed to �Completing the installation� on page 126.

� If you previously had installed BlackBerry User Administration on the computer, you can update it now by completing the updating BlackBerry User Administration procedure below.

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

Installation and Getting Started Guide 121

Page 126: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

Updating BlackBerry User Administration1. The Installation Settings for BlackBerry User Administration screen appears.

InstallShield Wizard—Installation Settings for BlackBerry User Administration screen

2. In the Installation Settings for BlackBerry User Administration screen, click Next. The Secure Password screen appears.

InstallShield Wizard—Secure Password screen

3. Type a password that will be used to secure the BlackBerry User Administration client connection.

4. Click Next. The BlackBerry Server List screen appears.

122 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 127: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management software (standalone)

InstallShield Wizard—BlackBerry Server List screen

5. To create a MAPI profile for each BlackBerry administration mailbox that is associated with a BlackBerry Enterprise Server, in the BlackBerry Server Name field, type the BlackBerry Enterprise Server name and in the Admin MAPI Profile field, type the BlackBerry Enterprise Server Administration MAPI Profile name.

� If you are using an existing MAPI profile, click Add to add the server and MAPI profile combination to the Server List. This action adds the server name and its MAPI profile to the RemoteAdmin.txt file in the BlackBerry User Administration folder after installation. The BlackBerry User Administration service reads this file when it starts. The file name and location are defined through a registry key.

� If the MAPI profile does not yet exist or requires editing, click Create/Edit Profile. The Microsoft Exchange Server dialog box appears.

Note: You can administer multiple MAPI profiles that have the same name on different servers, but you cannot add a server name more than once. If you try to add the same server more than once, a Duplicate BES Server entered warning message appears.

Installation and Getting Started Guide 123

Page 128: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox.

� Click Check Name to confirm both the server and mailbox names that you specified. Both names appear underlined after they are confirmed.

� Click OK. The BlackBerry Server List window appears.

6. In the BlackBerry Server List window, click Add to add the server and its MAPI profile to the Server List. This adds the server name and its MAPI profile to the RemoteAdmin.txt file found in the BlackBerry User Administration folder after installation. The BlackBerry User

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

124 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 129: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry Enterprise Server Management software (standalone)

Administration service reads this file when it starts. The file name and location are defined through a registry key.

7. Continue to add servers and their MAPI profiles to the Server List. After you finish, click Next. The Windows NT Login Information screen appears.

InstallShield Wizard—Windows NT Login Information screen

Note: If you do not want to add any or all Server:MAPI Profile combinations at this time, you can add Server:MAPI Profile combinations manually to RemoteAdmin.txt after you run the installer. In RemoteAdmin.txt, the server name and the MAPI profile name are separated by a tab. Any extra spacing (other than a single tab) renders the Server:MAPI Profile combination unreadable.

You can also run the installer again at any time to add Server:MAPI Profile combinations to RemoteAdmin.txt.

Note: If you click Next without adding a pending Server:MAPI Profile combination to the Server List, a dialog box prompts you to decide whether or not you want to add “Server:MAPI Profile” to the list. Click Yes or No.

Installation and Getting Started Guide 125

Page 130: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

Completing the installation1. The Ready to install BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Ready to install BlackBerry Enterprise Server screen

2. Review the settings that appear in this window. Click Install. The Installing BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Installing BlackBerry Enterprise Server screen

After the installation is complete, the final screen of the InstallShield Wizard appears.

126 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 131: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Creating a database after the BlackBerry Enterprise Server Management installation (optional)

InstallShield Wizard—InstallShield Wizard Completed screen

3. Click Finish. The InstallShield Wizard closes.

After the BlackBerry Enterprise Server Management software is installed, you can add BlackBerry Enterprise Servers to the BlackBerry Enterprise Server Management console and begin managing BlackBerry Enterprise Servers using the console.

Creating a database after the BlackBerry Enterprise Server Management installation (optional)

1. Using the BlackBerry Enterprise Server Management service account, log in to the computer on which you want to create the database.

2. Change to the database directory and complete one of the procedures shown below, according to the server on which you want to install the database:

If you are installing the database on the BlackBerry Enterprise Server Management computer:

Note: If you did not install the database prior to running BlackBerry Enterprise Server Management, you receive an error message the first time that you open BlackBerry Enterprise Server Management.

Warning: If you successfully installed the database during the BlackBerry Enterprise Server Management installation, you do not have to complete the following procedure.

Note: Before you create a database with SQL Server, you must start MSSQLSERVER (the SQL Server service).

Installation and Getting Started Guide 127

Page 132: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

� at a command prompt, change to the directory in which the database script files are installed, as specified in the Choose Destination Location window during the BlackBerry Enterprise Server Management installation. Typically, the directory path is:

C:\Program Files\Research In Motion\BlackBerry Enterprise Server Management\Database\

If you are installing the database on a computer other than the BlackBerry Enterprise Server Management computer select one of the following options:

� Copy the database software from the BlackBerry Enterprise Server Software CD in drive:\MSDE\.

3. Create a database using CreateDB.exe, with one of the following methods:

� To create a database using the default values, at the command line, type the following command:

CreateDB.exe

128 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 133: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Creating a database after the BlackBerry Enterprise Server Management installation (optional)

� To change default values for the database, add -? to the command, as shown below, to view the parameters:

CreateDB.exe -?

To change a database parameter, run the CreateDB.exe command, and add the parameter(s) to be changed and new parameter value(s), as shown in the example below:

CreateDB.exe -P database -n DB

where the password is changed to database and the database name is changed to DB.

Note: The database parameters are as follows:

-S is the name of the computer on which the database is to be installed (default is the local computer).

-U is the user ID that is required to gain access to the SQL server (the default value is sa).

-P is the password that is required to gain access to the SQL server (the default value for SQL/MSDE is no password, indicated as ““).

-n is the database name (BESMgmt by default).

-o is the location of the osql.exe utility.

-l is the location of the data directory.

-q is quiet mode (no messages).

-d is the directory of the input SQL files (the current directory, in which you are running MMCCreateDB.exe, is the default).

-E indicates a trusted connection should be used instead of SQL authentication (if this is present, the userID and password are ignored).

-delete indicates that if the database exists already, it will be backed up, deleted and recreated. Otherwise, if a database with the given name already exists, it is updated.

-k <key> enables you to specify a license key to add to the database.

Installation and Getting Started Guide 129

Page 134: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 7: Installing administration software

130 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 135: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8Installing standalone BlackBerry User AdministrationThis section provides information on the following topics:

� Installing BlackBerry User Administration software (standalone)

� Installing BlackBerry Enterprise Server Management

� Installing BlackBerry User Administration

� Completing installation

Page 136: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

You can install BlackBerry User Administration during the installation of the BlackBerry Enterprise Server, or you can install it separately, either on the same computer or on a different computer from the BlackBerry Enterprise Server service.

Before you install BlackBerry User Administration software, verify that you have completed the necessary preinstallation procedures. Refer to "Preinstallation" on page 27 for more information.

Installing BlackBerry User Administration software (standalone)1. Select one of the following options:

� Log in to the BlackBerry Enterprise Server computer as the BlackBerry Enterprise Server Management service account (which can be the same as the BlackBerry Enterprise Server service account)

� Log in to a different computer running Windows NT Server 4.0 (Service Pack 5 or later) or Windows 2000 Server (Service Pack 1 or later) or Windows Server 2003 or Windows XP that has Microsoft Exchange 5.5 Administrator, Microsoft Exchange 2000 System Manager, Microsoft Exchange 2003 System Manager, Microsoft Outlook 2000 (Corporate or Workgroup installation), Microsoft Outlook 2003, or Microsoft Outlook XP installed. Refer to "System requirements" on page 28 for more information.

2. Run the setup program to start the BlackBerry Enterprise Server installation program. If you have installed other BlackBerry Enterprise Server Software options on the same computer already, the InstallShield Wizard runs an upgrade/modify/remove program that enables you to install BlackBerry User Administration. Otherwise, the InstallShield Wizard runs an initial

Warning: To install BlackBerry User Administration, BlackBerry Enterprise Server Management must also be installed on the same computer.

Note: If you are using Microsoft Exchange 2000/2003, the service account/mailbox used to install and run BlackBerry User Administration must have the following Microsoft Exchange 2000/2003 permissions: Exchange View-only Administration, Administer information store, and Receive as.

Note: If you are running Microsoft Windows XP, you will not see the Setup Type window. You will be directed to an Admin Only installation.

Note: If you are installing the BlackBerry Enterprise Server on a computer running Microsoft Outlook 2000, Microsoft Outlook 2003, or Microsoft Outlook XP, a Typical installation installs the Attachment Service, BlackBerry Enterprise Server Management, all utilities, and documentation. A Custom installation gives you the option to install the Attachment Service, BlackBerry Enterprise Server Management, BlackBerry User Administration, all utilities, and documentation.

132 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 137: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry User Administration software (standalone)

installation, which requires you to enter a license key and to accept the software license agreement.

The Welcome screen appears.

3. Click Next. If this is the first installation of the BlackBerry Enterprise Server Software on this computer, complete the following steps:

� In the Customer Information window, type the customer information and the license key.

� In the License Agreement window, read the license agreement and, if you agree to its terms, accept the license agreement.

� In the Setup Type window, click Custom setup type.

If this is an update to an earlier installation of the BlackBerry Enterprise Server Software on this computer, complete the following steps:

� In the Program Maintenance window, select the Modify option.

� In the Customer Information window, verify your customer information

� In the License Agreement window, read the license agreement and, if you agree to its terms, accept the license agreement.

The Custom Setup screen appears.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Installation and Getting Started Guide 133

Page 138: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

InstallShield Wizard—Custom Setup screen

Items that are installed by default are marked with a icon. Items that are not installed are marked with a icon.

4. Click an item you do not wish to install that is marked by a icon. A drop-down list appears.

5. Click This feature will not be available.

6. Repeat the previous two steps for each item you do not wish to install.

7. Click BlackBerry User Administration and, in the drop-down list, click This feature will be installed on local hard drive.

Custom Setup screen—Drop-down list

8. If BlackBerry Enterprise Server Management is not installed on this computer already, click BlackBerry Enterprise Server Management. A drop-down list appears.

9. Click This feature will be installed on local hard drive.

10. Click Next.

Warning: To install BlackBerry User Administration, BlackBerry Enterprise Server Management must also be installed on the same computer. If you try to install BlackBerry User Administration without BlackBerry Enterprise Server Management, a warning appears and BlackBerry User Administration cannot be installed.

134 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 139: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry User Administration software (standalone)

If you installed BlackBerry Enterprise Server Management already, proceed to Installing BlackBerry User Administration on page 140. Otherwise, continue with Installing BlackBerry Enterprise Server Management.

Installing BlackBerry Enterprise Server ManagementRefer to "Installing administration software" on page 113 for more information on installing BlackBerry Enterprise Server Management on a separate computer from BlackBerry Enterprise Server, and creating a database.

Unless you installed BlackBerry Enterprise Server Management already, the Installation Settings for BlackBerry Enterprise Server Management screen appears.

InstallShield Wizard—Installation Settings for BlackBerry Enterprise Server Management screen

1. Click Next. The Database Information screen appears.

Installation and Getting Started Guide 135

Page 140: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

InstallShield Wizard—Database Information screen

2. In the SQL Server Name field, accept the local server name, or type the name of another server on which you intend to install, or have already installed, a database.

3. In the Database Name field, accept the default name (BESMgmt) or type a new name.

4. In the Database Authentication section, select the database authentication type: Windows (trusted) for Windows NT Authentication or SQL Authentication.

5. If you select SQL Authentication, complete the following additional steps:

� In the SQL User Name field, accept the default user name (sa) or type a new user name.

� In the Password field, accept the default password (no password) or type a new password. The user name and password are used only to create the SQL database.

6. Click Next. The BlackBerry Enterprise Server Database Maintenance screen appears.

Note: If you do not want to install the database on the local computer (that is, if you change the server name to that of another computer on which you want to use a database), you cannot use the BlackBerry Enterprise Server InstallShield Wizard to install the database. You can manually install the database at any time following the BlackBerry Enterprise Server Management installation. Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information.

Note: If you do not know the database authentication type, ask your database administrator.

136 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 141: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry User Administration software (standalone)

InstallShield Wizard—BlackBerry Enterprise Server Database Maintenance screen

7. Select one of the following options:

� To create a database for BlackBerry Enterprise Server Management, select Create BlackBerry Enterprise Server Management database

� To update a database you already created, select Update BlackBerry Enterprise Server Management database

8. Click Next. The Database Path Information screen appears.

InstallShield Wizard—Database Path Information screen

9. Confirm that the root directory of your SQL files location (as it appears in the Database Program Path field) is correct. If the correct directory path does not appear by default, click Browse to select it from the Database Program Path dialog box, or type it in the Database Program Path field.

Installation and Getting Started Guide 137

Page 142: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

10. Confirm that the directory of your SQL data store (as it appears in the Database Data Path field) is correct. If the correct directory path does not appear by default, click Browse to select it from the Database Data Path dialog box, or type it in the Database Data Path field.

11. If you have not yet installed MSDE or SQL Server, click Install MSDE to run a silent installation at this point (otherwise, proceed to step 15). A warning dialog box appears.

Warning dialog box—Installing MSDE

12. Click Yes. A dialog box appears that enables you to select the location of MSDE on your local computer.

Dialog box—Browse to select MSDE installation file

13. Browse to the location that you want to use. Click OK. The InstallShield Wizard minimizes while MSDE is installed. The installation requires approximately three minutes.

14. After the MSDE installation completes, click Next. The BlackBerry Enterprise Server Management MAPI Profile screen appears.

138 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 143: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry User Administration software (standalone)

InstallShield Wizard—BlackBerry Enterprise Server Management MAPI Profile screen

15. In the Management MAPI Profile field, type the name of the MAPI profile for the BlackBerry Enterprise Server Management administration service account, which the BlackBerry Enterprise Server Management service uses to communicate with the Microsoft Exchange Server. This name can be the same as or different from the MAPI profile and service account that you use for the BlackBerry Enterprise Server.

If you type the name of a non-existent MAPI profile, a dialog box prompts you to create a new MAPI profile. Click Yes. A Microsoft Exchange Server dialog box appears.

Microsoft Exchange Server dialog box

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

Installation and Getting Started Guide 139

Page 144: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names that you specified.

� After both names appear underlined, click OK. The BlackBerry Enterprise Server Management MAPI Profile screen appears.

16. Click Next. The Installation Settings for BlackBerry User Administration screen appears.

InstallShield Wizard—Installation Settings for BlackBerry User Administration screen

Installing BlackBerry User Administration1. In the Installation Settings for BlackBerry User Administration screen, click Next. The Secure

Password screen appears.

140 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 145: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry User Administration software (standalone)

InstallShield Wizard—Secure Password screen

2. Type a password that will be used to secure the BlackBerry User Administration client connection.

3. Click Next. The BlackBerry Server List screen appears.

InstallShield Wizard—BlackBerry Server List screen

4. To create a MAPI profile for each BlackBerry administration mailbox that is associated with a BlackBerry Enterprise Server, in the BlackBerry Server Name field, type the BlackBerry Enterprise Server name and in the Admin MAPI Profile field, type the BlackBerry Enterprise Server Administration MAPI Profile name.

Note: You can administer multiple MAPI profiles that have the same name on different servers, but you cannot add a server name more than once. If you try to add the same server more than once, a Duplicate BES Server entered warning message appears.

Installation and Getting Started Guide 141

Page 146: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

� If you are using an existing MAPI profile, click Add to add the server and MAPI profile combination to the Server List. This action adds the server name and its MAPI profile to the RemoteAdmin.txt file in the BlackBerry User Administration folder after installation. The BlackBerry User Administration service reads this file when it starts. The file name and location are defined through a registry key.

� If the MAPI profile does not yet exist or requires editing, click Create/Edit Profile. The Microsoft Exchange Server dialog box appears.

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox.

� Click Check Name to confirm both the server and mailbox names that you specified. Both names appear underlined after they are confirmed.

� Click OK. The BlackBerry Server List window appears.

5. In the BlackBerry Server List window, click Add to add the server and its MAPI profile to the Server List. This adds the server name and its MAPI profile to the RemoteAdmin.txt file found in the BlackBerry User Administration folder after installation. The BlackBerry User

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

142 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 147: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry User Administration software (standalone)

Administration service reads this file when it starts. The file name and location are defined through a registry key.

6. Continue to add servers and their MAPI profiles to the Server List. After you finish, click Next. The Windows NT Login Information screen appears.

InstallShield Wizard—Windows NT Login Information screen

Complete the installation using the following procedure.

Completing installation1. In the Password field, type the password for the login account that is shown in the Account

field. The account that appears is the account with which you logged in to install the software. This account should be the BlackBerry User Administration service account that you defined before you began the installation.

2. Click Next. Type the password for the service account. You must define a valid password to proceed with the installation.

3. Click Next. The Ready to install BlackBerry Enterprise Server screen appears.

Note: If you do not want to add any or all Server:MAPI Profile combinations at this time, you can add Server:MAPI Profile combinations manually to RemoteAdmin.txt after you run the installer. In RemoteAdmin.txt, the server name and the MAPI profile name are separated by a tab. Any extra spacing (other than a single tab) renders the Server:MAPI Profile combination unreadable.

You can also run the installer again at any time to add Server:MAPI Profile combinations to RemoteAdmin.txt.

Note: If you click Next without adding a pending Server:MAPI Profile combination to the Server List, a dialog box prompts you to decide whether or not you want to add “Server:MAPI Profile” to the list. Click Yes or No.

Installation and Getting Started Guide 143

Page 148: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

InstallShield Wizard—Ready to install BlackBerry Enterprise Server screen

4. Review the settings that appear in this window. Click Install. The Installing BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Installing BlackBerry Enterprise Server screen

After the installation is complete, the final screen of the InstallShield Wizard appears.

144 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 149: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Installing BlackBerry User Administration software (standalone)

InstallShield Wizard—InstallShield Wizard Completed screen

5. Leave the Yes, I would like to view the readme file(s) now option selected. Click Finish.

The Readme file for this release of the BlackBerry Enterprise Server Software appears. It includes information about all of the available software that you might have chosen to install.

After the BlackBerry Enterprise Server Management software is installed, you can add BlackBerry Enterprise Servers to the BlackBerry Enterprise Server Management console and begin managing BlackBerry Enterprise Servers through the console.

Note: If you did not install the database prior to running BlackBerry Enterprise Server Management, an error message appears the first time that you open BlackBerry Enterprise Server Management.

Installation and Getting Started Guide 145

Page 150: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 8: Installing standalone BlackBerry User Administration

146 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 151: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 9Postinstallation proceduresThis section provides information on the following topics:

� Verifying MAPI profiles

� Configuring the BlackBerry Enterprise Server(s)

� Stopping or starting the BlackBerry Enterprise Server services

� Importing system information

� Removing BlackBerry Enterprise Server administration extensions

� Starting BlackBerry User Administration service manually

� Using the BlackBerry User Administration client

Page 152: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 9: Postinstallation procedures

These procedures should be completed after you install the BlackBerry Enterprise Server Software. You should complete these steps in the order in which they appear in this document. All the steps are required unless otherwise stated.

Verifying MAPI profilesAfter you install the BlackBerry Enterprise Server Software, you can complete the following procedure to view and/or edit the MAPI profile(s) that you created for BlackBerry Enterprise Server and BlackBerry Enterprise Server Management. The same MAPI profile can be used for both BlackBerry Enterprise Server and BlackBerry Enterprise Server Management.

Verifying the BlackBerry Enterprise Server MAPI profile1. From the Start menu, select Programs > BlackBerry Enterprise Server > Edit the MAPI Profile

for > BlackBerry Enterprise Server name. The Microsoft Exchange Server dialog box appears.

Microsoft Exchange Server dialog box

2. On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

3. In the Mailbox field, type the name of the BlackBerry Enterprise Server administration mailbox (for example, BESAdmin).

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 51 for more information.

148 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 153: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Verifying MAPI profiles

4. Click Check Name to confirm both the server and mailbox names that you specified.

5. After both names appear underlined, click OK.

The BlackBerry Enterprise Server MAPI profile is stored in the registry (HKEY_CURRENT_USER/Software/Research In Motion/BlackBerry Enterprise Server/Servers/Servername/MAPIProfile).

Verifying the BlackBerry Enterprise Server Management MAPI profile1. From the Start menu, select Programs > BlackBerry Enterprise Server > Edit the MAPI Profile

for > BlackBerry Server Management. The Microsoft Exchange Server dialog box appears.

Microsoft Exchange Server dialog box

2. On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

3. In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox (for example, BESAdmin).

4. Click Check Name to confirm both the server and mailbox names that you specified.

5. After both names appear underlined, click OK.

The BlackBerry Enterprise Server Management MAPI profile now exists and is stored in the registry (HKEY_CURRENT_USER/Software/Research In Motion/BlackBerry Enterprise Server/Management/MAPIProfile).

Installation and Getting Started Guide 149

Page 154: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 9: Postinstallation procedures

Configuring the BlackBerry Enterprise Server(s)After you install the BlackBerry Enterprise Server files, you must configure the BlackBerry Enterprise Server(s) you installed.

One of your first administrative tasks is to add a BlackBerry Enterprise Server to the BlackBerry Enterprise Server Management console so that the server can be administered through the console.

1. Right-click BlackBerry Server Management and select New BlackBerry Server. The BlackBerry Enterprise Server System Info window appears.

BlackBerry Enterprise Server System Info window

2. In the Server Name field, type the server name that you provided during the BlackBerry Enterprise Server Software installation.

3. In the SRP Identifier and SRP Authentication Key fields, type the appropriate information provided on the installation CD label. This information is unique to each host license.

Tip: To simplify installations, upgrades, and reinstalls, create an .srp file containing your SRP Identifier and SRP Authentication Key. You can import this .srp file so that these values are added to the appropriate fields automatically when required. Keep this file in a secure directory.

BlackBerry Enterprise Server name

SRP Identifier located on CD label

SRP Authentication Key located on CD labelHost Routing located on CD label. If there is no value provided, leave the field blank.

The mailbox used to administer the BlackBerry Enterprise Server

150 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 155: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Stopping or starting the BlackBerry Enterprise Server services

4. If host routing information is also provided on the BlackBerry Enterprise Server installation CD, in the Host Routing Information field, type the necessary information to connect to the mobile network.

5. Next to the Administration Mailbox field, click Select Mailbox to locate the mailbox that you created for BlackBerry Enterprise Server administration (this must be the same mailbox that is used during installation) or type the mailbox name into the field. Click Check Name. If there are any ambiguities within the mailbox name, the Microsoft Exchange Check Names window appears.

6. Verify your mailbox information. After you complete all necessary fields, click OK.

Repeat the procedure for additional BlackBerry Enterprise Servers. Verify that the SRP identifier and authentication keys are unique for each BlackBerry Enterprise Server.

Stopping or starting the BlackBerry Enterprise Server servicesAll of the BlackBerry Enterprise Server services (with the exception of the BlackBerry Database Consistency Service) are installed as automatic services. You must manually start the services after the installation or upgrade. Initially starting the BlackBerry Server Servername service writes the host name of the BlackBerry Enterprise Server computer to the administration mailbox.

If you need to stop or start the services at any time, complete one of the following procedures:

Starting/stopping services through Windows Services1. From the Start button, select Programs > Administrative Tools > Services to open the Services

window.

Warning: You should only define values in this field if values are provided with the installation material. If you are using the default Network Access Node (the SRP Address value provided on your installation CD label), or are uncertain which values to use, leave this field blank. If you define incorrect values in this field, connection to the mobile network is not be possible.

Warning: The first time you install the BlackBerry Enterprise Server, you must start the services through Windows Services. The option to start and stop the services through the BlackBerry Enterprise Server Management console is available only once the services have been initially started through Windows Services.

Installation and Getting Started Guide 151

Page 156: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 9: Postinstallation procedures

2.

Services

3. Stop/Start services:

� Select the BlackBerry Server <Servername> item. Right-click and select Stop or Start to stop or start the BlackBerry Enterprise Server service.

� Select the BlackBerry Mobile Data Server <Servername> item. Right-click and select Stop or Start to stop or start the Mobile Data Service.

� BESAlert and the BlackBerry Database Consistency Service can be stopped and started only through Windows Services.

4. Close the window.

Starting/stopping services through BlackBerry Enterprise Server Management

1. In the Tree view, right-click a BlackBerry Enterprise Server.

2. Stop/Start services:

� Select Stop BlackBerry Server or Start BlackBerry Server to stop or start the BlackBerry Enterprise Server service.

Warning: The first time you install the BlackBerry Enterprise Server, you must start the services through Windows Services. The option to start and stop the services through the BlackBerry Enterprise Server Management console is available only once the services have been initially started through Windows Services.

152 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 157: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Importing system information

� Select Stop Mobile Data Service or Start Mobile Data Service to stop or start the Mobile Data Service.

Importing system informationYou can import server information (for example, server name, administrator mailbox, and so on) to BlackBerry Enterprise Server Management.

1. In the Tree view, right-click BlackBerry Server Management. Click Import. A directory dialog box appears.

2. Browse to the directory location of the system information text file. Click Open. The Import BlackBerry Server dialog box appears.

3. Review the information that is imported. Click OK.

Removing BlackBerry Enterprise Server administration extensionsIf you previously used Microsoft Exchange 5.5 administration extensions to manage BlackBerry Enterprise Server, you should remove the BlackBerry Enterprise Server administration extensions. You must remove the extensions AFTER you upgrade to BlackBerry Enterprise Server version .

Verify that you have exported all server information from the administration extensions, installed the BlackBerry Enterprise Server version , and imported the server information to BlackBerry Enterprise Server Management before you remove the administration extensions.

1. Log in using an account with administrative privileges (typically, BESAdmin) on the local computer.

Warning: If you upgraded from using the Microsoft Exchange 5.5 administration extensions to using BlackBerry Enterprise Server Management, you should have exported your server information from the administration extensions, installed the BlackBerry Enterprise Server version , and then removed the administration extensions. You must import the server information that you exported from the Microsoft Exchange 5.5 administration extensions before you installed the BlackBerry Enterprise Server version .

Note: You must manually enter the SRP Identifier and SRP Authentication Key on the server’s BlackBerry Server (Servername) Properties window in the General tab. After you are finished, click Apply before closing the window.

Warning: If you upgraded from BlackBerry Enterprise Server version 2.1 or earlier, WinBBinstaller.exe was automatically removed. WinBBinstaller.exe is required to remove the Microsoft Exchange 5.5 administration extensions after you have upgraded and imported any system information as necessary. Contact technical support to obtain a copy of WinBBinstaller.exe.

Installation and Getting Started Guide 153

Page 158: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 9: Postinstallation procedures

2. From the Start menu, select Programs > BlackBerry Enterprise Server > Uninstall Administration Extensions.

Starting BlackBerry User Administration service manuallyThe BlackBerry User Administration service is installed as an automatic service, but must be started manually after an installation or upgrade.

1. From the Start button, select Programs > Administrative Tools > Services to open the Services window.

Windows Services

2. Select the BlackBerry User Administration item. Right-click and select Start to start the BlackBerry Enterprise Server service.

3. Right-click BlackBerry User Administration again and select Properties. The BlackBerry User Administration Properties window appears.

154 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 159: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Using the BlackBerry User Administration client

BlackBerry User Administration Properties window

4. On the General pane, in the Startup type drop-down list, verify that Automatic is selected.

5. On the Log On tab, verify that you specified a log in user account that has the right to administer Microsoft Exchange settings (using the permissions set before the installation).

6. Close the window.

Using the BlackBerry User Administration clientYou can use BlackBerry User Administration client to complete the following functions:

� add users to a BlackBerry Enterprise Server

� delete users from a BlackBerry Enterprise Server

� list all users on a BlackBerry Enterprise Server

� verify that a user exists on the specified BlackBerry Enterprise Server

The BlackBerry User Administration client is run from the command line of any computer on your network, and does not require administrative privileges. You can optionally provide input files for adding or deleting multiple users.

Installation and Getting Started Guide 155

Page 160: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 9: Postinstallation procedures

Command line syntaxTo use the BlackBerry User Administration client, run it from the command line using the following syntax:

C:\Program Files\Research In Motion\BlackBerry Enterprise Server\UserAdmin\BBUserAdminClient -s servername -n networkaddress -flag(s)

Where:

� servername is the name of the BlackBerry Enterprise Server that you want to administer

� networkaddress is the server�s network address

� and flag(s) is one or more of the commands (also called switches) that are described in the table below.

Flag Description

-a Mailbox Domain Name or email address of the user to add to the BlackBerry Enterprise Server

-d Mailbox Domain Name or email address of the user to delete from the BlackBerry Enterprise Server

-c Mailbox Domain Name or email address of the user to verify is existing on the specified BlackBerry Enterprise Server

-s BlackBerry Enterprise Server to administer (required)

-f File name for list of mailbox Domain Names or email addresses to add

-g File name for list of mailbox Domain Names or email addresses to delete

-l List current users on the specified BlackBerry Enterprise Server

-u List detailed user information for users currently on the BlackBerry Enterprise Server

-w Wipe client database(s) when user mailbox Domain Name(s) or email addresses are deleted. Use this flag in conjunction with -d or -g.

-n Network address or computer name of the computer on which the BlackBerry User Administration service is running (required)

-m Information about the Mobile Data Service for the specified user

-me Enable Mobile Data Service for the specified user

-md Disable Mobile Data Service for the specified user

-i Information about the BlackBerry Enterprise Server(s), including server status

-p Request BlackBerry User Administration Client password prompt

-?/-h Display help screen

156 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 161: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Using the BlackBerry User Administration client

Defining an input fileIf you want to add or delete multiple users, you can provide an input file. The input file must contain a separate line for each Domain Name and provide the full mailbox Domain Name.

Reference the file with either the -f or -g flag when you run the BlackBerry User Administration client.

The sample below shows the required input file format:

Input file format

Installation and Getting Started Guide 157

Page 162: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 9: Postinstallation procedures

158 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 163: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10Upgrading, updating, and modifying BlackBerry Enterprise ServerThis section provides information on the following topics:

� Prerequisites for upgrade

� Upgrading overview

� Before upgrading your software

� Upgrading BlackBerry Enterprise Server

� Updating BlackBerry Enterprise Server

� Modifying the BlackBerry Enterprise Server

Page 164: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

Prerequisites for upgrade

The system requirements and preinstallation procedures for an upgrade are identical to a new installation. You must verify that you have all of the system requirements installed and preinstallation procedures completed before upgrading. Refer to "Preinstallation" on page 27 for more information.

Upgrading overviewUsing the BlackBerry Enterprise Server InstallShield Wizard to upgrade, update, or modify your software:

1. Upgrade the BlackBerry Enterprise Server Management database server.

2. Upgrade all other BlackBerry Enterprise Server Management consoles, if you have more than one.

3. Upgrade the Blackberry Enterprise Server(s).

4. Complete the following post-upgrade procedures:

Note: If you are running BlackBerry Enterprise Server version 2.1 or later, you do not need to remove your current software to upgrade your BlackBerry Enterprise Server Software to version .

Warning: If you are upgrading from the Microsoft Exchange 5.5 administration extensions to BlackBerry Enterprise Server Management, you must export your server information from the administration extensions before you install the BlackBerry Enterprise Server version .

Warnings:

� Use of more than one database is an unsupported configuration. You must upgrade the database and all services to the same BlackBerry Enterprise Server Software version in a single time frame. If you do not upgrade all services at the same time, using the upgraded database with services running an older version will cause problems. Refer to "What is the recommended database configuration for BlackBerry Enterprise Server?" on page 237 for more information.

� You should upgrade the BlackBerry Enterprise Server Management database server before upgrading BlackBerry Enterprise Server Management on any other computer and before starting the BlackBerry Enterprise Server service and Mobile Data Service. To accomplish this, upgrade BlackBerry Enterprise Server Management on the database server or use the CreateDB.exe utility on a remote computer (after upgrading, but prior to starting the services). Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information on upgrading the database remotely.

� You must upgrade the BlackBerry Enterprise Server Management database server and all other BlackBerry Enterprise Server Management consoles or the IT policy will fail.

160 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 165: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Before upgrading your software

� Starting the BlackBerry Enterprise Server service. Refer to "Stopping or starting the BlackBerry Enterprise Server services" on page 151 for more information.

� Starting the Mobile Data Service (if you installed it)

You should complete these steps in the order in which they appear in this document. All of the steps are required.

Before upgrading your software1. Log in to the BlackBerry Enterprise Server target computer as the BlackBerry Enterprise Server

service account or site services account (this account should have Local Administrator rights to the BlackBerry Enterprise Server).

2. Using Windows 2000:In the Start menu, select Programs > Administrative Tools > Services. Right-click BlackBerry Server and select Stop to stop the BlackBerry Server service. Right-click BES Alert and select Stop to stop the BESAlert service.

3. Verify that you are logged in to the BlackBerry Enterprise Server computer as the Administrator.

4. If Microsoft Outlook is installed on the BlackBerry Enterprise Server, a warning message appears to indicate that Microsoft Outlook should be removed before you proceed with the BlackBerry Enterprise Server install. Remove Microsoft Outlook.

5. If you have just removed Microsoft Outlook, install your Microsoft Exchange administration tool on the BlackBerry Enterprise Server (or reinstall if it is already present).

6. Manually register the CDO.dll hotfix using one of the following methods:a) At the command prompt (C:/winnt/system32/), typeregsvr32 cdo.dllb) From the Start menu, select Run. In the Run dialog box, in the Open field, type regsvr32 cdo.dll

Warning: Before you install BlackBerry Enterprise Server, temporarily disable any "watchdog" agents (for example, BMC® PATROL®, NetIQ® XMP™, IBM® Tivoli®, HP® OpenView®, or Compaq Insight Manager®) that are currently monitoring the BlackBerry Enterprise Server. Typically, a "watchdog" agent is used to restart services that might stop during normal operation. If you are running a "watchdog" agent, and you do not disable it, it might restart the BlackBerry service without warning during the installation process, causing unpredictable results.

Installation and Getting Started Guide 161

Page 166: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

Upgrading BlackBerry Enterprise Server

Verify that you are logged in on the BlackBerry Enterprise Server target computer as the BlackBerry Enterprise Server service account.

1. Run the provided setup program to start the BlackBerry Enterprise Server installation program.

� If you have Microsoft Outlook installed, a warning dialog box appears.

Warning dialog box—Microsoft Outlook must be removed

OR

If you have Microsoft Outlook XP or later installed, a warning dialog box appears.

Warning dialog box—Microsoft Outlook XP or later must be removed

� Click OK to acknowledge that you are aware that you must remove Microsoft Outlook for the BlackBerry Enterprise Server to function properly after installation. You should remove

Warning: You should upgrade the BlackBerry Enterprise Server Management database server before upgrading BlackBerry Enterprise Server Management on any other computer and before starting the BlackBerry Enterprise Server service and Mobile Data Service. To accomplish this, upgrade BlackBerry Enterprise Server Management on the database server or use the CreateDB.exe utility on a remote computer (after upgrading, but prior to starting the services). Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information on upgrading the database remotely.

Warning: You should not have Microsoft Outlook installed on the computer on which you are installing the BlackBerry Enterprise Server. If Microsoft Outlook is present on the BlackBerry Enterprise Server computer, wireless calendar synchronization does not work because Microsoft Outlook’s versions of CDO.dll and MAPI files do not support wireless calendar synchronization. If Microsoft Outlook is opened on a BlackBerry Enterprise Server, it attempts to overwrite the MAPI system. Therefore, Microsoft Outlook on a BlackBerry Enterprise Server is an unsupported configuration.

162 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 167: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Upgrading BlackBerry Enterprise Server

Microsoft Outlook before proceeding with the BlackBerry Enterprise Server Software installation.

� If you do not have Java Runtime Environment (JRE) 1.4 installed, a warning dialog box appears.

Warning dialog box—JRE 1.4 must be installed for Mobile Data Service

This software is provided on the BlackBerry Enterprise Server CD.

� Click OK. Install JRE 1.4. Refer to "System requirements" on page 28 for more information.

2. The InstallShield Wizard for BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Welcome screen

3. In the Welcome to the InstallShield Wizard for BlackBerry Enterprise Server screen, click Next. The License Information screen appears.

Installation and Getting Started Guide 163

Page 168: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—License Information screen

4. Verify that I accept the terms in the license agreement is selected. Click Next.

The rest of the installation procedure is identical to a new installation. Refer to "Installing BlackBerry Enterprise Server Software (Typical installation)" on page 59 for more information. Complete the procedure on page 59 - page 81. When you are prompted for a Setup Type, select Custom (which should be selected by default).

Updating BlackBerry Enterprise ServerUpdating the existing installation of the BlackBerry Enterprise Server version enables you to repair the installation and replace any missing files.

To update the existing BlackBerry Enterprise Server installation, complete the following procedure:

1. Verify that you are logged in to the BlackBerry Enterprise Server target computer as the BlackBerry Enterprise Server service account. Run the provided setup program to start the BlackBerry Enterprise Server installation program.

Note: You will see a Ready to upgrade BlackBerry Enterprise Server screen at the end of the installation instead of a Ready to install BlackBerry Enterprise Server screen. Click Install to complete the upgrade process.

164 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 169: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

InstallShield Wizard—Welcome screen

2. The Welcome to the InstallShield Wizard for BlackBerry Enterprise Server upgrade program screen appears.

3. Click Next. The Program Maintenance screen appears.

InstallShield Wizard—Program Maintenance screen

4. Select Update or Repair. Click Next. The Customer Information screen appears.

Installation and Getting Started Guide 165

Page 170: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—Customer Information screen

5. If necessary, change the values shown on this screen:

6. Click Next. The License Agreement appears.

Field Action

User Name In this field, type your user name.

Organization In this field, type the name of your company or organization.

Country From this drop-down list, select the country in which you purchased your license for the BlackBerry Enterprise Server Software.

License Key In this field, type your license key to BlackBerry Enterprise Server Software.

166 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 171: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

InstallShield Wizard—License Agreement screen

7. Verify that I accept the terms in the license agreement is selected. Click Next.

Update or review BlackBerry Service(s)The BlackBerry Enterprise Server Software installation enables you to update or review BlackBerry Service #1 at this point in the installation if you selected that option. If you did not choose to update BlackBerry Service #1, proceed to page 172.

1. The Update or Review Settings for BlackBerry Service #1 screen appears.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Installation and Getting Started Guide 167

Page 172: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—Update or review Settings for BlackBerry Service #1 screen

2. Click Next. The BlackBerry Server Communication Information screen appears.

InstallShield Wizard—BlackBerry Server Communication Information screen

3. The BlackBerry Server Communication Information screen displays your current BlackBerry Enterprise Server communication settings. Verify the settings or, if necessary, change the values that default from the earlier BlackBerry Enterprise Server installation.

4. In the SRP Host field, type the SRP Address. This is the Network Access Node that the BlackBerry Enterprise Server uses to connect to the network (for example, srp.na.blackberry.net). Use the SRP Address value provided on your installation CD label, unless you are using a proxy

Note: If you no longer want to update settings for this installation option, click Skip, and then proceed to page 172.

168 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 173: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

firewall, in which case the network access node must be the internal IP of the Proxy, not the SRP Address.

5. In the SRP Port field, type the port number for the network access node defined above. Unless you're using a port mapping firewall, this value should be 3101.

6. Click Test Network Connection to verify that your settings permit connection to the network.

7. If the connection is unsuccessful, click OK. The Communication Information screen appears. Verify the values are correct and retest. If the connection is still unsuccessful, a firewall configuration problem might exist.

8. If the connection is successful, in the confirmation dialog box, click OK.

9. Click Next. The BlackBerry Server MAPI Profile screen appears.

InstallShield Wizard—BlackBerry Server MAPI Profile screen

10. In the Admin MAPI Profile field, type the name of the MAPI profile for the BlackBerry Enterprise Server administration service account, which the BlackBerry Enterprise Server service uses to communicate with the Microsoft Exchange Server. If you type the name of a non-existent MAPI profile, you are prompted to create a new MAPI profile. Click Yes. The Microsoft Exchange Server dialog box appears. You can also select Create/Edit MAPI Profile to open the Microsoft Exchange Server dialog box.

Installation and Getting Started Guide 169

Page 174: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names you specified.

� After both names appear underlined, click OK. The BlackBerry Server MAPI Profile screen appears.

11. Click Next.

Update or review attachment service and connectorsThe BlackBerry Enterprise Server Software installation enables you to update or review the attachment service if you selected that option. If you did not choose to update the attachment service, proceed to page 172.

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

170 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 175: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

1. The Update or Review Settings for Attachment Connectors screen appears.

InstallShield Wizard—Update or Review Settings for Attachment Connectors screen

2. Click Next. The Attachment Service Host screen appears.

InstallShield Wizard—Attachment Service Host screen

3. In the Server Name field, localhost or the local BlackBerry Enterprise Server name appears by default. To point to the attachment service on a remote computer, type the name of the remote computer running the attachment service.

If you are installing/have installed the attachment service on a remote server, click Test Network Connection to verify that the connection to the remote computer is working.

4. Click Next.

Installation and Getting Started Guide 171

Page 176: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

Update or review BlackBerry Enterprise Server ManagementThe BlackBerry Enterprise Server Software installation enables you to update or review BlackBerry Enterprise Server Management at this point in the installation if you selected that option. If you did not choose to update BlackBerry Enterprise Server Management, proceed to page 177

1. The Update or Review Settings for BlackBerry Enterprise Server Management screen appears.

InstallShield Wizard—Update or Review Settings for BlackBerry Enterprise Server Management screen

2. Click Next. The Database Information screen appears.

InstallShield Wizard—Database Information screen

Note: If you no longer want to update settings for this installation option, click Skip, and then proceed to page 177.

172 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 177: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

3. In the Database Information section, if you installed an SQL Server instance, the name of the SQL Server appears by default in the SQL Server Name field. If you do not have an SQL Server, the local computer name appears instead. You can replace the default server name with the name of another server on which you intend to install the database, or with the name of a server on which a database you want to use already resides.

4. In the Database Information section, accept the default Database Name (BESMgmt) or type a new name in the Database Name field.

5. In the Database Authentication section, choose the database authentication type that is predetermined by the database installation (Windows (trusted) for Windows NT Authentication or SQL Authentication).

� If you select SQL Authentication, in the SQL User Name field, accept the default user name (sa) or type a new user name; and, in the Password field, accept the default password (no password) or type a new password. The user name and password are used only to create the SQL database.

� If you select Windows (trusted), the SQL User Name field, and Password field are disabled (unavailable).

6. Click Next. The InstallShield Wizard attempts to detect and verify an SQL Server instance. If nothing is detected, the following warning appears.

Warning dialog box—SQL Server not detected

You have the option of installing MSDE from the Database Path Information screen (refer to page 174). Refer to "Supported database versions" on page 34 for more information. If a dialog box appears that prompts you to start the SQL Server service, click Yes.

Note: If you do not want to install the database on the local computer (that is, if you change the server name to that of another computer on which you want to use a database), you cannot use the BlackBerry Enterprise Server InstallShield Wizard to install the database. You can manually install the database at any time following the BlackBerry Enterprise Server Management installation. Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information.

Note: If you do not know the database authentication type, ask your database administrator.

Installation and Getting Started Guide 173

Page 178: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

7. The BlackBerry Enterprise Server Database Maintenance screen appears.

InstallShield Wizard—BlackBerry Enterprise Server Database Maintenance screen

8. Select one of the following options:

� To create a database for BlackBerry Enterprise Server Management, select Create BlackBerry Enterprise Server Management database

� To update a database you already created, select Update BlackBerry Enterprise Server Management database

9. Click Next. The BlackBerry Database Path Information screen appears.

InstallShield Wizard—Database Path Information screen

Complete the following steps:

174 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 179: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

� Confirm that the root directory of your SQL files location (as it appears in the Database Program Path field) is correct.

� If the correct directory path does not appear by default, click Browse to select the correct path from the Database Program Path dialog box, or type it in the Database Program Path field.

� Confirm that the directory of your SQL data store (as it appears in the Database Data Path field) is correct.

� If the correct directory path does not appear by default, click Browse to select the correct path from the Database Data Path dialog box, or type it in the Database Data Path field.

� If you installed SQL Server and it is detected by the InstallShield Wizard, the Install MSDE option does not appear. If you have not installed MSDE or SQL Server, you can click Install MSDE to run a silent installation at this point. A warning dialog box appears.

Warning dialog box—Installing MSDE

� Click Yes. A dialog box appears that enables you to select the location of MSDE on your local computer.

Dialog box—Browse to select MSDE installation file

� Browse to the location that you want to use. Click OK. The InstallShield Wizard minimizes while MSDE is installed. The installation requires approximately three minutes.

10. Click Next. The BlackBerry Enterprise Server Management MAPI Profile screen appears.

Installation and Getting Started Guide 175

Page 180: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—BlackBerry Enterprise Server Management MAPI Profile screen

11. In the Management MAPI Profile field, type the name of the MAPI profile for the BlackBerry Enterprise Server Management administration service account, which the BlackBerry Enterprise Server Management service uses to communicate with the Microsoft Exchange Server. This name can be the same as or different from the MAPI profile and service account that you use for the BlackBerry Enterprise Server. If you type the name of a non-existent MAPI profile, you are prompted to create a new MAPI profile. Click Yes. The Microsoft Exchange Server dialog box appears. You can also select Create/Edit MAPI Profile to open the Microsoft Exchange Server dialog box.

Microsoft Exchange Server dialog box

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

176 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 181: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names that you specified.

12. After both names appear underlined, click OK. The BlackBerry Enterprise Server Management MAPI Profile screen appears. Click Next.

Update or review BlackBerry User AdministrationThe BlackBerry Enterprise Server Software installation enables you to update or review BlackBerry User Administration if you selected that option. If you did not choose to update BlackBerry User Administration, proceed to page 172.

1. If you chose to update BlackBerry User Administration, the Update or Review Settings for BlackBerry User Administration screen appears.

InstallShield Wizard—Update or Review Settings for BlackBerry User Administration screen

2. Click Next. The Secure Password screen appears.

Note: If you no longer want to update settings for this installation option, click Skip, and then proceed to page 180.

Installation and Getting Started Guide 177

Page 182: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—Secure Password screen

3. Type the password used to secure the BlackBerry User Administration client connection.

4. Click Next. The BlackBerry Server List screen appears.

InstallShield Wizard—BlackBerry Server List screen

5. Review your Server:MAPI Profile settings. To create a MAPI profile for each BlackBerry administration mailbox that is associated with a BlackBerry Enterprise Server, type the BlackBerry Enterprise Server name in the BlackBerry Server Name field, and then type the

178 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 183: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

BlackBerry Enterprise Server Administration MAPI profile name in the Admin MAPI Profile field.

To add an existing MAPI profile, click Add to add the server and MAPI profile combination to the Server List. This adds the server name and its MAPI profile to the RemoteAdmin.txt file that is found in the BlackBerry User Administration folder after it is installed. The BlackBerry User Administration service reads this file when it starts. The file name and location are defined through a registry key.

If the MAPI profile does not yet exist or requires editing, click Create/Edit Profile. The Microsoft Exchange Server dialog box appears.

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox.

Note: You can administer multiple MAPI profiles that have the same name on different servers, but you cannot add a server name more than once. If you try to add the same server more than once, a Duplicate BES Server entered warning message appears.

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

Installation and Getting Started Guide 179

Page 184: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

� Click Check Name to confirm both the server and mailbox names that you specified. Both names appear underlined after they are confirmed.

� Click OK. The BlackBerry Server List window appears.

6. You can continue to add servers and their MAPI profiles to the Server List. After you are finished, click Next.

Update or review Mobile Data ServiceThe BlackBerry Enterprise Server Software installation enables you to update or review Mobile Data Service at this point in the installation if you selected that option. If you did not choose to update Mobile Data Service, proceed to page 177.

1. If you chose to update Mobile Data Service, the Update or Review Settings for Mobile Data Service screen appears.

InstallShield Wizard—Update or Review Settings for Mobile Data Service screen

Note: If you do not want to add any or all Server:MAPI Profile combinations at this time, you can add Server:MAPI Profile combinations manually to RemoteAdmin.txt after you run the installer. In RemoteAdmin.txt, the server name and the MAPI profile name are separated by a tab. Any extra spacing (other than a single tab) renders the Server:MAPI Profile combination unreadable.

You can also run the installer again at any time to add Server:MAPI Profile combinations to RemoteAdmin.txt.

Note: If you click Next without adding a pending Server:MAPI Profile combination to the Server List, a Question dialog box prompts you to decide whether or not you want to add “Server:MAPI Profile” to the list. Click Yes or No.

Note: If you no longer want to update settings for this installation option, click Skip, and then proceed to page 184.

180 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 185: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

2. Click Next. The Mobile Data Service Push Server Settings screen appears.

InstallShield Wizard—Mobile Data Service Push Server Settings screen

3. The BlackBerry Enterprise Server Management MAPI profile appears by default in the MAPI Profile field. Mobile Data Service should use the BlackBerry Enterprise Server Management database settings.

4. In the Database Consistency Polling Frequency field, the default value of 24 (hours) appears. This frequency is the rate at which the BlackBerry Enterprise Server Management database is checked against the data in users� mailboxes.

5. Click Next.

� If you have BlackBerry Enterprise Server Management installed, proceed to �Completing the update� on page 184.

� If you do not have BlackBerry Enterprise Server Management installed, the Database Information screen appears.

Installation and Getting Started Guide 181

Page 186: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—BlackBerry Server Management Database Information (Configuring Mobile Data Service)

6. In the Database Information section, the name of the local server appears by default in the Server Name field. You can replace the default server name with the name of another server on which you intend to install the database, or with the name of a server on which a database that you want to use already resides.

7. Accept the default Database Name (BESMgmt) or, in the Database Name field, type a new name.

8. In the Database Authentication section, choose the database authentication type predetermined by the database installation (Windows (trusted) for Windows NT Authentication or SQL Authentication).

� If you select SQL Authentication: in the SQL User Name field, accept the default user name (sa) or type a new user name; and, in the Password field, accept the default password (no password) or type a new password. The user name and password are used only to create the SQL database.

� If you select Windows (trusted): the SQL User Name field, and Password field are disabled (unavailable).

9. Click Next. The Log Folder screen appears. This screen enables you to set a single log file location.

Note: If you do not want to install the database on the local computer (that is, if you change the server name to that of another computer on which you want to use a database), you cannot use the BlackBerry Enterprise Server Management InstallShield Wizard to install the database. You can manually install the database at any time following the BlackBerry Enterprise Server Management install. Refer to "Creating a database after the BlackBerry Enterprise Server Management installation (optional)" on page 127 for more information.

Note: If you do not know the database authentication type, ask your database administrator.

182 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 187: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Updating BlackBerry Enterprise Server

InstallShield Wizard—Log Folder screen

10. To accept the default log folder path, click Next.

Or

If you wish to change the default path to which all log files are to be saved, click Browse.

The Change Current Destination Folder dialog appears.

InstallShield Wizard—Change Current Destination Folder screen

� Click the Look in drop-down list and browse to the new location, or type a directory path in the Folder name field.

Warning: You cannot configure the log files to save with a different file-name format. You can change the location to which the log files are saved (on the BlackBerry Enterprise Server Software installer Log Folder screen, during an upgrade or installation).

Installation and Getting Started Guide 183

Page 188: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

� Click OK. The Log folder screen appears.

� To accept the new log folder path, click Next.

The rest of the update and review process is the same, regardless of the options that you are updating.

Completing the update1. The Windows NT Login Information screen appears.

InstallShield Wizard—Windows NT Login Information screen

2. In the Account field, the name of the Windows NT account that you are currently using appears in the Account field. In the Password field, type the password for this account.

3. Click Next. The Ready to update BlackBerry Enterprise Server screen appears.

184 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 189: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Modifying the BlackBerry Enterprise Server

InstallShield Wizard—Ready to update BlackBerry Enterprise Server screen

4. Review the contents of this screen, which lists the updates that you chose to make. Click Install to begin updating BlackBerry Enterprise Server.

Modifying the BlackBerry Enterprise ServerModifying the existing installation of the BlackBerry Enterprise Server version enables you to remove from or add to the list of installed components.

To modify the existing BlackBerry Enterprise Server installation, complete the following procedure:

1. Verify that you are logged in to the BlackBerry Enterprise Server target computer as the BlackBerry Enterprise Server service account. Run the provided setup program to start the BlackBerry Enterprise Server installation program. Welcome to the InstallShield Wizard for BlackBerry Enterprise Server upgrade program screen.

Installation and Getting Started Guide 185

Page 190: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance screen appears.

InstallShield Wizard—Program Maintenance screen

3. Select Modify. Click Next. The Customer Information screen appears.

186 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 191: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Modifying the BlackBerry Enterprise Server

InstallShield Wizard—Customer Information screen

4. If necessary, change the values shown on this screen:

5. Click Next. The License Agreement screen appears.

Field Action

User Name In this field, type your user name.

Organization In this field, type the name of your company or organization.

Country From this drop-down list, select the country in which you purchased your license for the BlackBerry Enterprise Server Software.

License Key In this field, type your license key to BlackBerry Enterprise Server Software.

Installation and Getting Started Guide 187

Page 192: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

InstallShield Wizard—License Agreement screen

6. Verify that I accept the terms in the license agreement is selected. Click Next. The Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

7. Items that will be installed by default are marked with a icon. Items that are not to be installed are marked with a icon.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Tip: Click Help to view a Custom Setup Tips screen with further tips about these icons.

188 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 193: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Modifying the BlackBerry Enterprise Server

Install options—Drop-down list

8. Click an item. A drop-down list appears.

9. Select one of the following options:

� This feature will be installed on local hard drive

� This feature, and all sub-features, will be installed on local hard drive

� This feature will not be available

10. Click Next. The Ready to Modify screen appears.

Install options—Ready to Modify screen

11. Review the settings. Click Install.

Installation and Getting Started Guide 189

Page 194: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 10: Upgrading, updating, and modifying BlackBerry Enterprise Server

190 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 195: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11Removing softwareThis section provides information on the following topics:

� Removing BlackBerry Enterprise Server administration extensions

� Removing BlackBerry Enterprise Server Software

� Removing the attachment service

� Removing the attachment connector only

� Removing BlackBerry Enterprise Server Management software

� Removing BlackBerry User Administration Software

� Removing Mobile Data Service

� Removing BlackBerry Server utilities

Page 196: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

Removing BlackBerry Enterprise Server administration extensionsIf you previously used Microsoft Exchange 5.5 administration extensions to manage BlackBerry Enterprise Server, you should remove the BlackBerry Enterprise Server administration extensions. You must remove the extensions AFTER you upgrade to BlackBerry Enterprise Server version .

Verify that you have exported all server information from the administration extensions and installed the BlackBerry Enterprise Server version before you remove the administration extensions.

1. Log in using an account with administrative privileges (typically, BESAdmin) on the local computer.

2. On the Start menu, select BlackBerry Enterprise Server > Uninstall Administration Extensions.

Note: Completing this procedure removes the BlackBerry Enterprise Server from the Configuration container of the Microsoft Exchange 5.5 administration software.

Note: You must enter the name of the Microsoft Exchange Server from which you want to remove the administration extensions.

192 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 197: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry Enterprise Server Software

Removing BlackBerry Enterprise Server Software

To remove ALL BlackBerry Enterprise Server Software, including any other tools, utilities, services, or documentation that is installed with the BlackBerry Enterprise Server, complete the following steps:

1. Run the provided setup program to start the BlackBerry Enterprise Server installation program. The Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance window appears.

Note: This procedure does not remove the BlackBerry Enterprise Server administration extensions from Microsoft Exchange. If you want to remove the administration extensions, you must remove the extensions BEFORE you remove the BlackBerry Enterprise Server Software.

Installation and Getting Started Guide 193

Page 198: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

InstallShield Wizard—Program Maintenance screen

3. Select the Remove option. Click Next. The Remove the Program screen appears.

InstallShield Wizard—Remove the Program screen

4. Click Remove. A dialog box appears that prompts you to choose whether or not you want to remove all data associated with each service that you are removing.

Warning: After you click Remove, ALL installed BlackBerry Enterprise Server and related software, utilities, services, and documentation are removed.

194 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 199: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry Enterprise Server Software

Dialog box—Remove data that is associated with a service

5. Click Yes to remove all data that is associated with the service, or click No to leave data on the local computer.

After the removal process is complete, the InstallShield Wizard Completed screen appears.

InstallShield Wizard—InstallShield Wizard Completed screen

6. Click Finish. The InstallShield Wizard closes.

Installation and Getting Started Guide 195

Page 200: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

Removing the attachment service and attachment connector1. Run the provided setup program to start the BlackBerry Enterprise Server installation program.

The Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance window appears.

InstallShield Wizard—Program Maintenance screen

3. Select the Modify option. Click Next. The Customer Information screen appears.

196 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 201: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing the attachment service and attachment connector

InstallShield Wizard—Customer Information screen

4. Verify your customer information. Click Next. The License Agreement screen appears.

InstallShield Wizard—License Agreement screen

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Installation and Getting Started Guide 197

Page 202: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

5. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

6. Select Attachment Service. Click This feature will not be available.

7. If you also want to remove the Attachment Connector(s) from the BlackBerry Enterprise Server instance(s), select Attachment Connector #X. Click This feature will not be available.

8. Click Next. The Ready to modify BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Ready to modify BlackBerry Enterprise Server screen

198 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 203: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing the attachment service and attachment connector

9. Review the changes that you are about to make. Click Install. The InstallShield Wizard removes the software.

After the InstallShield Wizard completes the removal process, the InstallShield Wizard Completed screen appears.

InstallShield Wizard—InstallShield Wizard Completed screen

10. Click Finish. The InstallShield Wizard closes.

Installation and Getting Started Guide 199

Page 204: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

Removing the attachment connector only

1. Run the provided setup program to start the BlackBerry Enterprise Server installation program. The Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance window appears.

InstallShield Wizard—Program Maintenance screen

3. Select the Modify option. Click Next. The Customer Information screen appears.

Warning: Removing the attachment connector from the BlackBerry Enterprise Server disables use of the attachment service on that BlackBerry Enterprise Server.

200 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 205: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing the attachment connector only

InstallShield Wizard—Customer Information screen

4. Verify your customer information. Click Next. The License Agreement screen appears.

InstallShield Wizard—License Agreement screen

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Installation and Getting Started Guide 201

Page 206: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

5. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

6. Select Attachment Connector #X. Click This feature will not be available.

7. Click Next. The Ready to modify BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Ready to modify BlackBerry Enterprise Server screen

202 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 207: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing the attachment connector only

8. Review the changes that you are about to make. Click Install. The InstallShield Wizard removes the software.

After the InstallShield Wizard completes the removal process, the InstallShield Wizard Completed screen appears.

InstallShield Wizard—InstallShield Wizard Completed screen

9. Click Finish. The InstallShield Wizard closes.

Installation and Getting Started Guide 203

Page 208: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

Removing BlackBerry Enterprise Server Management software

1. Run the provided setup program to start the BlackBerry Enterprise Server installation program. The Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance window appears.

InstallShield Wizard—Program Maintenance screen

3. Select the Modify option. Click Next. The Customer Information screen appears.

Note: Removing BlackBerry Enterprise Server Management does not automatically remove MSDE or the BlackBerry Enterprise Server Management database. They must be removed individually.

204 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 209: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry Enterprise Server Management software

InstallShield Wizard—Customer Information screen

4. Verify your customer information. Click Next. The License Agreement screen appears.

InstallShield Wizard—License Agreement screen

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Installation and Getting Started Guide 205

Page 210: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

5. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

6. Select BlackBerry Enterprise Server Management. Click This feature will not be available.

Custom Setup screen—Installation options

206 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 211: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry Enterprise Server Management software

7. Click Next.

If you have BlackBerry User Administration installed, a dialog box appears.

Dialog box—Removing BlackBerry Enterprise Server Management

Click No to remove BlackBerry Enterprise Server Management. BlackBerry User Administration is also removed. Another dialog box appears to confirm the removal.

Warning dialog box—Removing BlackBerry User Administration

Click OK.

8. The Ready to modify BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Ready to modify BlackBerry Enterprise Server screen

Installation and Getting Started Guide 207

Page 212: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

9. Review the changes that you are about to make. Click Install. The InstallShield Wizard removes the software.

After the InstallShield Wizard completes the removal process, the InstallShield Wizard Completed screen appears.

InstallShield Wizard—InstallShield Wizard Completed screen

10. Click Finish. The InstallShield Wizard closes.

208 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 213: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry User Administration Software

Removing BlackBerry User Administration Software1. Run the setup program to start the BlackBerry Enterprise Server installation program. The

Welcome Screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance screen appears.

InstallShield Wizard—Program Maintenance screen

Installation and Getting Started Guide 209

Page 214: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

3. Select the Modify option. Click Next. The Customer Information screen appears.

InstallShield Wizard—Customer Information screen

4. Verify your customer information. Click Next. The License Agreement window appears.

InstallShield Wizard—License Agreement screen

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

210 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 215: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry User Administration Software

5. Verify that the I accept the terms in the license agreement option is selected. Failure to accept the agreement stops the installation. Click Next. The Custom Setup screen appears.

InstallShield Wizard—Custom Setup screen

6. Select BlackBerry User Administration. Click This feature will not be available.

Custom Setup screen—Installation options

Installation and Getting Started Guide 211

Page 216: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

7. Click Next. The Ready to modify BlackBerry Enterprise Server screen appears.

InstallShield Wizard—Ready to modify BlackBerry Enterprise Server screen

8. Review the changes that you are about to make. Click Install. The InstallShield Wizard removes the software.

9. After the InstallShield Wizard completes the removal process, the InstallShield Wizard Completed screen appears.

InstallShield Wizard—InstallShield Wizard Completed screen

10. Click Finish. The InstallShield Wizard closes.

212 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 217: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing Mobile Data Service

Removing Mobile Data Service1. Run the setup program to start the BlackBerry Enterprise Server installation program. The

Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance screen appears.

InstallShield Wizard—Program Maintenance screen

Installation and Getting Started Guide 213

Page 218: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

3. Select the Modify option. Click Next. The Customer Information screen appears.

InstallShield Wizard—Customer Information screen

4. Verify your customer information. Click Next. The License Agreement screen appears.

InstallShield Wizard—License Agreement screen

5. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Custom Setup screen appears.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

214 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 219: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing Mobile Data Service

InstallShield Wizard—Custom Setup screen

6. Select MDS Service #1. From the drop-down list, click This feature will not be available.

Custom Setup screen—Installation options

7. Click Next. The Ready to modify BlackBerry Enterprise Server screen appears.

Installation and Getting Started Guide 215

Page 220: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

InstallShield Wizard—Ready to modify BlackBerry Enterprise Server screen

8. Review the changes that you are about to make. Click Install.

A dialog box appears that prompts you to choose whether or not you want to remove data that is associated with the Mobile Data Service (MDS Service #1).

Warning dialog box—Remove data that is associated with the service

9. Click Yes to remove all data that is associated with the service, or click No to keep data on the local computer.

After the InstallShield Wizard completes the removal process, the InstallShield Wizard Completed screen appears.

216 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 221: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing Mobile Data Service

InstallShield Wizard—InstallShield Wizard Completed screen

10. Click Finish. The InstallShield Wizard closes.

Installation and Getting Started Guide 217

Page 222: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

Removing BlackBerry Server utilities1. Run the provided setup program to start the BlackBerry Enterprise Server installation program.

The Welcome screen appears.

InstallShield Wizard—Welcome screen

2. Click Next. The Program Maintenance screen appears.

InstallShield Wizard—Program Maintenance screen

3. Select the Modify option. Click Next.

The Customer Information window appears.

218 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 223: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry Server utilities

InstallShield Wizard—Customer Information screen

4. Verify your customer information. Click Next. The License Agreement screen appears.

InstallShield Wizard—License Agreement screen

5. Verify that the I accept the terms in the license agreement option is selected. Click Next. The Custom Setup screen appears.

Note: Read the license agreement carefully. Proceeding with the installation indicates that you agree with the conditions of the license agreement. Failure to accept the agreement results in the termination of the installation program.

Installation and Getting Started Guide 219

Page 224: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

InstallShield Wizard—Custom Setup screen

6. Select BlackBerry Server Utilities. From the drop-down list, click This feature will not be available.

Custom Setup screen—Installation options

7. Click Next. The Ready to modify BlackBerry Enterprise Server screen appears.

Note: All the BlackBerry Server Utilities are removed simultaneously. You cannot remove them separately.

220 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 225: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Removing BlackBerry Server utilities

InstallShield Wizard—Ready to modify BlackBerry Enterprise Server screen

8. Review the changes that you are about to make. Click Install. The InstallShield Wizard removes the software.

After the InstallShield Wizard completes the removal process, the InstallShield Wizard Completed screen appears.

InstallShield Wizard—InstallShield Wizard Completed screen

9. Click Finish. The InstallShield Wizard closes.

Installation and Getting Started Guide 221

Page 226: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 11: Removing software

222 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 227: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 12Error messagesThis section provides information on the following topics:

� 5301 Startup error

� 5302 Windows error

� 5401 Windows error

� 5407 error

� No Service Name Error (5403 or 5404)

� BlackBerry User Administration service error codes

� Attachment service errors

� Mobile Data Service debug logs: Insufficient database permissions

� MAPI error codes

Page 228: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 12: Error messages

Error numbers that begin with 53 are associated with MAPI problems. Error numbers that begin with 54 are associated with administration configuration problems.

5301 Startup errorSymptoms

When you try to start the BlackBerry Enterprise Server, a 5301 Windows error occurs.

What is the problem?

This error occurs in a Microsoft Exchange 5.5 environment under the following circumstances. Microsoft Outlook was removed from the BlackBerry Enterprise Server computer after Microsoft Exchange 5.5 (Service Pack 4) was installed. The removal of Microsoft Outlook interfered with the MAPI version that is required by the BlackBerry Enterprise Server.

Solution

Reinstall Microsoft Exchange 5.5 (Service Pack 4).

5302 Windows error

SymptomsWhen you try to start the BlackBerry Enterprise Server, a 5302 Windows error occurs.

What is the problem?Several problems might cause this error:

Problem 1

The MAPI profile that is specified is incorrect.

224 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 229: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

5401 Windows error

Solution 1

Check the MAPI profile that is specified for the BlackBerry Enterprise Server and verify that it is linked to a Windows NT account with Service Account Admin permissions. Also verify that the profile only contains the following services: Microsoft Exchange Server, Outlook Address Book, and Personal Address Book. Remove any other services, such as Internet Mail.

Problem 2

The account that was used to start the BlackBerry Enterprise Server is incorrect.

Solution 2

1. From the Start menu, select Settings > Control Panel. The Control Panel window appears.

2. Double-click the Services icon. The Services window appears.

3. Click Startup and verify that the Log On As section has the correct account selected for the BlackBerry Enterprise Server service.

This account should be the same one that was used to install the BlackBerry Enterprise Server files.

5401 Windows error

SymptomsWhen you try to start the BlackBerry Enterprise Server service, a 5401 Windows error occurs.

What is the problem?Several problems might cause this error:

Problem 1

You have not added the BlackBerry Enterprise Server to the BlackBerry Enterprise Server Management console.

Solution 1

Complete the procedure below.

Installation and Getting Started Guide 225

Page 230: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 12: Error messages

1. Right-click BlackBerry Server Management and select New BlackBerry Server.

2. In the BlackBerry Servers System Info window, define the following system information:

� In the Server Name field, type the same server name that you used during the installation.

� In the SRP Identifier and SRP Authentication Key fields, type the appropriate information that is provided with the installation CD.

� In the Administration Mailbox field, click Select Mailbox to locate the mailbox that you set up for BlackBerry Enterprise Server administration.

3. After you complete all of the fields, click OK.

Problem 2

The BlackBerry Enterprise Server that you added is not the same as the one that you specified in the BlackBerry Enterprise Server installation.

Solution 2

In Microsoft Exchange 5.5 Administrator or Microsoft Exchange 2000/2003 System Manager, remove the server and then re-add the server.

Problem 3

The administration mailbox that you selected (in the Administration Mailbox field) when you added the BlackBerry Enterprise Server is incorrect.

Solution 3

Complete the procedure below.

1. Right-click a server and click Remove Server to remove the current BlackBerry Enterprise Server.

2. Click Add Server. Type or select the correct Administration Mailbox name from the list (the mailbox that is linked to the Windows NT account that you used to install the BlackBerry Enterprise Server).

5407 errorSymptom

226 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 231: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

No Service Name Error (5403 or 5404)

Error 5407 appears when you start a BlackBerry Enterprise Server from the services pane. The error is logged as error 5407 "Unable to start BlackBerry Server! Cannot use production SRP ID with Evalutaion BlackBerry Server".

SolutionError 5407 appears because you are trying to start an evaluation version of the BlackBerry Enterprise Server using a fully licensed production SRP Identifier. On the server Properties window, replace the SRP Identifier with the temporary SRP Identifier you received with the evaluation version CD. The temporary SRP Identifier starts with a T.

No Service Name Error (5403 or 5404)Symptoms

When you try to proceed with the BlackBerry Enterprise Server installation, a 5403 or 5404 Windows error occurs.

What is the problem?

This error indicates that you typed an incorrect server name. The Microsoft Exchange Server name is often mistakenly typed instead of the BlackBerry Enterprise Server name.

Solution

Open the BlackBerry Server System Info window and verify that the correct BlackBerry Enterprise Server name appears in the Server Name field.

BlackBerry User Administration service error codesThe following table describes the error codes that are associated with the BlackBerry User Administration service.

Flag Description

1 The action was successfully completed.

2 The service is busy adding the defined users. Multiple users might be accessing the service.

3 The service is busy deleting the defined users. Multiple users might be accessing the service.

Installation and Getting Started Guide 227

Page 232: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 12: Error messages

4 The service is busy initializing.

5 No profile is available for the server.

6 The service is unable to retrieve the server’s Domain Name. Verify that it was properly defined in the MAPI profile text file or on the command line.

7 The MAPI logon failed. Verify the profile and server mailbox were correctly defined in the MAPI profile text file.

8 The service was unable to retrieve the message store table. This is a MAPI-related error. Verify that the service has the necessary permissions and that there are no network problems.

9 The service was unable to query all rows in the message store table. This is a MAPI-related error. Verify that the service has the necessary permissions and that there are no network problems.

10 The service was unable to open the message store table. This is a MAPI-related error. Verify that the service has the necessary permissions and that there are no network problems.

11 The service was unable to locate the default message store table. This is a MAPI-related error. Verify that the service has the necessary permissions and that there are no network problems.

12 The service was unable to communicate with the query interface. This is a MAPI-related error. Verify that the service has the necessary permissions and that there are no network problems.

13 Database creation failed. This is a MAPI-related error, which could be associated with one of the following problems:

� the service does not have the necessary permissions

� there are network problems

� the wrong mailbox is associated with the service

� the server might not have been added to the extensions

14 The service was unable to open the server database. Verify that the correct server name is defined in the MAPI profile text file. This is a MAPI-related error. Verify that the service has the necessary permissions and that there are no network problems.

15 The service was unable to open the Global Address Book.

16 The MAPI allocate buffer failed.

17 The service was unable to open Server Manager. Verify that the BlackBerry Enterprise Server extensions are installed on the server.

18 The MAPI initialization failed. Verify that the service has the necessary permissions and that there are no network problems.

19 The service was unable to get user information. Verify that the user was correctly defined in the input file or at the command line.

20 The user exists on the server. With the -c flag, this flag confirms that the user is on the specified server. With the -a or -f flag, this flag confirms that the user was already added.

Flag Description

228 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 233: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

BlackBerry User Administration service error codes

21 The user does not exist on the server. With the -c flag, this flag confirms that the user is not on the specified server. With the -d or -g flag, this flag confirms that the user was already deleted or never existed on the server.

22 The service was unable to retrieve the user list. Verify that you defined the correct server name.

23 The user that you are adding already exists on another server.

24 The service is busy listing users. Multiple users might be accessing the service.

25 The server does not exist. Verify the profile and server mailbox were correctly defined in the MAPI profile text file.

26 No session ID found.

27 The service is busy checking users.

28 The license count is exceeded.

29 Initialization of Active Directory Service failed (ADSI is required on the computer. Refer to “Preinstallation requirements” in the BlackBerry Enterprise Server for Microsoft Exchange 5.5 Installation and Getting Started Guide and the BlackBerry Enterprise Server for Microsoft Exchange 2000/2003 Installation and Getting Started Guide).

30 This is an ambiguous mailbox name.

31 The BlackBerry Enterprise Server Management database is not found.

32 The license key is not found in database.

33 The user license count is exceeded (warning).

34 The Mobile Data Service license count is exceeded (warning).

35 The user and Mobile Data Service license counts are exceeded (warning).

Flag Description

Installation and Getting Started Guide 229

Page 234: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 12: Error messages

Attachment service errorsThe following error messages appear in the BlackBerry Enterprise Server log when the attachment service fails to retrieve attachments.

Error Error number

Loglevel

Description

Unknown Error 1 warning The attachment service encountered an unknown error and is not working.Remedy: Verify that the attachment service is installed and that the service is started.

Error file not found

2 warning The attachment service cannot locate the attachment with the specified name.

Error unknown file format

3 warning The attachment service does not support the attachment type or document version.

Error password protected file not handled

4 warning The attachment is password-protected, and the attachment service does not support password protection for the attachment format. Currently password protection is supported for .pdf files only.

Error password protected file

5 warning The document is password protected, and the attachment service cannot convert the document unless the password is supplied.Remedy: The user must provide the correct password.

Error invalid password

6 warning The password that the user provided for the attachment is incorrect. Remedy: The user should retype the password and resubmit the file to view it.

Error invalid file 7 warning The file format is supported by the attachment service, but the data is corrupt or invalid.

Error conversion fail

8 warning The attachment service encountered a problem during file conversion, which could be due to invalid data. Remedy: Open the document in the original application to verify that the file is valid.

Error invalid filename

9 warning The submitted file has an invalid filename, which includes either '`' or '&', that will not be accepted by the Microsoft XML parser will not accept. The attachment will not be parsed.Remedy: Rename the attachment to exclude the “`” or “&” characters, so that the attachment service can convert the file.

230 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 235: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Mobile Data Service debug logs: Insufficient database permissions

Mobile Data Service debug logs: Insufficient database permissionsIf you log onto a service account without the required permissions on the database and attempt to start the Mobile Data Service, the following errors are visible in the Mobile Data Service debug logs.

<2003-01-23 08:41:44 EST>:[102]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to java.sql.SQLException: [Microsoft][ODBC SQL Server Driver][Shared Memory]ConnectionWrite (WrapperWrite()).>

<2003-01-23 08:43:43 EST>:[103]:<CWARREN-W2K>:<WARNING>:<Caught exception while saving statistics:[Microsoft][ODBC SQL Server Driver][Shared Memory]SQL Server does not exist or access denied.>

<2003-01-23 08:44:17 EST>:[104]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to java.sql.SQLException: [Microsoft][ODBC SQL Server Driver][Shared Memory]SQL Server does not exist or access denied.>

<2003-01-23 08:59:44 EST>:[117]:<CWARREN-W2K>:<Debug>:<LAYER = SRP, LAYER = SRP, EVENT = Stopped>

<2003-01-23 09:00:36 EST>:[1]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to net.rim.shared.management.ManagementException: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open database requested in login 'BESMgmt'. Login fails.>

Error summary failed

10 warning The attachment service is unable to create a Table of Contents for the attachment. The document might be small or might not contain any information upon which to create a summary.Remedy: View the attachment’s full content.

Error server not present

11 warning The attachment service is not running or is not correctly configured.Remedy: Verify that the attachment service is properly installed and that the service is running.

Error instantiation failed

255 error The attachment service cannot create the doc submit COM component instance.Remedy: At the command prompt, run REGSVR32 on all COM Modules to make sure that the components are registered.

Error Error number

Loglevel

Description

Installation and Getting Started Guide 231

Page 236: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 12: Error messages

<2003-01-23 09:00:42 EST>:[2]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to net.rim.shared.management.ManagementException: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open database requested in login 'BESMgmt'. Login fails.>

<2003-01-23 09:00:54 EST>:[3]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to net.rim.shared.management.ManagementException: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open database requested in login 'BESMgmt'. Login fails.>

<2003-01-23 09:01:08 EST>:[4]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to net.rim.shared.management.ManagementException: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open database requested in login 'BESMgmt'. Login fails.>

<2003-01-23 09:01:23 EST>:[5]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to net.rim.shared.management.ManagementException: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open database requested in login 'BESMgmt'. Login fails.>

<2003-01-23 09:01:37 EST>:[6]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to net.rim.shared.management.ManagementException: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open database requested in login 'BESMgmt'. Login fails.>

<2003-01-23 09:01:47 EST>:[7]:<CWARREN-W2K>:<WARNING>:<LAYER = MDS, Cannot retrieve config data from database. Using cached values>

<2003-01-23 09:01:47 EST>:[8]:<CWARREN-W2K>:<Debug>:<LAYER = SCM, EVENT = Connected, TOPSERVICE = IPPP, LOWERSERVICE = GME>

<2003-01-23 09:01:47 EST>:[9]:<CWARREN-W2K>:<Debug>:<LAYER = SCM, EVENT = Connected, TOPSERVICE = GME, LOWERSERVICE = SRP>

<2003-01-23 09:01:48 EST>:[10]:<CWARREN-W2K>:<EVENT>:<MDS has started>

<2003-01-23 09:01:48 EST>:[11]:<CWARREN-W2K>:<Debug>:<LAYER = IPPP, LAYER = IPPP, EVENT = Initialization>

<2003-01-23 09:01:49 EST>:[12]:<CWARREN-W2K>:<Debug>:<LAYER = IPPP, LAYER = IPPP, EVENT = Started>

<2003-01-23 09:01:49 EST>:[13]:<CWARREN-W2K>:<Debug>:<LAYER = SRP, LAYER = SRP, EVENT = Initialization>

<2003-01-23 09:01:49 EST>:[14]:<CWARREN-W2K>:<Debug>:<LAYER = SRP, LAYER = SRP, EVENT = Started>

<2003-01-23 09:01:49 EST>:[15]:<CWARREN-W2K>:<Debug>:<LAYER = IPPP, EVENT = Started, THREAD = QueuesManager>

<2003-01-23 09:01:49 EST>:[16]:<CWARREN-W2K>:<Debug>:<LAYER = IPPP, EVENT = Started, THREAD = ListenOnDatagramStatus>

232 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 237: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

MAPI error codes

<2003-01-23 09:01:49 EST>:[17]:<CWARREN-W2K>:<Debug>:<LAYER = IPPP, EVENT = Started, THREAD = ListenForServersPackets>

<2003-01-23 09:01:49 EST>:[18]:<CWARREN-W2K>:<Debug>:<LAYER = IPPP, EVENT = Started, THREAD = ListenForClientsPackets>

<2003-01-23 09:01:49 EST>:[19]:<CWARREN-W2K>:<Debug>:<LAYER = IPPP, EVENT = Started, THREAD = ConnectionsInputStreamesReader>

<2003-01-23 09:02:20 EST>:[20]:<CWARREN-W2K>:<Debug>:<LAYER = SRP, Trying to connect to 127.0.0.1:3200>

<2003-01-23 09:02:42 EST>:[21]:<CWARREN-W2K>:<WARNING>:<Error retrieving config data from database due to net.rim.shared.management.ManagementException: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot open database requested in login 'BESMgmt'. Login fails.>

<2003-01-23 09:02:51 EST>:[22]:<CWARREN-W2K>:<Debug>:<LAYER = SRP, Trying to connect to 127.0.0.1:3200>

MAPI error codesThe following MAPI error codes might appear during installation.

Error code Description

MAPIInitialize (80040005)

The MAPI is not present. This dialog might indicate that sufficient system requirements to create a MAPI profile are not detected because the MAPI subsystem has not been initialized. Verify that you have all system requirements installed, including one of the following:

� Microsoft Exchange 2000 System Manager,

� Microsoft Exchange 2003 System Manager,

� Microsoft Exchange 5.5 Administrator,

� Microsoft Outlook 2000 (Corporate or Workgroup)

� or Microsoft Outlook 2003

and that you have opened whichever one of these three tools you have installed at least once.

CreateProfile (80070005)

This error indicates one of the following:

� The user does not have write access to create a MAPI profile in the registry

� The profile exists, but it is not mapped correctly to the registry key name due because it contains special characters

Installation and Getting Started Guide 233

Page 238: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 12: Error messages

234 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 239: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13Frequently asked questionsThis section provides information on the following topics:

� Why can I not generate a license key?

� What is the recommended database configuration for BlackBerry Enterprise Server?

� I upgraded from BlackBerry Enterprise Server version 2.1 for Microsoft Exchange. Why can�t I remove the Microsoft Exchange 5.5 administration extensions?

� I have installed the attachment service on the server. Why do attachments not appear on the user�s BlackBerry handheld?

� How can I disable the attachment service after I have installed it?

� Why do I get a '500' connection timeout error when I try to view web pages on my BlackBerry Browser?

� Why am I prompted to choose a profile when I start BlackBerry Enterprise Server Management?

� Wireless email reconciliation is enabled, but users are not seeing immediate synchronization of changes between the handheld and the desktop. Why not?

� How do I troubleshoot Mobile Data Service problems?

� Why do using filters, using encryption keys, and replying to messages often fail?

� Why has this laptop user's handheld not received messages since the laptop was last connected to the LAN?

� Why are some messages not forwarded to the user�s handheld?

� Why do users� handhelds stay at Initializing after they are added or deleted?

� What happens to the users when you delete a BlackBerry Enterprise Server?

Page 240: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13: Frequently asked questions

� Why is the server status Disabled?

� Why is the server status SRP Connection Down?

� Why is wireless calendar synchronization not working?

� How do I change the attachment service default port settings?

� How do I obtain additional support?

236 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 241: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Why can I not generate a license key?If you remove Microsoft Exchange 5.5 administration extensions before you upgrade the BlackBerry Enterprise Server version 3.6 from an earlier installation, you cannot generate a license key. Remove the Microsoft Exchange 5.5 administration extensions only after you upgrade to BlackBerry Enterprise Server version 3.6 or later. If you have already removed the Microsoft Exchange 5.5 administration extensions before upgrading, you must obtain a new license key. Contact the source from which you obtained your BlackBerry Enterprise Server Software for further information.

What is the recommended database configuration for BlackBerry Enterprise Server?The recommended database configuration is one database for each organization. Using multiple databases introduces the risk of having a BlackBerry Enterprise Server on more than one database with a different IT policy applied in each case.

When upgrading, you must upgrade the database and all services to the same BlackBerry Enterprise Server Software version in a single time frame. Upgrade the database first. If you do not upgrade all services at the same time, using the upgraded database with services running an older version will cause problems.

I upgraded from BlackBerry Enterprise Server version 2.1 for Microsoft Exchange. Why can’t I remove the Microsoft Exchange 5.5 administration extensions?When you upgraded from BlackBerry Enterprise Server version 2.1 or earlier, WinBBinstaller.exe was automatically removed. WinBBinstaller.exe is required to remove the Microsoft Exchange 5.5 administration extensions after you have upgraded and imported any system information as necessary. Contact technical support to obtain a copy of WinBBinstaller.exe.

I have installed the attachment service on the server. Why do attachments not appear on the user’s BlackBerry handheld?If you have installed the attachment service option, and the user is properly configured to use the attachment service (Refer to "Attachment service" on page 24 for more information) start the BlackBerry Attachment Server service before you start the BlackBerry Server Servername service. Otherwise, users cannot view attachments on the handheld.

Installation and Getting Started Guide 237

Page 242: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13: Frequently asked questions

How can I disable the attachment service after I have installed it?To fully disable the attachment service, it is insufficient to stop the BlackBerry Attachment Service through Windows Services. If you stop the service, Open Attachment still appears on the user�s handheld menu when an attachment is received on the handheld, and if the user clicks Open Attachment, an error results.

To prevent Open Attachment from appearing in the handheld menu, remove all supported attachments from the Format List field in the BlackBerry Attachment Service configuration tool. Refer to �Modifying connector configuration� in your BlackBerry Enterprise Server for Microsoft Exchange Administration Guide for more information.

To prevent the attachment service connecting to the BlackBerry Enterprise Server, modify the installation by removing the Attachment Connector on the BlackBerry Enterprise Server. Refer to "Removing the attachment connector only" on page 200 for more information.

Why do I get a '500' connection timeout error when I try to view web pages on my BlackBerry Browser?The 500 connection timeout error occurs when the BlackBerry Enterprise Server with Mobile Data Service is unable to resolve the URL that the handheld requests, or when the handheld is not in good wireless coverage. From the BlackBerry Enterprise Server, verify that you can ping www.blackberry.com. If you are using an HTTP proxy, verify that the proxy is defined correctly in the BlackBerry Enterprise Server Management console's Mobile Data Service Properties window.

The error might also be caused by a port conflict on the server. From the BlackBerry Enterprise Server Management console's Mobile Data Service Properties window, review the ports that Mobile Data Service is configured to use, stop the Mobile Data Service, and run a netstat -a command at the command prompt to verify that no other service is trying to use those ports.

Why am I prompted to choose a profile when I start BlackBerry Enterprise Server Management?If a Choose Profile dialog box appears when you first start the BlackBerry Enterprise Server Management console, the MAPIProfile entry does not exist in the registry. (This issue might occur if you are not logged in as a user service account with a MAPI profile.) If a MAPI profile exists, it should be stored in the registry as HKEY_CURRENT_USER/Software/Research In Motion/BlackBerry Enterprise Server/Management/MAPIProfile.

238 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 243: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Solution

If a MAPI profile does exist, you can select it in the Choose Profile dialog box from Select Name drop-down list. Click OK.

Choose Profile dialog box

If a MAPI profile does not exist, complete the following steps to create one:

1. At the command prompt, type regedit. The Registry Editor window appears.

2. Browse to HKEY_CURRENT_USER/Software/Research In Motion/BlackBerry Enterprise Server/Management/.

3. In the right pane, right-click and select New > String Value. A new registry entry icon appears.

Registry Editor: Creating new string value

4. Type MAPIProfile to name the icon.

Installation and Getting Started Guide 239

Page 244: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13: Frequently asked questions

5. Double-click MAPIProfile. The Edit String dialog box appears.

Edit String dialog box

6. If the Value Data field is empty, type a name for the MAPI profile. Click OK.

7. To view and edit the MAPI profile, from the Start menu, select Programs > BlackBerry Enterprise Server > Edit the MAPI Profile for > BlackBerry Server Management. The Microsoft Exchange Server dialog box appears.

Microsoft Exchange Server dialog box

� On the General tab, in the Microsoft Exchange server field, type the name of the Microsoft Exchange server on which you created the service account mailbox.

� In the Mailbox field, type the name of the BlackBerry Enterprise Server Management administration mailbox (for example, BESAdmin).

� Click Check Name to confirm both the server and mailbox names that you specified.

8. After both names appear underlined, click OK.

Note: If the Microsoft Exchange Server dialog box does not open, and the error Unable to find Exchange Server MAPI component occurs, you should verify that the MAPI subsystem is initialized. The error occurs because a MAPI client is not already present on the server. The fixmapisvc.exe utility enables the BlackBerry Enterprise Server installation to facilitate MAPI profile creation and editing. Refer to "Creating a MAPI profile" on page 47 for more information.

240 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 245: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

9. Open BlackBerry Enterprise Server Management. You should no longer be prompted for a profile. If you are prompted for a profile, check the registry setting to verify that the MAPIProfile setting is correct.

Wireless email reconciliation is enabled, but users are not seeing immediate synchronization of changes between the handheld and the desktop. Why not?If the user is on a server that is automatically enabled for wireless email reconciliation support and the user has upgraded the handheld to a version that supports wireless email reconciliation, changes made to messages on the user�s handheld are reflected on the user�s desktop within a short period of time. If there are pending changes on the user�s handheld that require immediate reconciliation, the user can reconcile the email messages from the handheld manually using the Wireless Reconcile option.

How do I troubleshoot Mobile Data Service problems?If users have problems using the Mobile Data Service, complete the following steps to diagnose and fix the problem.

1. Verify that you started or restarted the BlackBerry Enterprise Server service after enabling Mobile Data Service at the server level.

2. Verify that the user has the Desktop IPPP service book entries (in the Options application, click Service Book, and look for entries called Browser Config and IPPP).

If these service books are not present, contact the network operator. On the Java-enabled handhelds, the IPPP service book must be provisioned as part of the handheld registration process. (Refer to "Handheld compatibility" on page 20 for more information about supported networks, handheld versions, and handheld and desktop software versions.)

3. Verify that the Mobile Data Service is running. You can view information about the Mobile Data Service in one of two ways:

� Check the log files in the Mobile Data Service installation directory.

� Open a Browser and go to http://<MDS_hostname>:<web_server_port>/

4. Verify that Mobile Data Service is enabled on the BlackBerry Enterprise Server.

5. Verify that the user is on the BlackBerry Enterprise Server on which you installed and enabled the Mobile Data Service, and that the user is enabled for Mobile Data Service.

6. Verify that the BlackBerry Enterprise Server is using the correct MAPI profile for the user.

Installation and Getting Started Guide 241

Page 246: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13: Frequently asked questions

Why do using filters, using encryption keys, and replying to messages often fail?

Symptoms

� Filters are not being applied to messages: the filters that are listed in the Redirector Settings window of the user�s BlackBerry Desktop Software do not appear to function

� Encryption key problems: users update their keys at the desktop and still receive encryption failure messages. Handhelds only function if they are plugged in at the BlackBerry Enterprise Server (mailbox extension) and have Microsoft Exchange keys

� Forwarding, Replying with text, and More features frequently fail: features are failing when users have not deleted or moved a message from the Inbox

The BlackBerry Enterprise Server does not work for users (mostly laptop) who use Personal Folders as their main message store.

The BlackBerry Enterprise Server monitors the user's MAPI store on the Microsoft Exchange Server. Personal Folders are a local MAPI store that resides on the user�s computer (or laptop). The server does not have access to MAPI stores on individual computers.

The BlackBerry Desktop Manager stores encryption keys and filter configuration in the default MAPI message store. If the user�s computer is configured to use Personal Folders, the above symptoms might appear. When Personal Folders are used (and MAPI is configured to deliver mail to Personal Folders) and Outlook is running, mail is moved (and deleted) from the Microsoft Exchange Server's store to the local Personal Folder store. When the BlackBerry Enterprise Server tries to find the original message in the Microsoft Exchange Server's message store when the user performs a Forward, Reply with Text, or More, the message is no longer there; it has been moved to the user's computer.

Solution

The user should migrate from using Personal Folders to using Offline Folders.

Personal Folders is a legacy feature of Microsoft Mail. The main reason people use Personal Folders is to retain a local copy of their mail. After users disconnect from the network, they can still read their email messages (therefore Personal Folders usage is more common among laptop users). This is why Offline Folders (.ost files) were introduced in Microsoft Outlook. With Offline Folders, mail is synchronized (in other words, replicated) between the Microsoft Exchange Server message store and the local message store. This synchronization provides the benefit of local copies for offline viewing and centralized storage, so that the IT department can backup the company's mail on a regular basis. Because mail is left on the Microsoft Exchange Server with Offline Folders, the BlackBerry Enterprise Server redirects email properly.

242 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 247: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Why has this laptop user's handheld not received messages since the laptop was last connected to the LAN?If the user is running the BlackBerry Desktop Software (with BlackBerry Enterprise Server client) on a laptop that is connected to a LAN, and the handheld is connected to the laptop, the user must exit the BlackBerry Desktop Manager before disconnecting the notebook from the LAN.

If the user does not disconnect the handheld from the computer (or exit the BlackBerry Desktop Manager) before disconnecting the laptop from the LAN, the server is not notified that the handheld is no longer connected to the computer. Therefore, if the Disable email redirection to handheld while in cradle option is enabled, no email is forwarded to the handheld because the server believes that the handheld is still connected to the computer.

Solution

The BlackBerry Enterprise Server removes the In-cradle status automatically within 10 minutes if it does not detect the BlackBerry Desktop Manager in use. You can also clear the In-cradle status manually.

1. Select a server name.

2. From the User Name list, right-click a user name and click User Stats. The User Stats window appears.

3. Click Clear-In-Cradle. The In-cradle flag is removed and email redirection resumes.

Why are some messages not forwarded to the user’s handheld?There are a few reasons why messages are not forwarded to a user�s handheld.

� Global redirection filters are applied to conditions for which the user has defined filters.

� If users are hidden in the Global Address List, and they have installed the default BlackBerry Desktop Manager filter To & BCC, the filter fails when users are BCC�d because the users cannot be found in the Global Address List. Administrators are not able to email All Points Bulletin messages to hidden users if they have the Default filter enabled. To resolve this problem, send PIN-based All Points Bulletin messages to hidden users.

Installation and Getting Started Guide 243

Page 248: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13: Frequently asked questions

Why do users’ handhelds stay at Initializing after they are added or deleted?There are a few possible reasons why a user�s status reads Initializing after the user is added to or deleted from a BlackBerry Enterprise Server.

� After you add a user to a BlackBerry Enterprise Server, the user�s status becomes Initializing by default, and remains Initializing until the user connects the handheld to the desktop computer.

� When you remove a user from a BlackBerry Enterprise Server, the user�s status becomes Initializing by default, and remains Initializing until the user connects the handheld to the desktop computer.

� To change a user�s status after they are added to or deleted from the BlackBerry Enterprise Server, the BlackBerry Enterprise Server service must be running to change a user�s status after they are added to or deleted from the BlackBerry Enterprise Server. From the Control Panel window, open Services and verify that the BlackBerry Enterprise Server status reads Started.

What happens to the users when you delete a BlackBerry Enterprise Server?If you delete a BlackBerry Enterprise Server from the BlackBerry Enterprise Server Management computer, all of its users are removed. The users are reassigned automatically as desktop redirector users, but they must connect to the desktop redirector before email redirection occurs.

If you delete only the database, you can still restore users by re-adding the BlackBerry Enterprise Server on which the users are listed, because the users' information is stored in the BlackBerry Enterprise Server service account mailbox.

Why is the server status Disabled?The SRP Connection is present, but your BlackBerry Enterprise Server is not running.

Solution

1. From the Start menu, select Settings > Control Panel, open Services and verify that the BlackBerry Enterprise Server status reads Started.

If the service is running, your second point of verification is the Windows NT Event Viewer.

2. Open the Windows NT Event Viewer.

244 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 249: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

3. From the Log menu, click Application Log, and scan for BlackBerry logs that contain error messages (particularly those pertaining to misnamed MAPI profiles).

You can also check your debug log for any recent BlackBerry Enterprise Server entries.

Why is the server status SRP Connection Down?While the BlackBerry Enterprise Server is running, the Service Relay Protocol (the BlackBerry link to the wireless network) is disconnected.

Solution

Verify that the Domain Name System (DNS) is set up properly on the server computer. The system might not be able to resolve or find SRP HOST (indicated in italics because the value is variable; refer to the label on your installation CD for the correct SRP Host value), which is the Network Address Node that is specified during installation. You can run the BBSRPTEST utility to determine where the connection process is failing.

1. Copy BBSRPTEST.exe to the computer that is running the BlackBerry Enterprise Server.

2. At a command prompt, run the BBSRPTEST.exe with no additional parameters. The utility reads the settings from the registry and attempts to connect to the SRP host server.

The following message should appear:

� Attempting to connect to srp host (IP Address), port 3101 Successful

where srp host and IP Address are indicated in italics because the values are variable; refer to the label on your installation CD for the correct SRP Host value and IP Address.

You might see one of the following messages instead:

� gethostbyname() failed for name srp host: error code = 11001This message indicates a configuration problem on your computer. Your computer is unable to look up the SRP host server's name. 11001 means that the name is not found.

� connect() failed: error code = 10060This message indicates that no one is answering the connection request, or the firewall "swallowed" the connection request. 10060 means a timeout occurred.

� connect() failed: error code = 10061This message indicates that the connection was refused; either the SRP host server is not running or the firewall prevented the connection from going through. 10061 means the connection was refused.

� “recv(): connection lost”This message indicates that the connection was broken (by the firewall or proxy) before the

Installation and Getting Started Guide 245

Page 250: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13: Frequently asked questions

test program could handshake with the SRP host server. The error code that is listed is the Winsock error code.

Why is wireless calendar synchronization not working?If Microsoft Outlook is installed on the BlackBerry Enterprise Server computer, wireless calendar synchronization does not work. The versions of CDO.dll and MAPI that are included in the Microsoft Outlook package are unable to support wireless calendar synchronization. To perform wireless calendar synchronization, BlackBerry Enterprise Server version requires the correct versions of the CDO.dll and MAPI files. (Refer to "System requirements" on page 28 for more information.)

Solution

1. Remove Microsoft Outlook.

2. Verify that CDO.dll is re-registered: from the command line, change to c:\winnt\system32 and execute the following command:

regsvr32 cdo.dll3. Reconfigure the MAPI version: Microsoft Exchange Administrator installs its copy of the

MAPI32.dll file into the c:\winnt\system32 directory. After Microsoft Outlook is installed, it renames that file to MAPI32x.dll and installs its own MAPI32.dll file.

4. Rename MAPI32.dll to MAPI32.dll.outlook (or another name as desired), and copy MAPI32x.dll to MAPI32.dll.

246 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 251: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

How do I change the attachment service default port settings?The table below shows the attachment service default port settings and the registry location where you can modify the settings. If you do not have a port conflict, retain the default settings.

How do I obtain additional support?Contact the source from which you obtained your BlackBerry Enterprise Server Software for further information.

Default port Description Registry value

1999 administration configuration port

HKLM\SYSTEM\CurrentControlSet\Services\BBAttachServer\ConfigPort

1900 server submit port HKLM\SYSTEM\CurrentControlSet\Services\BBAttachServer\BBAttachServerPort

HKLM\SOFTWARE\Research In Motion\BBAttachServer\BBAttachBESExtension\BBAttachServerPort

Note: You must modify the value in both registry locations.

Installation and Getting Started Guide 247

Page 252: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Chapter 13: Frequently asked questions

248 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 253: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

IndexNumerics

3101, port, 185401 error, 2295403 error, 2315404 error, 231

A

aboutBlackBerry Enterprise Server

Management console, 18the server, 18this guide, 9

Active Directory Service Interfaces (ADSI), 32additional resources, 10Admin only installation type, 59administration

documentation, 11extensions, removing, 157, 196mailbox, 127, 145, 182permission, 20permission, BlackBerry User

Administration service, 20software, overview, 19

APIcomponents, 13documentation, 12

attachment servicecomponents, 15default port settings, changing, 251frequently asked questions, 241hardware requirements, 28overview, 24support, 21

audience description, 10authentication, 23

B

BBPerfMonInstall.exe, 14BBSRPTest.exe, 14, 249BBUserAdminClient.exe, 13BBUserAdminService.exe, 13before you install, 39BESAlert.exe, 12BESExtension.hh and BlackBerryServer.lib, 15BESManMMC.msc, 13BESPerfInfo.dl, 12BESProfile.exe, 13BlackBerry Enterprise Server

adding, 154configuring, 154evaluation version, 37extensions, removing, 157, 196illustration, message flow, 19modifying, 189overview, 18removing, 195, 197service account, 44, 49updating, 168upgrading, 163, 165, 166

BlackBerry Enterprise Server Managementconsole, 19, 20, 154overview, 19requirements, 31service account, 44, 49

BlackBerry solution, components, 18BlackBerry User Administration

client, using, 159overview, 20service account, 44, 49service, client, 20service, error codes, 231

Installation and Getting Started Guide 249

Page 254: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Index

uninstalling, 213using client, 159

BlackBerryBackup.exe, 14BlackBerryServer.exe, 12BlackBerryServerSNMPAgent.dll, 12browser

frequently asked questions, 242overview, 23

C

C++-enabled handhelds, 20, 21, 23, 24CalHelper.exe, 13CD contents, 12CDMA2000 1X network, 20CDO.dll

installing, 165registering, 165

change database parameter, 133checklist, preinstallation, 39Choose Profile dialog box, 242client, BlackBerry User Administration service, 20command line syntax, 160compatibility

desktop software, 20handheld software, 20handheld versions, 20

componentsAPI, 15attachment service, 15BlackBerry solution, 18

configuringBlackBerry Enterprise Server, 154firewall, 33

connection, TCP/IP, 18, 33conventions, documentation, 10cradle/charger, 18CreateDB.exe, 13

create database using, 132Custom

installation type, 59setup screen, 68

D

dataconversion, 22routing, 22

data integrity, 23database

authentication type, 74, 81, 109, 122, 140, 177, 186

information, 73, 177, 186name, 74, 81, 108, 121, 140, 177, 186parameter, 133parameter, change, 133recommended configuration, 241software, installation, 53

DataTAC network, 20DBConsistency.exe, 13dbghelp.dll, 12defining an input file, 161deleting, BlackBerry Enterprise Server status, 248desktop software, 18documentation

administration, 11API, 12conventions, 10installation, 11IT Policy Manager, 11resources, 10

Domain Name System (DNS), 33

E

encryption keyfailure, 246FAQs, 241

enteringSRP Authentication Key, 38

environmentMicrosoft Exchange 2000, 19Microsoft Exchange 5.5, 19mixed mode, 19

250 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 255: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Index

errors, 227, 2395401, 2295403, 2315404, 231codes, 161codes, BlackBerry User Administration

service, 231no service name, 231

evaluation versionBlackBerry Enterprise Server, 37server Properties window, 37

F

FBUpdate.exe, 14filters

failure, FAQ, 246FAQs, 241

firewall configuration, 33fixmapisvc.exe, 14, 51flags, 160frequently asked questions

attachment service default port settings, 251

attachments not appearing on handheld, 241

browser �500� connection timeout error, 242

changing routing group name, 250Choose Profile dialog box, 242deleted users, 248failure of encryption keys, 241failure of filters, 241failure of replying, 241generating license key, 241laptop not receiving messages, 247laptop user, 247Mobile Data Service, 245recommended database configuration,

241server status is Disabled, 247, 248

SRP connection down, 249user status Initializing, 248wireless calendar synchronization, 250wireless email reconciliation, 245

G

gateway, Wide Area Protocol (WAP), 23GSM/GPRS network, 20guide, about, 9

H

handheldC++-enabled, 20, 21, 23, 24compatibility, 20Java-enabled, 20, 21, 23, 24not receiving messages, FAQ, 247support, 20

HandheldCleanup.exe, 14hardware requirements, 28

attachment service, 28Mobile Data Service, 28

I

IEMSTest.exe, 14illustration

BlackBerry Enterprise Server message flow, 19

importing system information, 157input file

defining, 161format, 161optional, 159

installation, 57, 63, 87, 95, 117, 135CDO.dll, 165database software, 53documentation, 11MSDE, 53, 74, 76, 179type, Admin Only, 59type, Custom, 59type, Typical, 59

Installation and Getting Started Guide 251

Page 256: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Index

IT Admin commands, wireless synchronization, 21IT Policy Manager

documentation, 11utility, 11

IT policy settings, wireless synchronization, 21ITPolicy.exe, 14

J

Java Runtime Environment (JRE), 33Java-enabled handhelds, 20, 21, 23, 24

K

keyword.txt, 14

L

laptop connected to LAN, FAQ, 247license key

generating, frequently asked questions, 241

in registry, 36overview, 36temporary, restrictions, 36troubleshooting, 241

local administrator permissions, 48Log Folder screen, 82, 187log on user account, 159

M

MAPI profileediting, 180frequently asked questions, 243verifying, 152

messagelaptop not receiving, FAQ, 247not received, FAQ, 247reply to failure, FAQ, 246

message flow illustration, 19

Microsoft, 118, 136Microsoft Data Engine (MSDE), 20, 35

installing, 53, 74, 76Microsoft Exchange

Administer Information store permission, 49

View Only Administrator permission, 49Microsoft Exchange 2000 environment, 19Microsoft Exchange 2000 System Manager, 118, 136Microsoft Exchange 2003, 28, 30

mail server environment, 40System Manager, 30

Microsoft Exchange 2003 System Manager, 40, 41, 118, 136Microsoft Exchange 5.5 administration extensions, removing, 157, 196, 241Microsoft Exchange 5.5 Administrator, 118, 136Microsoft Exchange 5.5 environment, 19Microsoft Exchange administration and Windows software

compatible versions, 35Microsoft Management Console snap-in, 19Microsoft Management Console, requirements, 32Microsoft Outlook 2000, 41Microsoft Outlook 2000 (Corporate or Workgroup installation), 118, 136Microsoft Outlook 2003, 41, 118, 136Microsoft Outlook XP, 41mixed mode environment, 19MMC snap-in, 19Mobile Data Service

hardware requirements, 28overview, 22parameters, 23removing, 217requirements, 32troubleshooting, 245

Mobitex network, 20

252 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 257: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Index

modifying the BlackBerry Enterprise Server, 189MSDE 2000 Service Pack 3, 41, 53MSSQLSERVER, 131

N

networkCDMA2000 1X, 20DataTAC, 20GSM/GPRS, 20Mobitex, 20Nextel, 20

Nextel network, 20no service name error, 231

O

obtaining additional support, 251Open Database Connectivity (ODBC), 32optional input files, 159overview

administration software, 19attachment service, 24BlackBerry Enterprise Server, 18BlackBerry Enterprise Server

Management, 19BlackBerry User Administration, 20browser, 23license keys, 36Mobile Data Service, 22S/MIME, 23wireless email reconciliation, 24

P

PAC file, 32, 40package contents, 12password

database, 74, 81, 109, 122, 140, 177, 186SQL authentication, 74, 81, 109, 122, 140,

177, 186

permissionsassigning to the service account, 45, 48BlackBerry User Administration service,

20local administrator, 48

planning, 57policy.inf, 14port 3101, 18, 33port settings, attachment service, 251preinstallation

procedures, 43requirements checklist, 39

proxy auto-configuration (PAC) file, 32, 40

R

registering CDO.dll, 165registry key, 127, 129, 146, 147, 183Remote Address Lookup, support, 21removing

administration extensions, 157, 196BlackBerry Enterprise Server, 195, 197BlackBerry User Administration

Software, 213Mobile Data Service, 217MSDE, 208utilities, 222

reply to messages failure, FAQ, 246replying, FAQs, 241requirements

hardware, 28, 39software, 28, 39

resources, additional, 10routing group, name change, 250

S

S/MIMEdesktop requirements, 23digital signing, 23overview, 23

Secure Multipurpose Internet Mail Extensions (S/MIME), 23security, 23

Installation and Getting Started Guide 253

Page 258: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Index

serverabout, 18compatibility, 19functions, 18information, SRP Authentication Key, 154information, SRP Identifier, 154software, removing, 195, 197software, upgrading, 165status Disabled, FAQ, 247, 248

server Properties windowevaluation version, 37

servicestarting, 155, 156stopping, 155, 156

service accountassigning permissions, 48BlackBerry Enterprise Server, 44, 49BlackBerry Enterprise Server

Management, 44, 49BlackBerry User Administration, 44, 49setting permissions, 45

SetAdminKey.exe, 14setup, 57, 63, 87, 95, 117, 135software

package, 12requirements, 28

SQL 7.0, 35SQL Server

authentication, 74, 81, 109, 122, 140, 177, 186

service, 131SQL User Name, 74, 81, 109, 122, 140, 177, 186SRP

Authentication Key, 154Authentication Key, entering, 38connection down, FAQ, 249Identifier, 154

SRP connectionunavailable, 37

SRP Identifiertemporary, 37

stand alone IT Policy Manager, documentation, 11starting BlackBerry Enterprise Server services, 155, 156stopping BlackBerry Enterprise Server services, 155, 156support

attachment service, 21desktop software, 20handheld software, 20handheld versions, 20obtaining, 251Remote Address Lookup, 21wireless calendar synchronization, 20wireless email reconciliation, 22

syntax, command line, 160system

information, importing, 157requirements, 28

T

TCP/IP connection, 18, 33technical support

obtaining, 251temporary evaluation license key, 36Terminal Server service, 53Terminal Services

Application Server mode, 28Remote Desktop mode, 28

Triple Data Encryption Standard (DES) encryption technology, 23Typical installation type, 59

U

uninstallingBlackBerry Enterprise Server, 197BlackBerry Enterprise Server

Management, 149BlackBerry User Administration, 213Mobile Data Service, 217MSDE, 208utilities, 222

254 BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Page 259: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

Index

Universal Content Stream (UCS) format, 25Universal Serial Bus (USB) drivers, 41updating BlackBerry Enterprise Server, 168upgrading

BlackBerry Enterprise Server, 165, 166overview, 163

usage parameter, utility, 15USB cable, 18user

add remotely, 20, 159delete remotely, 20, 159list remotely, 20, 159mailbox level administration, 20name, SQL Server authentication, 74, 81,

109, 122, 140, 177, 186server level administration, 20status Initializing, FAQ, 248

using the BlackBerry User Administration client, 159utilities

BBPerfMonInstall.exe, 13BBSRPTest.exe, 13, 249BBUserAdminClient.exe, 13BBUSerAdminService.exe, 13BESProfile.exe, 13BlackBerryBackup.exe, 13DBConsistency.exe, 13FBUpdate.exe, 13fixmapisvc.exe, 13HandheldCleanup.exe, 13

IEMSTest.exe, 13IT Policy Manager, 11ITPolicy.exe, 13, 14removing, 222usage parameter, 15

W

Wide Area Protocol (WAP) gateway, 23Windows 2000

Terminal Services, 28Windows 2003

Terminal Services, 28Windows NT

authentication, 74, 81, 109, 122, 140, 177, 186

service, 18Windows Server 2003, 30, 33, 39, 41Windows Services, 155Windows XP, 41wireless calendar synchronization, support, 20wireless email reconciliation

frequently asked questions, 245overview, 24support, 22

wireless IT policy synchronization, 20wireless synchronization

of IT admin commands, 21of IT policy settings, 21

Installation and Getting Started Guide 255

Page 260: BlackBerry Enterprise Server for Microsoft Exchange 2000/2003

© 2004 Research In Motion LimitedPublished in Canada