Feedback
Contents
- Before You Begin
- Deploy Cisco Jabber
- Required Files
- Install Cisco Options Package File for Devices
- Verify Device COP File Version
- Dial Rules
- Application Dial Rules
- Use of Dial Rules with Cisco Jabber
- Obtain COP File for Dial Rules
- Copy Dial Rules
- Locate Copy of Dial Rules
- Modify Dial Rules
- Restart TFTP Service
- Increase SIP Dual Mode Alert Timer Value
- Create a Dedicated SIP Profile
- System-Level Prerequisites
- Usage and Error Tracking
Before You Begin
Deploy Cisco Jabber
Procedure
Step 1 Verify system requirements, including network requirements for optimal voice quality and call maintenance. Release notes for this product are located at http://www.cisco.com/en/US/products/ps11596/prod_release_notes_list.html. Step 2 Review the list of necessary files. You can collect these files now, or collect them as you need them for the procedures in this document. See Required Files. Step 3 Set up the system. See Before You Begin. Step 4 Add a test device. See Administration. Step 5 Set up required features as follows: Instructions for each feature are listed in Feature Setup.
- Verify that all prerequisites are met.
- Set up the system-level settings for the features and functionality that you will deploy.
- Set up the required user-level settings.
- Set up the device in Cisco Unified Communications Manager (Unified CM).
- Test your setup for each feature.
Step 6 Use your working setup as a template for setting up devices for your users. See Bulk Configuration. Step 7 Send an email message with the information that users need to set up Cisco Jabber.
The settings you entered on the device page in Unified CM are automatically entered into the application on the device. Users enter passwords as applicable. Documentation for users is located at http://www.cisco.com/en/US/products/ps11596/products_user_guide_list.html.
Required Files
You need the following files to set up and use Cisco Jabber. You can collect them all now or obtain them when you are ready to use them.
Table 1 Required Files for all Cisco Unified Communications Manager Releases File
To Obtain This File, See
Device COP file
Go to the software download site, http://www.cisco.com/go/jabber_iphone_cop.
Locate and download cmterm-iphone-install-130129.cop.sgn.
Cisco Jabber application for your device
Access the App Store from within iTunes or use the App Store application on the iOS device.
When you search for Cisco Jabber, be sure to distinguish Cisco Jabber from Cisco Jabber IM.
Table 2 Additional Required Files for Cisco Unified Communications Manager Release 8.5 and Earlier File
To Obtain This File, See
Cisco Options Package (COP) file required to make Application Dial Rules available to Cisco Jabber
Note This file is required for Unified CM 8.5 and earlier. For Unified CM 8.6 and later, the Application Dial Rules are integrated into the application, so you do not need to install an additional COP file to see the applicable fields.
Cisco Jabber for iPhone uses the same COP file as Cisco UC Integration for Microsoft Office Lync to make Application Dial Rules available.
Go to the Software Downloads page for Cisco UC Integration for Microsoft Office Communicator. Download and unzip the Administration Toolkit bundle. Within this bundle, you need only the following file: cmterm-cupc-dialrule-wizard-0.1.cop.
Install Cisco Options Package File for Devices
ProcedureTo make Cisco Jabber available as a device in Unified CM, you must install a device-specific Cisco Options Package (COP) file on all your Unified CM servers.
Perform this procedure at a time of low usage; it can interrupt service.
General information about installing COP files is available in the "Software Upgrades" chapter in the Cisco Unified Communications Operating System Administration Guide for your release, available from the maintenance guides list.
Verify Device COP File Version
ProcedureUse the following procedure to verify that you are using the correct device COP file for this release of Cisco Jabber.
Step 1 Sign in to the Unified CM Administration portal. Step 2 Choose . Step 3 Click Add New. Step 4 From the Phone Type drop-down list, choose Cisco Dual Mode for iPhone. Step 5 Click Next. Step 6 Scroll down to the Product Specific Configuration Layout section, and verify that you can see the Dial via Office drop-down list. If you can see the Dial via Office drop-down list, the COP file is already installed on your system.
If you cannot see the Dial via Office drop-down list, locate and download the correct COP file. For more information, see Required Files.
Dial Rules
Cisco Jabber for iPhone uses two sets of dial rules to make it easier for users to dial phone numbers from the their iPhone.Unified CM generates these files when the Cisco Options Package (COP) file for dial rules is installed.
Directory Lookup Dial Rules use Microsoft Active Directory to identify callers. Cisco Jabber displays the Caller ID from the main iPhone Address Book instead of any name provided by the Unified CM or Microsoft Active Directory.
Application Dial Rules
Because people are accustomed to dialing numbers differently from a mobile device than from a desk phone, consider setting up Unified CM to accommodate the different number patterns that mobile device users dial.
You can create these rules in Unified CM so that they apply to all calls and devices; or edit an XML file, described later, so that the rules apply only to users of Cisco Jabber or so that different rules apply to devices in different countries or area codes.
For example, users sometimes dial numbers as follows:
- Mobile device users may not be in the habit of dialing 9 before they dial a number outside the company.
- If the mobile device number is in a different area code than the desk phone number, users may dial area codes when using their mobile device even though they do not include the area code when dialing from work phones, and vice versa.
- Mobile device users who dial an international number sometimes begin the number with a plus sign (+).
You can set up Application Dial Rules to successfully connect the types of calls that are described in these examples.
For complete information about setting up Application Dial Rules, see the online help in Unified CM.
Use of Dial Rules with Cisco Jabber
Perform this series of procedures to make all your existing dial rules available to Cisco Jabber.
Note
These procedures apply only to Unified CM Release 8.5 and earlier. For Unified CM 8.6 and later, the Application Dial Rules are integrated into the application, so you do not need to install an additional COP file to see the applicable fields. You can access the Application Dial Rules settings in Unified CM 8.6 and later by choosing . For information about Application Dial Rule setup, see the related chapter in the Cisco Unified Communications Manager Administration Guide for your release, available from the Unified CM maintenance guides list.
Note
The COP file that you use for dial rules is different than the device COP file that is described elsewhere in this document.
Other Cisco products can use this same COP file for dial rules.
With this series of procedures, you install required XML files in a folder called CUPC at the root level of the Unified CM TFTP server. If you need different rules for Cisco Jabber than you need for other clients that use this file, use the optional procedure to copy and modify the XML file to create a dedicated file for Cisco Jabber.
If you set up other Cisco telephony clients and integrations, you may have performed this series of procedures already.
Note
Every time you update the dial rules on Unified CM, you must repeat this series of procedures to make the changes available to clients, including Cisco Jabber.
- Obtain COP File for Dial Rules
- Copy Dial Rules
- Locate Copy of Dial Rules
- Modify Dial Rules
- Restart TFTP Service
Obtain COP File for Dial Rules
Procedure
Step 1 Go to the Cisco UC Integration for Microsoft Office Communicator Software Downloads page.
Note Cisco Jabber for iPhone uses the same COP file as Cisco UC Integration for Microsoft Office Communicator to make Application Dial Rules available.
Step 2 Next to the Administration Toolkit bundle, click Download. Step 3 Follow the instructions on the screen. Step 4 Unzip the downloaded file. Step 5 Locate the following dial rules COP file in the CUCM folder: cmterm-cupc-dialrule-wizard-0.1.cop.sgn. You do not need any other files in this download.
Step 6 Place the dial rules COP file on a server that is accessible by FTP or SFTP.
Copy Dial Rules
Procedure
Step 1 Sign in to the Publisher server in your Unified CM cluster. Step 2 In the top-right corner of the Unified CM Administration portal, choose Cisco Unified OS Administration and select Go. Step 3 Select . Step 4 Specify the location of the Dial Rules COP file in the Software Installation/Upgrade window. Step 5 Select Next. Step 6 From the Available Software drop-down list, select the COP file. Step 7 Select Next. Step 8 Select Install. Step 9 Repeat this procedure for every Unified CM server that runs a TFTP server.
Modify Dial Rules
Use this optional procedure only if you want to modify the dial rules file for use by Cisco Jabber. For example:
- You may require rules that are unique to Cisco Jabber and are not used for other clients.
- You may need to create multiple files and assign different rules to the Cisco Jabber device of each user. One example is if users have mobile devices that are issued in different countries or area codes, and your existing rules do not accommodate the way users may dial numbers from mobile devices based in multiple countries or area codes.
Before You BeginProcedure
- Using the guidelines in Application Dial Rules, determine the Application Dial Rules you need.
- If you do not know how to use the TFTP server on Unified CM, go to the Unified CM maintenance guide list and locate the following documents for your release:
Step 1 Navigate to the CUPC folder at the root level of the Unified CM TFTP server. Step 2 Copy the rules file you want to modify for Cisco Jabber.
Example:Using the built-in TFTP client on a PC or Mac, enter the following commands:tftp server-name get CUPC/AppDialRules.xmlStep 3 Rename the file as needed.
Example: AppDialRulesFrance.xmlStep 4 Open the file in a text editor. Step 5 Following the example of the existing rules, modify or add rules as needed. Step 6 Save your changes. Step 7 Upload the modified file.
Step 8 Repeat this procedure for any other rules files that you need to customize.
What to Do Next
After you complete and upload all customized dial rules files, continue with the next procedure in this section.
If you use Unified CM Release 8.5 or earlier and you want Cisco Jabber devices to apply Application Dial Rules, you must specify the path to these dial rules files, including the filenames. If you move or rename these files, make sure you update this path in the Application Dial Rules URL field on the configuration page for each deployed device.
Restart TFTP Service
ProcedurePerform this procedure at a time of low usage; it can interrupt service.
For more information, see "Starting, Stopping, Restarting, and Refreshing Status of Services in Control Center" in the Cisco Unified Serviceability Administration Guide in the maintenance guides list.
Step 1 In the top-right corner of the Unified CM Administration portal, choose Cisco Unified Serviceability and select Go. Step 2 Select . Step 3 Choose the server and select Go. Step 4 Select Cisco TFTP. Step 5 Select Restart. Step 6 Repeat this procedure on every server on which you ran this Application Dial Rules COP file.
Increase SIP Dual Mode Alert Timer Value
ProcedureIncrease the SIP Dual Mode Alert Timer value to ensure that calls to the Cisco Jabber extension are not prematurely routed to the mobile-network phone number.
Step 1 Sign in to the Unified CM Administration portal. Step 2 Select . Step 3 Select the server. Step 4 Select the Cisco CallManager (Active) service. Step 5 Scroll to the Clusterwide Parameters (System - Mobility) section. Step 6 Increase the SIP Dual Mode Alert Timer value to 4500 milliseconds. Step 7 Select Save.
Note If, after you increase the SIP Dual Mode Alert Timer value, incoming calls that arrive in Cisco Jabber are still terminated and diverted using Mobile Connect, you can increase the SIP Dual Mode Alert Timer value again in increments of 500 milliseconds. The 4500 millisecond value is the lowest recommended value.
Create a Dedicated SIP Profile
ProcedureCreate a dedicated SIP Profile that allows Cisco Jabber to stay connected to Unified CM while Cisco Jabber is running in the background.
Only certain versions of Unified CM support this feature. See the "System Requirements" in the Release Notes for Cisco Jabber for iPhone at http://www.cisco.com/en/US/products/ps11596/prod_release_notes_list.html.
Note
This device setting does not affect Cisco Jabber 8.0 clients.
What to Do Next
Select this SIP profile for all Cisco Dual Mode for iPhone devices that are running Cisco Jabber.
System-Level Prerequisites
Make sure your system meets the following prerequisites:
- See the “Call Park” chapter in the Cisco Unified Communications Manager Features and Services Guide at http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html.
- Conferencing calls requires G.711 for all participating endpoints, unless transcoding is available. If only G.729a is supported on Cisco Jabber, you must set up an external transcoder to allow transcoding from G.729a on the phone to G.711 on the conference bridge.
Usage and Error Tracking
Cisco Jabber relies on a third-party service, Google Analytics, to collect and generate aggregated usage and error-tracking data that Cisco uses to discover defects and improve product performance. In compliance with the Google Analytics privacy statement, Cisco does not store personal identifying information.
All information that Google Analytics stores and collects is confidential. Only Cisco has access to this information. This functionality is not currently available as a reporting tool for administrators.
You can enable or disable usage reporting for each user when you set up each Cisco Jabber device in Unified CM.
Depending on the setting, Cisco collects the following information:
Table 3 Usage and Error Tracking Usage and Error Tracking Setting
Information Collected
Enabled
- Errors and warnings
- Screen views in Cisco Jabber (for example, how often users view their list of voice messages)
- Feature activity (for example, how often users add a contact)
- IP address of the TFTP server to which Cisco Jabber connects
- Approximate geographic location, based on mobile service provider activity
Detailed
Same information collected as when you select "Enabled" Disabled
None
The first time users open Cisco Jabber, they see an agreement that describes the data that Cisco collects. Users must accept this agreement to use the application, whether or not the usage tracking feature is currently enabled.
