Feedback
Contents
Administration
Set Up Cisco Jabber
Perform this series of procedures to set up all your Cisco Jabber features on your Unified CM, and then provide users with instructions for setting up Cisco Jabber on their devices.
Perform the following procedures in order:
- Add a test device with basic telephony features. See Add User Device.
- Set up any additional features on your test device. These features are optional. See Feature setup.
- After you verify that all features work on your test device, set up individual users and devices in bulk. See Bulk configuration.
- (Optional) Optimize Cisco Jabber setup for users by preparing an automatic setup link. See Prepare Automatic Setup Link (Optional).
- (Optional) Customize the user experience by setting up other applications to cross-launch Cisco Jabber. See Cross-Launch Cisco Jabber from Another Application (Optional).
- Provide users with instructions for setting up their Cisco Jabber clients. See User Instructions.
Add User Device
Before You BeginProcedure
- Set up and test voicemail for the extension you will assign to this device, following standard procedures for any device. Make sure you set up the voicemail number as a regular phone number so users can call the voicemail system using an Enterprise VoIP or mobile call.
- Verify that the Device Pool that you will assign to the Cisco Jabber device is associated with a region that includes support for all supported audio codecs. For supported codecs, see the Release Notes for this product at http://www.cisco.com/en/US/products/ps11596/prod_release_notes_list.html.
- Determine whether you want to enable or disable usage and error tracking for each user. For information, see Usage and Error Tracking.
Step 1 Sign in to the Unified CM Administration portal. Step 2 Select , and click Add New to add a new phone device with Cisco Dual Mode for iPhone as the Phone Type. Step 3 Enter the required settings for your devices. For more information, see Parameter Descriptions. Restrictions and requirements that are not specific to Cisco Jabber may apply to these values. If you require additional information about any option on the device configuration window, see the online help in Unified CM.
Step 4 Select Save. Step 5 Select Apply Config. Step 6 Select [Line n] - Add a new DN. Step 7 Enter the directory number of this device. This can be a new DN; a desk phone with the same DN is not required.
Step 8 If this device is a standalone device (not sharing a DN with a desk phone), configure these settings to forward calls when Cisco Jabber is not running and connected to the network, so callers do not receive an error message: For more information about these settings, see the online help in Unified CM for the Forward All and other settings on the same window.
Step 9 Set the No Answer Ring Duration (seconds) to 24 seconds to allow time for Cisco Jabber to ring before calls go to voicemail.
Note If Cisco Jabber for iPhone users have a PIN on the device, you may need to increase the No Answer Ring Duration (seconds) setting to ensure that they have enough time to enter the PIN and answer the call before the call goes to voicemail.
If you increase the No Answer Ring Duration (seconds) setting, see related cautions for this setting in the online help in Unified CM.
Step 10 In the Multiple Call/Call Waiting Settings on Device device name section, in the Busy Trigger field, ensure that the value is set to 2 or greater. Step 11 Configure other settings as appropriate for your environment. Cisco Jabber does not require specific values. Step 12 Select Save. Step 13 Navigate to the End User window for the user. Step 14 Associate the Cisco Dual Mode for iPhone device that you just created for this user. Depending on your release of Unified CM, the device should now appear in the Controlled Devices box in the Device Information or Device Associations section.
Step 15 If this user has a desk phone, select the desk phone as the Primary User Device. Step 16 If the device is a standalone device that runs without an associated desk phone, you may need to enter other information that is standard for all devices in your system.
What to Do Next
Verify that your configuration works:
- Make sure the phone is connected to the corporate network. Verify that you can access a web window on your corporate intranet using the browser on your phone.
- Launch Cisco Jabber and complete the setup wizard. Enter the Device Name (TCTXXXX) and the IP address of your TFTP server (generally the IP address of your Unified CM server) of the device you just added.
- Make a VoIP call and test telephony features in Cisco Jabber, such as the ability to make, hold, and transfer calls.
If you allowed end-user configuration editing and you are making changes to an existing configuration, delete the Phone Services account on the device and then set up the account again.
Table 1 Parameter Descriptions Parameter
Description
Device Information Device Name The Device Name:
- Can represent only one device. If a single user has Cisco Jabber on multiple devices (for example, an iPhone and an iPod Touch), configure separate Cisco Dual Mode for iPhone devices for each in Unified CM.
- Must start with TCT.
- Must be uppercase.
- Can contain up to 15 characters total.
- Can include only A to Z, 0 to 9, dot (.), dash (-), or underscore (_).
Phone Button Template
Select Standard Dual Mode for iPhone. Media Resource Group List
Configure these settings to prevent confusion for the person the user calls. These settings are not specific to this device.
For information, see the Unified CM documentation.
User Hold MOH Audio Source
Network Hold MOH Audio Source
Primary Phone If this user has a desk phone, select the desk phone. Selecting the primary phone sets the device as an adjunct in the Unified CM for licensing purposes.
Enable Cisco Unified Mobile Communicator
This option is not available in Cisco Unified Communications Manager Release 6.1.5.
For Cisco Unified Communications Manager release 7.1.5:
Select this option if the Cisco Jabber application that runs in conjunction with a Cisco Unified Mobility Advantage server is also installed on this iPhone, in order to allow both applications to run with full functionality.
For all other situations and other Cisco Unified Communications Manager releases, do not select this option.
Protocol-Specific Information Device Security Profile
Select Cisco Dual Mode for iPhone - Standard SIP Non-Secure Profile.
This profile has SIP Digest authentication disabled.
SIP Profile Select the SIP profile you created in Create a dedicated SIP profile. Other settings in the preceding sections
As appropriate to your deployment. Values that are not described in this document are not specific to Cisco Jabber but you may need to enter them for the device to work properly.
Product Specific Configuration Layout Information in this section is downloaded to the iOS device during initial setup, to automatically set up Cisco Jabber.
Allow End User Configuration Editing
Select Disable for this setting unless a user absolutely must be able to independently change settings. Instructions in this document assume that you disabled End User Configuration Editing.
If you disable this setting:
- All changes that you make in the Product Specific Configuration Layout section of this window are automatically updated on Cisco Jabber at each launch, except as noted.
- Exception: Users can always manually enter passwords.
If you enable this setting:
- Changes you make on this window are not automatically passed to the client.
- If you change settings on this window, users must delete their account settings from Cisco Jabber and then set up Cisco Jabber again from the beginning, in order for your changes to take effect.
- Exception: The following settings are updated on Cisco Jabber at each launch:
If you choose Restricted, the same restrictions as Disabled apply, but users can adjust the Default Ringtone setting.
iPhone Country Code
The E.164 international dialing code of the country in which this user is located.
This parameter helps determine caller ID names.
This information is set only during initial setup of Cisco Jabber. If you need to change this setting for an existing user, the user must delete all account information from Cisco Jabber and reenter it.
Cisco Usage and Error Tracking
Select the level of usage information that is available to Cisco.
For more information, see Usage and Error Tracking.
Disallow Shake To Lock
(Cisco Mobile 8.1, Cisco Jabber 8.6)
Shake to Lock is not enabled and not needed for this release.
(Cisco Mobile 8.0)
Users can shake the iPhone while Cisco Mobile is running to prevent the iPhone from sleeping while Cisco Mobile is open, so that Cisco Mobile can receive incoming calls.
Preventing the iPhone from sleeping prevents the native iPhone PIN lock from turning on when the phone is not in use, and can affect battery life.
If you select Yes, Shake to Lock is not available to users.
If you select No, users can choose whether or not to enable Shake to Lock.
Sign In Feature
Select Enabled to allow users to sign in using Extension Mobility. Directory Lookup Rules URL and Application Dial Rules URL
If you move or rename the files that are generated by the procedure in Dial rules setup , enter the path to those files.
Use this format:
tftp://<ip address of TFTP server>/<pathname to the XMLfile>/<XML filename>
Note If you enter or change information in this field, select Apply Config, and then exit and restart the client application after you complete configurations in Unified CM. Otherwise, leave these settings blank.
Note Starting with Unified CM Release 8.6, dial rules are applied by the Unified CM and not the client.
Enable LDAP User Authentication
Use LDAP to integrate corporate photos. For more information, see Integrate Corporate Directory Photos from an LDAP Server. LDAP Username LDAP Password LDAP Server Enable LDAP SSL LDAP Search Base LDAP Field Mappings LDAP Photo Location Emergency Numbers
Numbers that, when dialed on an iPhone, connect using the native phone application and the mobile network of the device. If dialed on an iPod, these numbers connect using VoIP calling. For example, 911, 999, 112. These numbers are prepopulated. Update if necessary.
Preset Wi-Fi Networks The SSIDs for Wi-Fi networks.
Cisco Jabber triggers Connect on Demand to AnyConnect if users are not on a Wi-Fi network listed in this field, or if they are on a mobile data network.
Separate multiple SSIDs with forward slash (/).
Example: SalesOffice1/CorporateWiFi
Default Ringtone Select Loud or Normal. If you choose Restricted, users can change only the Default Ringtone setting. If you choose Disabled, users cannot make any changes to settings.
Other settings in this section
The following settings are not supported in this release. Leave these settings blank:
- Normal Mode Codecs
- Low Bandwidth Codecs
- MeetingPlace Numbers
- WebEx Numbers
- Contacts
- XML Options
- Video Capabilities
You will enter remaining settings later, when you set up other features.
Bulk Configuration
Use the information in this document to set up an individual test user and device as the basis for completing a Bulk Administration template to set up all users and devices.
When you are ready for bulk processes, follow the instructions in the Bulk Administration Guide for your release of Unified CM, available from the maintenance guides list.
Note
The settings in the Product Specific Configuration Layout section of the device configuration page are not handled as individual columns in the exported spreadsheet. Instead, all of those settings, and the information they contain, appear as XML code in a single cell for each device. If you edit user-specific information in this cell, do so cautiously.
Important:When making bulk changes, to ensure that the changes get pushed to the devices, we recommend that you create and run two batch jobs using the following method.
- Create the first batch job to log out users and apply changes as follows:
- Sign in to the Unified CM Administration portal.
- Select .
- Search for the devices to update, and then select Next.
- Update the values that you want to change on the devices. Note: To automatically propagate the batch changes to the Cisco Jabber for iPhone application, go to Product Specific Configuration Layout section of Cisco Dual Mode for iPhone devices and set the Allow End User Configuration Editing parameter to either Disabled or Restricted. If you set the Allow End User Configuration Editing parameter to Enabled, the Cisco Jabber for iPhone application must be provisioned again for the changes to take effect.
- In the Logout/Reset/Restart section, check the Logout Users Before Update check box, and then select the Apply Config radio button.
- In the Job Information section, select whether you want to run the batch job immediately or later. The first batch job must finish running before you run the second batch job. If you schedule the batch jobs for a later time, make sure to allow enough time for the Unified CM to complete the first job before it runs the second job. For more information about scheduling jobs, see Scheduling Jobs.
- Create the second batch job to reset all the Cisco Dual Mode for iPhone devices as follows:
- Select .
- Search for the devices to update, and then select Next.
- Update the values that you want to change on the devices.
- In the Logout/Reset/Restart section, verify that the Logout Users Before Update check box is unchecked, and then select the Reset Phone radio button.
- In the Job Information section, select whether you want to run the batch job immediately or later.
Prepare Automatic Setup Link (Optional)
ProcedureSimplify the setup process for your users by allowing them to automatically enter settings into Cisco Jabber by tapping a link in an email message, instead of manually entering settings into Cisco Jabber.
This link transfers the information from the Product Specific Configuration Layout section on the Phone Configuration page in Unified CM to the settings in the Cisco Jabber application on the iPhone. At first launch, Cisco Jabber prompts users for any required passwords.
You can include the following information in the URL:
Cross-Launch Cisco Jabber from Another Application (Optional)
This feature allows developers to launch Cisco Jabber from third-party apps. Enable applications to launch Cisco Jabber by constructing and then opening a URL from within another app.
To cross-launch Cisco Jabber from your application, set up your app to open a URL with the following format:
ciscotel://<phonenumber>Examples
NoteYou can add a URL in ciscotel format to a web page field. When a user taps the URL, Cisco Jabber automatically calls the number contained in the URL. You can add phone numbers in this format to applications that support opening URLs, such as "Notes".
NoteSupport for various phone number formats varies depending on the application that opens the URL.
User Instructions
After you finish setting up devices in Unified CM, give your users the following information:
- Instructions for connecting the phone to the corporate Wi-Fi network. This process is independent of Cisco Jabber.
- User documentation with instructions for setting up Cisco Jabber, available from http://www.cisco.com/en/US/products/ps11596/products_user_guide_list.html.
- Additional setup instructions for Cisco Jabber. Automatic Setup
If you set up an automatic setup link, provide the link by email with the following instructions:Manual Setup
Note
For users with multiple Cisco Dual Mode for iPhone devices, make sure to identify which email message pertains to each device.
- (If applicable) credentials required to access the corporate directory.
- (If applicable) SIP Digest password.
- (If applicable) CCM User password. This password is required if you enable desk phone integration.
- For Unified CM Release 8.0: Users must use Cisco Jabber instead of Cisco Unified Mobile Communicator for dialing calls.
- For Unified CM Release 7.1.5: Users can use either application to dial calls.
- For all Unified CM releases: Cisco recommends that users access voicemail from Cisco Unified Mobile Communicator instead of from Cisco Jabber, because Cisco Unified Mobile Communicator has a richer feature set for voicemail, such as alerts for new voice messages.
- (If applicable) Information that users need to access the corporate network remotely using VPN. Provide instructions to help users download, install, and set up a VPN client such as Cisco AnyConnect Secure Mobility Client. Users can obtain information about how to install and use Cisco AnyConnect Secure Mobility Client on an iPhone from the latest iPhone User Guide for Cisco AnyConnect Secure Mobility Client in the user guide list. Users can obtain the Cisco AnyConnect Secure Mobility Client application in one of the following ways:
- Manual method: Ask users to manually download the Cisco AnyConnect Secure Mobility Client and Cisco Jabber for iPhone applications for free from the Apple App Store.
TipHost the links to these two applications on an internal web portal to help users find them.
- Automated method: Use Mobile Device Manager (MDM) software to push the applications to the devices so that the device automatically receives the two applications after registration. For information about how to use MDM, see the relevant third-party documentation.
- Information about using emergency numbers with Cisco Jabber. Cisco Jabber uses the native iPhone dialer if the user dials an emergency number that is defined in the Emergency Numbers field on the Unified CM. See Add User Device for more information.
Port and Protocol List
The following table lists ports and protocols that are in Cisco Jabber. The duration for each entry is “Ephemeral.”
Table 2 Cisco Jabber Ports and Protocols Feature
Protocol
Network Protocol
Port
Remarks
Unified CM Registration
TCP TCP 5060 SIP port for Unified CM Registration Phone Services
TFTP UDP 69, then Ephemeral
N/A Desk Phone Integration
QBE TCP 2748 N/A Media RTP UDP 16384-32766
This range is specified by the Unified CM in the device configuration file. These are the default values and can be any valid port.
UDP 2000-2050 Client local port used to connect to the Trivial File Transfer Protocol (TFTP) server to download the TFTP file. Directory LDAP TCP 389 LDAP with optional TLS Directory LDAPS TCP 636 LDAPS Directory LDAP TCP 3268 Active Directory Global Catalog over LDAP
Directory LDAPS TCP 3269 Active Directory Global Catalog over LDAPS
Unity Connection Voicemail
IMAP
TCP 143 N/A Unity Connection Voicemail
IMAP
TCP 7993 IMAP with SSL/TLS Extension Mobility
8080 Client
