Blackbe;rry SWD-1000192-0414013325-001 Technical manual

BlackBerry Mobile Voice System
Version: 5.0 | Service Pack: 2
Planning Guide

SWD-1000192-0414013325-001

Contents
1 Overview........................................................................................................................................................... 2
2Requirements................................................................................................................................................... 3
System requirements: BlackBerry MVS............................................................................................................ 3
System requirements: Telephony environment............................................................................................... 5
System requirements: PBX............................................................................................................................... 6
3Planning your organization's Wi-Fi infrastructure............................................................................................ 8
Best practice: Planning your organization's Wi-Fi infrastructure..................................................................... 8
4Planning a BlackBerry MVS installation............................................................................................................ 10
Best Practices: Installing and configuring the BlackBerry MVS......................................................................... 10
5 Configuring call direction.................................................................................................................................. 12
PBX-initiated calling.......................................................................................................................................... 12
BlackBerry device–initiated calling................................................................................................................... 12
6 BlackBerry MVS high availability....................................................................................................................... 13
Support for BlackBerry Enterprise Server failover............................................................................................ 14
Support for PBX failover................................................................................................................................... 14
How the BlackBerry MVS determines the health of MVS Session Manager instances..................................... 14
Conditions for failover to a standby MVS Session Manager............................................................................. 14
Scenario: What happens after the active MVS Session Manager stops responding........................................ 15
7 Glossary............................................................................................................................................................ 16
8 Provide feedback.............................................................................................................................................. 18
9 Legal notice....................................................................................................................................................... 19

Overview 1
The BlackBerry® Mobile Voice System integrates your organization's PBX phone system with the BlackBerry®
Enterprise Server to extend desk phone features to BlackBerry devices. The BlackBerry MVS is designed to do the
following:
• Integrate with the phone application on BlackBerry devices so that users can make calls from and receive calls
to your organization's work numbers
• Extend commonly used PBX features that are available from users' desk phones to their BlackBerry devices
• Provide simplified access to your organization’s voice mail system
• Provide Voice over Wi-Fi® access to desk phone features for users of Wi-Fi enabled BlackBerry devices
• Extend the security features of the BlackBerry Enterprise Server to authenticate BlackBerry device users to the
BlackBerry MVS and your organization's PBX phone system
• Permit you to manage the BlackBerry MVS from a single web administration console
• Incorporate the use of templates and classes of service to manage users' access to their work numbers and
phone features
• Permit you to configure the BlackBerry MVS to support high availability to help enhance the consistency and
reliability of your organization's BlackBerry MVS implementation
Planning Guide Overview
2

Requirements 2
System requirements: BlackBerry MVS
Item Requirement
hardware • two Intel® Xeon® 2.0 GHz processors
• 4 GB RAM
• two drives that are configured as RAID 1 or better
For a computer that is running only the MVS Console, you require only one
2.0 GHz processor, and 2GB RAM.
operating system Any of the following operating systems:
• Windows Server® 2003 R2 SP2 Standard (32 bit or 64 bit)
• Windows Server 2003 R2 SP2 Enterprise (32 bit or 64 bit)
• Windows Server 2008 R2
BlackBerry® Enterprise Server Any of the following BlackBerry® Enterprise Server software:
• BlackBerry® Enterprise Server 4.1 SP7 or later for Microsoft® Exchange
• BlackBerry Enterprise Server 5.0 or later for Microsoft Exchange
• BlackBerry® Enterprise Server 4.1 SP7 or later for IBM® Lotus®
Domino®
• BlackBerry Enterprise Server 5.0 or later for IBM Lotus Domino
• BlackBerry® Enterprise Server 4.1 SP7 or later for Novell® GroupWise®
• BlackBerry Enterprise Server 5.0 or later for Novell GroupWise
data management system Any of the following data management systems:
• Microsoft® SQL Server® 2000 with named pipes and TCP/IP network
protocols turned on
• Microsoft SQL Server 2005 SP2 with named pipes and TCP/IP network
protocols turned on
• Microsoft SQL Server 2008 with named pipes and TCP/IP network
protocols turned on
browser Any of the following browsers:
• Windows® Internet Explorer® 7
• Windows Internet Explorer 8 with JavaScript® turned on
• Mozilla® Firefox® 3.5 or later
your organization's telephony
environment
PBX vendor that is BlackBerry MVS platform-compliant
BlackBerry device Any of the following devices:
• BlackBerry® Pearl™ 8100 Series
Planning Guide Requirements
3

Item Requirement
• BlackBerry® Pearl™ 8220 smartphone
• BlackBerry® Curve™ 8300 smartphone
• BlackBerry® Curve™ 8310 smartphone
• BlackBerry® Curve™ 8320 smartphone
• BlackBerry® Curve™ 8330 smartphone
• BlackBerry® Curve™ 8520 smartphone
• BlackBerry® Curve™ 8530 smartphone
• BlackBerry® 8700 Series
• BlackBerry® 8800 smartphone
• BlackBerry® 8820 smartphone
• BlackBerry® Curve™ 8900 smartphone
• BlackBerry® Curve™ 8910 smartphone
• BlackBerry® Curve™ 8980 smartphone
• BlackBerry® Bold™ 9000 smartphone
• BlackBerry® Pearl™ 9100 smartphone
• BlackBerry® Curve™ 9300 smartphone
• BlackBerry® Curve™ 9330 smartphone
• BlackBerry® Storm™ 9500 smartphone
• BlackBerry® Storm™ 9530 smartphone
• BlackBerry® Storm2™ Series
• BlackBerry® Tour™ 9630 smartphone
• BlackBerry® Bold™ 9650 smartphone
• BlackBerry® Style™ 9670 smartphone
• BlackBerry® Bold™ 9700 smartphone
• BlackBerry® Bold™ 9780
• BlackBerry® Torch™ 9800 smartphone
BlackBerry® Device Software Any of the following BlackBerry Device Software versions:
• BlackBerry Device Software 4.5 or later for devices that operate on
GSM® networks (Voice over Mobile support only)
• BlackBerry Device Software 4.7.1 or later for devices that operate on
CDMA networks (Voice over Mobile support only)
• BlackBerry Device Software 5.0 or later for Voice over Wi-Fi® support
and Voice over Mobile support
• BlackBerry 6 for the BlackBerry Torch 9800
wireless service plan Any of the following features:
• data
• voice (not required if you use only Wi-Fi to make and take BlackBerry
MVS calls)
Planning Guide System requirements: BlackBerry MVS
4

Item Requirement
• caller ID
virtual environment (if applicable) Any of the following virtual environment software:
• VMware® ESX® Server 3.5.0
• VMware ESX Server 4.x
PDF file viewer Adobe® Reader® 5.0 or later
System requirements: Telephony environment
Item Requirement
DTMF Your organization's telephony environment must be able to perform the following
actions:
• detect and intercept DTMF tones from the cellular call leg between the PBX and
BlackBerry® devices
• notify the BlackBerry MVS Server of the DTMF tones using KPML notification
• emit DTMF tones into the audio path when the BlackBerry® Mobile Voice System
requests them
• send DTMF tones that are at least 100 milliseconds in duration to devices
If your organization's telephony environment includes components, such as a voice
mail server, that receive DTMF tones from the BlackBerry MVS, the telephony
environment must be able to present the DTMF tones in the correct format (for
example, RFC 2833, in-band media, H.323).
ANI number (Calling party) • The Calling Line ID of a received call identifies the BlackBerry MVS call that is
presented to the device. The Calling Line ID must be configured in the MVS
Console to match the ANI that your organization's telephony environment plans
to use for all BlackBerry MVS calls.
• Any BlackBerry MVS calls that a device makes must use the ANI that you
configured in your organization's telephony environment so that the called party
can see the caller ID that is configured for the BlackBerry MVS user.
• If your organization has a hunt group that is configured in the PBX with multiple
outgoing trunks, and each trunk has its own ANI number, you must type each
ANI number in the MVS Console.
DID/DDI number (Called
party)
• If you configure your organization's BlackBerry MVS for BlackBerry device–
initiated calling, you must configure a DID/DDI number in your organization's
telephony environment. You configure the DID/DDI number in the MVS Console
for each MVS Session Manager. The DID/DDI number is used to provision the
user accounts that you configured for the device.
Planning Guide System requirements: Telephony environment
5

Item Requirement
• In the class of service, make sure that you choose BlackBerry Smartphone > PBX
for users that you want to use BlackBerry device–initiated calling. You must verify
that a call that arrives at the DID/DDI number prompts the telephony
environment to send a SIP invitation to the BlackBerry MVS over the telephony
connector that has been configured between the telephony environment and
the BlackBerry MVS.
voice mail server (if
necessary)
If your organization uses solicited voice mail, the BlackBerry MVS requires a SIP line
to your organization's voice mail server, which must be compliant with RFC 3842, so
that a MWI displays on users' devices.
System requirements: PBX
Item Requirement
KPML The PBX must support KPML for the exchange of DTMF tones between the PBX
and the BlackBerry® Mobile Voice System.
support for BlackBerry devices The device must be an endpoint for the PBX.
G.729 is supported by BlackBerry MVS 5.0 and later. It is supported on all devices
except for the BlackBerry® Bold™ 9000 device and devices that operate on CDMA
networks.
SIP line The BlackBerry MVS requires a SIP line be connected to the PBX so that the PBX
can establish calls to devices.
If you configure the BlackBerry MVS for high availability, you must configure a
SIP line on each MVS Session Manager.
SIP trunk The BlackBerry MVS requires that a SIP trunk be connected to the PBX so that
the PBX can send calls to the mobile numbers on devices. When you configure
the SIP trunk, you must provide the IP address and port number of the MVS
Session Manager.
If you configure the BlackBerry MVS for high availability, you must configure a
SIP trunk on each MVS Session Manager.
call routing patterns for internal
numbers and external numbers
The phone numbers that the BlackBerry MVS sends to the PBX are E.164
formatted numbers and might not contain leading digits to indicate how the PBX
should route the call. You might need to configure the PBX so that the call routing
patterns add or remove leading digits for routing to internal numbers or external
numbers. For example, you should consider creating the following call routing
patterns:
• one that permits BlackBerry MVS users to make calls from the call log or
contact list on their devices without adding 9 before a phone number
Planning Guide System requirements: PBX
6

Item Requirement
• one that removes an NDD number from phone numbers that are dialed
from devices if the BlackBerry MVS user is in the same geographic location
as the PBX. The PBX should be configured to manage calls from devices if
the user types [phone] or (1) [phone].
• one for regions or countries that your organization's users frequently travel
to
Ensure the Class of Service setting of "User may change the mobile phone
number" is checked. When your organization's users are roaming
internationally, it might be necessary for the users to manually change the
mobile number on their devices to reflect what the PBX must dial to contact the
user. For example, if the user is from the United Kingdom the mobile number
on the user's device should be changed to include the IDD (00), the home country
code (44), and the user's area code and local phone number. For more
information on changing the mobile phone number on the device, visit
www.blackberry.com/support to read article KB17940.
DID/DDI number To configure device-initiated calling, you must configure your organization's call
routing patterns so that the PBX can route the device-initiated calls that use a
DID/DDI number to the MVS Session Manager that is associated with the DID/
DDI number. For example, if the DID/DDI number that you configure in the MVS
Console for the MVS Session Manager is [phone], for any device-initiated
calls that arrive at the PBX using a DID/DDI number of [phone], the PBX
must route the calls to the MVS Session Manager that is associated with the DID/
DDI number of [phone].
You require one DID/DDI number for each MVS Session Manager in your
organization’s environment.
Planning Guide System requirements: PBX
7

Planning your organization's Wi-Fi
infrastructure
3
If your organization plans to use Wi-Fi® enabled BlackBerry® devices for making and taking BlackBerry® Mobile Voice
System calls, you must make sure that your Wi-Fi infrastructure can support Voice over Wi-Fi calls. During the planning
process, you should collaborate with your organization's Wi-Fi infrastructure vendor to make sure that the Wi-Fi
infrastructure is designed and configured to support Voice over Wi-Fi calls.
To make sure that your organization's Wi-Fi infrastructure can support Voice over Wi-Fi calls, you should use
BlackBerry devices to perform an in-depth site survey. For more information, visit www.blackberry.com/support to
read article KB13299. The results of the survey should permit you to perform the following tasks:
• design and configure a Wi-Fi controller-based architecture
• identify the type of authentication and level of encryption that your organization requires
• configure a QoS implementation
• determine the expected Wi-Fi coverage and capacity boundaries of the access points
• determine the capacity of your organization's Wi-Fi infrastructure. Make sure that you account for the expected
usage for both BlackBerry MVS users and individuals who use Wi-Fi technology on their laptop computers.
• create documentation for your organization's users to help them configure their devices to connect to Wi-Fi
networks and make Voice over Wi-Fi calls
Best practice: Planning your organization's Wi-Fi
infrastructure
The following guidelines are intended to help you design a Wi-Fi infrastructure that permits BlackBerry devices to
connect to an access point that has a medium-to-high data rate. When the data rate of the access point is too low
or the signal strength of the access point is too weak, the device should roam to an access point with a higher data
rate or a stronger signal strength. When designing your organization's Wi-Fi infrastructure, you should consider the
following guidelines:
• Establish a minimum signal strength level of -65 dBm in the planned coverage area.
• Establish a minimum SNR of 25 dB in the planned coverage area.
• When roaming in the planned coverage area, make sure that it takes no longer than 50 milliseconds to perform
an access point to access point handoff.
• Eliminate any 802.11b-only devices and the associated data rates. By eliminating the 802.11b-only devices,
802.11g devices do not need to enter protection mode, which reduces the maximum data throughput of the
devices.
Using Wi-Fi enabled BlackBerry devices for making and taking BlackBerry MVS calls from a home office or a hotspot
is unpredictable because of the instability of those types of networks and cannot be expected to be as reliable as
when the user is in a controlled environment. If your organization's users make Voice over Wi-Fi calls from a home
office or hotspot, you must make sure that the integrated VPN client on their BlackBerry devices is configured for a
highly secure connection to your organization's network through the Internet.
Planning Guide Planning your organization's Wi-Fi infrastructure
8