About this Document


This document provides installation instructions for Unified CCE 12.5(1) ES55. It also contains a list of Unified CCE issues resolved by this engineering special. Review all installation information before installing the product. Failure to install this engineering special as described can result in inconsistent Unified CCE behavior.

This document contains these sections:

Sign Up for Email Notification of New Field Notices


In the Product Alert Tool, you can set up profiles to receive email notification of new Field Notices, Product Alerts, or End of Sale information for your selected products.

The Product Alert Tool is available at https://www.cisco.com/cisco/support/notifications.html.

About Cisco Unified CCE (and Unified CCE Engineering Specials)

In 12.5(1), after the initial release, CCE transitioned from Oracle to OpenJDK for the Java runtime environment. Newer installs and upgrades with 12.5(1a) base installer run with OpenJDK JRE while the older installs and upgrades with 12.5(1) base run with Oracle JRE. This engineering special enables 12.5(1) systems to transition to OpenJDK and is a mandatory prerequisite for receiving further maintenance patches on CCE.

Although 12.5(1a) installer lays down OpenJDK JRE for CCE applications, prior engineering specials than ES55 that contain Java deliverable files as a fix, may not work as expected. ES55 bundles all those Java file related fixes and can be installed directly. If you are evaluating the fixes delivered in one or more of the following ES', install ES55 as an alternative - ES4, ES5, ES7, ES12, ES21, ES22, ES25, ES30, ES33, ES39, ES43, ES50, and ES51.

In addition to enabling CCE Java applications to employ OpenJDK, the following functionality that was delivered in ES30 and ES50 respectively, are also included in this engineering special:

·  Support for Edge Chromium browser (Microsoft Edge v79 and later) that was delivered as part of ES30.

·  Support for higher number of configured Agents for HCS 24000 Agents deployment that was delivered as part of ES50


Unified CCE Compatibility and Support Specifications


Unified CCE Version Support

Unified CCE Component Support

This section lists the Unified CCE components on which you can and cannot install this engineering special.

Supported Unified CCE Components

Unsupported Unified CCE Components

Unified CCE Engineering Special Installation Planning


Installing Unified CCE 12.5(1) ES55


  1. Using the Unified CCE Service Control, stop all the Unified CCE Services running on the system.
  2. Launch the installer provided for the ES55 and follow the instructions on the screen.
  3. Check the version of tomcat installed by running <ICM HOME>\tomcat\bin\version.bat . If its 9.0.37 or higher, then do the following steps

oStep 1:
In <ICM HOME>\tomcat\conf\server.xml make sure the entry for <Connector> entry for APJ protocol is as below
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" address="127.0.0.1" maxPostSize="5242880" secretRequired="false" allowedRequestAttributesPattern=".*" />
If the highlighted entry is missing, then add the entry in server.xml

 

oStep 2:

§ Download the 32-bit tomcat installer zip from http://archive.apache.org/dist/tomcat/tomcat-9/ . Download the same version that is displayed when version.bat was run.

§ Unzip the installer to a temp folder

§ Copy tomcat-util-scan.jar from the <temp>\apache-tomcat-9.0.xx\lib location to <ICM HOME>\tomcat\lib

§ Using the ICM/CCE Service Control, start Apache Tomcat 9 service.

  1. If the Unified CCE Services are set to manual, using the Unified CCE Service Control, start all the Unified CCE Services.

Post Install Directions for Unified CCE 12.5(1) ES55


Just like any other Java upgrade on CCE servers, certificates may have to be re-imported if one is upgrading from a previous CCE version, that relied on Oracle JRE. Please refer to the Installation and Upgrade guide for more details.


Uninstall Directions for Unified CCE 12.5(1) ES55


  1. To uninstall this patch, go to Control Panel.
  2. Select "Add or Remove Programs".
  3. Find the installed patch in the list and select "Remove".

Note: Remove patches in the reverse order of their installation. For example, if you installed patches 3, then 5, then 10 for a product, you must uninstall patches 10, 5, and 3, in that order, to remove the patches from that product.


Post Uninstall Directions for Unified CCE 12.5(1) ES55


Certificates may have to be re-imported if one is downgrading to a previous CCE version, that relied on Oracle JRE. Please refer to the Installation and Upgrade guide for more details.


Resolved Caveats in this Engineering Special


This section provides a list of significant Unified CCE defects resolved by this engineering special. It contains these subsections:


Note: You can view more information on and track individual Unified CCE defects using the Cisco Bug Search tool, located at: https://bst.cloudapps.cisco.com/bugsearch/search?null.


Resolved Caveats in Unified CCE 12.5(1) ES55

This section lists caveats specifically resolved by Unified CCE 12.5(1) ES55.

Index of Resolved Caveats

Caveats in this section are ordered by UNIFIED CCE component, severity, and then identifier.

Identifier

Severity

Component

Headline

CSCvx52770

2

tools

Certmon does not handle the JAVA_HOME change when in FIPS mode

Detailed list of Resolved Caveats in This Engineering Special

Caveats are ordered by severity then defect number.


Defect Number: CSCvx52770

Component: tools

Severity: 2

Headline: Certmon does not handle the JAVA_HOME change when in FIPS mode


Symptom:
VM reboots

Conditions:
1. After installing the Unified CCE 12.5(1) ES33 and Enable FIPS. 2. Install any new java update.

Workaround:
Make sure data (-Djava.ext.dirs) in the the registry value HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Tomcat9\Parameters\Java\Options\ matches the JAVA_HOME. -Djava.ext.dirs=C:\icm\ssl\bin;C:\Program Files (x86)\Java\jre1.8.0_221\lib\ext

Further Problem Description:


Resolved Caveats of Previous ES’s included in this Engineering Special

 

ES#

Identifier

Severity

Component

Headline

ES4

CSCvm45006

6

pg.cucm.jtapi

Add support for agent with two phones with same ACD extension

ES5

CSCvt61292

3

aw.tools

ECC CTI variable size check enforcement to be relaxed and a warning be displayed if size is exceeded

ES7

CSCvs85018

2

dbconfig

Finesse gadget is not loading in CCEAMDIN in PCCE labonly mode

ES7

CSCvs64183

3

dbconfig

PCCE registration of SSO clients fail in SPOG

ES7

CSCvs77949

3

dbconfig

Agents with TraceON enabled for 12k is 400 in Doc vs 100 in System Capacity (pcce webadmin)

ES7

CSCvs96235

3

dbconfig

PCCE exeeded configuration limit should not trigger Service Busy state

ES7

CSCvt09634

3

dbconfig

PCCE 4K/12K day 1 validations are not exercised for both Main Site and Remote Sites

ES7

CSCvu00949

3

dbconfig

SPOG: Cloud Connect Integration page not working in Lab Only mode

ES7

CSCvt07963

5

dbconfig

[VPAT Observation] Keyboard visual focus is not visible on some elements

ES7

CSCvs48546

3

template

SSO supervisor : cceadmin fails to load due to bundle mismatch

ES7

CSCvs56462

3

template

Miscellaneous page fails to load with InternalServerError when there are no NetworkVRU's in system

ES7

CSCvt05248

3

template

In 4k, While deleting a peripheral set, the validation errors are not getting listed in UI

ES7

CSCvs77189

2

web.config.ui

Cannot Switch to HCS 4K Deployment if Total Dialed Numbers on All CVP Route Clients Exceeds 4000

ES7

CSCvt01048

3

web.config.ui

CVP shows OUT_OF_SYNC every 10 mins after CloudConnectInventoryScanner

ES12

CSCvs21511

3

dbconfig

PCCE 12K: HDS fails to register to SSO mode

ES12

CSCvs49920

3

dbconfig

Not able to switch PrincipalAW when DF Service is down on the existing PrincipalAW

ES12

CSCvs79502

3

dbconfig

PCCE4k: Able to add Machines to inventory with Same MachineName

ES12

CSCvt65662

3

dbconfig

NullPointerException during PCCE 4K/12K fresh install when Rogger is simplexed in the CSV

ES12

CSCvs64057

2

template

Reason Codes doesn't show in Teams gadget for the first time

ES21

CSCvt74130

2

dbconfig

PCCE2K Upgrade Wizard error

ES21

CSCvv12160

3

dbconfig

External HDS save fails from Inventory after component update

ES21

CSCvv21519

3

dbconfig

CUIC user group membership revoked for bulk user during PCCE sync

ES21

CSCvu91063

6

dbconfig

PCCE 12.5 4K/12K Deployment Type - Peripheral Gateway API does not work

ES21

CSCvv04451

3

template

Finesse gadget does not load in cceadmin Device Configuration

ES21

CSCvu25506

2

web.config.api

Agent create/update with default SkillGroup failing with 500 error

ES21

CSCvv07804

2

web.config.ui

CCE Administration Unable to Update IDS Subscriber Name

ES21

CSCvv43901

2

web.config.ui

SPOG does not allow resetting SIGDigits back to 0

ES22

CSCvv43532

2

web.setup

Evaluation of icm for Apache Struts Aug20 vulnerabilities

ES25

CSCvu54806

2

dbconfig

Not able to update credentials of Remote Site CUCM PUB

ES25

CSCvu85367

2

dbconfig

Symmetric Key exception observed intermittently

ES25

CSCvu20611

3

smart-license

Correct CCE Server License tag

ES25

CSCvv74905

3

smart-license

ICM 12.5(1) setting "Next_Available_Number" to 5000 for "Smart_License_Entitlements" table.

ES33

CSCvw90939

6

security

Multiple Vulnerabilities in openssl

ES33

CSCvv51017

1

dbconfig

Unable to Set the deploymentType to PCCE2k

ES33

CSCvw45522

3

dbconfig

Business Hours does not load departments if departments are more than 25

ES33

CSCvv53307

2

ova

PCCE not correctly validate CPU speed

ES33

CSCvu91011

2

web.config.ui

CCEadmin uses the first Finesse cluster credentials for Subscriber of the second cluster

ES39

CSCvw82858

2

web.config.api

Outbound Import API throws 503 service unavailable leading Tomcat to crash

ES43

CSCvw77880

2

web.setup

Evaluation of UCCE for Apache Struts Dec 20 critical vulnerability- CVE-2020-17530

ES51

CSCvw53423

2

dbconfig

Issue in Fresh Install of PCCE Simplex Lab mode

 


Obtaining Documentation


You can access current Cisco documentation on the Support pages at the following sites:

Documentation Feedback

To provide comments about this document, send an email message to the following address:

contactcenterproducts_docfeedback@cisco.com

We appreciate your comments.

Obtaining Technical Assistance


Cisco.com is a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com registered users, additional troubleshooting tools are available from the TAC site.

Cisco.com

Cisco.com provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through Cisco.com, you can find information about Cisco and our networking solutions, services, and programs. You can also resolve technical issues with online technical support and download software packages. Valuable online skill assessment, training, and certification programs are also available.

Customers and partners can self-register on Cisco.com to obtain additional personalized information and services. Registered users can order products, check on the status of an order, access technical support, and view benefits specific to their relationships with Cisco.

Technical Assistance Center

The Cisco TAC site is available to all customers who need technical assistance with a Cisco product or technology that is under warranty or covered by a maintenance contract.

Contacting TAC by Using the Cisco TAC Site

If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC by going to https://www.cisco.com/c/en/us/support/index.html.

P3 and P4 level problems are defined as follows:

In each of the above cases, use the Cisco TAC site to quickly find answers to your questions.

If you cannot resolve your technical issue by using the TAC online resources, Cisco.com registered users can open a case online by using the TAC Case Open tool at the following site: https://mycase.cloudapps.cisco.com/create/start/

Contacting TAC by Telephone

If you have a priority level 1(P1) or priority level 2 (P2) problem, contact TAC by telephone and immediately open a case. To obtain a directory of toll-free numbers for your country, go to the following sites:

P1 and P2 level problems are defined as follows: