Installation and Administration Guide for Cisco Unified Mobility Advantage, Release 7.0
Deploying Cisco Unified Mobile Communicator on BlackBerry Devices
Downloads: This chapterpdf (PDF - 174.0KB) The complete bookPDF (PDF - 4.1MB) | Feedback

Deploying Cisco Unified Mobile Communicator on BlackBerry Devices

Table Of Contents

Deploying Cisco Unified Mobile Communicator on BlackBerry Devices

How to Configure the BlackBerry Enterprise Server for Use With Cisco Unified Mobility Advantage

Configuring IT Policies

Configuring Software Configuration Policies

How to Make the Client Application Available to Users

Allowing Third Party Application Downloads from the BlackBerry Enterprise Server

Downloading the BlackBerry Client Installer from Cisco Unified Mobility Advantage

Placing the Client Software on the BlackBerry Enterprise Server

Creating a Software Configuration File and Deploying it to Users

Configuring Cisco Unified Mobility Advantage to Send Provisioning Messages to BlackBerry Devices

Preventing Outlook From Treating BlackBerry Provisioning Email Messages As Junk Mail

Provisioning and Installing on BlackBerry Devices


Deploying Cisco Unified Mobile Communicator on BlackBerry Devices


Revised Date: August 13, 2009

BlackBerry devices running the latest Release 3.x version of Cisco Unified Mobile Communicator will run with Cisco Unified Mobility Advantage Release 7.x, but users will not have Release 7.x features. See the Release Notes for limitations.

Configure the BlackBerry Enterprise Server and Cisco Unified Mobility Advantage as follows:

How to Configure the BlackBerry Enterprise Server for Use With Cisco Unified Mobility Advantage

How to Make the Client Application Available to Users

Configuring Cisco Unified Mobility Advantage to Send Provisioning Messages to BlackBerry Devices

Preventing Outlook From Treating BlackBerry Provisioning Email Messages As Junk Mail

Provisioning and Installing on BlackBerry Devices

How to Configure the BlackBerry Enterprise Server for Use With Cisco Unified Mobility Advantage

Configuring IT Policies

Configuring Software Configuration Policies

Configuring IT Policies

Configure the following IT Policy settings on the BlackBerry Enterprise Server to enable the installation of third-party applications.

Procedure


Step 1 Open the BlackBerry Manager.

Step 2 Select the BlackBerry domain.

Step 3 Select Global tab > Edit Properties link > IT Policy.

Step 4 Select affected IT Policy, and select Properties.

Step 5 Select Security Policy Group.

Step 6 Set Disallow Third Party Application Download to False.

Step 7 Select TCP Policy Group.

Step 8 Set the following values for each GSM mobile phone service provider. In the U.S., these settings are:

T-Mobile:

APN—wap.voicestream.com

Username—leave blank

Password—leave blank

AT&T/Cingular:

APN—wap.cingular

Username—wap@cingulargprs.com

Password—leave blank


Note If you have multiple GSM mobile phone service providers, you must create multiple IT policies with different values in this field. For non-GSM mobile phone service providers, these values can be set to any value.



Configuring Software Configuration Policies

Procedure


Step 1 Open the BlackBerry Manager and select the BlackBerry domain.

Step 2 Select the Software Configurations tab.

Step 3 Select Manage Application Policies.

Step 4 Select Policy and select Properties

Step 5 Set these properties:

Policy
Setting

Disposition

Required

Internal Network Connection

Allowed



What To Do Next

Install and configure Cisco Unified Mobility Advantage, and configure enterprise servers as applicable.

How to Make the Client Application Available to Users

Perform the following procedures in order:

Allowing Third Party Application Downloads from the BlackBerry Enterprise Server

Downloading the BlackBerry Client Installer from Cisco Unified Mobility Advantage

Placing the Client Software on the BlackBerry Enterprise Server

Creating a Software Configuration File and Deploying it to Users

Allowing Third Party Application Downloads from the BlackBerry Enterprise Server


Note For security reasons, some BlackBerry Enterprise Server configurations do not allow third party application downloads. You must temporarily allow third party application downloads in order to deploy Mobile Communicator on BlackBerry Devices.
For more information on policy and software configuration settings, see the BlackBerry Enterprise Server Policy Reference Guide.


Procedure


Step 1 Sign in to the BlackBerry Enterprise Server.

Step 2 Select Global.

Step 3 Select Edit Properties.

Step 4 Select IT Policies in the IT Policy Administration window.

Step 5 Highlight IT Policies and select the More button located on the far right of the screen. You should see any policies that have already been provisioned.

Step 6 Select Properties and find the Security Policy Group.

Step 7 Select on the Security Policy Group.

Step 8 Locate the Disallow Third Party Application Download setting and select False.

Step 9 Select OK.


Downloading the BlackBerry Client Installer from Cisco Unified Mobility Advantage

Before You Begin

Upload the client software to Cisco Unified Mobility Advantage. See Uploading a Cisco Unified Mobile Communicator Release, page 13-2

Procedure


Step 1 Select the [+] beside Handset Platform Management in the Admin Portal.

Step 2 Select Version Management.

Step 3 Select Download next to the BlackBerry device to download the Cisco Unified Mobile Communicator.zip file to your system.

Step 4 Extract the .zip file.


Placing the Client Software on the BlackBerry Enterprise Server

Before You Begin

Complete the following:

Allowing Third Party Application Downloads from the BlackBerry Enterprise Server

Procedure


Step 1 Browse to this location on the BlackBerry Enterprise Server to place the Cisco Unified Mobile Communicator files into a new share:

C:\Program Files\Common Files\Research In Motion

Step 2 Create a placeholder folder titled \Shared\Applications for the Cisco Unified Mobile Communicator files:

C:\Program Files\Common Files\Research In Motion\Shared\Applications

Step 3 Create a folder titled \cisco_umc within the \Applications folder:

C:\Program Files\Common Files\Research In Motion\Shared\Applications\cisco_umc

Step 4 Place the following two files in the \cisco_umc folder (XX represents the language):

cisco_umc_XX.cod

cisco_umc_XX.alx

Step 5 Run the loader.exe program:

a. Change to the Apploader directory:

C:\Program Files\Common Files\Research In Motion\Apploader

b. Run loader.exe /index.

Step 6 Set up the folder as a share:

a. Browse to this location:

C:\Program Files\Common Files\Research In Motion

b. Select Everyone under Group or user names on the Share Permissions folder.

c. Select Allow next to Read under Permissions for Everyone.

Step 7 Select OK.


Creating a Software Configuration File and Deploying it to Users


Note See the RIM document Creating a Software Configuration— BlackBerry Enterprise Server Quick Start Supplement for more information.


Procedure


Step 1 Sign in to the BlackBerry Manager-Security Administrator Authority.

Step 2 Select the Software Configurations tab on the BlackBerry Domain (near the top of the window).

Step 3 Select Add New Configuration.

Step 4 Type a name and description for the software configuration file that will contain the Cisco Unified Mobile Communicator application in the Configuration Name and Configuration Description fields.

For example, Mobile Communicator Deployment.

Step 5 Enter the UNC name (not the local file path) in the Device Software Share Location field.

Step 6 Select OK.

A list of device software and applications appears. The list includes the Cisco Unified Mobile Communicator application.

Step 7 Set the Delivery to Wireless Only.

Step 8 Select the Policies button.

Step 9 Set the Application Control policies as shown in this example:

Step 10 Select OK.

Step 11 Start the BlackBerry Handheld Manager.

Step 12 Select Users.

Step 13 Select the user name.

Step 14 Select Assign Software Configuration under Device Management.

Step 15 Locate the name of the Cisco Unified Mobile Communicator software configuration file you created in Step 4.

For example, Mobile Communicator Deployment.

Step 16 Select OK.

The BlackBerry Enterprise Server polls BlackBerry Devices every four hours. At that time, the server deploys any new or missing applications to the BlackBerry Devices.


Configuring Cisco Unified Mobility Advantage to Send Provisioning Messages to BlackBerry Devices

Use SMTP Server Configuration to enable the Cisco Unified Mobility Advantage to send email messages to BlackBerry devices.

Before You Begin

Make sure that your SMTP Server allows relaying from Cisco Unified Mobility Advantage. For information, contact your SMTP administrator.

Procedure


Step 1 Select the [+] beside System Management.

Step 2 Select SMTP Server Configuration.

Step 3 Enter information:

Item
Description

Host Name

Hostname of your SMTP gateway. This must be the same as your Exchange hostname if you use the Exchange server as your SMTP gateway.

Port

Port number for the SMTP gateway. Usually, this is 25.

Authentication Required

Identifies whether or not your organization requires authentication on the mail server. If the value for this field is True, you will need to enter a password apart from an Admin Email address (see next two fields).

Admin Email

Email address for the administrator responsible for management of Cisco Unified Mobility Advantage.

Cisco Unified Mobility Advantage uses this email address to send provisioning emails and alerts to BlackBerry users.

SMTP Authentication Password

Password associated with the Admin Email address.

Required only if the SMTP server requires authentication.


Step 4 Select Submit.

Step 5 Restart Cisco Unified Mobility Advantage to activate the settings.


Preventing Outlook From Treating BlackBerry Provisioning Email Messages As Junk Mail

Have users perform the following procedure to prevent Microsoft Outlook from treating BlackBerry provisioning email messages as junk mail.

Before You Begin

Note the Admin Email address in the Admin Portal under System Management > SMTP Server Configuration. You will provide this to users.

Procedure


Step 1 Open Microsoft Outlook.

Step 2 Open the Tools menu and select Options.

Step 3 Select Preferences.

Step 4 Select the Junk e-mail button, and then select the Safe Senders tab.

Step 5 Select Add.

Step 6 Enter the Admin email address, and select OK.

Step 7 Select OK again to complete the configuration.

Step 8 Continue to check your Junk mailbox and, if necessary, disable junk-mail blocking during provisioning.


Provisioning and Installing on BlackBerry Devices

You can use the procedure in this section to:

Add a phone for each user

Install the client software

There are two ways to add phones:

You can use the procedure in this topic.

You can have users add their own phones in the User Portal. However, you must still complete the requirements in the Before You Begin section of this procedure. Refer users to the Cisco Unified Mobile Communicator 3.x Quick Start Guide for BlackBerry Devices.

There are three ways to install the client software on BlackBerry devices:

You can automate installation from the BlackBerry Enterprise Server. However, each phone must still be associated with its user using one of the methods mentioned above.

You can install the client manually on each phone using this procedure

You can have users install the client on their own phones by using the User Portal. However, you must still complete the requirements in the Before You Begin section of this procedure. Refer users to the Cisco Unified Mobile Communicator 3.x Quick Start Guide for BlackBerry Devices.

Before You Begin

In order to prevent provisioning email messages from being routed to the "Junk E-mail" folder in Outlook, give BlackBerry device users the Admin Email address and the procedure in Preventing Outlook From Treating BlackBerry Provisioning Email Messages As Junk Mail.

(Cisco Unified Mobility Advantage Release 7.0 only) By default access is restricted by device. You must remove this restriction for BlackBerry devices. To remove this restriction for all devices on the system, see Enabling Device ID Checking, page 12-1.

After loading Cisco Unified Mobile Communicator on the BlackBerry Enterprise Server as described in Placing the Client Software on the BlackBerry Enterprise Server, Cisco Unified Mobile Communicator is automatically pushed out within four hours to activated users with the appropriate BlackBerry device data service. When this is complete, you can provision Mobile Communicator on the BlackBerry device.

Follow procedures in How To Add Users and Prepare to Add Their Devices, page 14-1

Procedure


Step 1 Sign in to the Cisco Unified Mobility Advantage Admin Portal.

Step 2 Select the [+] beside End Users.

Step 3 Select Search/Maintenance to display activated users.

Step 4 Search for the user by scrolling through the list or by searching by name or mobile phone number and selecting Search.

Step 5 Select Edit next to the user ID.

Step 6 Select Add Phone.

Step 7 Edit the Add Phone properties:

Phone List
Description

Country

Select the country of the service provider.

Service Provider

Select the mobile phone service provider

Phone Make/Model

Select the mobile phone make and model

Language

Select language.

Phone Number

Enter the area code and mobile phone number

Use the format 5555555555.


Step 8 Select Next.

Step 9 Do one of the following:

If
Do This

You are distributing the client software through the BlackBerry Enterprise Server

Select Finish.

 

You need to manually install the client software on the BlackBerry device

1. Follow the prompts that you see to install Cisco Unified Mobile Communicator on the BlackBerry device.

2. Select Finish when installation is complete.

 



What To Do Next

(Cisco Unified Mobility Advantage Release 7.0 only) If you did not disable Device ID checking for the entire system, you must disable it for each BlackBerry device you add. See Restricting Access By Device, page 14-2.

Give the BlackBerry device to the user. The user must open Cisco Unified Mobile Communicator on the device and enter his or her Cisco Unified Mobile Communicator password at the sign-in prompt.

Evaluate the items in Information to Give to Users, page 14-3 and provide the user with instructions for the tasks that you have not already completed.