Configure the BlackBerry MVS

Before you can start using the BlackBerry Mobile Voice System, you must configure a telephony connector, the BlackBerry MVS Server, a class of service, and a template. You must plan the template carefully. The BlackBerry MVS does not apply future template changes to user accounts that already have a template applied to them. The configuration wizard is designed to help you configure these features.

  1. In the MVS Console, click Start.
  2. On the Telephony Connector screen, specify the appropriate information, as described in the "Telephony connector settings" topic. Click Next.
  3. On the Add Voice Mail Connector screen, perform one of the following actions:
    • To integrate the BlackBerry MVS with a solicited voice mail system, select the I want to set up a voice mail connector check box, and specify the appropriate information as described in the “Settings for voice mail connectors” topic. Click Next.
    • If your organization has an unsolicited voice mail system, clear the I want to set up a voice mail connector check box. Click Next.
  4. On the Add MVS Server screen, specify the appropriate information as described in the “BlackBerry MVS Server settings” topic. Click Next.
  5. On the Add Class Of Service screen, type a name for the class of service and specify the appropriate information as described in the "Settings for classes of service" topic. Perform any of the following actions:
    • To use the default settings, click Next.
    • To change the default class of service, select the check box beside each feature that you want to permit users to change or use. Click Next.
  6. On the Add Template screen, type a name for the template and specify the appropriate information as described in the "Template settings" topic.
  7. Click Finish.

Telephony connector settings

A telephony connector represents your organization's telephony infrastructure (for example, a PBX or a gateway) within the BlackBerry MVS environment. A telephony connector specifies the IP address and ports that the BlackBerry MVS uses to connect to your telephony infrastructure for SIP communications as well as parameters required for call control. You configure telephony connectors through the MVS Console.

Field

Description

Display Name

This field specifies the display name for the telephony connector.

Type

This field specifies the type of PBX. Select Universal SIP Connector.

IP Address

This field specifies the IP address of your organization's PBX.

Host Name

This field specifies the host name or FQDN of the PBX.

The default host name is the same as the IP address.

Line Port

This field specifies the UDP port number that the PBX listens on for SIP communications that are made on the behalf of a specific telephone extension within your organization. This is only required with some PBX types.

This port communicates with the line port that is specified on the Add MVS Server page.

The default port number is 5060.

Trunk Port

This field specifies the UDP port number that the PBX listens on for general SIP communications.

This port communicates with the trunk port that is specified on the Add MVS Server page.

The default port number is 6060.

Registration Timeout

This field specifies how frequently BlackBerry devices register with the PBX.

The default registration timeout limit for the BlackBerry Mobile Voice System is 1200 seconds.

Caller Identification Number

When PBX-initiated call direction is applied, the node initiates call setup of the media path to the BlackBerry device. The node must send the Caller Identification Number as the calling party number to identify that this is a BlackBerry MVS call.

Obtain this number from your organization's PBX administrator.

Optional ANI numbers available for identifying BlackBerry MVS calls

This field specifies the optional ANI numbers for your organization's PBX.

When the MVS Session Manager starts a call, it sends the ANI number that is associated with the telephony connector as the Caller Identification Number to the PBX. In some cases, the Caller Identification Number is altered. You can specify additional ANI numbers for identifying BlackBerry MVS calls. Part of the BlackBerry MVS provisioning information that the BlackBerry MVS Server sends to the BlackBerry MVS Client includes the optional ANI numbers so that the BlackBerry MVS Client has a record of the numbers that can call. The BlackBerry MVS Client uses a combination of the caller identification number and the numbers in the Optional ANI numbers list to identify BlackBerry MVS calls.

Location

The Location feature provides phone number normalization. The feature translates the globally unique E.164 number starting with a plus sign (+) to a locally significant number by stripping the plus sign (+) and adding International Direct Dial (IDD) or National Direct Dial (NDD) access codes corresponding to the PSTN dial plan for the selected location.

Normalization is applied to the called number of outgoing external calls that start with a plus sign. The 'called number' refers to a called number sent from the MVS Session Manager to the PBX. 'Outgoing' means from the enterprise to the external network.

Use this feature when your organization's PBX does not support the plus sign or does not add the prefixes automatically.

Back To Top

Settings for voice mail connectors

If your organization uses solicited voice mail notification, you must configure a voice mail connector so that your organization's users can receive MWIs on their BlackBerry devices. Your organization's BlackBerry Mobile Voice System users require a user ID and password to access their voice mail. If your organization uses unsolicited voice mail notifications, do not configure a voice mail connector. If you turn on MWI, when a caller leaves a voice mail message for a user, an MWI displays on the user's device.

You use the settings for voice mail connectors to associate the BlackBerry MVS with a voice mail system. To configure the settings, in the MVS Console, in the left pane, click Voice Mail Connectors > Manage.

Field

Description

Display Name

This field specifies the display name of the voice mail system.

IP Address

This field specifies the IP address of the voice mail server.

Registrar Name

This field specifies the FQDN or IP address of your organization's voice mail server, if required.

Port

This field specifies the port number that the BlackBerry MVS and your organization's voice mail server use for SIP communication.

The default port number is 5060.

Subscription Timeout

This field specifies the length of time, in seconds, before the registration session expires.

Back To Top

BlackBerry MVS Server settings

The BlackBerry MVS Server communicates with the BlackBerry Enterprise Server to send and receive BlackBerry Mobile Voice System requests to and from BlackBerry devices. The BlackBerry MVS Server also communicates with the telephony connector, which provides connectivity to the PBX or gateway, and with the voice mail connector, which provides connectivity with your organization's voice mail server.

Field

Description

MVS Server

Instance Name

This field specifies the instance name of the BlackBerry MVS Server.

Note: The instance name must match the name that was specified for the BlackBerry MVS Server when it was installed.

IP Address

This field specifies the IP address of the computer where you are installing the BlackBerry MVS components.

FMC Phone

SIP IP Address

This field specifies the IP address that FMC Phone uses to bind the SIP trunk and SIP line. Generally, it is the IP address of the computer where you are installing the BlackBerry MVS Server.

Line Port

This field specifies the UDP port number that FMC Phone uses for SIP communications that are made on behalf of a specific telephone extension within your organization. It is only required with some PBX types (for example, Cisco).

The default port number is 5060.

Trunk Port

This field specifies the UDP port number that FMC Phone uses for general SIP communications.

The default port number is 6060.

Telephony Connector DID/DDI Number

This field specifies a DID/DDI number for the telephony connector that the MVS Session Manager communicates with. You must add a DID/DDI number when you configure the BlackBerry MVS for BlackBerry device–initiated calling. The DID/DDI number must be an E.164 formatted number and include the home country code.

Telephony Connector No Data Coverage Number

This field specifies a no data coverage number for the telephony connector that the BlackBerry MVS Client uses to connect to the MVS Session Manager when the BlackBerry MVS user is in an area with no data coverage.

If you configure a no data coverage number, you must configure a corresponding DID/DDI number on your organization's PBX.

Event Manager

Listen Port

This field specifies the port number that the MVS Event Manager listens on for requests for information from the MVS Console. The default port number is 17635.

Enable Event Email Notifications

This field specifies that you want to set up email notifications.

SMTP Server

This field specifies the hostname or IP address of your organization's SMTP server.

SMTP Port

This field specifies the port number of your organization's SMTP server.

"To" Email Address

This field specifies the email address that you want event notifications to be sent to.

"From" Email Address

This field specifies the email address that you want event notifications to be sent from.

Does the BlackBerry MVS require SMTP authentication to send email notifications?

This field specifies that the BlackBerry MVS requires SMTP authentication to send email notifications.

SMTP Username

This field specifies the user name of your organization's SMTP server

SMTP Password

This field specifies the password for your organization's SMTP server.

Confirm SMTP Password

This field confirms the password for your organization's SMTP server.

BlackBerry Enterprise Server Connector

Listen Port

This field specifies the port number that the MVS BlackBerry Enterprise Server Connector listens on for requests to send and receive messages to and from BlackBerry MVS users. The default port number is 17633.

Associated

This field specifies the BlackBerry Enterprise Server that you want to associate with the BlackBerry Enterprise Server Connector.

Change the communication password that the BlackBerry MVS uses

This field specifies that you want to change the communication password between your organization's BlackBerry Enterprise Server components and the BlackBerry MVS.

Data Manager

Listen Port

This field specifies the port number that the MVS Data Manager listens on for requests to retrieve information from the BlackBerry Configuration Database. The default port number is 17631.

Witness Server

Listen Port

This field specifies the port number that the MVS Witness Server listens on for health reports from BlackBerry MVS components. The default port number is 17634.

Back To Top

Settings for classes of service

You use the class of service fields to define permissions for groups of BlackBerry device users.

Field

Description

Class of Service Name

This field specifies the name of the class of service.

BlackBerry MVS Call Features

These options specify the user features and device features that are in the class of service.

BlackBerry MVS Only Calling

This field allows you to restrict your organization's users so that they can use only the BlackBerry Mobile Voice System line and not the phone number that is provided by the wireless service provider.

If you restrict calling using BlackBerry MVS Only Calling, optionally you can turn off the feature based on call direction in combination with roaming. For example, you can turn off BlackBerry MVS Only Calling for incoming calls when a user is roaming.

If you have configured your organization's users for BlackBerry MVS Only Calling, you must also type a phone number in the No Data Coverage Number field on the BlackBerry MVS Server page in the MVS Console. During times of network congestion, if an outgoing call takes too long to initiate, the BlackBerry device will use the no data coverage number to initiate the call. The no data coverage number must be unique and dedicated to the BlackBerry MVS. The no data coverage number must also be different than the number that you use for the Telephony Connector DID/DDI Number and the number that you use for the PBX Initiated Calling Caller Identification Number.

After placing an Emergency Call, allow incoming calls for a duration of (in minutes)

When you configure your organization’s users for BlackBerry MVS Only Calling, you must also configure a length of time that inbound calls are permitted on the mobile line so that emergency services personnel can contact a user who makes an emergency call. You can permit inbound calls on the mobile line from 0 to 2880 minutes.

Validate Caller Identification for PBX-Initiated Calls

During normal call setup some wireless networks might alter the caller identification number. If the BlackBerry MVS Client does not recognize the number the BlackBerry MVS Client rejects the call. To avoid this, you can permit the BlackBerry MVS Client to ignore the number. When you do this, the BlackBerry MVS Client accepts the call.

Even if you have not enabled this feature, when the BlackBerry MVS Client detects that the user is roaming, and the user receives a call that has an altered caller identification number, the BlackBerry MVS Client will still accept the call.

Call Direction

These options permit you to configure the BlackBerry Mobile Voice System to use PBX-initiated calling or BlackBerry device–initiated calling.

Wi-Fi Profile Control

These fields permit you to specify user access to Voice over Wi-Fi calling on pushed Wi-Fi profiles and Voice over Wi-Fi calling on user-defined Wi-Fi profiles.

Device Settings

These fields permit you to define the starting RTP port number that the device uses when making Voice over Wi-Fi calls, and to define the preferred order of codecs when making Voice over Wi-Fi calls.

User Edit Control

These fields specify the features that a user can change.

Scheduling Control

These fields specify the days of the week that a user can schedule.

Back To Top

Template settings

Field

Description

Template Name

This field specifies the name of the template.

BlackBerry MVS Line Label

This is the label that appears on the user's BlackBerry device when the BlackBerry Mobile Voice System line is in use.

Default line for outgoing calls

This field specifies the default line that the BlackBerry device uses to make outgoing calls.

The following settings are available:

  • BlackBerry MVS Line
  • Mobile Line
  • Last selected

When users click Last selected, the next outgoing call uses the most recently selected line.

If you configure the default line for outgoing calls to BlackBerry MVS Line for your organization's users and do not clear the User may change the default line for outgoing calls option in the class of service that is associated with the users, those users can change the line preference from their BlackBerry devices.

When the BlackBerry MVS Line is unavailable, use the Mobile Line

This field appears when BlackBerry MVS Line or Last selected are configured as the default line for outgoing calls. This field specifies whether users can use the mobile line if the BlackBerry MVS line is not available.

The following settings are available:

  • Always: Users can use the work number to make outgoing calls. If the work number is not available, outgoing calls use the mobile number.
  • Ask: Users can use the work number to make outgoing calls if the work number is available. If the work number is not available, users can use the mobile number, if they accept a prompt to do so.
  • Never: Users can use only the work number to make outgoing calls. This option does not appear if Last selected is configured as the default line for outgoing calls.

Default network for BlackBerry MVS calls

This field specifies the default voice network that the device uses to make outgoing calls. The following voice network settings are available:

  • Wi-Fi
  • Mobile
  • Mobile Only

When Wi-Fi is unavailable, use Mobile

This field appears when Wi-Fi is selected as the default network for work calls. This field specifies whether users can use the mobile network if a Wi-Fi network is not available.

The following settings are available:

  • Yes: When a user is connected to a Wi-Fi network, the BlackBerry MVS uses Voice over Wi-Fi to make and receive work calls; however, the user can use the work number regardless of Wi-Fi network availability. When the user is outside a Wi-Fi coverage area, the BlackBerry MVS uses Voice over Mobile.
  • No: A user must be connected to a Wi-Fi network to use the work number.

Outgoing call setup sound

This field specifies the sound that plays when the BlackBerry MVS is setting up an outgoing call. The following two options are:
  • Tones
  • Ringing

Voice Mail Access Number

This field specifies the number that users call to access voice mail.

MWI Notifications

This field specifies whether MWIs are turned on or turned off.

Network handoff

This field specifies whether a BlackBerry device can automatically move an active call between the Wi-Fi network and the mobile network. The following options are available:
  • Automatic handoff with user notification: A message and an audible alert notifies the user when an active call moves between Voice over Wi-Fi and Voice over Mobile.
  • Automatic handoff with user prompt: A message and an audible alert asks the users if they want to move an active call between Voice over Wi-Fi and Voice over Mobile. If the user does not respond to the message, the call does not move.
  • Automatic handoff is not available: Automatic network handoff is not available.

Caller Restrictions

This field specifies one of the following caller restrictions:

  • All Callers Allowed
  • All Callers Except Blocked
  • Allowed Callers Only
  • No Callers Allowed

If you change the Caller Restriction field to No Callers Allowed for your organization's users and do not clear the User may change caller restrictions option in the class of service that is associated with the users, those users can receive calls if they change the caller restrictions on their devices to permit BlackBerry MVS calls.

Allow calls from unknown numbers

This field specifies that you want to allow calls from unknown numbers to reach your organization's BlackBerry MVS users.

Blocked Callers

This field specifies the phone numbers that are not permitted to contact your organization's BlackBerry MVS users.

Allowed Callers

This field specifies the phone numbers that are permitted to contact your organization's BlackBerry MVS users.

Office Time Zone

This field specifies the local time zone.

Days of Week

These fields specify when users can receive calls (for example, all days of the week or only a specific day of the week).

Back To Top
Previous topic: Log in to the MVS Console

Was this information helpful? Send us your comments.