Installation and Configuration Guide BlackBerry Enterprise Server for IBM Domino Version: 5.0
Add to my manuals89 Pages
advertisement
BlackBerry Enterprise Server for IBM
Domino
Version: 5.0
Service Pack: 4
Installation and Configuration Guide
Published: 2014-01-14
SWD-20140114173558876
3
4
5
1
2
Contents
7
8
6
9
10
11
12
13
14
6
Installation and Configuration 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.
You can manage the BlackBerry Enterprise Server, smartphones, and user accounts using the BlackBerry Administration
Service. You can access the BlackBerry Administration Service web application from any computer that can access the computer that hosts the BlackBerry Administration Service.
You can optionally install BlackBerry Management Studio in your organization's environment to provide a simplified administrative console for your organization's helpdesk administrators and an integrated view of the BlackBerry Enterprise
Server and other MDM domains. For more information, visit http://www.blackberry.com/go/serverdocs to see the
BlackBerry Management Studio Feature and Technical Overview.
Installation and Configuration Guide Planning a BlackBerry Enterprise Server installation
Planning a BlackBerry
Enterprise Server installation
2
You can install all BlackBerry Enterprise Server components on one computer, or you can install specific components on separate computers. You should consider any impact to system resources before you decide where to install the components.
You install all components on one computer if you do not plan to activate many BlackBerry devices, if you determine that the computer can manage the volume of traffic for the BlackBerry Enterprise Server components, and if it is acceptable that the computer has direct access to the Internet, without being located in the DMZ.
If you want to configure high availability, you must install an additional BlackBerry Enterprise Server on a computer that is separate from the computer that hosts the primary BlackBerry Enterprise Server. During the installation process, you specify that the duplicate BlackBerry Enterprise Server is the standby BlackBerry Enterprise Server.
For performance information, see the BlackBerry Enterprise Server Performance Benchmarking Guide.
For more information about high availability, see the BlackBerry Enterprise Server Planning Guide.
Installing all BlackBerry Enterprise Server components on one computer
If you want to evaluate the BlackBerry Enterprise Server or complete a BlackBerry Enterprise Server installation for a small number of users, you can install all the BlackBerry Enterprise Server components on the same computer.
During the installation process you can choose to install the BlackBerry Collaboration Service and BlackBerry Web Desktop
Manager with the BlackBerry Enterprise Server. All of the other BlackBerry Enterprise Server components are installed automatically when you install the BlackBerry Enterprise Server.
7
Installation and Configuration Guide Planning a BlackBerry Enterprise Server installation
8
Installing the BlackBerry Administration
Service
The BlackBerry Administration Service permits you to manage a BlackBerry Enterprise Server domain through a webbased application. A BlackBerry Enterprise Server domain consists of one BlackBerry Configuration Database and all
BlackBerry Enterprise Server instances and remote components that use the BlackBerry Configuration Database.
You can install the BlackBerry Administration Service with other BlackBerry Enterprise Server components or by itself on a separate computer. You can install the BlackBerry Administration Service on a separate computer to limit the impact that the BlackBerry Administration Service might have on system resources and to prevent administrators in your organization from accessing any part of the computer that hosts the BlackBerry Enterprise Server. If you install the BlackBerry
Administration Service before you install a BlackBerry Enterprise Server, the installation process will complete successfully but it will not function properly until the BlackBerry Enterprise Server is installed.
When you install the BlackBerry Administration Service, you can install the BlackBerry Web Desktop Manager and select whether you want administrators to use Windows authentication, IBM Domino authentication, or BlackBerry
Administration Service authentication to log in to the BlackBerry Administration Service. You must verify that all administrators have access to the BlackBerry Administration Service web address (https://<computer_name>:<port>/ webconsole/app).
Installing the BlackBerry Attachment
Service
The BlackBerry Attachment Service converts supported attachments into a format that users can view on their BlackBerry devices. By default, the BlackBerry Enterprise Server includes the BlackBerry Attachment Service.
The BlackBerry Attachment Service might use increased system resources when it processes numerous conversion requests simultaneously. If you want to increase the number of conversion requests that can occur concurrently without impacting message delivery, you can install a BlackBerry Attachment Service on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server.
You can connect multiple BlackBerry Enterprise Server instances and BlackBerry MDS Connection Service instances to a
BlackBerry Attachment Service instance.
When you install the BlackBerry Attachment Service on a computer that is separate from the computer that hosts the
BlackBerry Enterprise Server, the installation process installs the BlackBerry Attachment Service and BlackBerry
Controller. The BlackBerry Controller monitors the BlackBerry Attachment Service and restarts it if it stops responding.
Installation and Configuration Guide Planning a BlackBerry Enterprise Server installation
Installing the BlackBerry Collaboration
Service
The BlackBerry Collaboration Service provides an encrypted connection between your organization's instant messaging server and the collaboration client on BlackBerry devices so that BlackBerry device users can start and manage instant messaging conversations on their devices.
If you want to maximize the number of sockets available so that the BlackBerry Collaboration Service can respond to an increased amount of requests from the collaboration client, you can install the BlackBerry Collaboration Service by itself on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server. (Microsoft Office
Communications Server 2007 R2 and Microsoft Lync Server 2010 do not use persistent socket connections.)
If you install the BlackBerry Collaboration Service on a separate computer, the installation process installs the BlackBerry
Collaboration Service and BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry Collaboration Service and restarts it if it stops responding.
You can connect multiple BlackBerry Enterprise Server instances to a BlackBerry Collaboration Service instance.
A different type of BlackBerry Collaboration Service exists for each instant messaging environment. For example, a
BlackBerry Collaboration Service exists for Microsoft Office Communications Server 2007, and a different BlackBerry
Collaboration Service exists for IBM Sametime. You can install only one type of BlackBerry Collaboration Service for each
BlackBerry Enterprise Server in your organization's environment. Users can use only one type of collaboration client on their devices.
Installing the BlackBerry MDS Connection
Service
The BlackBerry MDS Connection Service provides users with access to online content and applications on your organization's intranet or the Internet. By default, the BlackBerry Enterprise Server includes the BlackBerry MDS
Connection Service.
The BlackBerry MDS Connection Service might use increased system resources when it processes content requests. If you want to minimize the impact this has on message delivery, you can install the BlackBerry MDS Connection Service by itself on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server.
You can connect multiple BlackBerry Enterprise Server instances to a BlackBerry MDS Connection Service instance.
When you install the BlackBerry MDS Connection Service on a separate computer, you must assign at least one BlackBerry
Enterprise Server instance to it during the installation process. The BlackBerry MDS Connection Service uses the
BlackBerry Enterprise Server information to connect to the BlackBerry Attachment Service.
9
10
Installation and Configuration Guide Planning a BlackBerry Enterprise Server installation
When you install the BlackBerry MDS Connection Service on a separate computer, the installation process installs the
BlackBerry MDS Connection Service and BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry MDS
Connection Service and restarts it if it stops responding.
Installing the BlackBerry Router
The BlackBerry Router connects to the wireless network and sends data to and from BlackBerry devices.
You can install a BlackBerry Router with other BlackBerry Enterprise Server components or by itself on a separate computer. You can install the BlackBerry Router on a computer that is separate from the computer that hosts the
BlackBerry Enterprise Server if you want to install the BlackBerry Router in the DMZ, or to install standby BlackBerry
Router instances as failover components in case the primary BlackBerry Router is unavailable.
You can connect multiple BlackBerry Enterprise Server instances to a BlackBerry Router instance.
If you install the BlackBerry Router on a separate computer, the installation process installs the BlackBerry Router and
BlackBerry Controller. The BlackBerry Controller monitors the BlackBerry Router and restarts it if it stops responding.
Installation and Configuration 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.
You can improve the performance and reliability of the BlackBerry Enterprise Server by installing the BlackBerry Enterprise
Server components on multiple computers. If your BlackBerry Enterprise Server environment supports up to 1000 users, install the BlackBerry Configuration Database on a computer that is separate from the computer that hosts the BlackBerry
Enterprise Server. If your BlackBerry Enterprise Server environment supports up to 2000 users, install the BlackBerry
Configuration Database and the BlackBerry Administration Service on computers that are separate from the computer that hosts the BlackBerry Enterprise Server.
Item
BlackBerry Enterprise Server that supports up to 200 users
Requirement
• Two processors, 2.0 GHz Intel Xeon
• 3 GB of memory
• 64-bit operating system: Two 64 GB drives (minimum), RAID 1
• 32-bit operating system: Two 36 GB drives (minimum), RAID 1
• 150 MB disk space for the BlackBerry Enterprise Server
• 400 MB disk space for the BlackBerry Administration Service
• Approximately 2 MB per user each day for log files (100 email messages per user)
BlackBerry Enterprise Server that supports up to 500 users
• Two processors, 2.8 GHz Intel Xeon
• 3 GB of memory
• 64-bit operating system: Two 64 GB drives (minimum), RAID 1 or four 64 GB drives (minimum), RAID 1+0
• 32-bit operating system: Two 36 GB drives (minimum), RAID 1 or four 36 GB drives (minimum), RAID 1+0
• 150 MB disk space for the BlackBerry Enterprise Server
• 400 MB disk space for the BlackBerry Administration Service
11
Installation and Configuration Guide
Item
BlackBerry Enterprise Server that supports up to 1000 users
BlackBerry Enterprise Server that supports up to 2000 users
Hardware requirements: BlackBerry Enterprise Server
Requirement
• Approximately 2 MB per user each day for log files (100 email messages per user)
• Single processor, 3.0 GHz Intel Xeon 5100 Series (Dual Core) or two processors, 1.6 GHz Intel Xeon 5100 Series (Dual Core)
• 4 GB of memory
• 64-bit operating system: Four 64 GB drives (minimum), RAID 1+0
• 32-bit operating system: Four 36 GB drives (minimum), RAID 1+0
• 150 MB disk space for the BlackBerry Enterprise Server
• 400 MB disk space for the BlackBerry Administration Service
• Approximately 2 MB per user each day for log files (100 email messages per user)
• 64-bit operating system recommended
• Single processor, 2.83 GHz Intel Xeon 5400 Series (Quad Core) or two processors, 3.0 GHz Intel Xeon 5100 Series (Dual Core)
• 4 GB of memory
• 64-bit operating system: Six 64 GB drives (minimum), RAID 1+0 or eight 64
GB drives (minimum), RAID 1+0
• 32-bit operating system: Six 36 GB drives (minimum), RAID 1+0 or eight 36
GB drives (minimum), RAID 1+0
• 150 MB disk space for the BlackBerry Enterprise Server
• 400 MB disk space for the BlackBerry Administration Service
• Approximately 2 MB per user each day for log files (100 email messages per user)
12
Installation and Configuration 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.
System requirements: BlackBerry
Enterprise Server
Item operating system messaging server
32-bit IBM Domino notes.ini file
Requirement
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
Any of the following servers:
• IBM Domino 8.0.2 with a primary Domino Directory
• IBM Domino 8.5.1 with a primary Domino Directory
• IBM Domino 8.5.2 with a primary Domino Directory
A 32-bit IBM Domino server, even if the operating system is a 64-bit operating system
A notes.ini file with the following conditions:
• read and write permissions
• SERVERKEYFILENAME value configured for the server.id name
13
Installation and Configuration Guide System requirements
Item partitioning of the messaging server
Requirement
A nonpartitioned messaging server on the computer that you want to install the
BlackBerry Enterprise Server on permissions for the messaging server A messaging server with the following permissions:
• membership in the LocalDomainServers group
• manager-level access to the mail files for user accounts
DIIOP task running static IP address for the computer browser media player
In your organization's environment, an IBM Domino server running the DIIOP task and, if you are using IBM Domino authentication with the BlackBerry
Administration Service or BlackBerry Web Desktop Manager, the directory assistance feature turned on
To install the BlackBerry Administration Service in a pool, a static IP address for the computer that hosts the component
Windows Internet Explorer 7.0 to 8.0 with language preferences configured to display encoded web pages
One of the following:
• if using Windows Server 2008, to support audio attachments, Windows
Media Format SDK (for more information, visit msdn.microsoft.com
and search Windows Media Format SDK)
• if using Windows Server 2003, to support audio attachments, Windows
Media Player 9 or later network proximity
File and Printer Sharing
A high-speed, switched connection between the BlackBerry Enterprise Server and messaging servers
If using Windows Server 2003, to permit the BlackBerry Controller to monitor
BlackBerry Enterprise Server components, install File and Printer Sharing
For more information, see the documentation for Windows Server
14
Installation and Configuration Guide System requirements
System requirements: BlackBerry
Administration Service and BlackBerry Web
Desktop Manager
The following system requirements apply to the computer that you install the BlackBerry Administration Service and
BlackBerry Web Desktop Manager on.
Item operating system
Requirement
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
BlackBerry Web Desktop Manager users
DIIOP task running hardware load balancer
A minimum 1.2 GB of memory
To support BlackBerry Web Desktop Manager users, the following conditions:
• Internet accounts and passwords for IBM Domino for BlackBerry Web
Desktop Manager users
• all user accounts located on the same IBM Domino server
In your organization's environment, an IBM Domino server running the DIIOP task and, if you use IBM Domino authentication with BlackBerry Administration
Service or BlackBerry Web Desktop Manager, with the directory assistance feature turned on.
If you configure high availability for the BlackBerry Administration Service using a hardware load balancer, you must implement session persistence for SSL
15
16
Installation and Configuration Guide
Item outgoing data connection
System requirements
Requirement connections. For information on how to implement session persistence, contact the vendor of your hardware load balancer.
For the BlackBerry Administration Service, an HTTPS connection using port number 443
System requirements: BlackBerry
Enterprise Server databases
Item database management system collation setting
Requirement
Any of the following database management systems:
• Microsoft SQL Server 2005 SP3 (32-bit or 64-bit)
• Microsoft SQL Server 2005 SP4 (32-bit or 64-bit)
• Microsoft SQL Server 2005 Express SP3
• Microsoft SQL Server 2008 SP2 (32-bit or 64-bit)
• Microsoft SQL Server 2008 SP3 (32-bit or 64-bit)
• 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 collation settings, the following conditions:
• database server collation configured to default case-insensitive
• BlackBerry Configuration Database collation configured to default caseinsensitive
Installation and Configuration Guide
Item database connectivity nested triggers database mirroring
System requirements
Requirement
• collation must be the same for the Microsoft SQL Server instance and the database server that hosts the BlackBerry database notification system
(BlackBerry Configuration Database)
• default collations are suggested though non-default collations are supported
(for more information, visit www.blackberry.com/go/kbhelp to read articles
KB04785 and KB15534)
• TCP/IP network protocols turned on
• No count option turned off
Nested trigger support turned on. For more information, visit msdn.microsoft.com
to read article ms178101.
To support database mirroring for the BlackBerry Configuration Database, the following conditions:
• Any of the following database management systems:
• Microsoft SQL Server 2005 SP3 Enterprise Edition or Standard Edition
(32-bit or 64-bit)
• Microsoft SQL Server 2005 SP4 Enterprise Edition or Standard Edition
(32-bit or 64-bit)
• 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 principal and mirrored databases must be the same version and edition
• only use static port number 1433
• do not use named instances
• verify that the SQL Server Browser service is running
17
18
Installation and Configuration Guide System requirements
Item database transactional replication
Requirement
• turn off the Named Pipes option in the Microsoft SQL Server Native Client on the computers that host the BlackBerry Enterprise Server instances
To support database transactional replication for the BlackBerry Configuration
Database, the following conditions:
• the database server must be Microsoft SQL Server 2005 SP3 or later
• the database server that hosts the replicated database must use the same version and build as the database server that hosts the primary database
System requirements: BlackBerry
Attachment Service
The following system requirements apply to the computer that you install the BlackBerry Attachment Service on.
Item operating system
Requirement
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 media player One of the following:
• if using Windows Server 2008, to support audio attachments, Windows
Media Format SDK (for more information, visit msdn.microsoft.com
and search Windows Media Format SDK)
• if using Windows Server 2003, to support audio attachments, Windows
Media Player 9 or later
Installation and Configuration Guide
Item browser
System requirements
Requirement
Windows Internet Explorer 7.0 to 8.0 with language preferences configured to display encoded web pages
System requirements: BlackBerry
Collaboration Service
The following system requirements apply to the computer that you install the BlackBerry Collaboration Service on.
Item operating system
Requirement
Unless otherwise stated, 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
IBM Sametime
Novell GroupWise Messenger
IP address of the computer that hosts the BlackBerry Collaboration Service added to the CommunityConnectivity document on the IBM Sametime server
SSL authentication turned on for the Novell GroupWise Messenger agents on the
Novell GroupWise Messenger server
The latest Microsoft hotfixes installed Microsoft Office Live Communications
Server 2005 or Microsoft Office
Communications Server 2007
Microsoft Office Communications
Server 2007 R2
• Any of the following operating systems:
• Windows Server 2003 R2 SP2 (64-bit)
• Windows Server 2008 SP2 (64-bit)
• Windows Server 2008 R2
19
Installation and Configuration Guide
Item
Microsoft Lync Server 2010
System requirements
Requirement
• Windows Server 2008 R2 SP1
• Windows Server 2012
• The latest Microsoft hotfixes installed
• The BlackBerry Collaboration Service installed in the same Microsoft Active
Directory domain as Microsoft Office Communications Server 2007 R2
• The Windows account that runs the BlackBerry Collaboration Service added to one of the following groups:
• RTCUniversalServerAdmins group, to automatically provision the
BlackBerry Collaboration Service as a trusted service in Microsoft Active
Directory (for more information, visit msdn.microsoft.com
to read about required Microsoft Active Directory permissions)
• RTCComponentUniversalServices group, if you use another account with the required permissions (RTCUniversalServerAdmins) to manually provision the BlackBerry Collaboration Service as a trusted service in
Microsoft Active Directory (for more information, see "Manually provision the BlackBerry Collaboration Service as a trusted application")
• Microsoft .NET Framework 3.5 SP1
• Microsoft Visual C++ 2008 Redistributable Package (vcredist_x64.exe)
• Microsoft SQL Server Native Client (sqlncli_x64.msi)
• Microsoft Unified Communications Managed API 2.0 Core Redist 64-bit
(ucmaredist.msi)
• Microsoft Office Communications Server 2007 R2, Core Components
(ocscore.msi)
• The required certificate installed in the Personal Certificate folder for the local computer account
For detailed instructions about the Microsoft install packages and installing the required certificate, see "Preparing the computer that hosts the BlackBerry
Collaboration Service for use with Microsoft Office Communications Server 2007
R2".
• Any of the following operating systems:
• Windows Server 2003 R2 SP2 (64-bit)
20
Installation and Configuration Guide
Item
System requirements
Requirement
• Windows Server 2008 SP2 (64-bit)
• Windows Server 2008 R2
• Windows Server 2008 R2 SP1
• Windows Server 2012
• The latest Microsoft hotfixes installed
• The BlackBerry Collaboration Service installed in the same Microsoft Active
Directory domain as Microsoft Lync Server 2010
• The Windows account that runs the BlackBerry Collaboration Service added to one of the following groups:
• RTCUniversalServerAdmins group, to automatically provision the
BlackBerry Collaboration Service as a trusted service in Microsoft Active
Directory (for more information, visit msdn.microsoft.com
to read about required Microsoft Active Directory permissions)
• RTCComponentUniversalServices group, if you use another account with the required permissions (RTCUniversalServerAdmins) to manually provision the BlackBerry Collaboration Service as a trusted service in
Microsoft Active Directory (for more information, see "Manually provision the BlackBerry Collaboration Service as a trusted application")
• Microsoft .NET Framework 3.5 SP1
• Microsoft Visual C++ 2008 Redistributable Package (vcredist_x64.exe)
• 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.com
)
• The required certificate installed in the Personal Certificate folder for the local computer account
For detailed instructions about the Microsoft install packages and installing the required certificate, see "Preparing the computer that hosts the BlackBerry
Collaboration Service for use with Microsoft Lync Server 2010".
21
Installation and Configuration Guide System requirements
System requirements: BlackBerry MDS
Connection Service
The following system requirements apply to the computer that you install the BlackBerry MDS Connection Service on.
Item operating system
Requirement
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
RSA Authentication Agent memory
To support enhanced network authentication (optional), RSA Authentication
Agent 6.1 for Windows Server 2003 or RSA Authentication Agent 7.0.1 for
Windows Server 2008.
One of the following:
• 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
22
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 systems:
Installation and Configuration Guide
• 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
System requirements
System requirements for your organization's environment
The following system requirements apply when you configure single sign-on authentication for the BlackBerry
Administration Service and BlackBerry Web Desktop Manager or configure the BlackBerry MDS Connection Service to support Integrated Windows authentication.
Item network services application server file server
Requirement
Microsoft Active Directory running at Windows Server 2003 domain functional level or higher
For the BlackBerry MDS Connection Service to support Integrated Windows authentication, Microsoft IIS 6.0 or 7.0 using Integrated Windows authentication
For the BlackBerry MDS Connection Service to support Integrated Windows authentication, Windows Server 2003 file services or Windows Server 2008 file services
23
Installation and Configuration Guide System requirements
24
System requirements: Computers for
BlackBerry Web Desktop Manager and
BlackBerry Administration Service users
Item browser browser settings for Windows Internet
Explorer
Requirement
• Windows Internet Explorer 7.0 to 8.0
• Mozilla Firefox 3.6+
• Google Chrome 4.0+
• Safari 4 for Mac
Windows Internet Explorer 7 or later provides optimal support for BlackBerry
Web Desktop Manager features and BlackBerry Administration Service features.
Depending on the browser that you use, the BlackBerry Web Desktop Manager and BlackBerry Administration Service might not recognize BlackBerry devices and the browser might prevent you from activating devices that are connected to the computer, backing up and restoring device data, or adding or updating device applications.
To support browser access, you must configure the following settings:
• language preferences configured to display encoded web pages
• Microsoft hotfix 955839 installed on the users' computers to make sure the correct time zones are displayed
• the following settings turned on to support Microsoft ActiveX:
• 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
Installation and Configuration Guide System requirements
Item Requirement
• 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 Service web address added as a trusted web site and Enable protected mode cleared
• if you configure single sign-on authentication for the BlackBerry
Administration Service
• the BlackBerry Web Desktop Manager and BlackBerry Administration
Service web sites assigned to the local intranet zone
• Enable Integrated Windows Authentication selected
• if you do not configure single sign-on authentication for the BlackBerry
Administration Service
• the BlackBerry Web Desktop Manager and BlackBerry Administration
Service web sites assigned to the local intranet or trusted sites security zone browser settings for Firefox, Safari, and
Google Chrome
To support browser access, you must configure the following settings:
• support for JavaScript
• cookies turned on
• support for TLS or SSL
• to permit trusted connections to the BlackBerry Administration Service, the
SSL certificate installed
Single sign-on authentication for the BlackBerry Administration Service is not supported by Google Chrome.
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:
• IBM Domino 8.0.2
25
26
Installation and Configuration Guide
• IBM Domino 8.5.1
• IBM Domino 8.5.2
System requirements
System requirements: Firewall
To install the BlackBerry Enterprise Server, configure a firewall or proxy firewall with the following conditions:
• Exclusive use of port 3101 to open and maintain an outbound, bidirectional TCP/IP connection to an external server
• Support for resolving 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 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.5 Community Server
• Microsoft Office Live Communications Server 2005 SP1 Standard or Enterprise
• Microsoft Office Communications Server 2007 Standard or Enterprise
• Microsoft Office Communications Server 2007 R2
• Microsoft Lync Server 2010
• Novell GroupWise Messenger 2.0 or later
Installation and Configuration Guide System requirements
Supported features and environments
Item
Virtual environment
Enhanced network authentication
Multiple IBM Domino domains
IP
SNMP monitoring
Remote access
BlackBerry Enterprise Server
For information, please visit www.blackberry.com
to read KB 29661.
All BlackBerry Enterprise Server components support RSA Authentication Agent 6.1 for
Windows Server 2003 and RSA Authentication Agent 7.0.1 for Windows Server 2008.
The BlackBerry Messaging Agent supports multiple IBM Domino domains with the following conditions:
• the IBM Domino server on the computer that hosts the BlackBerry Enterprise Server configured with the Connection documents for the other IBM Domino servers in the domains that the server replicates from
• the IBM Domino server on the computer that hosts the BlackBerry Enterprise Server configured with membership in the LocalDomainServers group in all the domains in your organization's environment
• cross-certification established between the messaging servers and directory servers in other domains
BlackBerry Enterprise Server components support only IPv4 for TCP/IP connections.
The BlackBerry Enterprise Server components support the SNMP service.
The BlackBerry Enterprise Server components support remote access by administrators who use Remote Desktop Connection.
Unsupported environments
Item
DMZ
Description
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
27
Installation and Configuration Guide System requirements
Item email application
IBM DB2 UDB instant messaging server
Description
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components do not support installation on computers that host email applications such as
Microsoft Outlook. Email applications use data files that can cause conflicts with the BlackBerry Enterprise Server components. As a result, the BlackBerry
Enterprise Server components might not function as expected.
BlackBerry Enterprise Server 5.0 and later and BlackBerry Enterprise Server components do not support IBM DB2 UDB.
Any of the following environments:
• If you configure the BlackBerry Enterprise Server for high availability, the primary BlackBerry Enterprise Server instance and standby BlackBerry
Enterprise Server instance do not support more than one type of instant messaging server in a BlackBerry Enterprise Server pair. For example, if you install the BlackBerry Collaboration Service for use with Microsoft Office
Communications Server 2007 on the primary instance, you must also install the BlackBerry Collaboration Service for use with Microsoft Office
Communications Server 2007 on the standby instance.
• A BlackBerry Enterprise Server or BlackBerry Enterprise Server pair that connects to multiple instances of the BlackBerry Collaboration Service does not support more than one type of instant messaging server. You must use the same type of instant messaging server for each local or remote
BlackBerry Collaboration Service that you connect to a BlackBerry
Enterprise Server or BlackBerry Enterprise Server pair.
BlackBerry Collaboration Service
BlackBerry Attachment Service
Remote Desktop Services or Terminal
Services
If you install the BlackBerry Collaboration Service for use with Microsoft Lync
Server 2010, the BlackBerry Collaboration Service does not support using ocscore.msi or ucmaredist.msi from the Microsoft Lync Server 2010 installation files on the computer that you install the BlackBerry Collaboration Service on.
You must use ocscore.msi and ucmaredist.msi from Microsoft Office
Communications Server 2007 R2. For more information, visit the Volume
Licensing Service Center at www.microsoft.com
.
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.blackberry.com/support/downloads/ .
The BlackBerry Enterprise Server and BlackBerry Enterprise Server components do not support installation on a computer that you installed Remote Desktop
Services or Terminal Services on.
28
Installation and Configuration Guide Preinstallation tasks
Preinstallation tasks
5
Configuring a messaging environment
Configure a group for the BlackBerry Enterprise Server
Before you begin: Verify that the LocalDomainServers group includes the computer you want to install the BlackBerry
Enterprise Server on.
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.
You can administer the BlackBerry Enterprise Server and the BlackBerry Administration Service only with the groups and user accounts that you include in the BlackBerryAdmins group.
1.
On a computer that hosts the IBM Domino administration console, in the administration server directory, create an
IBM Domino group with the following attributes:
• Name: BlackBerryAdmins
• Group type: Access Control List only
• Description: Users who can add, delete, and change settings for BlackBerry device users
• Members: LocalDomainServers, any groups or users who might administer the BlackBerry Enterprise Server
2.
On the server that you want to install the BlackBerry Enterprise Server on, replicate the BlackBerryAdmins group in the IBM Domino Directory.
Configure the Server document to permit the
BlackBerry Enterprise Server to move user accounts within a BlackBerry Domain
You must configure the Server document so that you can move user accounts between BlackBerry Enterprise Server instances in your organization's BlackBerry Domain.
29
Installation and Configuration Guide Preinstallation tasks
1.
On a computer that hosts the IBM Domino administration console, open the Server document for the IBM Domino server that you want to install the BlackBerry Enterprise Server on.
2.
In the Run unrestricted methods and operations field, add the LocalDomainServers group.
30
Configuring connections for the BlackBerry
Enterprise Server database
The database for the BlackBerry Enterprise Server is the BlackBerry Configuration Database. You create the BlackBerry
Configuration Database when you install a BlackBerry Enterprise Server or BlackBerry Administration Service or when you run the CreateDB executable.
The BlackBerry Enterprise Server can connect to its database on the Microsoft SQL Server using Windows authentication or database authentication. By default, the BlackBerry Enterprise Server logs in to its database using the Windows account that you use to complete the installation process or the database credentials you provided during the installation process.
To support database mirroring for the BlackBerry Configuration Database with Microsoft SQL Server 2005 or Microsoft SQL
Server 2008, you must use Windows authentication.
Specifying permissions when you connect to the
BlackBerry Configuration Database using Windows authentication or Microsoft SQL Server authentication
If you connect the BlackBerry Enterprise Server to the BlackBerry Configuration Database using Windows authentication or
Microsoft SQL Server authentication during the BlackBerry Enterprise Server installation process, the Windows account or
Microsoft SQL Server account that you specify must have database permissions on the database server. The type of permissions that you specify is determined by the setup option that you select and whether you create the BlackBerry
Configuration Database on the computer that hosts the BlackBerry Enterprise Server components or on another database server.
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.
When you select Windows authentication during the BlackBerry Enterprise Server installation process, the setup application automatically assigns the required permissions to the Windows account that you use to complete the installation process.
Installation and Configuration Guide Preinstallation tasks
When you select Microsoft SQL Server authentication during the BlackBerry Enterprise Server installation process, you must assign the required database permissions to the Microsoft SQL Server account that you use to complete the installation process.
Assign permissions to the Windows account or Microsoft SQL Server account
Perform one of the following actions:
• If you create the BlackBerry Configuration Database on the computer that hosts the BlackBerry Enterprise Server and you require the setup application to install Microsoft SQL Server Express during the installation process and you choose
Windows authentication, you are not required to assign Microsoft SQL Server permissions to the Windows account. 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.
• If you create the BlackBerry Configuration Database on the computer that hosts the BlackBerry Enterprise Server and you require the setup application to install Microsoft SQL Server Express during the installation process and you choose
Microsoft SQL Server authentication, you must assign the database creator (dbcreator server role) Microsoft SQL Server permission to the Microsoft SQL Server account. 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 Microsoft SQL Server account.
• If you create the BlackBerry Configuration Database on the computer that hosts the BlackBerry Enterprise Server and the computer already hosts a Microsoft SQL Server, you must assign the database creator (dbcreator server role)
Microsoft SQL Server permission to the Windows account 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.
• If you create the BlackBerry Configuration Database on a computer that does not host the BlackBerry Enterprise
Server, you must assign the database creator (dbcreator server role) Microsoft SQL Server permission to the Windows 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.
31
Installation and Configuration Guide Preinstallation tasks
32
Configuring the local system account in an IBM
Domino environment
Add Windows credentials to the local system account
You can configure the local system account to access the BlackBerry Enterprise Server, install the BlackBerry
Configuration Database on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server, and use Windows authentication to connect to the BlackBerry Configuration Database.
In the Microsoft SQL Server Enterprise Manager or Microsoft SQL Server Management Studio, create a new user account with the following properties:
• user name that is the same as the name of the BlackBerry Enterprise Server computer, and uses the format <Domain>
\<computer_name>$
• authentication configured to Windows authentication
• roles assigned that are required to change the 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. After you create or upgrade the BlackBerry Configuration Database using the
CreateDB executable, you can run the setup application using a Windows account with minimum requirements to the database server.
Before you begin: Verify that the appropriate permissions are configured on the database server.
1.
Log in to the computer that hosts the database server using a local administrator account or a Windows account that has SQL administrator permissions.
2.
Copy the BlackBerry Enterprise Server installation files to the database server that you want to configure as the host server for the BlackBerry Configuration Database.
3.
Extract the contents to a folder on the computer.
4.
Navigate to <extracted_folder>\Database.
5.
Open the BesMgmt.cfg file in a text editor.
6.
Change the file to include information that is specific to your organization's environment.
7.
Save and close the file.
8.
Open a command prompt window.
Installation and Configuration Guide Preinstallation tasks
9.
Change to <extracted_folder>\Database.
10. Type CreateDB.exe BESMgmt.cfg.
BESMgmt.cfg properties
Property
CMD
DATABASE_NAME
SERVER
USERID
PASSWORD
SCRIPT_ROOT
LOG_DIR
DBMS
DB_FILE_DIR
BACKUP_DIR
BES_TYPE
Description
This property specifies the type of action that the CreateDB executable must complete (for example, whether to install or upgrade the BlackBerry Configuration Database).
This property specifies the name of the BlackBerry Configuration Database.
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.
If you use database authentication, this property specifies the user name of the database account that has server administrator permission and database creator permission.
If you use database authentication, this property specifies the password for the database account.
This property specifies the path to the DBInstallScripts folder.
By default, this folder is in the same root folder that the CreateDB.exe file is located in.
This property specifies the path to the folder that you want to create log files in.
By default, this folder is in the same root folder that the CreateDB.exe file is located in.
This property specifies the database management system that your organization uses.
This property specifies an existing folder that you want to save the database files in.
By default, this folder is in the same root folder that the CreateDB.exe file is located in.
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.
This property specifies the messaging server that your organization uses.
33
Installation and Configuration Guide Preinstallation tasks
34
Install the SNMP service for monitoring by a monitoring application
You must install the SNMP service on each computer that you want to install the BlackBerry Enterprise Server if you want to use a monitoring application to monitor the BlackBerry Enterprise Server activity.
Before you begin: Verify that each computer can access the Windows installation media.
1.
On the taskbar, click Start > Settings > Control Panel > Add/Remove Programs > Add/Remove Windows
Components.
2.
Double-click Management and Monitoring Tools.
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.
After you finish: To complete the SNMP service installation process, after you install the BlackBerry Enterprise Server or
BlackBerry Enterprise Server components, configure the SNMP service to monitor the activity of the BlackBerry Enterprise
Server or BlackBerry Enterprise Server components.
Creating a BlackBerry Administration
Service pool that includes the BlackBerry
Web Desktop Manager using DNS round robin
When you install the BlackBerry Administration Service, BlackBerry Web Desktop Manager, or both, the setup application installs the BlackBerry Administration Service services automatically. The BlackBerry Administration Service and
BlackBerry Web Desktop Manager require the BlackBerry Administration Service services to run.
Installation and Configuration Guide Preinstallation tasks
If you create a BlackBerry Administration Service pool using DNS round robin, you can install the BlackBerry
Administration Service and BlackBerry Web Desktop Manager on each computer in the pool or you can install the
BlackBerry Administration Service or BlackBerry Web Desktop Manager on some of the computers in the pool. If you install the BlackBerry Administration Service and BlackBerry Web Desktop Manager on each computer in the pool, you can use the pool name that you specified during the installation process in the URLs for the BlackBerry Administration Service and
BlackBerry Web Desktop Manager (for example, https://<pool_name>/webconsole/login or https://<pool_name>/ webdesktop/login).
If you do not install both components on each computer in the pool and you try to access one of the URLs using the pool name, the web browser might display an HTTP 404 error message. The HTTP 404 error message occurs when the web browser tries to connect to a computer in the pool that you did not install the component on that you are trying to access.
For example, you can install the BlackBerry Administration Service on two of the computers in the pool and the BlackBerry
Web Desktop Manager on two other computers in the pool.
To make sure that the web browser does not display HTTP 404 error messages, you can choose one of the following options:
• You can create separate pools within the BlackBerry Administration Service pool for the BlackBerry Administration
Service and the BlackBerry Web Desktop Manager. You can provide your organization's administrators and BlackBerry device users with URLs that include the specific pool names.
• 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://<FQDN_of_computer>/webconsole/login or https://<FQDN_of_computer>/webdesktop/login).
Create the DNS record for a BlackBerry
Administration Service instance
To configure multiple BlackBerry Administration Service instances for high availability using DNS round robin, you must create a DNS record. The DNS record permits the clients of the BlackBerry Administration Service pool to access the instances using a single DNS name. You must create the DNS record in the same domain as the computers that host the
BlackBerry Administration Service instances.
Before you begin:
• Configure a static IP address for each computer that you want to install a BlackBerry Administration Service instance on.
• Obtain permission to manage the DNS.
• If you configure DNS round robin, configure clients to resolve the DNS name into a list of IP addresses and distribute traffic equally across the BlackBerry Administration Service instances in the pool.
1.
Log in to the DNS server.
2.
In the DNS management console, access the forward lookup zone that you want to add the BlackBerry
Administration Service instance to.
35
Installation and Configuration Guide Preinstallation tasks
3.
To create a new host, perform the following actions:
1. In the Name field, type the name of the BlackBerry Administration Service pool that you want to use.
2. In the IP Address1 field, type the IP address of the computer that you want to host a BlackBerry Administration
Service instance on.
3. Select the Create associated pointer (PTR) record check box.
4.
Repeat step 3 for each BlackBerry Administration Service instance that you want to install. When you add entries to the same pool, you must use the same pool name for all BlackBerry Administration Service instances.
After you finish: To remove a BlackBerry Administration Service instance from a pool, delete the entry for the IP address of the BlackBerry Administration Service instance from the DNS server.
36
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.
Before you install the BlackBerry Collaboration Service, you must perform the following actions in the order that they are listed below:
1. Install and enable Microsoft .NET Framework 3.5 SP1 (if you installed Microsoft .NET Framework 4.0, visit support.microsoft.com
to read article 2224981 before you continue).
2. For the following steps, use the install packages included with the Microsoft Office Communications Server 2007 R2 installation files. For steps a and b, you can find the files in Setup\amd64, and for steps c and d, you can find the files in
Setup\amd64\Setup.
a Install Microsoft Visual C++ 2008 Redistributable Package (vcredist_x64.exe).
b Install Microsoft SQL Server Native Client (sqlncli_x64.msi).
c Install Microsoft Unified Communications Managed API 2.0 Core Redist 64-bit (ucmaredist.msi).
d Install Microsoft Office Communications Server 2007 R2, Core Components (ocscore.msi).
3. Install the required certificate in the Personal Certificate folder for the local computer account. You must choose the
Web Server Certificate template and specify the following information:
• For the Subject Name, type the FQDN of the computer that you install the BlackBerry Collaboration Service on.
Installation and Configuration Guide Preinstallation tasks
• For the Friendly Name, type OCSConnector.
To download the install packages, visit the Microsoft Download Center or the Volume Licensing Service Center at www.microsoft.com
.
For more information about installing the required certificate, visit www.blackberry.com/btsc to read article KB24960.
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. Install and enable Microsoft .NET Framework 3.5 SP1 (if you installed Microsoft .NET Framework 4.0, visit support.microsoft.com
to read article 2224981 before you continue).
2. For the following steps, use the install packages included with Microsoft Lync Server 2010 installation files. You can find the files in Setup\amd64.
a Install Microsoft Visual C++ 2008 Redistributable Package (vcredist_x64.exe).
b Install Microsoft SQL Server Native Client (sqlncli_x64.msi).
3. For the following steps, you need to download the software from the Volume Licensing Service Center at www.microsoft.com
.
a Install Microsoft Unified Communications Managed API 2.0 Core Redist 64-bit (ucmaredist.msi).
b Install Microsoft Office Communications Server 2007 R2, Core Components (ocscore.msi).
4. Install the required certificate in the Personal Certificate folder for the local computer account. You must choose the
Web Server Certificate template and specify the following information:
• For the Subject Name, type the FQDN of the Microsoft Lync Server 2010 pool.
• For the Subject Alternative Names, type the FQDN of the Microsoft Lync Server 2010 pool and the FQDN of the computer that you install the BlackBerry Collaboration Service on.
• For the Friendly Name, type OCSConnector.
The BlackBerry Collaboration Service supports Microsoft Unified Communications Managed API 2.0 and must use
Microsoft Office Communications Server 2007 R2, Core Components to take advantage of the backwards compatibility of
37
38
Installation and Configuration Guide Preinstallation tasks
Microsoft Lync Server 2010 with Microsoft Unified Communications Managed API 2.0. The BlackBerry Collaboration
Service does not support using ocscore.msi or ucmaredist.msi from the Microsoft Lync Server 2010 installation files.
To download the install packages, visit the Microsoft Download Center or the Volume Licensing Service Center at www.microsoft.com
.
For more information about installing the required certificate, visit www.blackberry.com/btsc to read article KB24960.
Persistent socket connections for the
BlackBerry Collaboration Service
Instant messaging environment
Microsoft Office Live Communications Server 2005 or
Microsoft Office Communications Server 2007, and TLS communication protocol
Microsoft Office Live Communications Server 2005 or
Microsoft Office Communications Server 2007, and TCP communication protocol
BlackBerry Collaboration Service requirements one persistent socket connection for each instant messaging session three persistent socket connections for each instant messaging session
Microsoft Office Live Communications Server 2005 or
Microsoft Office Communications Server 2007, and HTTPS communication protocol one persistent socket connection and multiple sequential socket connections for each instant messaging session
IBM Sametime
Novell GroupWise Messenger three persistent socket connections to create one TCP connection; all instant messaging sessions use that TCP connection one persistent socket connection for each instant messaging session
Microsoft Office Communications Server 2007 R2 and Microsoft Lync Server 2010 do not require any persistent socket connections, you can use a small pool of shared connections for instant messaging sessions instead.
Installation and Configuration Guide Preinstallation 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.x
• BlackBerry Enterprise Server (core)
• BlackBerry Administration Service
JRE 1.6.x
• BlackBerry Enterprise Server (core)
• BlackBerry Administration Service
• BlackBerry Collaboration Service
• BlackBerry MDS Connection Service
Microsoft XML Core Services 6.0 SP2
• All components except the BlackBerry Router
Microsoft SQL Server 2008 R2 Express Edition
(if selected)
• BlackBerry Administration Service
• Any other components
Microsoft .NET Framework 2.0
(if you are installing Microsoft SQL Server
Express)
Microsoft .NET Framework 3.5 SP1
(if you are installing Microsoft Office
Communications Server 2007 R2 or Microsoft
Lync Server 2010)
• All components
• BlackBerry Collaboration Service
39
Installation and Configuration Guide Installing the BlackBerry Enterprise Server software
Installing the BlackBerry
Enterprise Server software
6
40
Prerequisites: Installing the BlackBerry
Enterprise Server software
• Verify that the Windows account that you use to install the BlackBerry Enterprise Server software is assigned the local administrator permission on the computer that you perform the installation process on.
• Verify that the computer that you perform the installation process on is in a Windows domain.
• If you want to enable transaction logging for all IBM Domino messaging servers and your environment includes large mail files with more than 10K of unread marks, upgrade all mail servers that have BlackBerry users to IBM Domino
8.5.2 FP2 or later. For more information, visit www.ibm.com/support/ to read Reference number 1470828.
• If the IBM Domino server was installed recently, start it and stop it.
• In a Windows Server 2003 environment, to install Microsoft SQL Server 2008 R2 Express Edition during the installation of BlackBerry Enterprise Server, you must install Windows PowerShell 1.0, Microsoft .NET Framework 3.5 SP1, and
Microsoft Windows Installer 4.5 before you run the BlackBerry Enterprise Server setup application.
• Retrieve the following information:
• BlackBerry CAL key
• SRP host (in BlackBerry Enterprise Server version 5.0 and later, the format of the SRP host is different from earlier versions)
• SRP identifier
• SRP authentication key
• computer name and port number of the instant messaging server (For Microsoft Office Live Communications Server
2005 and Microsoft Office Communications Server 2007 use the virtual server name and port number where the
AJAX service is installed.)
• computer name and port number of the proxy server (if applicable)
• Add the blackberry.net domain to the permitted lists in the antivirus application or anti-spam application that the messaging server or gateway uses.
Installation and Configuration Guide Installing the BlackBerry Enterprise Server software
• Verify that the computer has access to www.blackberry.com
(optional).
• If your organization uses a proxy server for Internet access, get the credentials for the proxy server.
• Verify that you installed the appropriate languages and text services on the computer that you use to install the
BlackBerry Enterprise Server, including code page 20127 (US-ASCII) which is required for all supported languages.
• If you want to install Microsoft SQL Server 2008 R2 Express Edition on a computer that does not host any BlackBerry
Enterprise Server components, you can navigate to the Tools folder in the BlackBerry Enterprise Server installation files and run Sqlexpr.exe.
• If you are installing the BlackBerry Administration Service, verify that the computers that host the BlackBerry
Administration Service and BlackBerry Configuration Database are not separated by a WAN bridge.
• If you are performing the installation on a computer that has more than one NIC, verify that the production NIC is first in the bind order in the Windows network settings.
Install the BlackBerry Enterprise Server software
Note: To manage the BlackBerry Enterprise Server, you must install the BlackBerry Administration Service. You can install the BlackBerry Administration Service on the computer that hosts the BlackBerry Enterprise Server or on a separate computer. You must install the BlackBerry Administration Service if you create a BlackBerry Configuration Database and you must also either install or upgrade the BlackBerry Administration Service on the computer that you perform the installation process on in the BlackBerry Enterprise Server domain.
1.
Log in to the computer that you want to install the BlackBerry Enterprise Server on using the Windows account that you created and that has correct permissions. This account runs the BlackBerry Enterprise Server services.
2.
Stop the IBM Domino server.
3.
Change the startup type of the IBM Domino server to Manual.
4.
In the BlackBerry Enterprise Server installation files, double-click setup.exe. If your operating system is Windows
Server 2008, run setup.exe as an administrator.
5.
In the Setup type dialog box, select one of the following options:
• If this installation process is the first installation of BlackBerry Enterprise Server software in a BlackBerry
Enterprise Server domain, select Create a BlackBerry Configuration Database.
• For all other installations of the BlackBerry Enterprise Server software, select Use an existing BlackBerry
Configuration Database.
6.
In the Setup options dialog box, you can select or remove BlackBerry Enterprise Server components from the
Additional Components list.
41
Installation and Configuration Guide Installing the BlackBerry Enterprise Server software
7.
To permit administrators to log in to the BlackBerry Administration Service using their Microsoft Active Directory credentials, in the BlackBerry administration list, click Use Active Directory authentication.
8.
In the Accounts and Folders dialog box, in the Name field, type the name of the BlackBerry Enterprise Server that you want the BlackBerry Administration Service to display.
9.
After the setup application installs the necessary components, click Continue.
10. In the Database information dialog box, if you configured the database server to use static ports, select the Static option. If the static port number is not 1433, in the Port field, type the port number.
11. In the Database mirroring options dialog box, if you want to configure database mirroring, select the Add support for database mirroring check box and in the Name of the mirror database server field, type the name of the database server that hosts the mirror database. The setup application does not create the BlackBerry Configuration Database on the mirror Microsoft SQL Server; it adds a registry key to the computer that includes the name of the mirror
Microsoft SQL Server.
12. In the Administration settings dialog box, perform the following actions:
• 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. If you install more than one 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.
• In the New password and Confirm password fields, type the password for the SSL certificate that the BlackBerry
Administration Service uses to authenticate with browsers. You must use the same password for every BlackBerry
Administration Service instance in the BlackBerry Enterprise Server domain.
13. If you chose to use Active Directory authentication in step 7, in the Microsoft Active Directory settings dialog box, in the User password field, type the password for the Microsoft Active Directory account (for example, BESAdmin) that the BlackBerry Enterprise Server uses to authenticate with Microsoft Active Directory.
14. In the Advanced administration settings dialog box, perform one of the following actions:
• If you select Use Windows authentication, you can choose to use the Microsoft Active Directory account that you used in the previous step, or you can specify login information for a Microsoft Active Directory administrator.
• If you select Use BlackBerry Administration Service authentication, type and confirm a password for the
BlackBerry Administration Service administrator account. Consider using the minimum rules for password complexity when you create the password for the administrator account. The password should be at least 8 characters in length and contain at least one number, letter, and special character, and should not contain dictionary words.
You use the login information that you specify to log in to the BlackBerry Administration Service for the first time.
15. In the DIIOP settings dialog box perform the following actions:
• In the FQDN field, type the FQDN of the IBM Domino server that is running the DIIOP task or if you want to configure high availability for the DIIOP task, the FQDN of a hardware load balancer entry or software load balancer entry.
• In the Port number field, type the TCP/IP port number for the DIIOP task (by default, 63148).
42
Installation and Configuration Guide Installing the BlackBerry Enterprise Server software
16. 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.
17. In the Console addresses dialog box, copy the web addresses for the BlackBerry Enterprise Server components and paste them into a document for future reference. You can use the web addresses to log in to the BlackBerry
Enterprise Server components that you installed.
After you finish:
• To verify that the BlackBerry Configuration Database on a Microsoft SQL Server uses the appropriate collation setting, check that the collation setting for the BlackBerry Configuration Database is default case-insensitive.
• If you reinstalled the BlackBerry Administration Service, in , delete the cache.
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.
The BlackBerry Administration Service instances use the pool name for interprocess communication and when you configure BlackBerry Administration Service high availability using DNS round robin. You must specify a valid DNS host name during the installation process, even if you do not configure BlackBerry Administration Service high availability using
DNS round robin.
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. If you keep the default value and configure BlackBerry Administration Service high availability using DNS round robin at a later time, you must use the BlackBerry Configuration Panel to change the pool name to the host name for the pool.
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.
43
Installation and Configuration Guide Installing the BlackBerry Enterprise Server software
44
Install a BlackBerry Enterprise Server component on a computer that is separate from the computer that hosts the
BlackBerry Enterprise Server
Before you begin:
• Install a BlackBerry Enterprise Server and the BlackBerry Administration Service in your organization's environment.
• Verify that the BlackBerry Administration Service is running on a Windows account that has permission to access and change the Windows registry on the computer that you want to install the BlackBerry Enterprise Server component on.
• If you configured database mirroring for the BlackBerry Configuration Database, you must verify that the BlackBerry
Enterprise Server is connected to the principal database before you run the setup application.
1.
Using the Windows account that you created, log in to the computer that is separate from the computer that hosts the
BlackBerry Enterprise Server. This account runs the services for the BlackBerry Enterprise Server components.
2.
If the BlackBerry Enterprise Server component that you are installing requires the IBM Domino server, perform the following actions: a.
Stop the Domino server.
b.
Change the startup type of the Domino server to Manual.
3.
In the BlackBerry Enterprise Server installation files, double-click setup.exe. If the computer is running Windows
Server 2008, run setup.exe as an administrator.
4.
In the Setup type dialog box, select Use an existing BlackBerry Configuration Database.
5.
In the Database information dialog box, perform the following actions:
• Type the names of the database server and BlackBerry Configuration Database that the BlackBerry Enterprise
Server uses.
• If you configured the database server to use static ports, select the Static option. If the static port number is not
1433, in the Port field, type the port number.
6.
In the Database mirroring options dialog box, if you want to configure database mirroring, select the Add support for database mirroring check box and type the name of the database server that hosts the mirror database in the Name of the mirror database server field. The setup application does not create the BlackBerry Configuration Database on the mirror Microsoft SQL Server; it adds a registry key to the computer that contains the name of the mirror Microsoft
SQL Server.
Installation and Configuration Guide Installing the BlackBerry Enterprise Server software
7.
In the Setup options dialog box, select or remove BlackBerry Enterprise Server components from the Additional
Components list.
8.
After the setup application installs the necessary components, click Continue.
9.
In the Administration settings dialog box, perform the following actions:
• 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. If you install more than one 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.
• In the New password and Confirm password fields, type the password for the SSL certificate that the BlackBerry
Administration Service uses to authenticate with browsers. You must use the same password for every BlackBerry
Administration Service instance in the BlackBerry Enterprise Server domain.
10. In the Microsoft Active Directory settings dialog box, in the User password field, type the password for the Microsoft
Active Directory account (for example, BESAdmin) that the BlackBerry Enterprise Server uses to authenticate with
Microsoft Active Directory.
11. In the Advanced administration settings dialog box, perform one of the following actions:
• If you select Use Windows authentication, you can choose to use the Microsoft Active Directory account that you used in the previous step, or you can specify login information for a Microsoft Active Directory administrator.
• If you select Use BlackBerry Administration Service authentication, type and confirm a password for the
BlackBerry Administration Service administrator account. Consider using the minimum rules for password complexity when you create the password for the administrator account. The password should be at least 8 characters in length and contain at least one number, letter, and special character, and should not contain dictionary words.
You use the login information that you specify to log in to the BlackBerry Administration Service for the first time.
12. In the DIIOP settings dialog box, perform the following actions:
• In the FQDN field, type the FQDN of the IBM Domino server that is running the DIIOP task, or if you want to configure high availability for the DIIOP task, type the FQDN of a hardware load balancer entry or software load balancer entry.
• In the Port number field, type the TCP/IP port number for the DIIOP task (by default, 63148).
13. In the Start services dialog box, start the services for the BlackBerry Enterprise Server components.
14. In the Console addresses dialog box, copy the web addresses for the BlackBerry Enterprise Server components and paste them into a document for future reference. You can use the web addresses to log in to the BlackBerry
Enterprise Server components.
After you finish:
• To view the BlackBerry Enterprise Server component in the BlackBerry Administration Service, restart the BlackBerry
Administration Service.
• If you reinstalled the BlackBerry Administration Service, in , delete the cache.
45
46
Installation and Configuration Guide Installing the BlackBerry Enterprise Server software
Install a standalone BlackBerry Router
A standalone BlackBerry Router is a BlackBerry Router that is hosted by a computer that does not host any other
BlackBerry Enterprise Server components except the BlackBerry Controller. The BlackBerry Controller monitors the
BlackBerry Router and restarts the BlackBerry Router if it stops responding.
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.
In the BlackBerry Enterprise Server installation files, double-click Setup.exe. If your operating system is Windows
Server 2008, run setup.exe as an administrator.
3.
In the Setup type dialog box, select Install a standalone BlackBerry Router.
4.
When you receive a prompt, do not start the BlackBerry Router service until you configure the BlackBerry Router to connect to the BlackBerry Enterprise Server.
Test the connection from the BlackBerry Router to the
BlackBerry Infrastructure
To make sure that the BlackBerry Router can connect to the BlackBerry Infrastructure, you can test the connection using the BBSRPTest tool that is included with the BlackBerry Enterprise Server installation files. The BBSRPTest tool tries to connect to the BlackBerry Infrastructure using the SRP address and SRP port that you specified for the BlackBerry
Infrastructure during the BlackBerry Router installation process.
1.
On the computer that you want to test the connection to the BlackBerry Infrastructure on, at a command prompt, navigate to <drive>:\Program Files\Research In Motion\BlackBerry Enterprise Server.
2.
Type bbsrptest <srp_address> -<port>, where <srp_address> is the SRP address that you provided during the installation process and <port> is the SRP port number. For example, at the command line, type bbsrptest.exe –host server1.example.com –port 3101.
After you finish: If the test does not complete, use the Windows Socket (WINSOCK) error code to diagnose the problem.
For more information, visit http://msdn.microsoft.com
to read article Windows Socket Error Codes.
Installation and Configuration Guide Installing a standby BlackBerry Enterprise Server
Installing a standby BlackBerry
Enterprise Server
7
To configure the BlackBerry Enterprise Server for high availability and disaster recovery, you install a standby BlackBerry
Enterprise Server on a separate computer from your organization's primary BlackBerry Enterprise Server. During the installation process, you assign a standby BlackBerry Enterprise Server to a primary BlackBerry Enterprise Server. You can assign only one standby BlackBerry Enterprise Server to each primary BlackBerry Enterprise Server. The setup application assigns the SRP credentials of the primary BlackBerry Enterprise Server to the standby BlackBerry Enterprise Server automatically.
When you install a standby BlackBerry Enterprise Server, you can install the same BlackBerry Enterprise Server components that are installed on the primary BlackBerry Enterprise Server, or different components. For example, you might want to install additional components with the standby BlackBerry Enterprise Server if you want to use the system resources on the computer to distribute the performance load.
You cannot change a primary BlackBerry Enterprise Server to a standby BlackBerry Enterprise Server by running the setup application again.
By default, the standby BlackBerry Enterprise Server enables you to fail over the following components if they stop responding on the primary BlackBerry Enterprise Server:
• BlackBerry Attachment Service
• BlackBerry Collaboration Service
• BlackBerry Dispatcher
• BlackBerry MDS Connection Service
• BlackBerry Messaging Agent
• BlackBerry Policy Service
• BlackBerry Router
• BlackBerry Synchronization Service
Before you install the standby BlackBerry Enterprise Server, you must set up the IBM Domino servers on the computers that host the primary BlackBerry Enterprise Server and standby BlackBerry Enterprise Server in a cluster for replication.
The standby BlackBerry Enterprise Server automatically creates replicas of each user's BlackBerry state database when the user accounts are initialized on the standby BlackBerry Enterprise Server. User accounts might not initialize immediately on the standby BlackBerry Enterprise Server if the IBM Domino server has not yet replicated the BlackBerry state databases from the primary BlackBerry Enterprise Server.
After you complete the installation process, the setup application does not start all the services for the standby BlackBerry
Enterprise Server components. For example, the setup application does not start the BlackBerry Mail Store Service,
BlackBerry Synchronization Service, or BlackBerry Policy Service. The failover process starts the services when the standby BlackBerry Enterprise Server promotes itself.
47
48
Installation and Configuration Guide Installing a standby BlackBerry Enterprise Server
For more information about high availability in a large-scale environment, see the BlackBerry Enterprise Server Planning
Guide.
Configure the IBM Domino servers for
BlackBerry Enterprise Server high availability
Before you install the standby BlackBerry Enterprise Server, you must configure the IBM Domino servers to replicate data so that the standby BlackBerry Enterprise Server has access to the same data as the primary BlackBerry Enterprise Server has access to. You must create an IBM Domino cluster that includes the primary BlackBerry Enterprise Server and standby
BlackBerry Enterprise Server and create a schedule for replicating data such as the BlackBerry state databases and
BlackBerry profiles database.
1.
On the IBM Domino Administrator console, create a cluster that includes the server that hosts the primary BlackBerry
Enterprise Server and the server that hosts the standby BlackBerry Enterprise Server.
2.
Add the servers to the clusters immediately.
3.
Open the Server document for the server that hosts the primary BlackBerry Enterprise Server.
4.
On the Security tab, type both server names in each of the following fields:
• Run unrestricted methods and operations
• Create database & templates
• Create new replicas
• Create master templates
• Administrators
5.
Click Save.
6.
Open the Server document for the server that hosts the standby BlackBerry Enterprise Server.
7.
Repeat steps 4 and 5 to update the server that hosts the standby BlackBerry Enterprise Server.
8.
Schedule replication for the servers.
Installation and Configuration Guide Installing a standby BlackBerry Enterprise Server
Install a standby BlackBerry Enterprise
Server
Before you begin:
• Install a primary BlackBerry Enterprise Server.
• Start the IBM Domino server on the computer that you want to install the standby BlackBerry Enterprise Server on so that the BlackBerry profiles database is replicated.
• If you configured database mirroring for the BlackBerry Configuration Database, you must verify that the primary
BlackBerry Enterprise Server is connected to the principal database before you run the setup application.
• Verify that the BlackBerry Administration Service is running on a Windows account that has permission to access and change the Windows registry on the computer that you want to install the standby BlackBerry Enterprise Server on.
1.
Log in to the computer using the Windows account that you used to install the primary BlackBerry Enterprise Server.
This account runs the services for the standby BlackBerry Enterprise Server.
2.
Stop the Domino server.
3.
Change the startup type of the Domino server to Manual.
4.
In the BlackBerry Enterprise Server installation files, double-click setup.exe. If the computer is running Windows
Server 2008, run setup.exe as an administrator.
5.
In the Setup type dialog box, select Use an existing BlackBerry Configuration Database.
6.
In the Database information dialog box, perform the following actions:
• Type the names of the database server and BlackBerry Configuration Database that the BlackBerry Enterprise
Server uses.
• If you configured the database server to use static ports, select the Static option. If the static port number is not
1433, type the port number in the Port field.
7.
In the Database mirroring options dialog box, if you want to configure database mirroring, select the Add support for database mirroring check box and type the name of the database server that hosts the mirror database in the Name of the mirror database server field. The setup application does not create the BlackBerry Configuration Database on the mirror Microsoft SQL Server, it adds a registry key to the computer that includes the name of the mirror Microsoft
SQL Server.
8.
In the Setup options dialog box, perform the following actions:
• Click Install a standby BlackBerry Enterprise Server to set up high availability.
• In the Additional components list, select any components that you want to install with the standby BlackBerry
Enterprise Server.
49
Installation and Configuration Guide Installing a standby BlackBerry Enterprise Server
9.
In the High availability settings dialog box, select the primary BlackBerry Enterprise Server that you want to assign the standby BlackBerry Enterprise Server to.
10. After the setup application installs the necessary components, click Continue.
11. In the Administration settings dialog box, perform the following actions:
• 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. If you install more than one 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.
• In the New password and Confirm password fields, type the password for the SSL certificate that the BlackBerry
Administration Service uses to authenticate with browsers. You must use the same password for every BlackBerry
Administration Service instance in the BlackBerry Enterprise Server domain.
12. In the Microsoft Active Directory settings dialog box, in the User password field, type the password for the Microsoft
Active Directory account (for example, BESAdmin) that the standby BlackBerry Enterprise Server uses to authenticate with Microsoft Active Directory.
13. In the Advanced administration settings dialog box, perform one of the following actions:
• If you select Use Windows authentication, you can choose to use the Microsoft Active Directory account that you used in the previous step, or you can specify login information for a Microsoft Active Directory administrator.
• If you select Use BlackBerry Administration Service authentication, type and confirm a password for the
BlackBerry Administration Service administrator account. Consider using the minimum rules for password complexity when you create the password for the administrator account. The password should be at least 8 characters in length and contain at least one number, letter, and special character, and should not contain dictionary words.
You use the login information that you specify to log in to the BlackBerry Administration Service for the first time.
14. In the DIIOP settings dialog box perform the following actions:
• In the FQDN field, type the FQDN of the IBM Domino server that is running the DIIOP task or if you want to configure high availability for the DIIOP task, the FQDN of a hardware load balancer entry or software load balancer entry.
• In the Port number field, type the TCP/IP port number for the DIIOP task (by default, 63148).
15. Start the services for the standby BlackBerry Enterprise Server.
16. In the Console addresses dialog box, copy the BlackBerry Administration Service web address and paste it into a document for future reference. You can use the web address to log in to the BlackBerry Administration Service.
After you finish:
• To view the standby BlackBerry Enterprise Server information in the BlackBerry Administration Service, restart the
BlackBerry Administration Service on every computer that it is installed on in the BlackBerry Enterprise Server domain.
• If you reinstalled the BlackBerry Administration Service, in , delete the cache contents.
50
Installation and Configuration Guide Postinstallation tasks
Postinstallation tasks
8
Test the BlackBerry Enterprise Server installation
1.
In the Windows Services, verify that the services for the BlackBerry Enterprise Server and the IBM Domino service are running.
2.
In the Windows Event Viewer and log files that are located in <drive>:\Program Files\Research In Motion\BlackBerry
Enterprise Server\Logs, check for error messages.
3.
In the BlackBerry Administration Service, add a test user account.
If you can add a test user account, the connection from the BlackBerry Enterprise Server to the BlackBerry
Configuration Database and the messaging server is open.
4.
If you installed the BlackBerry MDS Connection Service, browse to http://<BES_host>:8080.
If the status page appears, the BlackBerry MDS Connection Service is running.
After you finish: For troubleshooting information, visit www.blackberry.com/support .
Install the BlackBerry database notification system
The BlackBerry database notification system is a publish/subscribe system that is designed to reduce the number of database queries that a BlackBerry Enterprise Server makes to the BlackBerry Configuration Database.
If you create the BlackBerry Configuration Database on the computer that hosts the BlackBerry Enterprise Server, the
BlackBerry database notification system installs automatically.
If you create the BlackBerry Configuration Database on a database server that you installed on a computer that is not the computer that hosts the BlackBerry Enterprise Server, you can install the BlackBerry database notification system manually after you complete the BlackBerry Enterprise Server installation process.
Before you begin:
51
52
Installation and Configuration Guide Postinstallation tasks
• You must have the system administrator permission for the database.
1.
On the database server, open the BlackBerry Enterprise Server installation files.
2.
Perform one of the following actions:
• If a 32-bit Microsoft SQL Server is running in your organization's environment, in the Tools\DBNS\x86 folder, copy the RimEsp.dll file to C:\Program Files\Microsoft SQL Server\MSSQL\Binn.
• If a 64-bit Microsoft SQL Server is running in your organization's environment, in the Tools\DBNS\x64 folder, copy the RimEsp.dll file to C:\Program Files(x86)\Microsoft SQL Server\MSSQL\Binn.
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. Confirm that the Microsoft SQL Server Management Studio displays the Function dbo.xp_RIMxxxx registered message.
11. To add additional BlackBerry Configuration Database instances in your organization's environment, repeat steps 7 to
10.
Best practice: Running the BlackBerry
Enterprise Server
Best practice
Do not change the startup type for the
BlackBerry Enterprise Server services.
Description
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. For example, the setup application configures the startup type for the BlackBerry Mail Store Service, BlackBerry Policy
Service, and BlackBerry Synchronization Service to manual.
To avoid errors in the BlackBerry Enterprise Server, do not change the startup type for the BlackBerry Enterprise Server services.
Installation and Configuration Guide Postinstallation tasks
Best practice Description
Do not change the account information for BlackBerry Enterprise Server services.
When you install or upgrade the BlackBerry Enterprise Server, the setup application configures the account information for the BlackBerry Enterprise
Server services.
Do not change the account information for the BlackBerry Enterprise Server unless the BlackBerry Enterprise Server documentation specifies that you can.
Run the BlackBerry Configuration
Panel as an administrator.
Consider the following guidelines if you are running the BlackBerry Configuration
Panel on Windows Server 2008:
• 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.
Use Windows Services to stop and start the BlackBerry Messaging Agent.
To stop and start the BlackBerry Messaging Agent after you have made changes to the configuration, stop and start the BlackBerry Controller service and
BlackBerry Dispatcher service in the Windows Services, or stop and start the
BlackBerry Enterprise Server using the BlackBerry Administration Service.
You should not use the IBM Domino console to stop and start the BlackBerry
Messaging Agent. If you use the IBM Domino console, the BlackBerry
Messaging Agent libraries might not load properly and, if you configure high availability, the BlackBerry Messaging Agent might not start correctly as the primary or standby instance.
Configure the BlackBerry Administration
Service instances in a pool to communicate across network subnets
The instances in the BlackBerry Administration Service pool use multicast UDP to communicate with each other. If the
BlackBerry Administration Service instances are located in different network subnets and your organization's network configuration does not permit multicast UDP across the network subnets, you must configure the BlackBerry
Administration Service instances to use TCP to communicate with each other. For example, if your organization uses a UDP peer-to-peer firewall filter, you must configure the BlackBerry Administration Service instances to use TCP to communicate across the network subnets.
1.
Make sure that no BlackBerry Administration Service instance is in the process of restarting.
53
54
Installation and Configuration Guide Postinstallation tasks
2.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry Administration Service.
3.
Click Edit component.
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.
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.
Before you begin: To manage a BlackBerry device using the BlackBerry Administration Service while the BlackBerry device is connected to the computer, the browser must permit Microsoft ActiveX controls.
1.
In the browser, type https://<server_name>/webconsole/app, where <server_name> is the name of the computer that hosts the BlackBerry Administration Service.
2.
In the User name field, type admin.
3.
In the Password field, type the password that you created during the installation process.
4.
In the Log in using drop-down list, click BlackBerry Administration Service or Active Directory Authentication.
5.
Click Log in.
There is a problem with this website's security certificate
Description
The browser displays this error message when you try to navigate to the BlackBerry Administration Service using Windows
Internet Explorer version 7 or later.
Installation and Configuration Guide Postinstallation tasks
Possible solution
Add the web address for the BlackBerry Administration Service to the list of trusted web sites in Windows Internet Explorer, and install the certificate for the BlackBerry Administration Service in the certificate store of your computer.
1. In Windows Internet Explorer, navigate to the BlackBerry Administration Service console.
2. Click Continue to this website (not recommended).
3. On the Tools menu, click Internet Options.
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. If you are trying to log in to the BlackBerry Administration
Service using a computer that runs Windows Vista, perform the following actions in the Certificate Import Wizard.
a In the Certificate Store dialog box, click Place all certificates in the following store.
b Click Browse.
c Click Trusted Root Certification Authorities.
d Click OK.
13. Close and reopen the browser.
Configuring communication with distributed components
Connecting to a BlackBerry Attachment Service
Perform the following actions if you installed the BlackBerry Attachment Service on a computer that is separate from the computer that host the BlackBerry Enterprise Server or BlackBerry Enterprise Server components that connect to the
BlackBerry Attachment Service. These actions ensure that BlackBerry Enterprise Server components can connect to the
BlackBerry Attachment Service.
55
Installation and Configuration Guide Postinstallation tasks
Connect a BlackBerry MDS Connection Service to a remote BlackBerry
Attachment Service
Perform the following task if you did not install the BlackBerry Attachment Service on the same computer as the
BlackBerry MDS Connection Service.
1.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Connector.
2.
Click the BlackBerry Attachment Connector that is installed with the BlackBerry MDS Connection Service.
3.
Click Edit instance.
4.
On the Supported Attachment Server instances tab, in the Name drop-down list, select the BlackBerry Attachment
Service instance that you want to connect the BlackBerry MDS Connection Service to.
5.
In the Results query period(s) field, type the number of seconds that you want the BlackBerry MDS Connection
Service to wait for a response before it sends a request to another BlackBerry Attachment Service instance.
6.
In the Dedicated server drop-down list, click yes if you want the BlackBerry Attachment Service instance to process specific content types only for the BlackBerry MDS Connection Service.
7.
In the Pool drop-down list, perform one of the following actions:
• To include the BlackBerry Attachment Service instance in the primary group of instances in a pool, select
Primary. You must include at least one BlackBerry Attachment Service instance in the primary group. If you are not configuring high availability, select Primary.
• To include the BlackBerry Attachment Service instance in the secondary group, select Secondary.
8.
Perform the following actions:
• To turn on support for an attachment file format, in the Extensions section, type the file extension of the format.
Click the Add icon beside the extension that you typed.
• To turn off support for an attachment file format, in the Extensions section, click the Delete icon beside the file extension.
9.
Click the Add icon.
10. Click Save All.
11. Repeat steps 2 to 10 for each BlackBerry MDS Connection Service instance in your organization's environment that requires the BlackBerry Attachment Service instance.
Connect the BlackBerry Collaboration Service to a remote BlackBerry
Attachment Service
Using the BlackBerry Client for IBM Sametime, users can send files to contacts in their contact lists. To optimize files for viewing on BlackBerry devices, the BlackBerry Collaboration Service must connect to a BlackBerry Attachment Service instance. If you did not install the BlackBerry Attachment Service instance on the same computer as the BlackBerry
Collaboration Service, you must connect the BlackBerry Collaboration Service to a remote BlackBerry Attachment Service.
56
Installation and Configuration Guide Postinstallation tasks
1.
On the computer that hosts the BlackBerry Collaboration Service, navigate to C:\Program Files\Research In Motion
\BlackBerry Enterprise Server\BBIM\Servers\<server_name>\config.
2.
In a text editor, open the rimpublic.property file.
3.
At the end of the file, type the following text on separate lines:
Attachment.Server.host=<attachment_server_host_name>
Attachment.Server.port.asp=1900
Attachment.Server.port.rqp=2000
4.
To connect another BlackBerry Collaboration Service to the BlackBerry Attachment Service instance, type the text that appears in step 3 for this BlackBerry Collaboration Service instance.
5.
Save and close the file.
6.
In the Windows Services, restart the BlackBerry Collaboration Service.
7.
On the computer that hosts the BlackBerry Attachment Service, in the Registry Editor, navigate to
HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BBAttachServer\BBAttachBESExtension.
8.
On the computer that hosts the BlackBerry Attachment Service, in the Registry Editor, perform one of the following actions:
• If you are running a 32-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion
\BBAttachServer\BBAttachBESExtension.
• If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node
\Research In Motion\BBAttachServer\BBAttachBESExtension.
9.
Change AllowRemoteServices to 1.
10. In the Windows Services, restart the BlackBerry Attachment Service.
Connect a BlackBerry Enterprise Server to a remote BlackBerry
Attachment Service
Perform the following actions if you did not install the BlackBerry Attachment Service on the same computer as the
BlackBerry Enterprise Server. The BlackBerry Messaging Agent requires access to the remote BlackBerry Attachment
Service so that it can process attachment requests.
1.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Connector.
2.
Click the BlackBerry Attachment Connector that is installed with the BlackBerry Enterprise Server.
3.
Click Edit instance.
4.
On the Supported Attachment Server instances tab, in the Name drop-down list, select the BlackBerry Attachment
Service instance that you want to connect to the BlackBerry Enterprise Server.
5.
In the Results query period(s) field, type the number of seconds that you want the BlackBerry Enterprise Server to wait for a response before it sends a request to another BlackBerry Attachment Service instance.
57
Installation and Configuration Guide Postinstallation tasks
6.
In the Dedicated server drop-down list, click yes if you want the BlackBerry Attachment Service instance to process specific content types only for the BlackBerry Enterprise Server.
7.
In the Pool drop-down list, perform one of the following actions:
• To include the BlackBerry Attachment Service instance in the primary group of instances in a pool, select
Primary. You must include at least one BlackBerry Attachment Service instance in the primary group. If you are not configuring BlackBerry Attachment Service high availability, select Primary.
• To include the BlackBerry Attachment Service instance in the secondary group, select Secondary.
8.
Perform the following actions:
• To turn on support for an attachment file format, in the Extensions section, type the file extension of the format.
Click the Add icon beside the extension that you typed.
• To turn off support for an attachment file format, in the Extensions section, click the Delete icon beside the file extension.
9.
Click the Add icon.
10. Click Save All.
11. Repeat steps 2 to 10 for each BlackBerry Enterprise Server instance in your organization's environment that requires the BlackBerry Attachment Service instance.
12. Restart the BlackBerry Enterprise Server.
a.
In the Component view, expand BlackBerry Enterprise Server.
b.
Click the BlackBerry Enterprise Server instance.
c.
Click Restart instance.
Connect a remote BlackBerry Attachment Service to a BlackBerry
Enterprise Server
Perform the following actions if you did not install the BlackBerry Attachment Service on the same computer as the
BlackBerry Enterprise Server. The BlackBerry Messaging Agent requires access to the remote BlackBerry Attachment
Service so that it can process attachment requests.
1.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Server.
2.
Click the name of the remote BlackBerry Attachment Service.
3.
Click Edit instance.
4.
On the Supported Attachment Connector instances tab, add the BlackBerry Attachment Connector that is installed with the BlackBerry Enterprise Server.
5.
Click Save All.
6.
To restart the BlackBerry Attachment Service, on the Instance information tab, in the Status list, click Restart instance.
58
Installation and Configuration Guide Postinstallation tasks
Connecting to a BlackBerry Router
Perform the following tasks if you installed the BlackBerry Router on a computer that is separate from the computer that hosts the BlackBerry Enterprise Server. These tasks ensure that the BlackBerry Enterprise Server can connect to the
BlackBerry Router.
Permit a BlackBerry Enterprise Server to connect to a remote BlackBerry
Router
If you installed a BlackBerry Router on a computer that is separate from the computer that hosts a BlackBerry Enterprise
Server, you must permit the BlackBerry Dispatcher that you installed with the BlackBerry Enterprise Server to connect to the BlackBerry Router. The BlackBerry Router that you installed on a separate computer can send data packets from the
BlackBerry Enterprise Server to BlackBerry devices.
1.
On the computer that hosts the BlackBerry Router, click Start > Run.
2.
Type regedit.
3.
Click OK.
4.
Perform one of the following actions:
• If you are running a 32-bit version of Windows, navigate to \\HKEY_LOCAL_MACHINE\SOFTWARE\Research In
Motion\BlackBerryRouter.
• If you are running a 64-bit version of Windows, navigate to \\HKEY_LOCAL_MACHINE\SOFTWARE
\WOW6432Node \Research In Motion\BlackBerryRouter.
5.
Verify the value of AllowRemoteServices is 1.
6.
If you want to change the port number that the BlackBerry Router uses to open connections to the BlackBerry
Dispatcher, change the value of ServicePort to the port number that the BlackBerry Router should use, for example, port number 80. By default, the port number is 3101.
7.
In the Windows Services, restart the BlackBerry Router service.
Connect a BlackBerry Enterprise Server to a remote BlackBerry Router
1.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry Enterprise Server.
2.
Click the BlackBerry Enterprise Server instance or BlackBerry Enterprise Server pair that you want to assign the
BlackBerry Router to.
3.
Click Edit instance.
4.
In the Router address section, type the FQDN of the computer that hosts the BlackBerry Router.
5.
If the BlackBerry Router uses a port number other than port number 3101, in the Port override field, type the port number.
59
60
Installation and Configuration Guide Postinstallation tasks
6.
Click the Add icon.
7.
Click Save All.
8.
Restart the BlackBerry Enterprise Server using one of the following methods:
• If you changed a BlackBerry Enterprise Server instance, on the Instance tab, click Restart instance.
• If you changed a BlackBerry Enterprise Server pair, click one of the instances and on the Instance tab, click
Restart instance. Repeat this step for the other instance.
• In the Windows Services, restart the BlackBerry Dispatcher.
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.
On a computer that hosts the BlackBerry Enterprise Server or BlackBerry Enterprise Server components, in the
Windows Services, right-click SNMP Service. Click Properties.
2.
On the General tab, change the startup type to Automatic.
3.
On the Traps tab, in the Community name field, type the community name for the SNMP service. The field is casesensitive.
4.
In the Trap Destinations section, add the IP address of the computer that hosts the monitoring application.
5.
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.
6.
Select the Accept SNMP packets from any host or Accept SNMP packets from these hosts option, depending on your organization's environment.
7.
If you selected Accept SNMP packets from these hosts, type the IP address of the computer that hosts the monitoring application.
8.
Click Apply.
9.
In the Services list, right-click SNMP Service. Click Restart.
Installation and Configuration Guide Postinstallation tasks
Restrict database permissions for the
BlackBerry Attachment Service
The BlackBerry Attachment Service accesses the BlackBerry Configuration Database to read attachment data using a
Windows account or a SQL authentication account. To limit the access that the BlackBerry Attachment Service account 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.
• To use database authentication, create a SQL authentication account for the BlackBerry Attachment Service.
1.
In the Microsoft SQL Server management console, create a SQL login for the Windows account or SQL authentication account.
2.
Assign the account to the rim_db_AttachmentServer role in the BlackBerry Configuration Database.
3.
If you want the BlackBerry Attachment Service to use a SQL authentication account to access the BlackBerry
Configuration Database, perform the following actions: a.
On the computer that you installed the BlackBerry Attachment Service on, log in using the Windows account that the BlackBerry Attachment Service is running on.
b.
Click Start > Run.
c.
Type regedit. Click OK.
d.
If you are running a 32-bit version of Windows, navigate to HKEY_CURRENT_USER\SOFTWARE\Research In
Motion.
e.
If you are running a 64-bit version of Windows, navigate to HKEY_CURRENT_USER\SOFTWARE
\WOW6432Node\Research In Motion.
f.
Create the BBAttachServer\Database keys.
g.
In the Database key, create the Login and Password string values for the SQL authentication account.
After you finish: After you complete the BlackBerry Attachment Service installation process, in the Windows Services, verify that the service for the BlackBerry Attachment Service is using the Windows account that you configured. If you need to change the account information, restart the BlackBerry Attachment Service.
61
Installation and Configuration Guide Postinstallation tasks
62
Configuring minimum Microsoft SQL Server permissions for the Windows account
The BlackBerry Enterprise Server setup application requires the Windows account that it uses during the installation process or upgrade process to have Microsoft SQL Server permissions to create or upgrade the BlackBerry Configuration
Database. The setup application requires the Windows account to have more Microsoft SQL Server permissions to install the BlackBerry Enterprise Server than the BlackBerry Enterprise Server requires to run.
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.
The following table describes the Microsoft SQL Server permissions for the setup application and the Windows account that the BlackBerry Enterprise Server uses to run.
Server and database roles Description db_owner rim_db_bes_server
The setup application requires this role to upgrade the BlackBerry Configuration Database.
This role is the default permission in Microsoft SQL Server for running the BlackBerry
Enterprise Server.
The setup application or the createDB executable creates the role automatically when it creates the BlackBerry Configuration Database.
This role is the minimum permission in Microsoft SQL Server for running the BlackBerry
Enterprise Server.
Configure minimum Microsoft SQL Server permissions for the Windows account
You can configure the minimum Microsoft SQL Server permissions for the Windows account that the BlackBerry Enterprise
Server uses to run.
1.
Open the Microsoft SQL Server console.
2.
Expand Microsoft SQL Server > Security > Logins.
3.
Right-click the Windows account that the BlackBerry Enterprise Server uses to run. Click Properties.
4.
Map the Windows account to the BlackBerry Configuration Database.
Installation and Configuration Guide
5.
Change the Database role membership to rim_db_bes_server.
6.
Remove all other database role memberships.
7.
Apply your changes.
Postinstallation tasks
Configure the BlackBerry Mail Store Service to use a local system account
Before you begin: Verify that the local system account has permission to access the Internet.
After you complete the BlackBerry Enterprise Server installation process, you can change the account that the BlackBerry
Mail Store Service uses to run to a local system account. If you do so, the BlackBerry Mail Store Service does not start and you cannot log in to the BlackBerry Administration Service unless you add the executables for IBM Domino to the system environment variables.
Note: You cannot configure the BlackBerry Administration Service services to use a local system account. The BlackBerry
Administration Service console cannot run when you configure the BlackBerry Administration Service services to use a local system account.
1.
On the computer that hosts the BlackBerry Enterprise Server, right-click My Computer. Click Properties.
2.
On the Advanced tab, click Environment Variables.
3.
Add the path to the IBM Domino installation folder to the Path system variable (for example, C:\Program Files\Lotus
\Domino\nserver.exe)
4.
Click OK.
5.
Restart the computer.
Add database credentials for the local system account
If you configured the setup application to use the local system account and SQL authentication to create or upgrade the
BlackBerry Configuration Database during the installation process, you must also specify the credentials for the local system account in the BlackBerry Configuration Panel. The BlackBerry Enterprise Server requires that you specify the credentials in the BlackBerry Configuration Panel before it can connect to the BlackBerry Configuration Database. The
BlackBerry Configuration Panel stores the credentials in encrypted format in the Windows registry.
63
64
Installation and Configuration Guide Postinstallation tasks
1.
On the computer that hosts the BlackBerry Enterprise Server, open the BlackBerry Configuration Panel.
2.
On the Local System Account SQL Authentication tab, type the user name and password for the local system account.
3.
Click Apply.
4.
Click OK.
Changing the BlackBerry Configuration
Database
If you want a BlackBerry Enterprise Server to use a different BlackBerry Configuration Database, you must run the setup application and specify the BlackBerry Configuration Database that you want the BlackBerry Enterprise Server to use.
When you change the BlackBerry Configuration Database, the BlackBerry Enterprise Server becomes unavailable and users cannot send or receive messages on their BlackBerry devices. Organizer data synchronization occurs after you have changed the BlackBerry Configuration Database.
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.
If you add the Windows account that runs the BlackBerry Collaboration Service to the RTCUniversalServerAdmins group, the BlackBerry Collaboration Service is automatically provisioned as a trusted application. The RTCUniversalServerAdmins group is created when you install Microsoft Office Communications Server 2007 R2 or Microsoft Lync Server 2010.
If you do not add the Windows account that runs the BlackBerry Collaboration Service to the RTCUniversalServerAdmins group, you must manually provision each BlackBerry Collaboration Service instance as a trusted application. If you change the listening port number or if the FQDN of the instant-messaging pool changes, you need to repeat the manual provisioning task. If you restart the BlackBerry Collaboration Service, you do not need to repeat the manual provisioning task.
Installation and Configuration Guide Postinstallation tasks
Manually provision the BlackBerry Collaboration
Service as a trusted application
Before you begin:
• Make sure that the Windows account that you use to complete this task is a member of the RTCUniversalServerAdmins group or a group with similar permissions.
• Turn off automatic configuration of the BlackBerry Collaboration Service as a trusted application.
1.
On the computer that hosts the BlackBerry Collaboration Service or on any computer that is in the BlackBerry
Enterprise Server domain, navigate to C:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server\BBIM
\bin.
2.
Run the BCSProvisioner.exe file.
3.
In the BCSProvisioner dialog box, perform the following actions to complete the provisioning process: a.
In the Office Communications Server Pool drop-down box, select the FQDN that you specified during the
BlackBerry Enterprise Server installation.
b.
In the BlackBerry Collaboration Service server FQDN field, type the FQDN of the computer that hosts the
BlackBerry Collaboration Service.
c.
In the Listening port field, type the port number that you specified during the BlackBerry Enterprise Server installation. The default port number is 65061.
d.
Click Provision BCS.
4.
In the Windows Services, restart the BlackBerry Collaboration Service.
Turn off automatic provisioning of 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 and you want to manually provision the BlackBerry Collaboration Service as a trusted application in Microsoft Active Directory, you must first turn off automatic provisioning.
Before you begin: Make sure that the Windows account that runs the BlackBerry Collaboration Service is a member of either the RTComponentUniversalServices group or the RTCUniversalServerAdmins group.
1.
On the computer that hosts the BlackBerry Collaboration Service, navigate to <drive>:\Program Files (x86)\Research
In Motion\BlackBerry Enterprise Server\BBIM\Servers\instance\config\.
2.
In a text editor, open the rimpublic.property file.
65
Installation and Configuration Guide
3.
At the end of the file, type improxy.RIMMSConnector.autoprovision=false.
4.
Save and close the rimpublic.property file.
5.
In the Windows Services, restart the BlackBerry Collaboration Service.
Postinstallation tasks
66
Installation and Configuration Guide Adding or removing BlackBerry Enterprise Server components
Adding or removing BlackBerry
Enterprise Server components
9
If you installed a BlackBerry Enterprise Server previously, you can add one or more BlackBerry Enterprise Server components to the existing BlackBerry Enterprise Server, or you can remove existing BlackBerry Enterprise Server components from the BlackBerry Enterprise Server.
To add or remove a BlackBerry Enterprise Server component, you must run the setup application again. The setup application removes the existing BlackBerry Enterprise Server software from the computer, and installs only the BlackBerry
Enterprise Server components that you select. You can also choose to install either a BlackBerry Enterprise Server or install one or more remote components.
If you installed a BlackBerry Enterprise Server and, when you run the setup application again you select the remote component setup option, the setup application removes the existing BlackBerry Enterprise Server software. If you installed one or more remote components and you select the BlackBerry Enterprise Server setup option, the setup application removes the existing remote components.
You can add or remove the following BlackBerry Enterprise Server components.
Component
BlackBerry Enterprise Server
Options
You can choose one of the following options:
• You can remove a BlackBerry Enterprise Server (which includes a
BlackBerry Attachment Service, BlackBerry Dispatcher, BlackBerry MDS
Connection Service, BlackBerry Messaging Agent, BlackBerry Policy
Service, BlackBerry Router, and BlackBerry Synchronization Service) and install one or more remote components instead.
• You can remove any remote components and install a BlackBerry Enterprise
Server instead.
BlackBerry Administration Service You can choose one of the following options:
• If you installed a BlackBerry Administration Service with a BlackBerry
Enterprise Server, you can remove the BlackBerry Administration Service.
• If you installed a BlackBerry Enterprise Server, you can add a BlackBerry
Administration Service.
• If you installed a BlackBerry Administration Service as a remote component, you can remove it.
67
Installation and Configuration Guide Adding or removing BlackBerry Enterprise Server components
Component
BlackBerry Attachment Service
BlackBerry Collaboration Service
BlackBerry MDS Connection Service
BlackBerry Router
Options
• If you installed remote components, you can add a BlackBerry
Administration Service.
You can choose one of the following options:
• If you installed a BlackBerry Attachment Service as a remote component, you can remove it.
• You can add a BlackBerry Attachment Service to an existing installation of another remote component.
You can choose one of the following options:
• If you installed a BlackBerry Collaboration Service with a BlackBerry
Enterprise Server, you can remove the BlackBerry Collaboration Service.
• If you installed a BlackBerry Enterprise Server, you can add a BlackBerry
Collaboration Service.
• If you installed a BlackBerry Collaboration Service as a remote component, you can remove it.
• If you installed remote components, you can add a BlackBerry Collaboration
Service.
You can choose one of the following options:
• If you installed a BlackBerry MDS Connection Service as a remote component, you can remove it.
• You can add a BlackBerry MDS Connection Service to an existing installation of another remote component.
You can choose one of the following options:
• If you installed a BlackBerry Router as a remote component, you can remove it.
• You can add a BlackBerry Router to an existing installation of another remote component.
68
Installation and Configuration Guide Adding or removing BlackBerry Enterprise Server components
Add or remove a BlackBerry Enterprise
Server component
When you add or remove a BlackBerry Enterprise Server component, the components on the computer that you perform this task on are unavailable for use until the installation or removal process is complete and you restart the BlackBerry
Enterprise Server services.
The process includes a restart of the BlackBerry Enterprise Server.
Before you begin:
• If you configured high availability and you want to add or remove a BlackBerry Enterprise Server component from a computer that hosts a primary BlackBerry Enterprise Server instance, perform a manual failover to the standby
BlackBerry Enterprise Server so that users are not affected by the adding or removing of a BlackBerry Enterprise Server component.
• If you configured database mirroring for the BlackBerry Configuration Database, you must verify that the BlackBerry
Enterprise Server is connected to the principal database before you run the setup application.
• If you want to remove a BlackBerry Router, BlackBerry Attachment Service, BlackBerry MDS Connection Service, or
BlackBerry Collaboration Service, use the BlackBerry Administration Service to remove the component from the list of component instances that the BlackBerry Enterprise Server instances use.
1.
Log in to a computer using the Windows account that you used to install the BlackBerry Enterprise Server components.
2.
If you installed the IBM Domino server, perform the following actions: a.
Stop the IBM Domino server.
b.
Change the startup type of the IBM Domino server to Manual.
3.
Stop the BlackBerry Enterprise Server services.
4.
In the BlackBerry Enterprise Server installation files, double-click setup.exe. If your operating system is Windows
Server 2008, run setup.exe as an administrator.
5.
In the Setup type dialog box, select Use an existing BlackBerry Configuration Database.
6.
In the Database information dialog box, perform the following actions:
• Verify the names of the database server and BlackBerry Configuration Database that the BlackBerry Enterprise
Server instances use.
• If you configured the database server to use static ports, select the Static option. If the static port number is not
1433, in the Port field, type the port number.
69
Installation and Configuration Guide Adding or removing BlackBerry Enterprise Server components
7.
If you want to configure database mirroring, in the Database mirroring options dialog box, you can select Add support for database mirroring and type the name of the database server that hosts the mirror database in the Name of the mirror database server field. The setup application does not create the BlackBerry Configuration Database on the mirror Microsoft SQL Server; it adds a registry key to the computer that includes the name of the mirror Microsoft
SQL Server.
8.
In the Setup options dialog box, select the components that you want to add and clear the checkboxes for the components that you want to remove. The setup application upgrades any components that you installed previously that you select and the components might be unavailable for users during the installation process.
9.
If the setup application prompts you 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 Administration settings dialog box, consider the following information:
• In the Pool name field, type a valid FQDN or IP address. The setup application uses the FQDN or IP address to create the BlackBerry Administration Service web address.
• You must type the password for the SSL certificate that the BlackBerry Administration Service uses for authentication with browsers.
12. In the Microsoft Active Directory settings dialog box, in the User password field, type the password for the Microsoft
Active Directory account (for example, BESAdmin) that the BlackBerry Enterprise Server instance uses to authenticate with Microsoft Active Directory.
13. In the Advanced administration settings dialog box, perform one of the following actions:
• If you select Use Windows authentication, you can choose to use the Microsoft Active Directory account that you used in the previous step, or you can specify login information for a Microsoft Active Directory administrator.
• If you select Use BlackBerry Administration Service authentication, type and confirm a password for the
BlackBerry Administration Service administrator account. Consider using the minimum rules for password complexity when you create the password for the administrator account. The password should be at least 8 characters in length and contain at least one number, letter, and special character, and should not contain dictionary words.
You use the login information that you specify to log in to the BlackBerry Administration Service for the first time.
14. In the DIIOP settings dialog box perform the following actions:
• In the FQDN field, type the FQDN of the IBM Domino server that is running the DIIOP task or if you want to configure high availability for the DIIOP task, type the FQDN of a hardware load balancer entry or software load balancer entry.
• In the Port number field, type the TCP/IP port number for the DIIOP task (by default, port 63148).
15. Start the services for the BlackBerry Enterprise Server instance.
16. In the Console addresses dialog box, copy the web addresses for the BlackBerry Enterprise Server components and paste them into a document for future reference. You can use the web addresses to log in to the BlackBerry
Enterprise Server components.
After you finish:
• If you added a component, to view the component information in the BlackBerry Administration Service, perform one of the following actions:
70
Installation and Configuration Guide Adding or removing BlackBerry Enterprise Server components
• Restart the BlackBerry Administration Service.
• On every computer that hosts the BlackBerry Administration Service, in the BlackBerry Administration Service, in the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain. Click
Component view and then click Refresh list of registered components.
• If you removed a component other than the BlackBerry Router, to delete the component information from the
BlackBerry Configuration Database, use the BlackBerry Administration Service.
• If you reinstalled the BlackBerry Administration Service, in , delete the cache content.
Remove BlackBerry Enterprise Server component information from the
BlackBerry Configuration Database
If you remove the software for a BlackBerry Enterprise Server component from a computer, the software removal process does not delete the component information from the BlackBerry Configuration Database. You must delete the information manually using the BlackBerry Administration Service so that the BlackBerry Administration Service does not display the information for the component that you removed.
Before you begin: Remove the software for the BlackBerry Enterprise Server component from the computer.
1.
In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain.
2.
Click Component view.
3.
Beside the component that you removed, which appears as Uninstalled, click the Delete icon.
4.
Click Yes - Delete the instance and wait until you return to the main page.
71
Installation and Configuration Guide Removing the BlackBerry Enterprise Server software
Removing the BlackBerry
Enterprise Server software
10
Remove the BlackBerry Enterprise Server software
1.
If the IBM Domino server is running on the computer, turn the server off.
2.
On the taskbar, click Start > Settings > Control Panel > Add/Remove Programs.
3.
Click BlackBerry Enterprise Server.
4.
Click Remove.
5.
Click Yes.
6.
If prompted, perform one of the following actions:
• To save all log files in the log directory, click No.
• To delete all files in the log directory, click Yes.
7.
If prompted, perform one of the following actions:
• To save user information for a future BlackBerry Enterprise Server installation, click No.
• To delete all user information, click Yes.
After you finish: To remove third-party software that the setup application installed during the BlackBerry Enterprise
Server installation process, you can remove the JRE software and Java Web Start software from the computer.
72
Delete registry keys
The BlackBerry Enterprise Server setup application might not remove all of the registry keys from the Windows registry when you remove the BlackBerry Enterprise Server software. You can remove the registry keys from the Windows registry manually after the process to remove the BlackBerry Enterprise Server software completes successfully.
Installation and Configuration Guide Removing the BlackBerry Enterprise Server software
1.
On the computer that you removed the BlackBerry Enterprise Server software from, on the Start menu, click Run.
2.
Type regedit.
3.
Click OK.
4.
Delete the remaining registry keys.
BlackBerry Enterprise Server registry keys
The setup application might not remove the following BlackBerry Enterprise Server registry keys from the Windows Registry when you remove the BlackBerry Enterprise Server software.
Key
Research In Motion
Location
HKEY_LOCAL_MACHINE\SOFTWARE (32-bit OS)
HKEY_LOCAL_MACHINE\Wow6432Node\SOFTWARE (64bit OS)
HKEY_LOCAL_MACHINE\System\CurrentControlSet
\Services
HKEY_LOCAL_MACHINE\System\ControlSet001\Services
BBAttachServer and any keys that start with BAS, BB, or
BlackBerry
BBAttachServer and any keys that start with BAS, BB, or
BlackBerry
BBAttachServer and any keys that start with BAS, BB, or
BlackBerry
Research In Motion any keys that are named BlackBerryServer, or are named the name of the BlackBerry Enterprise Server in your organization
Research In Motion any key where ProductName is BlackBerry Enterprise
Server
HKEY_LOCAL_MACHINE\System\ControlSet00n\Services
HKEY_CURRENT_USER\Software
HKEY_CURRENT_USER\Software\Microsoft\Windows NT
\CurrentVersion\Windows Messaging SubSystem\Profiles
HKEY_USERS\.DEFAULT\Software
HKEY_CLASSES_ROOT\Installer\Products
73
Installation and Configuration Guide Removing the BlackBerry Enterprise Server software
74
Removing the BlackBerry database notification system
You must remove the BlackBerry database notification system manually if you installed it manually. You can remove the
BlackBerry database notification system from one BlackBerry Configuration Database instance or all BlackBerry
Configuration Database instances.
Remove the BlackBerry database notification system from a BlackBerry Configuration Database
1.
Open the Microsoft SQL Server Management Studio.
2.
Using the console, navigate to Database\DBInstallScripts\SQLServer\5.0 in the BlackBerry Enterprise Server installation files.
3.
Open the NotifyUnInstall.sql file.
4.
Delete all commands after --- delete notification stored procedures and -- delete notification tables.
5.
Run the script.
6.
Perform one of the following actions:
• Restart Microsoft SQL Server.
• In Windows Explorer, navigate to C:\Program Files\Microsoft SQL Server\MSSQL\Binn. Rename the RimEsp.dll file
(for example, RimEspXXX.tmp).
Remove the BlackBerry database notification system from all BlackBerry Configuration Database instances
1.
Open the Microsoft SQL Server Management Studio.
2.
Using the console, navigate to Database\DBInstallScripts\SQLServer\5.0 in the BlackBerry Enterprise Server installation files.
3.
Open the NotifyUnInstall.sql file.
4.
Run the script.
Installation and Configuration Guide Removing the BlackBerry Enterprise Server software
5.
Using Windows Explorer, navigate to <drive>:\Program Files\Microsoft SQL Server\MSSQL\Binn.
6.
Delete the RimEsp.dll file.
75
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation process
Troubleshooting the
BlackBerry Enterprise Server installation 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.
Possible solution
After you restart the computer during the BlackBerry Enterprise Server installation process, you must log in using the same
Windows account that you used to start the installation process.
1. Close the setup application.
2. Log out of the computer.
3. Log in to the computer.
4. Restart the setup application.
76
Previous version detected but no database available
This error message appears when you cannot start the setup application or the setup application stops responding.
Possible solution
Verify that the registry keys that identify the BlackBerry Configuration Database exist in the Windows registry.
1. On the computer that you want to install or upgrade the BlackBerry Enterprise Server on, on the Start menu, click Run.
2. Type regedit.
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation 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. Restart the setup application.
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 Domino server recently but you did not start it yet, start it and stop it.
2. Restart the setup application.
Attempt to establish connection failed with security reason "3"
This message appears in the IBM Domino console after you install and start the BlackBerry Enterprise Server and IBM
Domino server.
Possible solution
Configure the local Windows account that the BlackBerry Enterprise Server uses for database authentication to connect to the remote BlackBerry Configuration Database.
77
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation 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.
78
You cannot determine the BlackBerry
Attachment Connector that the BlackBerry
Enterprise Server or the BlackBerry MDS
Connection Service uses
If you install a BlackBerry Enterprise Server, the setup application also installs two BlackBerry Attachment Connector instances automatically. One of the BlackBerry Attachment Connector instances connects the BlackBerry Enterprise
Server to the BlackBerry Attachment Service. The other instance connects the BlackBerry MDS Connection Service to the
BlackBerry Attachment Service. During the installation process, the setup application gives both BlackBerry Attachment
Connector instances a name that includes the computer name (for example, <computer_name>_AC).
The BlackBerry Administration Service displays the names of both the BlackBerry Attachment Connector instances. By default, you cannot determine easily which instance connects to the BlackBerry Enterprise Server or the BlackBerry MDS
Connection Service, so you can change the display names of both the BlackBerry Attachment Connector instances to make them easier to identify.
1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Connector.
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation process
2. Click one of the BlackBerry Attachment Connector instances.
3. On the Instance information tab, locate either the MDS Connection Service Instance name section or the Email
(Domino) Instance name section. Consider the following naming conventions:
• If you locate the section that is named MDS Connection Service Instance name, the BlackBerry MDS Connection
Service connects to this BlackBerry Attachment Connector instance.
• If you locate the section that is named Email (Domino) Instance name, the BlackBerry Enterprise Server connects to this BlackBerry Attachment Connector instance.
4. Click Edit instance.
5. Perform one of the following actions:
• If the BlackBerry MDS Connection Service connects to the BlackBerry Attachment Connector instance, in the
Instance information section, in the Friendly description field, type a unique name (for example,
<server_name>_AC_MDSCS).
• If the BlackBerry Enterprise Server uses the BlackBerry Attachment Connector instance, in the Instance information section, in the Friendly description field, type a unique name.
6. Click Save all.
The BlackBerry Administration Service updates the list of BlackBerry Attachment Connector instances automatically to use the names that you typed.
Some BlackBerry Enterprise Server components do not start
Possible cause Possible solution
The BlackBerry Administration Service,
BlackBerry MDS Connection Service, or BlackBerry Collaboration Service is configured to use a dynamic port when it connects to the BlackBerry
Configuration Database, but the database server uses a static port.
Configure a static port for the BlackBerry Configuration Database.
1. On the computer that hosts the BlackBerry Enterprise Server component, on the taskbar, click Start > All Programs > BlackBerry Enterprise Server.
2. Right-click BlackBerry Server Configuration and select Run as administrator.
3. On the Database Connectivity tab, clear the Use dynamic ports or specify
SQL port check box.
79
80
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation process
Possible cause Possible solution
4. In the Use dynamic ports or specify SQL port field, type the correct port number.
5. Click OK.
6. In the Windows Services, restart the services for the BlackBerry Enterprise
Server component.
The BlackBerry Administration Service,
BlackBerry MDS Connection Service, or BlackBerry Collaboration Service is configured to use an incorrect static port number when it connects to the
BlackBerry Configuration Database.
Configure the component to use the correct port number.
1. On the computer that hosts the BlackBerry Enterprise Server component, on the taskbar, click Start > All Programs > BlackBerry Enterprise Server.
2. Right-click BlackBerry Server Configuration and select Run as administrator.
3. On the Database Connectivity tab, clear the Use dynamic ports or specify
SQL port check box.
4. In the Use dynamic ports or specify SQL port field, type the correct port number.
5. Click OK.
6. In the Windows Services, restart the services for the BlackBerry Enterprise
Server component.
You cannot access the BlackBerry
Administration Service
Possible cause
The computer that hosts the BlackBerry Administration Service has more than one NIC and the production NIC is not first in the bind order in Windows network settings as it must be for you to access the BlackBerry Administration Service.
Possible solution
On the computer that hosts the BlackBerry Administration Service, in the Windows network settings, verify that the production NIC is first in the bind order. For more information, visit www.blackberry.com/btsc to read article KB18190.
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation process
You cannot create a user account in the
BlackBerry Administration Service
Possible cause Possible solution
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.
Configure the BlackBerry Administration Service to use a dynamic port for the
BlackBerry Configuration Database.
1. On the computer that hosts the BlackBerry Enterprise Server component, on the taskbar, click Start > All Programs > BlackBerry Enterprise Server.
2. Right-click BlackBerry Server Configuration and select Run as administrator.
3. On the Database Connectivity tab, select the Use dynamic ports or specify
SQL port check box.
4. Click OK.
5. In the Windows Services, restart the services for the BlackBerry
Administration Service.
You upgraded a BlackBerry Enterprise
Server to version 5.0 or later, and when you search for a user account in the
BlackBerry Administration Service, the
BlackBerry Administration Service cannot find the user account. The
BlackBerry Mail Store Service cannot connect to your organization’s contact list and synchronize the contact list to the BlackBerry Configuration
Database.
1. Verify that you configured the MailServer property in the notes.ini file on the computer that hosts the BlackBerry Enterprise Server for an IBM Domino server that is running.
2. Using the local system account, restart the Domino server that is running on the computer that hosts the BlackBerry Enterprise Server.
81
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation process
82
IBM Domino takes a long time to complete cluster replication
Possible cause
By default, IBM Domino servers use only one cluster replicator. If the IBM Domino servers take a long time to replicate the cluster, you can add cluster replicators to the IBM Domino servers.
Possible solution
Add cluster replicators to the IBM Domino servers. For more information about cluster replicators, including metrics that you can use to determine how many cluster replicators the IBM Domino servers require, see the IBM Domino documentation.
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. On the computer that hosts the BlackBerry Enterprise Server component, on the taskbar, click Start > All Programs >
BlackBerry Enterprise Server.
3. Right-click BlackBerry Server Configuration and select Run as administrator.
4. On the Administration Service - High Availability tab, in the Pool name field, type the name of the BlackBerry
Administration Service pool.
5. In the Windows Services, restart the services for the BlackBerry Administration Service.
Installation and Configuration Guide Troubleshooting the BlackBerry Enterprise Server installation process
The text in the license agreement is not readable
Possible cause
You have not installed the appropriate languages and text services on the computer that you use to install the BlackBerry
Enterprise Server.
Possible solution
Verify that you installed the appropriate languages and text services on the computer that you use to install the BlackBerry
Enterprise Server.
83
84
Installation and Configuration Guide Related resources
Related resources
12
To read the following guides or additional related material, visit http://www.blackberry.com/go/serverdocs .
Guide
What's New in BlackBerry Enterprise
Server 5.0 SP4 Job Aid
BlackBerry Enterprise Server Update
Guide
Information
• Summary of new features
• Summary of updates to the administrator guides for BlackBerry Enterprise
Server 5.0 SP4
BlackBerry Enterprise Server Release
Notes
BlackBerry Enterprise Server Upgrade
Guide
• Description of known issues and potential workarounds
• System requirements
• Upgrade instructions
BlackBerry Enterprise Server Policy
Reference Guide
• Descriptions of available IT policy rules and application control policy rules
• Descriptions of Wi-Fi configuration settings and VPN configuration settings
Installation and Configuration Guide Glossary
Glossary
13
AES
AJAX
BlackBerry CAL
BlackBerry Domain
BlackBerry MDS
CDMA
DIIOP
DMZ
DNS
FQDN
HTTP
HTTPS
IBM DB2 UDB
IIS
IP
IP address
JDK
JRE
LAN
LDAP
Advanced Encryption Standard
Asynchronous JavaScript and XML
A BlackBerry Client Access License (BlackBerry CAL) limits how many users you can add to a
BlackBerry Enterprise Server.
A BlackBerry Domain consists of the BlackBerry Configuration Database with its users and any
BlackBerry Enterprise Server instances that connect to it.
BlackBerry Mobile Data System
Code Division Multiple Access
Domino Internet Inter-ORB Protocol
A demilitarized zone (DMZ) is a neutral subnetwork outside of an organization's firewall. It exists between the trusted LAN of the organization and the untrusted external wireless network and public Internet.
Domain Name System fully qualified domain name
Hypertext Transfer Protocol over Secure Sockets Layer
Hypertext Transfer Protocol over Secure Sockets Layer
IBM DB2 Universal Database
Internet Information Services
Internet Protocol
An Internet Protocol (IP) address is an identification number that each computer or mobile device uses when it sends or receives information over a network, such as the Internet. This identification number identifies the specific computer or mobile device on the network.
Java Development Kit
Java Runtime Environment local area network
Lightweight Directory Access Protocol
85
messaging server
NIC
ORB
RAID
SNMP
SQL
SRP
SSL
TCP
TCP/IP
TLS
Triple DES
UDP
VPN
WAN
XML
Installation and Configuration Guide Glossary
A messaging server sends and processes messages and provides collaboration services, such as updating and communicating calendar and address book information.
network interface card object request broker redundant array of independent (or inexpensive) disks
Simple Network Management Protocol
Structured Query Language
Server Routing Protocol
Secure Sockets Layer
Transmission Control Protocol
Transmission Control Protocol/Internet Protocol (TCP/IP) is a set of communication protocols that is used to transmit data over networks, such as the Internet.
Transport Layer Security
Triple Data Encryption Standard
User Datagram Protocol virtual private network wide area network
Extensible Markup Language
86
Installation and Configuration 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, DB2, Domino, Lotus, and Sametime are trademarks of International Business Machines Corporation. Intel and Xeon are trademarks of Intel Corporation.
Microsoft, Active Directory, ActiveX, Hyper-V, Internet Explorer, Lync, SQL Server, Visual C++, Windows, Windows Media,
Windows Server, and Windows Vista are trademarks of Microsoft Corporation. Mozilla and Firefox are trademarks of Mozilla
Foundation. Novell and GroupWise are trademarks of Novell, Inc. Java, JavaScript, JDK, and JRE are trademarks of Oracle and/or its affiliates. RSA is a trademark of RSA Security. VMware vSphere is a trademark of VMware, Inc. All other trademarks are the property of their respective owners.
This documentation including all documentation incorporated by reference herein such as documentation provided or made available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS AVAILABLE" and without condition, endorsement, guarantee, representation, or warranty of any kind by BlackBerry Limited and its affiliated companies ("BlackBerry") and BlackBerry assumes no responsibility for any typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to protect BlackBerry proprietary and confidential information and/or trade secrets, this documentation may describe some aspects of BlackBerry technology in generalized terms. BlackBerry reserves the right to periodically change information that is contained in this documentation; however,
BlackBerry makes no commitment to provide any such changes, updates, enhancements, or other additions to this documentation to you in a timely manner or at all.
This documentation might contain references to third-party sources of information, hardware or software, products or services including components and content such as content protected by copyright and/or third-party websites
(collectively the "Third Party Products and Services"). BlackBerry does not control, and is not responsible for, any Third
Party Products and Services including, without limitation the content, accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and Services in this documentation does not imply endorsement by
BlackBerry of the Third Party Products and Services or the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR JURISDICTION, ALL CONDITIONS,
ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING WITHOUT LIMITATION, ANY CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR
WARRANTIES OF DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY, MERCHANTABLE
QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING FROM A STATUTE OR CUSTOM OR A
COURSE OF DEALING OR USAGE OF TRADE, OR RELATED TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE
OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES
REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT VARY BY STATE OR
PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES AND
CONDITIONS. TO THE EXTENT PERMITTED BY LAW, ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE
87
Installation and Configuration Guide Legal notice
DOCUMENTATION TO THE EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE
HEREBY LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR THE ITEM
THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO EVENT SHALL
BLACKBERRY BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION OR ITS USE, OR
PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY
PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING WITHOUT LIMITATION ANY OF THE FOLLOWING
DAMAGES: DIRECT, CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED
DAMAGES, DAMAGES FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS,
BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS OPPORTUNITY, OR CORRUPTION
OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY DATA, PROBLEMS ASSOCIATED WITH ANY
APPLICATIONS USED IN CONJUNCTION WITH BLACKBERRY PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF
THE USE OF BLACKBERRY PRODUCTS OR SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST
OF SUBSTITUTE GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR
PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN, AND EVEN IF
BLACKBERRY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, BLACKBERRY SHALL HAVE NO
OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR OTHERWISE TO YOU INCLUDING
ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF THE NATURE OF
THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT LIMITED TO BREACH OF CONTRACT,
NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL
BREACH OR BREACHES OR THE FAILURE OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY
CONTAINED HEREIN; AND (B) TO BLACKBERRY AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS,
AGENTS, SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED BLACKBERRY DISTRIBUTORS (ALSO
INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES, AND INDEPENDENT
CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY DIRECTOR,
EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF BLACKBERRY OR ANY AFFILIATES OF
BLACKBERRY HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to ensure that your airtime service provider has agreed to support all of their features. Some airtime service providers might not offer
Internet browsing functionality with a subscription to the BlackBerry ® Internet Service. Check with your service provider for availability, roaming arrangements, service plans and features. Installation or use of Third Party Products and Services with
BlackBerry's products and services may require one or more patent, trademark, copyright, or other licenses in order to avoid infringement or violation of third party rights. You are solely responsible for determining whether to use Third Party
Products and Services and if any third party licenses are required to do so. If required you are responsible for acquiring them. You should not install or use Third Party Products and Services until all necessary licenses have been acquired. Any
Third Party Products and Services that are provided with BlackBerry's products and services are provided as a convenience to you and are provided "AS IS" with no express or implied conditions, endorsements, guarantees, representations, or warranties of any kind by BlackBerry and BlackBerry assumes no liability whatsoever, in relation thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to the terms of
88
Installation and Configuration 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. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY EXPRESS WRITTEN
AGREEMENTS OR WARRANTIES PROVIDED BY BLACKBERRY FOR PORTIONS OF ANY BLACKBERRY PRODUCT OR
SERVICE OTHER THAN THIS DOCUMENTATION.
Certain features outlined in this documentation might require additional development or Third Party Products and Services for access to corporate applications.
This product contains a modified version of HTML Tidy. Copyright © 1998-2003 World Wide Web Consortium
(Massachusetts Institute of Technology, European Research Consortium for Informatics and Mathematics, Keio
University). All Rights Reserved.
This product includes software developed by the Apache Software Foundation ( www.apache.org/ ) and/or is licensed pursuant to one of the licenses listed at ( www.apache.org/licenses/ ). For more information, see the NOTICE.txt file included with the software
BlackBerry Limited
2200 University Avenue East
Waterloo, Ontario
Canada N2K 0A7
BlackBerry UK Limited
200 Bath Road
Slough, Berkshire SL1 3XE
United Kingdom
Published in Canada
89
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project