Contents
Administration
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 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 page, 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:
Step 9 Set the No Answer Ring Duration to 24 seconds to allow time for Cisco Jabber to ring before calls go to voicemail. See general restrictions in the online help in Unified CM.
Step 10 Configure other settings as appropriate for your environment. Cisco Jabber does not require specific values. Step 11 Select Save. Step 12 Navigate to the End User page for the user. Step 13 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 14 If this user has a desk phone, select the desk phone as the Primary User Device. Step 15 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 Wi-Fi. Verify that you can access a web page 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.
- Test basic telephony features in Cisco Jabber, such as the ability to make, hold, and transfer calls.
If you have allowed end-user configuration editing and you are making changes to an existing configuration, delete the Internet Calling 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 iPad), 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 may need to be entered for the device to work properly.
Product Specific Configuration Layout Information in this section is downloaded to the phone upon 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 you have disabled End User Configuration Editing.
If you disable this setting:
- All changes that you make in the “Product Specific Configuration Layout” section of this page 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 page are not automatically passed to the client.
- If you change settings on this page, 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 may 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 a user device, connect with the mobile network of the device. For example, 911, 999, 112. These numbers are pre-populated. Update if necessary.
Reserved Enter domain=cisco.com to ensure that the server hostname is resolvable when the Unified CM is configured with just a hostname for the various servers in your cluster. Verify the format of the hostname on your Unified CM in
.Default Ringtone Select Loud or Normal. Choosing “Restricted” allows users to change only the Default Ringtone setting. Choosing “Disabled” prevents users from making 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
- Secure Connect
- Secure Connect Gateway Address
- Secure Connect Authentication Group
- Secure Connect Certificate Enrollment Group (SCEP)
- Secure Connect Username (optional)
- Preset Wi-Fi Networks
- 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 individual users and devices as the basis for completing a Bulk Administration template to set up 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 http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html.
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.
Prepare automatic setup link
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.
User instructions
When you finish setting up devices in Unified CM, give your users the following information:
- Instructions for connecting the phone to the corporate Wi-Fi. 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.
- Instructions for setting up VPN access on the phone, if you want users to be able to use Cisco Jabber through VPN. This process is independent of the Cisco Jabber application.
- (If applicable) give users the credentials required to access the corporate directory.
- (If applicable) give users the SIP Digest password.
- If you enable desk phone integration, provide users’ CCMUser password.
- Cisco Jabber uses the native iPhone dialer if the user dials an emergency number defined in the Emergency Numbers field on the Unified CM. See Add user device for more information.
If you also deploy the Cisco Unified Mobile Communicator application that runs in conjunction with Cisco Unified Mobility Advantage (also known as Cisco Mobile 7.1):
- For Unified CM Release 7.1.3 or 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: Users should 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.
Port and Protocol List
The following table lists ports and protocols used in Cisco Jabber 8.6.2. The duration for each entry is “Ephemeral.”
Feature
Protocol
Network Protocol
Port
Remarks
Unified CM Registration
TCP TCP 5060 SIP port for Unified CM Registration Internet Calling
TFTP UDP 69 N/A Deskphone 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 actually by any valid port.
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