First Published: April 16, 2014 Last Modified: January 16, 2015 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental. Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http:// www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R) 2015 Cisco Systems, Inc. All rights reserved.
CONTENTS CHAPTER 1 Introduction 1 About Cisco Jabber for Mac 1 Documentation Resources 3 New in this Release 3 CHAPTER 2 Limitations and Restrictions 7 Limitation During Upgrade 7 Important Notes 7 CHAPTER 3 Requirements 9 Hardware Requirements for Cisco Jabber for Mac 9 Software Requirements 10 Operating Systems for Cisco Jabber for Mac 10 On-Premises Servers for Cisco Jabber for Windows and Cisco Jabber for Mac 10 Cloud-Based Servers 11 Directory Servers 11 Computer Telephony Integration Servitude 12 Ports and Protocols 12 CTI Supported Devices 13 Supported Codecs for Cisco Jabber for Windows and Cisco Jabber for Mac 13 COP Files for Cisco Jabber for Windows and Cisco Jabber for Mac 14 VPN Support 14 CHAPTER 4 Caveats 15 Search for Bugs 15 Open in this Release 16 Resolved Caveats 16 Closed Caveats 17 iii
Contents iv
CHAPTER 1 Introduction About Cisco Jabber for Mac, page 1 Documentation Resources, page 3 New in this Release, page 3 About Cisco Jabber for Mac Cisco Jabber delivers secure, clear and reliable communications, offers flexible deployment models, is built on open standards and integrates with commonly used applications. Full details on what analytics data Cisco Jabber does and does not collect can be found in the Cisco Jabber Supplement to Cisco s On-Line Privacy Policy at http://www.cisco.com/web/siteassets/legal/privacy_ 02Jun10.html. Features of Cisco Jabber for Mac IM/Availability 1:1 chat 1:1 chat history Group chat Offline instant messaging1 Standard and rich availability states Standard: Available, Away, Do not disturb Rich: In a WebEx Meeting2, Presenting2, On a call, In a meeting1 XMPP federation AOL federation Lync and Sametime federation (requires establishment of XMPP gateway) Use your computer or desk phone for phone calls (requires Cisco UC Integration) 1
About Cisco Jabber for Mac Introduction Computer phone and desk phone controls Forward calls (desk phone mode only) Conference (via Merge) CTI Servitude Voicemail (requires Cisco UC Integration) Visual Voicemail Meetings View a list of your WebEx meetings Start or join an instant WebEx meeting Start or join scheduled WebEx meeting from your meeting list or from meeting reminders Transition from an IM session to an instant meeting (WebEx only) Additional Features Desktop Share 2 File Transfer Predictive search of contact list, Address Book contacts, and corporate directory Security/Administration Single Sign-On 2 Policy enforcement Auto-upgrade 2 Signaling encryption Voice/video encryption(srtp) IM message encryption Multiple resource login Survivable Remote Site Telephony High-Availability Failover 1 Features available only for on-premises (Cisco Unified Presence server IM/Availability) deployments. 2 Features available only for cloud (Cisco Collaboration Cloud IM/Availability) deployments. 2
Introduction Documentation Resources Documentation Resources Installation and Configuration Guide The Installation and Configuration Guide contains information to help you plan your deployment, system, network requirements, supported devices, installation and client configuration. Server Setup Guide The Server Setup Guide provides the administrators with task-based information to help you configure services for the client. DNS Configuration Guide The DNS Configuration Guide contains information to help you plan your deployment, system, network requirements, supported devices, installation and client configuration. Licensing Information The Licensing Information document provides information on the open source libraries used by the application. Accessibility Guide Provides information on navigating the client, including shortcut keys, keyboard navigation, and other accessibility features. Advanced Features Guide The Advanced Features Guide provides an overview of task-based information about end user operation of the client. For additional information see the Cisco Jabber for Mac documentation page. New in this Release Expressway for Mobile and Remote Access Expressway for Mobile and Remote Access for Cisco Unified Communications Manager allows users to access their Cisco Jabber collaboration tools from outside the corporate firewall without a VPN client. Using Cisco collaboration gateways, the client can connect securely to your corporate network from remote locations such as Wi-Fi networks or mobile data networks. For more information about this feature, see the Installation and Configuration Guide. 3
New in this Release Introduction Service Discovery Service Discovery gives the client the ability to automatically detect and locate services. This feature is configured centrally by an administrator using DNS SRV records. Service Discovery removes the need for manual user interaction to configure services. Voice Services Domain The voice services domain parameter allows the user to specify the DNS domain to be a different value to the service domain. The DNS domain is where the _cisco-uds, _cuplogin and _collab-edge DNS SRV records are deployed. Service Discovery Excluded Services In certain deployment scenarios services can be excluded from the service discovery process. For information about setting up this feature, see the Installation and Configuration Guide and DNS Configuration Guide. Configuration URL This feature allows administrators to create a link that makes it easier for users to set up the client for the first time. This link allows user to cross-launch Jabber without having to manually enter service discovery information. Administrators create a link that includes the domain Cisco Jabber needs for service discovery. This link can also include information that Cisco Jabber needs to connect to Phone Services. Administrators then provide this link to users through email or a web page. After users select the link, Cisco Jabber bypasses the Welcome screen, discovers available services, and opens the Sign in screen. Users cannot navigate back to the Welcome screen. For information about setting up this feature, see the Installation and Configuration Guide. URI Dialing URI dialing allows a user to be called using an assigned URI instead of a phone number. URIs follow a user@domain format that is similar to an email address. URI dialing is enabled through configuration in the client and Cisco Unified Communications Manager. For information about setting up this feature, see the Installation and Configuration Guide and Server Setup Guide. 4
Introduction New in this Release Meetings Enhancements Supported in this release: Meetings tab to configure additional meetings sites. For information about setting up additional meetings sites, see the Advanced Features Guide. List Cisco WebEx meetings in the client meetings tab Instant Meeting Join an instant meeting from Cisco Jabber menu options Invitations sent to participants if they are online Start instant meeting from the Cisco Jabber client Join or start a scheduled Cisco WebEx meeting from reminders and notifications Meeting reminders Desktop Share Only available on cloud deployment Escalate from an Instant Message (IM) to a desktop share Desktop share from Cisco Jabber client menu with one online contact Authentication SSO to authenticate both Cisco Jabber and meetings services seamlessly Cisco Jabber client presence changes to reflect meeting activity The following are some aspects of the meetings feature that are not supported in this release: Mac calendar integration for meetings List meetings in the meetings tab from sources other than Cisco Jabber meetings Accessibility support Localization Desktop Share is not available for on-premises deployment Credentials in the Cloud Cisco Unified Communications Manager credentials stored in the cloud. Credentials are entered once and synchronised on Cisco Jabber devices. Screen Capture Screen capture allows a user to capture a selection of their screen and send to recipients. 5
New in this Release Introduction Self-Care Portal The self-care portal allows users to control the preferences for their phone devices associated with Cisco Jabber. The self-care portal is available for on-premises deployments using Cisco Unified Communications Manager version 10 and higher. IM Archiving Notifications IM archiving notifications are displayed to the user when the recipient of their IM had IM archiving activated. 6
CHAPTER 2 Limitations and Restrictions Limitation During Upgrade, page 7 Important Notes, page 7 Limitation During Upgrade The following features are not available in this release. Voicemail transcripts Call Transfer Call Park Send to Mobile Forced Authorization Code/Client Matter Code Observer Contact List Group Chat History Custom Contacts1 Compound search base Change Password2 Mac OSX 10.6.8 support 1 On-demand (Cisco Collaboration Cloud IM/Availability) deployments only 2 On-premise (Cisco Unified Presence server IM/Availability) deployments only Important Notes Issues with interoperability with other clients, devices, and third party software, along with server-side issues or defects that impact client functionality. 7
Important Notes Limitations and Restrictions Expressway for Mobile and Remote Access Deployment For an Expressway for Mobile and Remote Access deployment, when using an online certificate status protocol (OCSP) or online certificate revocation lists (CRL) to obtain the revocation status of the certificates, the Cisco Jabber client expects a response time of less than 5 seconds. Connections will fail if the response time is greater than the expected 5 seconds. Network Disconnection when using Cisco Jabber on audio or video call There is a known issue in the Mac OS where network interfaces will drop intermittently when DSCP is enabled. If you encounter this issue, do the following: 1 Select Preferences > Calls > Advanced. 2 Uncheck Enable Differentiated Service for Calls. Cisco Medianet Cisco Medianet is not currently supported on Mac OS X 10.9 (Mavericks). 8
CHAPTER 3 Requirements Hardware Requirements for Cisco Jabber for Mac, page 9 Software Requirements, page 10 Ports and Protocols, page 12 CTI Supported Devices, page 13 Supported Codecs for Cisco Jabber for Windows and Cisco Jabber for Mac, page 13 COP Files for Cisco Jabber for Windows and Cisco Jabber for Mac, page 14 VPN Support, page 14 Hardware Requirements for Cisco Jabber for Mac Installed RAM 2 GB RAM Free Physical Memory 1 GB Free Disk Space 300 MB CPU Speed and Type Intel Core 2 Duo or later processors in any of the following Apple hardware: Mac Pro MacBook Pro (including Retina Display model) MacBook 9
Software Requirements Requirements MacBook Air imac Mac Mini I/O Ports USB 2.0 for USB camera and audio devices. Software Requirements For successful deployment, ensure that client workstations meet the software requirements. Operating Systems for Cisco Jabber for Mac You can install Cisco Jabber for Mac on the following operating systems: Apple OS X Lion Version 10.7.4 (or later) Apple OS X Mountain Lion 10.8.1 (or later) Apple OS X Mavericks 10.9 (or later) This version of Cisco Jabber for Mac is not supported on Apple OS X Yosemite 10.10 On-Premises Servers for Cisco Jabber for Windows and Cisco Jabber for Mac Cisco Jabber uses domain name system (DNS) servers during startup. DNS servers are mandatory for Cisco Jabber. Cisco Jabber supports the following on-premises servers: Cisco Unified Communications Manager, release 8.0(1) or later Cisco Unified Presence, release 8.0(3) or later Cisco Unity Connection, release 8.5 or later Cisco WebEx Meetings Server, version 2.0 or later Cisco Expressway Series for Cisco Unified Communications Manager Cisco Expressway-E, version 8.1.1 or later Cisco Expressway-C, version 8.1.1 or later Cisco TelePresence Video Communications Server Cisco VCS Expressway, version 8.1.1 or later Cisco VCS Control, version 8.1.1 or later 10
Requirements Cloud-Based Servers Cisco Jabber supports the following features with Cisco Unified Survivable Remote Site Telephony, Version 8.5: Basic call functionality Ability to hold and resume calls Refer to the Cisco Unified SCCP and SIP SRST System Administrator Guide for information about configuring Cisco Unified Survivable Remote Site Telephony at: http://www.cisco.com/en/us/docs/voice_ip_comm/ cusrst/admin/sccp_sip_srst/configuration/guide/sccp_and_sip_srst_admin_guide.html. For Cisco Unified Communications Manager Express support details, refer to the Cisco Unified CME documentation: http://www.cisco.com/en/us/products/sw/voicesw/ps4625/products_device_support_tables_ list.html Cloud-Based Servers Cisco Jabber supports integration with the following hosted servers: Cisco WebEx Messenger service Cisco WebEx Administration Tool, minimum supported version is 7.5 Cisco WebEx Meeting Center, minimum supported versions are as follows: Version T26L with Service Pack EP 20 Version T27L with Service Pack 9 Directory Servers You can use the following directory servers with Cisco Jabber: Active Directory Domain Services for Windows Server 2012 R2 Active Directory Domain Services for Windows Server 2008 R2 Active Directory for Windows Server 2003 R2 Cisco Unified Communications Manager User Data Server (UDS) Cisco Jabber supports UDS with Cisco Unified Communications Manager, version 9.1(2) with the Cisco Options Package (COP) file: cmterm-cucm-uds-912-3.cop.sgn. OpenLDAP Restriction Directory integration with OpenLDAP requires that you define specific parameters in a Cisco Jabber configuration file. See LDAP Directory Servers for more information. 11
Computer Telephony Integration Servitude Requirements Computer Telephony Integration Servitude Cisco Jabber for Windows and Cisco Jabber for Mac support CTI servitude of Cisco Jabber from a third party application. Computer Telephony Integration (CTI) enables you to use computer-processing functions while making, receiving, and managing telephone calls. A CTI application can allow you to retrieve customer information from a database on the basis of information that caller ID provides and can enable you to use information that an interactive voice response (IVR) system captures. For more information on CTI servitude, see the CTI sections in the appropriate release of the Cisco Unified Communications Manager System Guide. Or you can see the following sites on the Cisco Developer Network for information about creating applications for CTI control through Cisco Unified Communications Manager APIs: Cisco TAPI: http://developer.cisco.com/web/tapi/home Cisco JTAPI: http://developer.cisco.com/web/jtapi/home Ports and Protocols The client uses the ports and protocols listed in the following tables: Inbound Port 16384 to 32766 Protocol UDP Description Real-Time Transport Protocol (RTP) media streams for audio and video Outbound Port 69 6970 80 389 636 3268 3269 2748 5060 Protocol UDP HTTP TCP (HTTP) UDP / TCP LDAPS TCP LDAPS TCP UDP / TCP Description Trivial File Transfer Protocol (TFTP) service TFTP service to download client configuration Cisco Unified Communications Manager administrator and user web pages LDAP directory server LDAP directory server (secure) Global Catalog server Global Catalog server (secure) CTI gateway Session Initiation Protocol (SIP) call signaling 12
Requirements CTI Supported Devices Port 5061 5070 5222 8443 Protocol TCP UDP TCP (XMPP) HTTPS Description Secure SIP call signaling Binary Floor Control Protocol (BFCP) for video desktop sharing Cisco Unified Presence or Cisco Unified Communications IM and Presence in on-premise deployments Web access to Cisco Unified Communications Manager and includes connections for the following: Cisco Unified Communications Manager IP Phone (CCMCIP) server for assigned devices User Data Service (UDS) 16384 to 32766 53 1080 UDP UDP / TCP SOCKS5 Bytestreams RTP media streams for audio and video Domain Name System (DNS) traffic Peer to peer file transfers If port 1080 is in use, the client attempts to use the next available port in the range from 1081 to 1089. In on-premise deployments, the client also uses port 1080 to send screen captures. Note If port 1080 is blocked, the client uses the following port range: 37200 to 37209. CTI Supported Devices To view the list of Computer Telephony Integration (CTI) supported devices: From Cisco Unified Reporting, select Unified CM Phone Feature List. From the Feature drop-down list, select CTI controlled. Supported Codecs for Cisco Jabber for Windows and Cisco Jabber for Mac Supported Audio Codecs G.722.1 32k and 24k. G.722.1 is supported on Cisco Unified Communications Manager 8.6.1 or later. G.711 a-law and u-law G.729a 13
COP Files for Cisco Jabber for Windows and Cisco Jabber for Mac Requirements Supported Video Codec H.264/AVC COP Files for Cisco Jabber for Windows and Cisco Jabber for Mac In certain cases, you might need to apply COP files to Cisco Unified Communications Manager. You can download the following COP files from the Cisco Jabber administration package on Cisco.com: COP File ciscocm.installcsfdevicetype.cop.sgn Description Adds the CSF device type to Cisco Unified Communications Manager. For more information, see Software Requirements. Cisco Unified Communications Manager Versions 7.1.3 ciscocm.addcsfsupportfield.cop.sgn cmterm-cupc-dialrule-wizard-0.1.cop.sgn Adds the CSF Support Field field for group configuration files. For more information, see Create Group Configurations. Publishes application dial rules and directory lookup rules to Cisco Jabber. For more information, see Publish Dial Rules. 8.6.1 and earlier 8.6.1 and earlier VPN Support Cisco Jabber for Mac supports the following software VPN clients. Cisco AnyConnect release 3.0.5, and 3.1 Cisco AnyConnect releases 2.2, 2.3, and 2.4 Cisco VPN client release 5.0 Cisco VPN client release 4.9.01 14
CHAPTER 4 Caveats Search for Bugs, page 15 Open in this Release, page 16 Resolved Caveats, page 16 Closed Caveats, page 17 Search for Bugs Bug Classification Known defects, or bugs, have a severity level that indicates the priority of the defect. Development managers define the bug severity. Severity helps the product team focus on bug fixes for future releases and prioritize fixes. The following table describes the bug severity levels: Severity level Description 1 Catastrophic Reasonably common circumstances cause the entire system to fail, or a major subsystem to stop working, or other devices on the network to be disrupted. No workarounds exist. 2 Severe Important functions are unusable and workarounds do not exist. Other functions and the rest of the network is operating normally. 3 Moderate Failures occur in unusual circumstances, or minor features do not work at all, or other failures occur but low-impact workarounds exist. This is the highest level for documentation bugs. 4 Minor Failures occur under very unusual circumstances, but operation essentially recovers without intervention. Users do not need to install any workarounds and performance impact is tolerable. 5 Cosmetic Defects do not cause any detrimental effect on system functionality. 6 Enhancement Requests for new functionality or feature improvements. 15
Open in this Release Caveats Search for Bugs To search for bugs, do the following: 1 Go to https://tools.cisco.com/bugsearch 2 Sign in with your Cisco.com user ID and password. 3 Enter a bug ID or specify search parameters. For more information, select Help in the top right of the Bug Search page. Open in this Release Identifier CSCuo60253 CSCuo16868 CSCuo17109 CSCul58570 CSCuo17322 CSCuo19469 CSCuo04615 CSCum35214 CSCun57226 CSCuj34427 Headline Jabber client fails to check or download client updates from the cloud Lync video call window adjustments ignored by client over Expressway Client fails to connect to deskphone if device name is mixed case The top Jabber menu appears behind apps that are in full screen mode Lost audio after 20 mins (decreasing bandwidth causes codec switch) Incorrect server name displayed in invalid certificate dialog Client connecting over Expressway even though user is connected via VPN Font size discrepancy between sent and received IMs Username & password not visible in client for admin created meeting site File transfer fails with a message "initiator cancelled the transfer" Resolved Caveats Identifier CSCul32173 CSCul35635 CSCun39505 CSCul31695 CSCun79499 CSCun18501 CSCul90593 Headline Failed to connect Microsoft AD through SSL port 636 The client is slow to connect to CCM/Unity over wired Thunderbird Jabber Mac should support extensions starting with pound "#" Customer's LDAP server password is written to console log Switch from photo server (UDS) to blobs (AD) results in loss of photos Duplicate message received in group chat Directory results not yielding correct jid 16
Caveats Closed Caveats Identifier CSCuj71895 CSCui69916 CSCum71608 CSCun60421 Headline Avatar photos disappear in group chat window when participant leaves Cannot paste DTMF tones into a call window Contacts are not sorted correctly in the title menu contact list Meetings didn't "spring forward" to observe daylight savings Closed Caveats Identifier CSCui31144 CSCul09086 CSCum34434 CSCum17021 Headline PHD doesn't work if plugged in while other camera is on Cannot connect to edge when there is a delay validating the certificate Many audio gaps in speech during a webex call on OSX 10.9 Localization - Desktop sharing window and menus not localized 17
Closed Caveats Caveats 18