Version: 5.
Published: 2014-01-16 SWD-20140116175501016
Contents 1 Overview: BlackBerry Enterprise Server.............................................................................................7 2 Planning a BlackBerry Enterprise Server........................................................................................... 8 Supported BlackBerry Enterprise Server versions that you can upgrade ............................................................................... 8 Replacing the BlackBerry Manager with the BlackBerry Administration Service ...
Permit meeting requests from outside of your organization when using Microsoft Exchange Web Services for Microsoft Exchange 2010............................................................................................................................................35 Configuring a Microsoft Exchange 2007 messaging environment........................................................................................ 35 Create a Windows account that has a Microsoft Exchange 2007 mailbox ......................
Specifying a name for the BlackBerry Administration Service pool during the installation process................................. 62 Upgrade the BlackBerry Enterprise Server instances that you configured for disaster recovery............................................ 62 7 Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database..............................................................................
There is a problem with this website's security certificate.............................................................................................90 Change applications to support BlackBerry MDS Connection Service failover...................................................................... 91 Configuring support for new attachments ..........................................................................................................................
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 smartphones. The BlackBerry Enterprise Server integrates with your organization's existing infrastructure to provide smartphone users with mobile access to your organization's resources.
Upgrade Guide Planning a BlackBerry Enterprise Server Planning a BlackBerry Enterprise Server 2 If your organization's environment includes only one BlackBerry Enterprise Server that is version 5.0 SP2 or later, you can upgrade the BlackBerry Enterprise Server to the latest version by overwriting it or by installing it on a different computer and moving the user data to the upgraded BlackBerry Enterprise Server.
Upgrade Guide Planning a BlackBerry Enterprise Server Replacing the BlackBerry Manager with the BlackBerry Administration Service In BlackBerry Enterprise Server versions later than version 4.1, the BlackBerry Administration Service replaces the BlackBerry Manager as the BlackBerry Enterprise Server component that you use to manage the BlackBerry Enterprise Server and BlackBerry device users. During the BlackBerry Enterprise Server upgrade process, the setup application removes the BlackBerry Manager.
Upgrade Guide Planning a BlackBerry Enterprise Server Upgrade implications for the BlackBerry Configuration Database When you upgrade the BlackBerry Enterprise Server to the latest version, you must also upgrade the BlackBerry Configuration Database to the latest version. You can use the setup application to install or upgrade BlackBerry Enterprise Server components such as the BlackBerry Configuration Database.
Upgrade Guide Planning a BlackBerry Enterprise Server When you upgrade the BlackBerry Enterprise Server to the latest version, corrective calendar synchronization is turned on by default. Corrective calendar synchronization is configured to run daily at 12:00 AM for all users whose devices are turned on. It checks users' calendars to correct any differences that display for the next seven days between calendars on devices and calendars in email applications.
Upgrade Guide • Planning a BlackBerry Enterprise Server cutover process that creates a BlackBerry Configuration Database If you use the in-place upgrade process, the BlackBerry MVS is not available to BlackBerry device users during the upgrade process. When the in-place upgrade process is complete, the BlackBerry MVS resumes automatically. If you use a cutover process to upgrade the BlackBerry Enterprise Server, you must perform several additional actions before the BlackBerry MVS is available to users.
Upgrade Guide Hardware requirements: BlackBerry Enterprise Server 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. The requirements are for a BlackBerry Enterprise Server environment that includes users that receive 100 to 200 email messages each day.
Upgrade Guide Hardware requirements: BlackBerry Enterprise Server Item Requirement BlackBerry Enterprise Server that supports up to 1000 users • Two processors, 2.
Upgrade Guide System requirements 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 System requirements Item Requirement CDO library To support the latest version of Microsoft Exchange Server in your organization's environment, the latest version of the CDO library that applies to the Microsoft Exchange Server version Unicode support for calendars To support Microsoft Exchange Server 2003, the following Microsoft hotfixes: • 913643 on the messaging server • 923537 on the computer that hosts the BlackBerry Enterprise Server static IP address for the computer To ins
Upgrade Guide System requirements Item Requirement operating system Any of the following operating systems: • Windows Server 2003 SP2 (32-bit or 64-bit) • Windows Server 2003 R2 SP2 (32-bit or 64-bit) • Windows Server 2008 SP2 (32-bit or 64-bit) • Windows Server 2008 R2 • Windows Server 2008 R2 SP1 • Windows Server 2012 • Microsoft hotfix 955839 installed on the computer that hosts the BlackBerry Administration Service and BlackBerry Web Desktop Manager memory A minimum 1.
Upgrade Guide Item collation setting database connectivity System requirements Requirement • Microsoft SQL Server 2008 R2 (32-bit or 64-bit) • Microsoft SQL Server 2008 R2 SP1 (32-bit or 64-bit) • Microsoft SQL Server 2008 R2 SP2 (32-bit or 64-bit) • Microsoft SQL Server 2008 Express SP3 (32-bit or 64-bit) • Microsoft SQL Server 2008 R2 Express SP1 (32-bit or 64-bit) • Microsoft SQL Server 2008 R2 Express SP2 (32-bit or 64-bit) • Microsoft SQL Server 2012 (32-bit or 64-bit) To configure c
Upgrade Guide Item database transactional replication System requirements Requirement • Microsoft SQL Server 2008 SP1 Enterprise Edition or Standard Edition (32-bit or 64-bit) • Microsoft SQL Server 2008 SP2 Enterprise Edition or Standard Edition (32-bit or 64-bit) • Microsoft SQL Server 2008 R2 Enterprise Edition or Standard Edition (32-bit or 64-bit) • the mirror database must reside on a different computer from the principal database • the Microsoft SQL Server instances for both the principa
Upgrade Guide Item media player browser System requirements Requirement • Windows Server 2003 SP2 (32-bit or 64-bit) • Windows Server 2003 R2 SP2 (32-bit or 64-bit) • Windows Server 2008 SP2 (32-bit or 64-bit) • Windows Server 2008 R2 • Windows Server 2008 R2 SP1 • Windows Server 2012 One of the following: • if using Windows Server 2008, to support audio attachments, Windows Media Format SDK (for more information, visit msdn.microsoft.
Upgrade Guide Item System requirements Requirement • Windows Server 2012 IBM Sametime IP address of the computer that hosts the BlackBerry Collaboration Service added to the CommunityConnectivity document on the IBM Sametime server Novell GroupWise Messenger SSL authentication turned on for the Novell GroupWise Messenger agents on the Novell GroupWise Messenger server Microsoft Office Live Communications Server 2005 or Microsoft Office Communications Server 2007 The latest Microsoft hotfixes insta
Upgrade Guide Item System requirements Requirement • Microsoft Unified Communications Managed API 2.0 Core Redist 64-bit (ucmaredist.msi) • Microsoft Office Communications Server 2007 R2, Core Components (ocscore.
Upgrade Guide Item System requirements Requirement • Microsoft SQL Server Native Client (sqlncli_x64.msi) • Microsoft Unified Communications Managed API 2.0 Core Redist 64-bit (to download ucmaredist.msi, visit the Volume Licensing Service Center at www.microsoft.com) • Microsoft Office Communications Server 2007 R2, Core Components (to download ocscore.msi, visit the Volume Licensing Service Center at www.microsoft.
Upgrade Guide Item System requirements Requirement • if you install a central push server and less than 1000 user accounts, a minimum of 1024 MB • if you install a central push server and more than 1000 user accounts, a minimum of 3 GB • if you do not install a central push server, a minimum of 512 MB System requirements: BlackBerry Router To install the BlackBerry Router on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server, any of the following operating sys
Upgrade Guide System requirements Item Requirement application server For the BlackBerry MDS Connection Service to support Integrated Windows authentication, Microsoft IIS 6.0 or 7.
Upgrade Guide Item System requirements Requirement • Automatic prompting for Microsoft ActiveX controls • Download signed Microsoft ActiveX controls • Run Microsoft ActiveX controls and plug-ins • Script Microsoft ActiveX controls marked safe for scripting • support for JavaScript • cookies turned on • support for TLS or SSL • the SSL certificate installed to permit trusted connections to the BlackBerry Administration Service • if using Windows Vista, the BlackBerry Administration Servic
Upgrade Guide System requirements System requirements: Messaging server Any of the following messaging servers that are located in close proximity to where you want to install the primary BlackBerry Enterprise Server: • Microsoft Exchange 2010 SP1 Multi-Tenant Deployment is supported with the following conditions: • Microsoft Exchange Server 2010 SP1 Update Rollup 3 • To manage calendars, enable Microsoft Exchange Web Services • Configure the BlackBerry Enterprise Server to run without public folder
Upgrade Guide System requirements System requirements: Instant messaging server To install the BlackBerry Enterprise Server, any of the following instant messaging servers: • IBM Sametime 7.0 Community Server • IBM Sametime 7.5 Community Server • IBM Sametime 8.0 Community Server • IBM Sametime 8.0.1 Community Server • IBM Sametime 8.0.2 Community Server • IBM Sametime 8.
Upgrade Guide System requirements Unsupported environments Item Description DMZ The BlackBerry Enterprise Server and BlackBerry Enterprise Server components, with the exception of the BlackBerry Router, do not support installation in a DMZ. messaging server The BlackBerry Enterprise Server for Microsoft Exchange (and all BlackBerry Enterprise Server components) does not support installation on the computer that hosts the messaging server.
Upgrade Guide Item System requirements Description Communications Server 2007 R2. For more information, visit the Volume Licensing Service Center at www.microsoft.com. BlackBerry Attachment Service You must install the software update for KB22953 on Windows Server 2008 if you want the BlackBerry Attachment Service to support .mp3 audio files on BlackBerry devices and all audio formats on BlackBerry 7100 Series devices that support CDMA networks. To download the software update for KB22953, visit www.
Upgrade Guide Preupgrade tasks Preupgrade tasks 5 Configuring a Microsoft Exchange 2010 messaging environment Create a Windows account that has a Microsoft Exchange 2010 mailbox You must create a Windows account with a Microsoft Exchange 2010 mailbox so that the Windows account can authenticate with the Microsoft Exchange Server.
Upgrade Guide Preupgrade tasks Configure Microsoft Exchange 2010 permissions for the Windows account Before you begin: Verify the domain name in Microsoft Active Directory. When you set the permissions, you must match the domain name in Microsoft Active Directory. 1. On a computer that hosts the Microsoft Exchange Management Shell, open the Microsoft Exchange Management Shell. 2.
Upgrade Guide Preupgrade tasks Before you begin: You must complete this task if the messaging server that the BlackBerry Enterprise Server uses is Microsoft Exchange 2010. If the messaging server is Microsoft Exchange 2010 SP1, you can change the MaxSessionsPerUser settings using client throttling policies. 1. On the computer that hosts the Microsoft Exchange CAS server, in :\Program Files\Microsoft\Exchange Server \V14\Bin, in a text editor, open the microsoft.exchange.addressbook.service.exe.
Upgrade Guide • Preupgrade tasks To enable a service account for all users in an organization, type the following command: New-ManagementRoleAssignment -Name: -Role ApplicationImpersonation -User: • To create a management scope for a specific group, type the following command: New-ManagementScope -Name: –RecipientRestrictionFilter: RecipientRoot: • To enable a service account for all users in a scope, type the following command: New
Upgrade Guide Preupgrade tasks Permit meeting requests from outside of your organization when using Microsoft Exchange Web Services for Microsoft Exchange 2010 By default, the BlackBerry Enterprise Server uses Microsoft Exchange Web Services to manage calendars on BlackBerry devices.
Upgrade Guide 4. Preupgrade tasks To permit the BlackBerry Enterprise Server to check if a user has permissions for a public folder, assign the Owner permission for all public folders to the administrator account. After you finish: • To verify that you created the Windows account, log in to a computer using the Windows account. • Verify that the Windows account is not a member of the Domain Administrators group in Microsoft Active Directory.
Upgrade Guide Preupgrade tasks 1. Log in to a computer in the Windows domain as an administrator that has permissions to change user objects in Microsoft Active Directory. 2. On the taskbar, click Start > Administrative Tools > Active Directory Users and Computers. 3. On the View menu, click Advanced Features. 4. Right-click the domain root. Click Properties. 5. On the Security tab, click Advanced. 6. Click Add. 7. Type the name of the Windows account that you created (for example, BESAdmin).
Upgrade Guide Preupgrade tasks Configuring a Microsoft Exchange 2003 messaging environment Create a Windows account that has a Microsoft Exchange 2003 mailbox You must create a Windows account that has a Microsoft Exchange 2003 mailbox so that the Windows account can authenticate with the Microsoft Exchange messaging server. 1. On any computer in the Windows domain, on the taskbar, click Start > Programs > Microsoft Exchange > Active Directory Users and Computers. 2.
Upgrade Guide Preupgrade tasks This task describes how to configure the Microsoft Exchange permissions at the administrative group level for every Microsoft Exchange 2003 server that hosts BlackBerry device users but you can also configure the permissions at other levels, such as at the root of the organization or another administrative group. 1. On the computer that hosts the Microsoft Exchange 2003 System Manager, open the Microsoft Exchange 2003 System Manager. 2.
Upgrade Guide 9. Preupgrade tasks Click OK. 10. Perform one of the following actions: • If you are running Windows Server 2003, in the Apply drop-down list, click User Objects. • If you are running Windows Server 2008, in the Apply drop-down list, click Descendant User Objects. 11. In the Allow column, select the Send As check box. 12. Click Apply. 13. Click OK.
Upgrade Guide Preupgrade tasks 13. Add the Windows account to the local administrators group. Prevent the Microsoft Exchange known issues for wireless calendar synchronization Some known issues for Microsoft Exchange impact how the BlackBerry Enterprise Server synchronizes calendars over the wireless network. To prevent the known issues from occurring, you can read about the known issues for Microsoft Exchange that might impact your organization's messaging environment and install the hotfixes for them.
Upgrade Guide 5. In the Profile Name drop-down list, select the profile names for the user accounts. 6. Click OK. 7. In the left pane, select the user accounts that you want to check. 8. Click Select. 9. Click OK. Preupgrade tasks Configuring connections for the BlackBerry Enterprise Server database The database for the BlackBerry Enterprise Server is the BlackBerry Configuration Database.
Upgrade Guide Preupgrade tasks Specifying permissions for the Windows account or Microsoft SQL Server account If you install Microsoft SQL Server 2008 R2 Express Edition during the BlackBerry Enterprise Server installation process, you might need to specify permissions for the Windows account or Microsoft SQL Server account, depending on the type of authentication you select.
Upgrade Guide Preupgrade tasks or Microsoft SQL Server account that you use to complete the BlackBerry Enterprise Server installation process. If you want the setup application to install the BlackBerry database notification system, you must assign the Microsoft SQL Server permission for the database system administrator (also called the sysadmin server role in Microsoft SQL Server Management Studio) to the Windows account or Microsoft SQL Server account.
Upgrade Guide Preupgrade tasks Backing up the BlackBerry Enterprise Server databases You must back up the BlackBerry Enterprise Server databases so that you can restore them if the BlackBerry Enterprise Server upgrade process does not complete. If your organization's environment includes Microsoft SQL Server, use the backup and restore tools that Microsoft provides to back up the BlackBerry Enterprise Server databases.
Upgrade Guide Parameter Preupgrade tasks Description If you specify a folder, it must already exist. The default folder is the current folder location. [-S] This parameter specifies the name of the computer that hosts the BlackBerry Enterprise Server database. [-E] This parameter specifies that you want to use Windows authentication instead of database authentication to connect to the database server. Your login account must have the database owner permission.
Upgrade Guide Preupgrade tasks 2. After you finish, you must remove the BlackBerry MDS Integration Service component information from the BlackBerry Configuration Database using the BlackBerry Administration Service • You can run the CreateDB executable that is included with the BlackBerry Enterprise Server 5.0 SP4 installation files For more information, visit www.blackberry.com/btsc to read artcle KB25012.
Upgrade Guide Preupgrade tasks BESMgmt.cfg properties Property Description CMD This property specifies the type of action that the CreateDB executable must complete (for example, whether to install or upgrade the BlackBerry Configuration Database). DATABASE_NAME This property specifies the name of the BlackBerry Configuration Database. SERVER This property specifies the name of the database server that hosts the BlackBerry Configuration Database.
Upgrade Guide Preupgrade tasks BlackBerry Administration Service console and you cannot use the BlackBerry Administration Service to configure the IT policy rules. To configure VoIP for BlackBerry device users, you must use the BlackBerry Mobile Voice System. If your organization's environment includes VoIP profiles or VoIP IT policy rules that you configured, the upgrade process removes the VoIP profiles when you upgrade to BlackBerry Enterprise Server 5.0 SP3 and later.
Upgrade Guide 3. Select the Simple Network Management Protocol check box. 4. Click OK. 5. When Windows Setup prompts you, install the files from the Windows installation media. 6. Complete the installation wizard. 7. In the Windows Services, verify that the SNMP service is running.
Upgrade Guide • Preupgrade tasks You can provide administrators and users in your organization's environment with URLs that include the FQDNs of the computers that you installed the BlackBerry Administration Service or BlackBerry Web Desktop Manager on (for example, https:///webconsole/login or https:///webdesktop/login).
Upgrade Guide Preupgrade tasks Preparing the computer that hosts the BlackBerry Collaboration Service for use with Microsoft Office Communications Server 2007 R2 If you plan to install the BlackBerry Collaboration Service for use with Microsoft Office Communications Server 2007 R2, you must verify that the computer that you install the BlackBerry Collaboration Service on includes the required items.
Upgrade Guide Preupgrade tasks Preparing the computer that hosts the BlackBerry Collaboration Service for use with Microsoft Lync Server 2010 If you plan to install the BlackBerry Collaboration Service for use with Microsoft Lync Server 2010, you must verify that the computer that you install the BlackBerry Collaboration Service on includes the required items. Before you install the BlackBerry Collaboration Service, you must perform the following actions in the order that they are listed below: 1.
Upgrade Guide Preupgrade tasks Applications that are installed with the BlackBerry Enterprise Server components You can use the BlackBerry Enterprise Server installation process to install third-party applications. Application BlackBerry Enterprise Server components that the application is installed with JDK 1.6.
Upgrade Guide Preupgrade tasks Prerequisites: Upgrading the BlackBerry Enterprise Server software • The BlackBerry Configuration Database and all BlackBerry Administration Service instances in the BlackBerry Enterprise Server domain must run the same version of the BlackBerry Enterprise Server software.
Upgrade Guide Preupgrade tasks 5.0 SP1 and later, the setup application installs the BlackBerry Administration API automatically when the setup application installs the BlackBerry Administration Service. • Close all BlackBerry Manager instances in the BlackBerry Enterprise Server domain and do not open the instances again. If you run the BlackBerry Manager with BlackBerry Enterprise Server 5.0 and later, you might experience issues with the BlackBerry Configuration Database.
Upgrade Guide Preupgrade tasks Perform a test upgrade of the BlackBerry Configuration Database Before you begin: Verify that you configured the appropriate permissions on the database server that you want to perform a test upgrade of the BlackBerry Configuration Database on. 1. Log in to the computer that hosts the BlackBerry Configuration Database using a local administrator account or a Windows account that has SQL administrator permissions. 2. Back up the BlackBerry Configuration Database. 3.
Upgrade Guide Preupgrade tasks Property Description USERID If you use database authentication, this property specifies the user name of the database account that has server administrator permission and database creator permission. PASSWORD If you use database authentication, this property specifies the password for the database account. SCRIPT_ROOT This property specifies the path to the DBInstallScripts folder. By default, this folder is in the same root folder that the CreateDB.
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 Upgrading the BlackBerry Enterprise Server software by using the in-place upgrade process Upgrade the BlackBerry Enterprise Server software by overwriting the existing version and retaining the existing BlackBerry Configuration Database The in-place upgrade process requires that you restart the computer. During the BlackBerry Enterprise Server installation process, you must restart the computer.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software by using the in-place upgrade process the mirror Microsoft SQL Server; it adds a registry key to the computer that includes the name of the mirror Microsoft SQL Server. 6. In the MAPI Settings dialog box, perform the following actions: a. In the Microsoft Exchange server field, type the name of the Microsoft Exchange server. b. In the Mailbox field, type the name of the administrator that has the appropriate permissions. c.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software by using the in-place upgrade process 14. Start the services for the BlackBerry Enterprise Server. If you installed the BlackBerry Administration Service, the setup application waits until the BlackBerry Administration Service services are running before the setup application continues. 15.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software by using the in-place upgrade process 1. Upgrade the standby BlackBerry Enterprise Server using the in-place upgrade process. During the upgrade process, do not verify the SRP credentials or start the BlackBerry Enterprise Server services so that you do not deactivate the SRP credentials. 2. Stop BlackBerry Enterprise Server so that you can start a manual failover process. 3.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database 7 You can use the cutover upgrade process to 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 Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database Upgrade a BlackBerry Configuration Database If you are not a database administrator and you do not have permissions to modify the BlackBerry Configuration Database, you can request that a database administrator with the appropriate permissions upgrades the BlackBerry Configuration Database before you run the setup application and upgrade the BlackBerry Ent
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database Property Description USERID If you use database authentication, this property specifies the user name of the database account that has server administrator permission and database creator permission. PASSWORD If you use database authentication, this property specifies the password for the database account.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database • Document the existing software configurations before you start the upgrade process so that you can create the software configurations again after the upgrade process is complete. For more information, see the BlackBerry Enterprise Server Administration Guide.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database BlackBerry Administration Service instance in the BlackBerry Enterprise Server domain, you must create a DNS entry for the pool name that is not the name of a computer and is mapped to the IP address of each BlackBerry Administration Service instance. b.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database The name for the BlackBerry Administration Service pool does not impact BlackBerry Administration Service high availability that uses a hardware load balancer. For more information about BlackBerry Administration Service high availability, see the BlackBerry Enterprise Server Planning Guide.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and upgrading the existing BlackBerry Configuration Database Prevent the previous BlackBerry Enterprise Server from connecting to the BlackBerry Infrastructure If you try to connect two BlackBerry Enterprise Server instances to the BlackBerry Infrastructure using identical SRP credentials, the BlackBerry Infrastructure deactivates the credentials, and wireless traffic stops. 1.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and creating a BlackBerry Configuration Database Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and creating 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.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and creating a BlackBerry Configuration Database Create a BlackBerry Configuration Database If the security required by your organization does not allow applications to have permissions to create or upgrade databases, you can run the CreateDB executable on the database server to create the BlackBerry Configuration Database instead of using the setup application.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and creating a BlackBerry Configuration Database Property Description SERVER This property specifies the name of the database server that hosts the BlackBerry Configuration Database. If a database instance hosts the BlackBerry Configuration Database, follow the format database_server_name\database_instance_name.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and creating a BlackBerry Configuration Database populates the BlackBerry Configuration Database if you did not create the BlackBerry Configuration Database previously using the SQL scripts.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and creating a BlackBerry Configuration Database a. In the Pool name field, type an FQDN that the setup application can use to create the BlackBerry Administration Service web address. If you install only one BlackBerry Administration Service instance in the BlackBerry Enterprise Server domain, you can accept the default pool name.
Upgrade Guide Upgrading the BlackBerry Enterprise Server using the cutover upgrade process and creating a BlackBerry Configuration Database The setup application uses the FQDN of the computer that you install the first BlackBerry Administration Service instance on as the default value for the pool name.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software in phases Upgrading the BlackBerry Enterprise Server software in phases 9 If you use 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 phased upgrade process, all BlackBerry devices receive new IT policies.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software in phases Upgrade multiple BlackBerry Enterprise Server instances in phases You can upgrade the BlackBerry Enterprise Server instances in your organization's environment in phases to minimize the impact on users. Before you begin: If you want to create a new BlackBerry Configuration Database, instruct users to back up their BlackBerry devices.
Upgrade Guide Upgrading the BlackBerry Enterprise Server software in phases Upgrade a standalone BlackBerry Router Note: You cannot manage the BlackBerry Controller that monitors a standalone BlackBerry Router in the BlackBerry Administration Service. You must manage the BlackBerry Controller in the BlackBerry Configuration Panel on the computer that hosts the standalone BlackBerry Router. 1. Log in to the computer using the Windows account that you want to use to run the BlackBerry Router. 2.
Upgrade Guide Postupgrade tasks Postupgrade tasks 10 Resend the database mirroring parameters to BlackBerry Enterprise Server components If the computers that host BlackBerry Enterprise Server components were not running or connected to the network when you configured the BlackBerry Enterprise Solution to support database mirroring, or if you do not know if all of the components were configured to support database mirroring, you should resend the database mirroring parameters to the components.
Upgrade Guide Postupgrade tasks Restore the BlackBerry MDS Connection Service configuration files You can use the BlackBerry MDS Connection Service configuration files, MdsLogin.conf and krb5.conf, to configure how the BlackBerry MDS Connection Service authenticates BlackBerry devices with content servers that use NTLM or Kerberos. The BlackBerry MDS Connection Service configuration files are located in :\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\Servers\Instance\config.
Upgrade Guide Postupgrade tasks 3. Open the Microsoft SQL Server Management Studio. 4. Using the Microsoft SQL Server Management Studio, navigate to Database\DBInstallScripts\SQLServer\5.0 in the BlackBerry Enterprise Server installation files. 5. Open the NotifyMasterInstall.sql file. 6. Run the script. 7. Open the NotifyInstall.sql file. 8. Change <_DATABASENAME_> to the name of the BlackBerry Configuration Database (for example, BesMgmt). 9. Run the script. 10.
Upgrade Guide Best practice Postupgrade tasks Description • Log in to the computer with a user account that is in the Administrator group on the Windows Server. • Right-click the BlackBerry Configuration Panel icon and click Run as administrator.
Upgrade Guide 8. • JP for Japanese • KR for Korean Postupgrade tasks In the Windows Services, restart the BlackBerry Dispatcher. Change the character encoding that the BlackBerry Enterprise Server uses to send Unicode messages By default, when the BlackBerry Enterprise Server receives Unicode messages from BlackBerry devices, it uses UTF-8 character encoding to process the Unicode messages.
Upgrade Guide Postupgrade tasks Configure the BlackBerry Enterprise Server to use only UTF-8 to send Unicode messages To make sure that the BlackBerry Enterprise Server uses only UTF-8 character encoding to process Unicode messages that it receives from BlackBerry devices, complete the following steps. 1. On the computer that hosts the BlackBerry Enterprise Server, on the taskbar, click Start > Run. 2. Type regedit. 3. Click OK. 4.
Upgrade Guide 2. Type regedit. 3. Click OK. 4. Perform one of the following actions: Postupgrade tasks • If you are running a 32-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion \BlackBerry Enterprise Server\Agents. • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node \Research In Motion\BlackBerry Enterprise Server\Agents. 5. Create a DWORD value that is named SetLocaleIDs. 6. Set the value to 1. 7.
Upgrade Guide Postupgrade tasks Prerequisites: Configuring the BlackBerry Enterprise Server to use Microsoft Exchange Web Services • Install an SSL certificate on a BlackBerry Enterprise Server so that the BlackBerry Enterprise Server can communicate with Microsoft Exchange Web Services. You must export the SSL certificate from the client access server for Microsoft Exchange and import the SSL certificate to the BlackBerry Enterprise Server.
Upgrade Guide • 5. Postupgrade tasks To configure all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances to use Microsoft Exchange Web Services, type traittool -global -trait EWSEnable -set true. Restart the BlackBerry Messaging Agent instances that you made changes to. After you finish: In the logs folder verify that the file named _CALH__.txt appears.
Upgrade Guide Postupgrade tasks Configure a Hosted BlackBerry services environment for use with Microsoft Exchange 2010 SP1 Multi-Tenant Deployment 1. Verify that you configured the Microsoft Exchange 2010 messaging environment and completed the tasks "Configure a management role for Microsoft Exchange Web Services" and "Configure the BlackBerry Enterprise Server to run without public folders". For more information, see "Configuring a Microsoft Exchange 2010 messaging environment". 2.
Upgrade Guide 4. In the BlackBerry Administration Service pool drop-down list, click TCP with TCP PING. 5. Click Save all. 6. Restart the BlackBerry Administration Service instances. Postupgrade tasks 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 Postupgrade tasks 4. On the Security tab, click Local Intranet. 5. Click Sites. 6. Click Add to add the console to the list of trusted web sites. 7. Click Close. 8. Click OK. 9. In the browser window, on the toolbar, click Certificate Error. 10. Click View certificates. 11. Click Install certificate. The Certificate Import Wizard opens. 12. Complete the instructions in the Certificate Import Wizard.
Upgrade Guide Postupgrade tasks • Configure a hardware load balancer. The load balancer accepts all requests from the application servers, and distributes the traffic to the various central push servers. If a central push server does not respond, the load balancer redistributes the requests to the remaining central push servers. • Configure the application to use the new HTTP response header x-rim-push-gateways.
Upgrade Guide Postupgrade tasks 2. Click the instance that you upgraded. 3. Click Edit instance. 4. In the Distiller section, in the Allowed column, turn on the attachment distillers that you want the BlackBerry Attachment Service to support. 5. If required, in the Distiller section, in the Attachment size (KB) column, change the attachment size, in KB, for the new attachments. 6. Click Save.
Upgrade Guide Postupgrade tasks Configuring a computer for monitoring Configure the SNMP service for monitoring by a monitoring application You can configure the SNMP service on the computer that hosts the BlackBerry Enterprise Server so that the a monitoring application can monitor BlackBerry Enterprise Server activity. Before you begin: Verify that the SNMP service is installed and running. 1.
Upgrade Guide Postupgrade tasks has to the tables in the BlackBerry Configuration Database, you can configure a BlackBerry Attachment Service account that has limited database permissions. This account is not the same as the account that the BlackBerry Enterprise Server uses to access the BlackBerry Configuration Database. Before you begin: • Create a Windows account for the BlackBerry Attachment Service.
Upgrade Guide Postupgrade tasks After the installation or upgrade process completes, you can change the Microsoft SQL Server permissions of the Windows account to the Microsoft SQL Server permissions that the BlackBerry Enterprise Server requires to run. When you change the Microsoft SQL Server permissions of the Windows account, you can use Microsoft SQL Server security to minimize the operations that the Windows account can perform on the BlackBerry Configuration Database.
Upgrade Guide Postupgrade tasks Provisioning the BlackBerry Collaboration Service as a trusted application If you install Microsoft Office Communications Server 2007 R2 or Microsoft Lync Server 2010 for instant messaging, you must provision the BlackBerry Collaboration Service as a trusted application in Microsoft Active Directory.
Upgrade Guide d. 4. Postupgrade tasks Click Provision BCS. In the Windows Services, restart the BlackBerry Collaboration Service.
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 Troubleshooting the BlackBerry Enterprise Server upgrade process 3. Click OK. 4. In the left pane, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server \Database. 5. If necessary, create case-sensitive strings that you name DatabaseName and DatabaseServerMachineName. 6. Specify the name of the BlackBerry Configuration Database as the value for DatabaseName. 7. Specify the FQDN name of the database server as the value for DatabaseServerMachineName. 8.
Upgrade Guide Troubleshooting the BlackBerry Enterprise Server upgrade process A third-party tool did not install and the BlackBerry Enterprise Server setup application closed Possible solution 1. On the BlackBerry Enterprise Server installation media, open the Tools folder. 2. Double-click the setup application file for the tool that you want to install. 3. Complete the instructions on the screen. 4. Restart the BlackBerry Enterprise Server setup application.
Upgrade Guide Troubleshooting the BlackBerry Enterprise Server upgrade process The setup application did not prompt you to change or confirm the MAPI profile Possible solution Create and change the MAPI profile manually. 1. On the BlackBerry Enterprise Server installation media, open the Tools folder. 2. Double-click the Fixmapisvc.exe file. 3. Verify that mapisvc.inf is installed in C:\winnt\system32\ or C:\windows\system32\. 4.
Upgrade Guide Troubleshooting the BlackBerry Enterprise Server upgrade process Users experience unexpected behavior with message lists and calendars on BlackBerry devices Possible cause If the MAPI and CDO client version 6.5.8022 was installed without uninstalling previous versions of the MAPI and CDO client (including the associated .DLL files), users might experience unexpected behavior with message lists and calendars on BlackBerry devices.
Upgrade Guide Troubleshooting the BlackBerry Enterprise Server upgrade process the MAPI and CDO client. The setup application displays this error message because you installed the MAPI and CDO client version 6.5.8022 in a different directory than the directory that you installed it in for previous versions. The error message does not prevent the BlackBerry Enterprise Server setup application from completing the installation process successfully.
Upgrade Guide Possible cause Troubleshooting the BlackBerry Enterprise Server upgrade process Possible solution 6. In the Windows Services, restart the services for the BlackBerry Enterprise Server component.
Upgrade Guide Possible cause Troubleshooting the BlackBerry Enterprise Server upgrade process Possible solution 5. In the Windows Services, restart the services for the BlackBerry Administration Service. The BlackBerry Administration Service pool name is the same as the FQDN of the host computer Possible cause A DNS record was not created before a BlackBerry Administration Service instance was installed. Possible solution 1. Create the DNS record for the BlackBerry Administration Service instance. 2.
Upgrade Guide Troubleshooting the BlackBerry Enterprise Server upgrade process If a BlackBerry Enterprise Server instance exists in a child domain, users from the parent and parallel domains are not populated by default. When you attempt to add a user in the BlackBerry Administration Service using your organization’s directory after an upgrade to BlackBerry Enterprise Server 5.
Upgrade Guide Troubleshooting the BlackBerry Enterprise Server upgrade process 2. Type regedit and click OK. If the User Account Control dialog appears, click Continue. 3. Navigate to the appropriate location (depending on the version of Windows Server): • HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents • HKEY_LOCAL_MACHINE\Software\WOW6432Node\Research In Motion\BlackBerry Enterprise Server\Agents 4.
Upgrade Guide Related resources Related resources 12 To read the following guides or additional related material, visit http://www.blackberry.com/go/serverdocs. Guide Information What's New in BlackBerry Enterprise Server 5.0 SP4 Job Aid • Summary of new features BlackBerry Enterprise Server Update Guide • Summary of updates to the administrator guides for BlackBerry Enterprise Server 5.
Upgrade Guide Glossary Glossary 13 AES Advanced Encryption Standard API application programming interface AJAX Asynchronous JavaScript and XML BlackBerry CAL 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 LAN A local area network (LAN) is a computer network shared by a group of computers in a small area, such as an office building. Any computer in this network can communicate with another computer that is part of the same network. MAPI Messaging Application Programming Interface messaging server A messaging server sends and processes messages and provides collaboration services, such as updating and communicating calendar and address book information.
Upgrade Guide Legal notice Legal notice 14 ©2014 BlackBerry. All rights reserved. BlackBerry® and related trademarks, names, and logos are the property of BlackBerry Limited and are registered and/or used in the U.S. and countries around the world. Safari is a trademark of Apple Inc. Google Chrome is a trademark of Google Inc. IBM, Lotus, and Sametime are trademarks of International Business Machines Corporation. Intel and Xeon are trademarks of Intel Corporation.
Upgrade Guide Legal notice 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 separate licenses and other agreements applicable thereto with third parties, except to the extent expressly covered by a license or other agreement with BlackBerry. 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 BlackBerry product or service are set out in a separate license or other agreement with BlackBerry applicable thereto.
