BlackBerry Enterprise Server for IBM Lotus Domino Version: 5.
SWDT561575-561575-0330020419-001
Contents 1 Overview: BlackBerry Enterprise Server.................................................................................................................................. 5 2 Planning a BlackBerry Enterprise Server upgrade................................................................................................................. Supported BlackBerry Enterprise Server versions that you can upgrade from........................................................................
Specifying permissions when connecting to the BlackBerry Enterprise Server databases using Windows authentication......................................................................................................................................................................... Configuring authentication to the BlackBerry MDS Integration Service database....................................................... Configuring the local system account in an IBM Lotus Domino environment.........................
7 Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrade the existing BlackBerry Configuration Database............................................................................................................................................................. Upgrade a BlackBerry Configuration Database.......................................................................................................................... BESMgmt.cfg properties.............................
Configure the SNMP service for monitoring....................................................................................................................... Configure the BlackBerry Monitoring Service to monitor a BlackBerry Enterprise Server............................................ Configure the BlackBerry MailStore Service to use a local system account............................................................................
Upgrade Guide Overview: BlackBerry Enterprise Server Overview: BlackBerry Enterprise Server 1 The BlackBerry® Enterprise Server is designed to be a secure, centralized link between an organization's wireless network, communications software, applications, and BlackBerry devices.
Upgrade Guide Planning a BlackBerry Enterprise Server upgrade Planning a BlackBerry Enterprise Server upgrade 2 If your organization's environment includes only one BlackBerry® Enterprise Server at version 4.0 SP7 or 4.1 SP3 or later, you can upgrade the BlackBerry Enterprise Server to the latest version by overwriting it or by installing the BlackBerry Enterprise Server on a different computer and moving the user data to the upgraded BlackBerry Enterprise Server.
Upgrade Guide Upgrade implications for the BlackBerry Configuration Database Upgrade implications for the BlackBerry Configuration Database When you upgrade to the latest BlackBerry® Enterprise Server version, you must upgrade to the lastest BlackBerry Configuration Database version.
Hardware requirements: BlackBerry Enterprise Server Upgrade Guide Hardware requirements: BlackBerry Enterprise Server 3 The following are requirements for a BlackBerry® Enterprise Server and the BlackBerry Enterprise Server components that you install on a single computer, and excludes the BlackBerry Collaboration Service and the BlackBerry MDS Integration Service. The requirements are for a BlackBerry Enterprise Server environment that includes users that receive 100 to 200 email messages each day.
System requirements Upgrade Guide System requirements 4 For information about calculating hardware requirements, visit www.blackberry.com/go/serverdocs to see the BlackBerry Enterprise Server Capacity Calculator and BlackBerry Enterprise Server Performance Benchmarking Guide.
Upgrade Guide Item System requirements: BlackBerry Administration Service and BlackBerry Web Desktop Manager Requirement DIIOP task running In your organization's environment, an IBM Lotus Domino server running the DIIOP task and, if you are using IBM Lotus Domino authentication with BlackBerry Administration Service or BlackBerry® Web Desktop Manager, with the directory assistance feature turned on database conditions for the BlackBerry® A database server that hosts the BlackBerry Configuration Databa
System requirements: BlackBerry Enterprise Server databases Upgrade Guide Item Requirement • • IBM® Lotus® Domino® Internet accounts and passwords for BlackBerry Web Desktop Manager users all user accounts located on the same IBM Lotus Domino server browser Windows® Internet Explorer® version 6.
System requirements: BlackBerry Attachment Service Upgrade Guide Item Requirement • • • database transactional replication a separate database server for the mirror database static port with the same port number for both database servers Microsoft SQL Server Browser running on both database servers To support database transactional replication for the BlackBerry Configuration Database or the BlackBerry MDS Integration Service database, the following conditions: • the database server must be Microsoft
System requirements: BlackBerry Collaboration Service Upgrade Guide System requirements: BlackBerry Collaboration Service Item Requirement operating system Any of the following operating systems: • Windows Server® 2003 SP1 or later • Windows Server 2003 R2 • Windows Server 2003 (64-bit) • Windows Server 2003 R2 SP2 (64-bit) • Windows Server® 2008 or later • Windows Server 2008 (64-bit) IBM® Lotus® Sametime® IP address of the BlackBerry® Collaboration Service computer added to the CommunityConnectivit
System requirements: BlackBerry MDS Integration Service Upgrade Guide Item Requirement RSA® Authentication Agent To support enhanced network authentication, RSA® Authentication Agent version 5.
System requirements: BlackBerry Router Upgrade Guide Item Requirement • • • • • Windows Server 2003 R2 Windows Server 2003 (64-bit) Windows Server 2003 R2 SP2 (64-bit) Windows Server® 2008 or later Windows Server 2008 (64-bit) SNMP browser The SNMP service running on the computer that hosts the BlackBerry Enterprise Server Windows® Internet Explorer® version 6.
System requirements: Messaging server Upgrade Guide Item Requirement browser settings To support BlackBerry® Web Desktop Manager, the following conditions must be met: • the BlackBerry Web Desktop Manager web address added as a trusted site or local intranet site • the following settings turned on to support Microsoft® ActiveX®: • Automatic prompting for ActiveX controls • Download signed Microsoft ActiveX controls • Run ActiveX controls and plug-ins • Script ActiveX controls marked safe for scripting
System requirements: Firewall Upgrade Guide System requirements: Firewall To install the BlackBerry® Enterprise Server, a firewall or proxy firewall with the following conditions: • exclusive use of port 3101 to open and maintain an outgoing, two-way TCP/IP connection to an external server • support for the resolution of Internet addresses that use DNS • for proxy firewalls, transparency of the proxy server System requirements: Instant messaging server To install the BlackBerry® Enterprise Server, any of
Unsupported environments Upgrade Guide Item Description • SNMP monitoring remote access cross-certification established between the messaging servers and directory servers in other domains The BlackBerry Enterprise Server and BlackBerry Enterprise Server components support the SNMP service. The BlackBerry Enterprise Server and BlackBerry Enterprise Server components support remote access by administrators who use Remote Desktop Connection.
Upgrade Guide Preupgrade tasks Preupgrade tasks 5 Configuring a messaging environment Configure a group for the BlackBerry Enterprise Server You must configure a group named BlackBerryAdmins in your organization's messaging environment. The BlackBerryAdmins group includes permissions that the BlackBerry® Enterprise Server can use to access specific databases.
Upgrade Guide Configuring connections for the BlackBerry Enterprise Server databases You can create the BlackBerry Configuration Database by installing a BlackBerry Enterprise Server instance or BlackBerry Administration Service instance, or by running the CreateDB executable. You can create the BlackBerry MDS Integration Service database or BlackBerry Monitoring Service database during the installation processes for the BlackBerry MDS Integration Service or BlackBerry Monitoring Service respectively.
Upgrade Guide Configuring connections for the BlackBerry Enterprise Server databases • If you create the BlackBerry Enterprise Server databases on the same computer as the BlackBerry Enterprise Server and the computer already hosts a Microsoft SQL Server, assign the database creator permission to the Windows account that you use to complete the BlackBerry Enterprise Server installation process.
Upgrade Guide Resolving IT policy and application control policy conflicts in a mixed version environment • Password Resolving IT policy and application control policy conflicts in a mixed version environment In BlackBerry® Enterprise Server versions earlier than version 5.0, the BlackBerry Policy Service queues delivery requests for IT policies and application control policies and sends them to BlackBerry devices. In BlackBerry Enterprise Server version 5.
Backing up the BlackBerry Configuration Database Upgrade Guide Back up the BlackBerry Configuration Database 1. 2. 3. 4. Copy the BlackBerry® Enterprise Server installation media to the database server that hosts the BlackBerry Configuration Database. Extract the contents of the installation media to a folder on the computer. At the command prompt, navigate to the Tools folder in the BlackBerry Enterprise Server installation media. Run BlackBerryDbBackup.exe.
Configuring the LDAP information for the BlackBerry Administration Service Upgrade Guide Parameter Description [-P] [-p] The default user name is sa. This parameter specifies the password that you use for for database authentication. This parameter specifies the interval, as a percentage, that you want the BlackBerry Configuration Database Backup Tool to report progress at. [-?] The default percentage is 10.
Upgrade Guide Configuring the LDAP information for the BlackBerry Administration Service Find the LDAP information that the BlackBerry Administration Service requires You can use the ldp support tool to access the domain controller in your organization's environment and locate the LDAP information before you install the BlackBerry® Administration Service. Before you begin: • Verify that you have a domain administrator account. • Download and install the Windows® support tools.
Upgrade Guide Migrating BlackBerry MDS Runtime Applications If the user accounts in your organization's environment are stored in more than one domain in a Microsoft® Active Directory® forest, you must configure the LDAP settings that the BlackBerry Administration Service uses so that the BlackBerry Administration Service can search the global catalog. 1. 2. 3.
Upgrade Guide 5. Install the SNMP service for monitoring by the BlackBerry Monitoring Service Import the data into the BlackBerry MDS Integration Service database. After you finish: To migrate user accounts to the BlackBerry MDS Integration Service pool after you complete the upgrade process, use the BlackBerry Administration Service to update the BlackBerry® Enterprise Server to use the new BlackBerry MDS Integration Service pool.
Upgrade Guide Creating a BlackBerry MDS Integration Service pool pool name that you specified during the installation process in the URLs for the BlackBerry Administration Service console and BlackBerry Web Desktop Manager (for example, https:///webconsole/login or https:///webdesktop/ login).
Upgrade Guide Configuring the setup application to use a non-default static port number for the database server • • You must have permission to manage the DNS. If you configure DNS round robin, you must configure clients to resolve the DNS name into a list of IP addresses and distribute traffic equally across the BlackBerry Administration Service or BlackBerry MDS Integration Service instances in the pool. 1. 2. Log in to the DNS server.
Applications that are installed with the BlackBerry Enterprise Server components Upgrade Guide 2. 3. 4. 5. 6. 7. 8. Expand SQL Native Client Configuration. Right-click Aliases. Click New Alias. In the Alias Name field, type the database server name. In the Port No field, type the static port number. In the Protocol drop-down list, click TCP/IP. In the Server field, type the database server name. Click OK. Create an alias to the database server using the cliconfg.exe tool 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
Prerequisites: Upgrading the BlackBerry Enterprise Server software Upgrade Guide Application BlackBerry Enterprise Server components that the application is installed with Microsoft® XML Parser version 6.0.1 Microsoft® SQL Server® Express 2005 (if selected) all components except the BlackBerry Router • • • • BlackBerry Administration Service BlackBerry Enterprise Server BlackBerry MDS Integration Service BlackBerry Monitoring Service Microsoft® .NET Framework version 2.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software by using the in-place upgrade process Upgrading the BlackBerry Enterprise Server software by using the in-place upgrade process 6 Using the in-place upgrade process, you can upgrade the BlackBerry® Enterprise Server software by replacing the existing version and upgrading the BlackBerry Configuration Database.
Upgrade Guide Upgrade the BlackBerry Enterprise Server software by overwriting the existing version and use the existing BlackBerry Configuration Database 6. 7. 8. In the Database information dialog box, verify the names of the database server and existing BlackBerry Configuration Database.
Upgrade Guide • You can type the name and password for the administrator account that has permissions to log in to and search the LDAP server. You can type the name for the administrator account as the login name, also known as the security account manager name (for example, besadmin). 15.
Upgrade Guide Upgrade the BlackBerry Enterprise Server instances that you configured for disaster recovery Upgrade the BlackBerry Enterprise Server instances that you configured for disaster recovery If you configured the BlackBerry® Enterprise Server instances in your organization's environment for disaster recovery, you configured two BlackBerry Enterprise Server instances that use the same SRP address.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrade the existing BlackBerry Configuration Database Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrade the existing BlackBerry Configuration Database 7 Using the cutover upgrade process, you can install a BlackBerry® Enterprise Server on a new computer and move user accounts and server information from a previous BlackBerry Enterprise Server to the new one.
Upgrade a BlackBerry Configuration Database Upgrade Guide 5. 6. 7. 8. 9. 10. Open the BesMgmt.cfg file in a text editor. Change the file to include information that is specific to your organization's environment. Save and close the file. Open a command prompt window. Navigate to \Database. Type CreateDB.exe BESMgmt.cfg. BESMgmt.cfg properties Property Description DATABASE_NAME CMD SCRIPT_ROOT This property specifies the name of the BlackBerry® Configuration Database.
Upgrade Guide Property Install the BlackBerry Enterprise Server on the new computer and upgrade the existing BlackBerry Configuration Database Description By default, this folder is located in the same root folder that the CreateDB.exe file is located in. Install the BlackBerry Enterprise Server on the new computer and upgrade the existing BlackBerry Configuration Database To administer the BlackBerry® Enterprise Server, you must install the BlackBerry Administration Service.
Upgrade Guide Install the BlackBerry Enterprise Server on the new computer and upgrade the existing BlackBerry Configuration Database 9. When prompted to restart the computer, click Yes. 10. Log in to the computer using the same account that you used in step 1. 11. In the CAL and SRP Information dialog box, type the SRP credentials that the BlackBerry Enterprise Server that you are replacing uses. 12.
Upgrade Guide Move user accounts to a new BlackBerry Enterprise Server using the BlackBerry Administration Service After you finish: As required, add the name of the BlackBerry MDS Integration Service pool to the DNS server, and change the name of the computer. Specifying a name for the BlackBerry Administration Service pool during the installation process During the installation process, the setup application prompts you to specify the name of the BlackBerry® Administration Service pool.
Upgrade Guide Prevent the previous BlackBerry Enterprise Server from connecting to the BlackBerry Infrastructure 9. Click Switch BlackBerry user to different BlackBerry Enterprise Server. 10. Select the new BlackBerry Enterprise Server from the list. 11. Click Save All. After you finish: Reassign the IT policies to the user accounts.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and create a BlackBerry Configuration Database Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and create a BlackBerry Configuration Database 8 Using the cutover upgrade process, you can install the BlackBerry® Enterprise Server on a new computer and move user accounts and server information from the previous BlackBerry Enterprise Server to the new one.
Create a BlackBerry Configuration Database Upgrade Guide 4. 5. 6. 7. 8. 9. 10. Navigate to \Database. Open the BesMgmt.cfg file in a text editor. Change the file to include information that is specific to your organization's environment. Save and close the file. Open a command prompt window. Change to \Database. Type CreateDB.exe BESMgmt.cfg. BESMgmt.
Upgrade Guide Install the BlackBerry Enterprise Server on a new computer and create a new BlackBerry Configuration Database Property Description BACKUP_DIR This property specifies an existing folder where you want to save the database backup in. By default, this folder is located in the same root folder that the CreateDB.exe file is located in.
Upgrade Guide Install the BlackBerry Enterprise Server on a new computer and create a new BlackBerry Configuration Database • If you configured the database server to use static ports, you must clear the Use dynamic ports check box. If the static port number is not 1433, type the port number in the Port field. 11. In the CAL and SRP information dialog box, type the new SRP credentials. 12.
Upgrade Guide Install the BlackBerry Enterprise Server on a new computer and create a new BlackBerry Configuration Database Specifying a name for the BlackBerry Administration Service pool during the installation process During the installation process, the setup application prompts you to specify the name of the BlackBerry® Administration Service pool.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software in phases Upgrading the BlackBerry Enterprise Server software in phases 9 Using the phased upgrade process, you can maintain previous versions of the BlackBerry® Enterprise Server software, install additional BlackBerry Enterprise Server instances over time, and move user accounts to the latest BlackBerry Enterprise Server versions. When you use the in-place upgrade process, all BlackBerry devices receive new IT policies.
Upgrade Guide 3. 4. 5. 6. 7. Upgrade multiple BlackBerry Enterprise Server instances in phases If you upgrade an existing BlackBerry Configuration Database, remove BlackBerry Manager instances from your organization's environment. Move user accounts to the upgraded BlackBerry Enterprise Server by performing one of the following actions: • To upgrade an existing BlackBerry Configuration Database, move user accounts using the BlackBerry Administration Service.
Postupgrade tasks Upgrade Guide Postupgrade tasks 10 Best practice: Running the BlackBerry Enterprise Server Best practice Description Do not change the startup type for the BlackBerry® Enterprise Server services. When you install or upgrade the BlackBerry Enterprise Server, the setup application configures the startup type for the BlackBerry Enterprise Server services to automatic or manual.
Upgrade Guide Log in to the BlackBerry Administration Service for the first time Log in to the BlackBerry Administration Service for the first time To open the BlackBerry® Administration Service, you can use a browser on any computer that has access to the computer that hosts the BlackBerry Administration Service.
Upgrade Guide Change applications to support BlackBerry MDS Connection Service failover Install a BlackBerry MDS Integration Service pool in an upgraded environment When you install new BlackBerry® MDS Integration Service instances in an upgraded environment instead of upgrading existing BlackBerry MDS Integration Service instances, you lose backend notification subscriptions. BlackBerry devices that run BlackBerry® MDS Runtime Application versions earlier than version 4.5 remove the applications. 1.
Upgrade Guide Configuring support for new attachments Configuring support for new attachments Configure an upgraded BlackBerry Enterprise Server to support new attachment extensions When you upgrade a BlackBerry® Enterprise Server instance, the upgrade process does not automatically add the new attachment extensions that the latest BlackBerry Enterprise Server version supports.
Upgrade Guide 4. 5. 6. Assigning an IT policy to a group In the Distiller section, in the Allowed column, turn on the attachment distillers that you want the BlackBerry Attachment Service to support. If required, in the Distiller section, in the Attachment size (KB) column, change the file size, in KB, for the new attachments. Click Save. Assigning an IT policy to a group After you complete the upgrade process, you can assign an IT policy to a group.
Configuring minimum Microsoft SQL Server permissions for the Windows account Upgrade Guide 1. 2. 3. In the Microsoft® SQL Server® management console, create a SQL login for the Windows account or SQL authentication account. Assign the account to the rim_db_AttachmentServer role in the BlackBerry Configuration Database. If you want the BlackBerry Attachment Service to use a SQL authentication account to access the BlackBerry Configuration Database, perform the following actions: a.
Configuring a computer for monitoring Upgrade Guide Server and database roles rim_db_bes_server Description You can remove this role from the Windows account that the BlackBerry Enterprise Server uses to run after the setup application creates or upgrades the BlackBerry Configuration Database. The BlackBerry Enterprise Server requires this role to run the BlackBerry Enterprise Server services.
Upgrade Guide 5. 6. 7. 8. 9. Configure the BlackBerry MailStore Service to use a local system account On the Security tab, in the Accepted community names section, add the community name that you typed in step 3. The SNMP community name is read-only. Select the Accept SNMP packets from any host or Accept SNMP packets from these hosts option, depending on your organization's environment.
Upgrade Guide 1. 2. 3. 4. 5. Configure the BlackBerry MailStore Service to use a local system account On the computer that hosts the BlackBerry Enterprise Server, right-click My Computer. Click Properties. On the Advanced tab, click Environment Variables. Add the path to the IBM Lotus Domino installation folder to the Path system variable (for example, C:\Program Files\Lotus \Domino\nserver.exe) Click OK. Restart the computer.
Upgrade Guide Troubleshooting the BlackBerry Enterprise Server upgrade process Troubleshooting the BlackBerry Enterprise Server upgrade process 11 Failed to write License Key to the Database This error message appears when you try to add the BlackBerry® Client Access License key during the installation process.
Upgrade Guide Could not open ID file Could not open ID file This message displays when you start the BlackBerry® Enterprise Server setup application but it closes unexpectedly. Possible solution 1. If you installed the IBM® Lotus® Domino® server recently but you did not start it yet, start it and stop it. 2. Restart the setup application.
Upgrade Guide A third-party tool did not install and the BlackBerry Enterprise Server setup application closed A third-party tool did not install and the BlackBerry Enterprise Server setup application closed Possible solution 1. 2. 3. 4. On the BlackBerry® Enterprise Server installation media, open the Tools folder. Double-click the setup application file for the tool that you want to install. Complete the instructions on the screen. Restart the BlackBerry Enterprise Server setup application.
Various BlackBerry Enterprise Server components do not start Upgrade Guide 3. 4. 5. 6. Change to \Tools. Type BlackBerryDBRestore.exe. Type the same parameters that you used when you backed up the BlackBerry Configuration Database. Press ENTER.
Upgrade Guide The BlackBerry Administration Service pool name is the same as the FQDN of the host computer The BlackBerry® Administration Service is configured to use static ports when it connects to the BlackBerry Configuration Database server, but the BlackBerry Configuration Database server uses a dynamic port. Possible solution Configure the BlackBerry Administration Service to use a dynamic port for the BlackBerry Configuration Database. 1. 2. 3. 4.
Upgrade Guide Glossary Glossary 12 AJAX Asynchronous JavaScript® and XML BlackBerry Client Access License A BlackBerry® Client Access License (BlackBerry CAL) limits how many users you can add to a BlackBerry® Enterprise Server. BlackBerry Domain A BlackBerry Domain consists of the BlackBerry Configuration Database with its users and any BlackBerry® Enterprise Server instances that connect to it.
Upgrade Guide Glossary JDK Java® Development Kit JRE Java® Runtime Environment LDAP Lightweight Directory Access Protocol LMM The Low Memory Manager (LMM) is an application on the BlackBerry device that deletes medium-priority items, such as old email messages and out-of-date calendar entries, when the amount of available flash memory on the BlackBerry device is less than 400 KB.
Upgrade Guide Provide feedback Provide feedback 13 To provide feedback on this deliverable, visit www.blackberry.com/docsfeedback.
Upgrade Guide Legal notice Legal notice 14 ©2009 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®, SureType®, SurePress™ and related trademarks, names, and logos are the property of Research In Motion Limited and are registered and/or used in the U.S. and countries around the world. IBM, DB2, Domino, Lotus, Lotus Notes, and Sametime are trademarks of International Business Machines Corporation. Java, JavaScript, and JRE are trademarks of Sun Microsystems, Inc.
Upgrade Guide Legal notice PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
Upgrade Guide Legal notice Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server, BlackBerry® Desktop Software, and/or BlackBerry® Device Software. The terms of use of any RIM product or service are set out in a separate license or other agreement with RIM applicable thereto.
