Integration Guide

Local Navigation

Using the Cisco Options Package (COP) file

The BlackBerry Mobile Voice System COP file is a phone definition file from Cisco that provides native support for BlackBerry MVS devices in the Cisco Unified Communications Manager environment. The BlackBerry MVS is only supported when the BlackBerry MVS COP file is installed.

Installing the COP file requires a restart of all of the nodes in the cluster. Make sure that you schedule any Cisco Unified Communications Manager changes during a maintenance window.

The following COP files are available for new installs and upgrades:

  • cmterm-rim_409_8.6v1-sip.cop.sgn, which uses 6 DLUs, permits your organization's users to make both Voice over Wi-Fi and Voice over Mobile calls.
  • cmterm-rim_410_8.6v1-sip.cop.sgn, which uses 3 DLUs, permits your organization's users to make Voice over Mobile calls only.

To download the COP files, visit the Software Download for BlackBerry Mobile Voice System page.

If you have already configured your organization's users for Voice over Mobile calling only and do not want them to use Voice over Wi-Fi calling, you do not have to upgrade the COP file. Users that use a 3 DLU COP file will register successfully with the PBX and the Voice over Wi-Fi options will not be available to them.

If you have already configured your organization's users for Voice over Mobile calling and you want your users to use Voice over Wi-Fi calling, you must perform the following tasks:

  • On the Cisco Unified Communications Manager you must install the new cmterm-rim_409_8.6v1-sip.cop.sgn COP file
  • On the Cisco Unified Communications Manager you must remove the BlackBerry MVS Client instances that are using the old COP file and add the instances back using the new COP file
  • On the BlackBerry MVS you must configure your organization's users for Voice over Wi-Fi calling

Install the COP file for the BlackBerry MVS

  1. Upload the digitally-signed BlackBerry Mobile Voice System COP file to an SFTP server.
  2. In the Cisco Unified Communications Manager UI, in the Navigation drop-down list , click Cisco Unified OS Administration.
  3. Click GO.
  4. Log in using the OS or Platform administration account.
  5. Click Software Upgrades > Install/Upgrade.
  6. In the Source list, select Remote Filesystem.
  7. In the Directory field, enter the path to the directory on the SFTP server where you uploaded the BlackBerry MVS COP file.
  8. In the Server field, enter the IP address or host name of the SFTP server.
  9. In the User Name field, enter the user name for the SFTP sever.
  10. In the User Password field, enter the password for the SFTP server.
  11. In the Transfer Protocol list, select SFTP.
  12. Click Next.
  13. In the Options/Upgrades list, select the digitally-signed BlackBerry MVS COP file.
  14. Click Next.
  15. Verify the MD5 hash value for the digitally-signed BlackBerry MVS COP file against the Cisco website.
  16. Click Next.
  17. When the BlackBerry MVS COP file installation is finished, restart all Cisco Unified Communications Manager nodes in the cluster, starting with the Publisher server.
Back To Top

Upgrade existing BlackBerry MVS users to use a new COP file

You do not have to perform this procedure if you are installing the BlackBerry Mobile Voice System for the first time.

  1. Log in to the Cisco Unified Communications Manager Administration webpage.
  2. Navigate to Bulk Administration > Phones > Export Phones > All Details.
  3. In the Select the Device Type field, select BlackBerry MVS Client.
  4. In the File Name field type a name for the file.
  5. Click the Run Immediately option.
  6. Click Submit.
  7. After the export completes, navigate to Bulk Administration > Upload/Download files and download the file.
  8. Save the file with a .csv file name extension.
  9. Navigate to Bulk Administration > Phones > Phone Template.
  10. Create a template for the new BlackBerry MVS Client with Voice over Wi-Fi device type.
  11. In the new template, complete the following fields:
    • Template Name
    • Description
    • Device Pool
    • Phone Button Template
    • Device Security Profile
    • SIP Profile
    • Required DTMF Reception
  12. Click Save.
  13. Click Add a new DN.
  14. In the Line 1 area, complete the following fields:
    • Line Template Name
    • Set the Maximum Number of Calls field to 4.
    • Set the Busy Trigger field to 3.
  15. Click Save.
  16. Open the .csv file that you created in step 8 and delete all BlackBerry MVS users who will not use Voice over Wi-Fi. Make sure that you keep the following columns in the file:
    • Device Name
    • Description
    • Device Pool
    • CSS
    • Location
    • Network Locale
    • Media Resource Group List
    • Device User Locale
    • Common Phone Profile
    • Directory Number 1
    • Partition 1
    • Line CSS 1
    • Line Text Label 1
    • External Phone Number Mask 1
    • Line Description 1
    • Alerting Name 1
    • Alerting Name ASCII 1
    • Display 1
    • ASCII Display 1
  17. Save the .csv file.
  18. Create another .csv file and list all of the device names to be deleted in a single column.
  19. Navigate to Bulk Administration > Upload/Download files and import the .csv file from step 18. Set the following parameters:
    • Target = Phones
    • Transaction Type = Delete Phones - Custom File
  20. Click Save.
  21. Navigate to Bulk Administration > Phones > Delete Phones > Custom File.
  22. In the Delete Phones where field, select Device Names and in the Custom File field, select the .csv file that you uploaded in step 19.
  23. Click the Run Immediately option.
  24. Click Submit. Before continuing, wait until the BAT Job Scheduler indicates that the devices are deleted.
  25. Navigate to Bulk Administration > Upload/Download files and import the .csv file that you saved in step 17. Set the following parameters:
    • Target = Phones
    • Transaction Type = Insert Phone - Specific Details
  26. Click Save.
  27. Navigate to Bulk Administration > Phones > Insert Phones.
  28. In the Insert Phones section, click the Insert Phones Specific Details option, and select the file that you uploaded in step 25.
  29. In the Phone Template Name drop-down list, click the template that you created in step 10.
  30. Click Run Immediately > Submit.
Back To Top

Update BlackBerry MVS users in the MVS Console to use Voice over Wi-Fi calling

  1. In the MVS Console, in the left pane, expand Users.
  2. Click Manage.
  3. Select the check box beside each user account that you want to change.
  4. Click Change MVS User Settings.
  5. Set the Default network for BlackBerry MVS calls option and the When <default network> is unavailable, use <secondary network> option appropriately for the users.
  6. Click Review Changes.
  7. Click Save.
Back To Top

Was this information helpful? Send us your comments.