Readme for Cisco Unity Connection Release User Guide

Readme for Cisco Unity Connection Release

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

System Requirements

System Requirements for Cisco Unity Connection Release 12.x is available at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/requirements/b_12xcucsysreqs.html.

Compatibility Information

The Compatibility Matrix for Cisco Unity Connection lists the most recent version combinations qualified to use for Cisco Unity Connection, and Unity Connection and with Cisco Business Edition (where applicable) at http://www.cisco.com/en/US/products/ps6509/products_device_support_tables_list.html.

Determining the Software Version

This section contains procedures for determining the version in use for the following software:

• Determine Version of Cisco Unity Connection Application
• Determine Version of Cisco Personal Communications Assistant Application
• Determine Version of Cisco Unified Communications Operating System

Determine Version of Cisco Unity Connection Application

This section contains two procedures. Use the applicable procedure, depending on whether you want to use Unity Connection Administration or a command-line interface (CLI) session to determine the version.

Using Cisco Unity Connection Administration

In Cisco Unity Connection Administration, in the upper-right corner below the Navigation list, select About.
The Unity Connection version is displayed below “Cisco Unity Connection Administration.”

Using the Command-Line Interface

Determine Version of Cisco Personal Communications Assistant Application

Using Cisco Personal Communications Assistant Application

Step 1 Sign in to the Cisco PCA.
Step 2 On the Cisco PCA Home page, select About in the upper right corner to display Cisco Unity Connection version.
Step 3 The Cisco PCA version is the same as the Unity Connection version.

Determine Version of Cisco Unified Communications Operating System

Use the applicable procedure.

Using Cisco Unified Operating System Administration

In Cisco Unified Operating System Administration, the System Version is displayed below “Cisco Unified Operating System Administration” in the blue banner on the page that appears after you sign in.

Using the Command-Line Interface

Step 1 Start a command-line interface (CLI)session. (For more information, see Cisco Unified Operating System Administration Help.)
Step 2 Run the show version active command.

Version and Description

Caution
If the Cisco Unity Connection server is running an engineering special (ES) with a full Cisco Unified Communications Operating System version number between 12.5.1.14009-1 to 12.5.1.14899-x, do not upgrade the server to Cisco Unity Connection 12.5(1)Service Update 4 because the upgrade will fail. Instead, upgrade the server with an ES released after 12.5(1) Service Update 4 that has a full Unified Communications OS version number of 12.5.1.15xxx or later to get the SU functionality.

Cisco Unity Connection 12.5(1) Service Update 4 is a cumulative update that incorporates all of the fixes and changes to Cisco Unity Connection version 12.5(1)—including the operating system and components shared by Cisco Unity Connection and Cisco Unified CM. It also incorporates additional changes that are specific to this service update.

To determine the full version number of the Cisco Unified Communications OperatingSystem that is currently installed on the active partition, run the CLI show version active command.

Full version numbers include the build number (for example, 12.5.1.14900-45), the software versions listed on the download pages on Cisco.com are abbreviated version numbers (for example, 12.5(1) ).

Do not refer to version numbers in any of the administration user interfaces because those versions apply to the interfaces themselves, not to the version installed on the active partition.

New and Changed Support or Functionality

This section contains all new and changed support or functionality for release 12.5(1) SU4 and later.

Note
The new locales for Unity Connection 12.5(1) SU4 have been released and available on Download Software site at https://software.cisco.com/download/home/282421576/type.

Authentication of Proxy Server in Smart Licensing

Cisco Unity Connection supports HTTPs proxy deployment option to communicate with Cisco Smart Software Manager(CSSM).

With Unity Connection 12.5(1) Service Update 4 and later releases, administrator provides an option to authenticate the proxy server for secure communication with CSSM. You can provide username and password for authentication of proxy server.

For more details, refer section Deployment Options in chapter “Managing Licenses” of Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 12 available at link https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/install_upgrade/guide/b_12xcuciumg.html.

Support of SpeechView in HCS Deployment Mode

With Cisco Unity Connection Release 12.5(1)Service Update 4 and later, administrator provide Speech View functionality to users with Hosted Collaboration Services (HCS) deployment mode. To use Speech View feature in HCS mode, you must have HCS Speech View Standard User Licenses with the users.

Note

Note In HCS mode, only Standard SpeechView Transcription Service is supported.

For information on supported entitlement tagsin HCS mode, see section “Cisco Unity Connection Provisioning Interface (CUPI) API — Smart Licensing” in chapter “Cisco Unity Connection Provisioning Interface (CUPI) API for System Settings” in Cisco Unity Connection Provisioning Interface (CUPI) API guide available at link https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/REST- API/CUPI_API/b_CUPI-API.html

For SpeechView configuration, see chapter “SpeechView” of System Administration Guide Cisco Unity Connection Release 12 available at link https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/administration/guide/b_12xcucsag.html.

Support of Tomcat Certificates in Secure SIP Calls

Cisco Unity Connection uses certificates and security profiles for authentication and encryption of voice messaging ports through SIP trunk integration with Cisco Unified Communications Manager. To configure secure calls in releases older than 12.5(1) Service Update 4, Unity Connection provides following options for SIP Integration:

• Using SIP Certificates.
• Using Tomcat Certificates in Next Gen Security

With Release 12.5(1) SU4 and later, Unity Connection supports only RSA key based Tomcat certificates to configure secure calls using SIPI integration. This allows the use of selfsigned as well asthird-party CA signed certificate for SIP secure call.

For information on SIP Integration, see Setting Up a Cisco Unified Communications Manager SIP Trunk Integration chapter of Cisco Unified Communications Manager SIP Integration Guide for Cisco Unity Connection Release 12.x available at link https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/integration/guide/cucm_sip/b_12xcucintcucmsip.html

Support of HAProxy

With Cisco Unity Connection Release 12.5(1)Service Update 4 and later, HAProxy frontends all the incoming web traffic into Unity Connection offloading Tomcat.

HAProxy is a fast and reliable solution that offers high availability, load balancing, and proxy capabilities for HTTP-based applications. HAProxy implementation has resulted in the following improvements:

• For about 10,000 client logins into Unity Connection, there is an average of 15-20% improvement in the total time taken for clients to log in to the system.
• New Performance counters are introduced in Real Time Monitoring Tool (RTMT) for better troubleshooting and monitoring.
• Improved Tomcat stability through offloading of cryptograph functionality for incoming web traffic.

For more information, see section System Architecture Improvements for Web Traffic of chapter “Cisco Unity Connection Overview” in Design Guide for Cisco Unity Connection 12.x available at link https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/design/guide/b_12xcucdg.html.

Related Documentation

Documentation for Cisco Unity Connection

For descriptions and URLs of Cisco Unity Connection documentation on Cisco.com, see the Documentation Guide for Cisco Unity Connection Release 12.x. The document is shipped with Unity Connection and is available at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/roadmap/b_12xcucdg.html.

Documentation for Cisco Unified Communications Manager Business Edition

For descriptions and URLs of Cisco Unified Communications Manager Business Edition documentation on Cisco.com, see the applicable version of Cisco Business Edition at https://www.cisco.com/c/en/us/support /unified-communications/index.html.

Installation Information

For instructions on downloading the service update, see the “Downloading Cisco Unity Connection Release 12.5(1) Service Update 4 Software” section.

For instructions on installing the service update on Cisco Unity Connection, see the “Upgrading Cisco Unity Connection” chapter of the Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 12.x at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/install_upgrade/guide/b_12xcuciumg.html.

Note

If you are performing an upgrade from a FIPS enabled Cisco Unity Connection release to Cisco Unity Connection 12.5(1)SU6, make sure to follow the stepsfor regenerating certificates before using any pre-existing telephony integrations. To learn how to regenerate certificates, see the Regenerating Certificates for FIPS section of the “FIPS Compliance in Cisco Unity Connection” chapter of the Security Guide for Cisco Unity Connection Release 12.x at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/security/guide/b_12xcucsecx.html.

Downloading Cisco Unity Connection Release 12.5(1) Service Update 4 Software

Note
The service update files can be used to upgrade Cisco Unity Connection. The files can be downloaded from the Unity Connection downloads page.

Caution
With restricted and unrestricted versions of Cisco Unity Connection software now available, download software carefully. Upgrading a restricted version to an unrestricted version is supported, but future upgrades are then limited to unrestricted versions. Upgrading an unrestricted version to a restricted version is not supported.
For more information on restricted and unrestricted versions of Unity Connection software, see the Downloading a VMware OVA Template for a Unity Connection 12.5(1) Virtual Machine of the Release Notes for Cisco Unity Connection Release 12.5(1) at http://www.cisco.com/c/en/us/support/unified- communications/unity-connection/products-release-notes-list.html.

Downloading Cisco Unity Connection Release 12.5(1) Service Update 4 Software

Step 1 Sign in to a computer with a high-speed Internet Unity Connection, and go to the Voice and Unified Communications Downloads page at http://www.cisco.com/cisco/software/navigator.html?mdfid=280082558.
Note To access the software download page, you must be signed in to Cisco.com as a registered user.
Step 2 In the tree control on the Downloads page, expand Products> Unified Communications> Unified Communications Applications> Messaging> Unity Connection, and select Unity Connection Version 12.x.
Step 3 On the Select a Software Type page, select Cisco Unity Connection Updates.
Step 4 On the Select a Release page, select 12.5(1) SU 4, and the download buttons appear on the right side of the page.
Step 5 Confirm that the computer you are using has sufficient hard-disk space for the downloaded files. (The download descriptions include file sizes.)
Step 6 Select the applicable download, then follow the on-screen prompts to complete the download, making note of the MD5 value.

Note The VOS version for above mentioned ISO is 12.5.1.14900-63.

Step 7 Use a checksum generator to confirm that the MD5 checksum matches the checksum that is listed on Cisco.com. If the values do not match, the downloaded files are damaged.

Caution Do not attempt to use a damaged file to install software, or the results will be unpredictable. If the MD5 values do not match, download the file again until the value for the downloaded file matches the value listed on Cisco.com.

Free checksum tools are available on the Internet, for example, the Microsoft File Checksum Integrity Verifier utility.
The utility is described in Microsoft Knowledge Base article 841290, Availability and Description of the File Checksum Integrity Verifier Utility. The KB article also includes a link for downloading the utility.

Step 8

If you are installing from a DVD, burn the DVD, noting the following considerations:

• Choose the option to burn a disc image, not the option to copy files. Burning a disc image will extract the thousands of files from the .iso file and write them to a DVD, which is necessary for the files to be accessible for the installation.
• Use the Joliet file system, which accommodates filenames up to 64 characters long.
• If the disc-burning application that you are using includes an option to verify the contents of the burned disc, choose that option. This causes the application to compare the contents of the burned disc with the source files.

Step 9 Confirm that the DVD contains a large number of directories and files.
Step 10 Delete unnecessary files from the hard disk to free disk space, including the .iso file that you downloaded.

See the “Rollback of Unity Connection” section of the “Upgrading Cisco Unity Connection” chapter of the Install, Upgrade, and Maintenance Guide for Cisco Unity Connection Release 12.x at https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/install_upgrade/guide/b_12xcuciumg.html.

If a Unity Connection cluster is configured, revert to the previous version on the publisher server first, then on the subscriber server.

Caveat Information

You can find the latest caveat information for Unity Connection version 12.5 by using Bug Toolkit, an Online tool available for customers to query defects according to their own needs.

Bug Toolkit is available at https://bst.cloudapps.cisco.com/bugsearch/.Fill in your query parameters by using the custom settings in the Advanced Settings option.

Note To access Bug Toolkit, you must be logged on to Cisco.com as a registered user.

This section contains the following caveat information:

• Open Caveats—Unity Connection Release 12.5(1) SU 4, on page 8
• Resolved Caveats—Unity Connection Release 12.5(1) SU4, on page 8
• Related Caveats—Cisco Unified Communications Manager 12.5(1) Components that are Used by Unity Connection 12.5(1), on page 9

Open Caveats—Unity Connection Release 12.5(1) SU 4

There are no open caveats for this release.

Click a link in the Caveat Number column to view the latest information on the caveat in Bug Toolkit. (Caveats are listed in order by severity, then by component, then by caveat number.)

Table 1: Unity Connection Release 12.5(1) SU4 Resolved Caveats

vulnerabilities.
CSCvw93402| serviceability| 2| Year 2021 cannot be selected while fetching any report in Serviceability Report page.
CSCvx27048| config| 3| Pre & Post Upgrade Check COP files, GUI install cause CPU over utilization in Unity Connection.
CSCvt30469| conversations| 3| Cross server sign-in and transfer not working in case of Secure Call.
CSCvx12734| core| 3| CuMbxSync Core in Logger if CsExMbxLocator Log is enabled & failure happens to save token to DB.
CSCvw29121| database| 3| CUC 12.5.1 Unable to Change Host name & IP Address through GUI documented steps.
CSCvv77137| database| 3| Variable length column sort flag not turned off for Unity instance leading to DB communication error
CSCvu31264| licensing| 3| CUC 12.5.1 HCS/HCS-LE Unity web page shows the server in evaluation mode/evaluation expired mode.
CSCvw52134| messaging| 3| REST API Support of Oauth2.0 to configure UMS Office365 for Government Customers
CSCvx29625| telephony| 3| Unable to send API request to CUCM from CUC using CURL.
---|---|---|---
CSCvx32232| telephony| 3| Unable to login VVM in 12.5 SU4 and 14.0.
CSCvu28889| selinux| 3| CUC : Multiple Issues After Upgrade Without Switchover With IPSec Enabled Until IPTables Restarted.
CSCvx30301| utilities| 3| Enhancement to hap Roxy log file rotation capture needed.

Related Caveats—CiscoUnifiedCommunicationsManager12.5(1)Components that are Used by Unity Connection 12.5(1)

Table 2: Cisco Unified CM 12.5(1) Components That Are Used by Unity Connection 12.5(1) below describes the Cisco Unified Communications Manager components that are used by Cisco Unity Connection.

Caveat information for the Cisco Unified CM components is available in the following documents:

• ReadMe for Cisco Unified Communications Manager Release 12.5(1) SU4 on the download page for 12.5(1) SU4 (start at https://software.cisco.com/download/home/280082558).

Table 2: Cisco Unified CM 12.5(1) Components That Are Used by Unity Connection 12.5(1)

interface
cdp| Cisco Discovery Protocol Drivers
cli| Command-line interface (CLI)
cmui| Certain elements in the Unity Connection web interfaces (such as search tables and splash screens)
cpi-afg| Cisco Unified Communications Answer File Generator
cpi-appinstall| Installation and upgrades
cpi-cert-mgmt| Certificate management
cpi-diagnose| Automated diagnostics system
cpi-os| Cisco Unified Communications Operating System
cpi-platform-api| Abstraction layer between the Cisco Unified Communications Operating System and the applications hosted on the platform
cpi-security| Security for connections to the server
cpi-service-mgr| Service Manager (ServM)
cpi-vendor| External vendor issues
cuc-tomcat| Apache Tomcat and third-party software
---|---
database| Installation and access to the configuration database (IDS)
database-ids| IDS database patches
ims| Identity Management System (IMS)
rtmt| Real-Time Monitoring Tool (RTMT)

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.

Cisco Product Security Overview

This product contains cryptographic features and is subject to United States and local country laws governing import, export, transfer and use. Delivery of Cisco cryptographic products does not imply third-party authority to import, export, distribute or use encryption. Importers, exporters, distributors and users are responsible for compliance with U.S. and local country laws. By using this product you agree to comply with applicable laws and regulations. If you are unable to comply with U.S. and local laws, return this product immediately.
Further information regarding U.S. export regulations may be found at https://research.ucdavis.edu/wpcontent/uploads/ExportControl-Overview-of- Regulations.pdf

References

• Cisco Unity Connection - Compatibility Information - Cisco
• Cisco Unity Connection - Release Notes - Cisco
• Platform Suite - Cisco
• Cisco Unity Connection - Compatibility Information - Cisco
• Support - Cisco Support and Downloads – Documentation, Tools, Cases - Cisco
• Unified Communications Products - Support and Downloads - Cisco

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>