About this Document

This document provides installation instructions for Unified CCE 12.5(1) ES100. 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 the following 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 Special)

Unified CCE Compatibility and Support Specifications

.

Unified CCE Version Support

UCCE 12.5(1)

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

You can install Unified CCE 12.5(1) ES100 on the following Unified CCE components:

Unsupported Unified CCE Components

Do not install this engineering special on any component other than:

 

Unified CCE Engineering Special Installation Planning

Installing Unified CCE 12.5(1) ES100

  1. Download the patch and copy the patch local to the server where patch is going to be installed.
  2. Stop all ICM services and application running on the server.
  3. Ensure that ES55 is installed prior to installing ES100. Run the patch installer exe and follow the instructions.
  4. Check the version of tomcat installed by running \tomcat\bin\version.bat . If its 9.0.37 or higher, then do the following steps.
  5. Reboot the server after successful completion of the patch install.
  6. Start the ICM services.

Uninstall Directions for Unified CCE 12.5(1) ES100

  1. Stop ICM services and applications running on the server.
  2. To uninstall this patch, go to Control Panel.
  3. Select Add or Remove Programs.
  4. Find the installed patch in the list and select Remove.
  5. Reboot the system.
  6. Start the ICM services.

 

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.

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) ES100

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

Index of Resolved Caveats

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

Identifier

Severity

Component

Headline

CSCvz50705

3

web.config.api

Tomcat crashes when contacts for more than 200 campaigns are imported in a sequential manner

Caveats are ordered by severity, then defect number.

Defect Number: CSCvz50705

Component: web.config.api

Severity: 3

Headline: Tomcat crashes when contacts for more than 200 campaigns are imported in a sequential manner


Symptom: Tomcat crashes when importing contact records for 200+ campaigns in sequential manner. Each campaign import contact API request can have a maximum of 10K records.

On SPOG front end, web page will just hang for more than the time it is supposed to take.

You may get the following error message:

Error occurred

     •    Timed out while connecting to server.

 

Tomcat logs will show the following errors:

OutOfMemory error.

IP ADDRESS <https://IP Address>: Aug 23 2021 19:31:48.180 +0200: %CCBU_ajp-nio-127.0.0.1-8009-exec-2-3-REST_API_EXCEPTION: %[exception=java.lang.OutOfMemoryError: GC overhead limit exceeded][message_string=uncaught exception thrown by the api]: The REST API has caught an exception

IP ADDRESS<https://IP ADDRESS/>: Aug 23 2021 19:31:48.196 +0200: %CCBU_ajp-nio-127.0.0.1-8009-exec-2-3-EXCEPTION_INFO: %[build_date=May 04, 2021 12:05 AM][build_type=rel][exception=java.lang.OutOfMemoryError: GC overhead limit exceeded

at java.lang.Long.toString(Long.java:399)

at java.lang.Long.toString(Long.java:124)

at java.util.Formatter$FormatSpecifier.print(Formatter.java:3096)

at java.util.Formatter$FormatSpecifier.print(Formatter.java:3083)

at java.util.Formatter$FormatSpecifier.printInteger(Formatter.java:2787)

at java.util.Formatter$FormatSpecifier.print(Formatter.java:2747)

at java.util.Formatter.format(Formatter.java:2520)

at java.util.Formatter.format(Formatter.java:2455)

at java.lang.String.format(String.java:2940)

at com.cisco.ccbu.cce.unifiedconfig.api.bulk.processors.ImportContactBulkProcessor.getDataForReplicationFile(ImportContactBulkProcessor.java:410)

at com.cisco.ccbu.cce.unifiedconfig.api.bulk.processors.ImportBulkProcessor.insertDataIntoTableAndReplicationFile(ImportBulkProcessor.java:415)

at com.cisco.ccbu.cce.unifiedconfig.api.bulk.processors.ImportContactBulkProcessor.processBeans(ImportContactBulkProcessor.java:106)

at com.cisco.ccbu.cce.unifiedconfig.api.bulk.processors.ImportBulkProcessor.executeImport(ImportBulkProcessor.java:97)

at com.cisco.ccbu.cce.unifiedconfig.api.campaign.importcontacts.ImportContactCreateTaskBase.doWork(ImportContactCreateTaskBase.java:83)

at com.cisco.ccbu.cce.unifiedconfig.api.campaign.importcontacts.ImportContactCreateTask.doWork(ImportContactCreateTask.java:111)

at com.cisco.ccbu.cce.unifiedconfig.async.AsyncExecutor.executeSync(AsyncExecutor.java:298)

at com.cisco.ccbu.cce.unifiedconfig.async.AsyncExecutor.execute(AsyncExecutor.java:222)

at com.cisco.ccbu.cce.unifiedconfig.api.campaign.CampaignService.importContacts(CampaignService.java:510)

at sun.reflect.GeneratedMethodAccessor169.invoke(Unknown Source)

at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)

at java.lang.reflect.Method.invoke(Method.java:498)

at com.sun.jersey.spi.container.JavaMethodInvokerFactory$1.invoke(JavaMethodInvokerFactory.java:60)

at com.sun.jersey.server.impl.model.method.dispatch.AbstractResourceMethodDispatchProvider$ResponseOutInvoker._dispatch(AbstractResourceMethodDispatchProvider.java:205)

at com.sun.jersey.server.impl.model.method.dispatch.ResourceJavaMethodDispatcher.dispatch(ResourceJavaMethodDispatcher.java:75)

 

Conditions: CCE: 12.5


Workaround: Change the below parameters and restart tomcat service

 

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\Tomcat7\Parameters\Java\JvmMx -> 512 (increased from 256)

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\Tomcat7\Parameters\Java\Options -> -XX:MaxPermSize=256m (increased from 128m).

Further Problem Description: 

The workaround mentioned above is temporary and need to be assessed by the Engineering team further based on the load testing with the max supported API limits.

 

Caveats resolved in earlier ESs and included as part of Unified CCE 12.5.1 ES100

 Identifier

Severity

Component

Headline

CSCvt61292

3

aw.tools

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

CSCvs85018

2

dbconfig

Finesse gadget is not loading in CCEAMDIN in PCCE Lab-Only mode

CSCvs64183

3

dbconfig

PCCE registration of SSO clients fail in SPOG

CSCvs77949

3

dbconfig

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

CSCvs96235

3

dbconfig

PCCE exeeded configuration limit should not trigger Service Busy state

CSCvt09634

3

dbconfig

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

CSCvu00949

3

dbconfig

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

CSCvt07963

5

dbconfig

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

CSCvs56462

3

template

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

CSCvt05248

3

template

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

CSCvs77189

2

web.config.ui

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

CSCvt01048

3

web.config.ui

CVP shows OUT_OF_SYNC every 10 mins after CloudConnectInventoryScanner

CSCvs21511

3

dbconfig

PCCE 12K: HDS fails to register to SSO mode

CSCvs49920

3

dbconfig

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

CSCvs79502

3

dbconfig

PCCE4k: Able to add Machines to inventory with Same MachineName

CSCvt65662

3

dbconfig

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

CSCvu54806

2

dbconfig

Not able to update credentials of Remote Site CUCM PUB

CSCvu85367

2

dbconfig

Symmetric Key exception observed intermittently

CSCvt74130

2

dbconfig

PCCE2K Upgrade Wizard error

CSCvv12160

3

dbconfig

External HDS save fails from Inventory after component update

CSCvv21519

3

dbconfig

CUIC user group membership revoked for bulk user during PCCE sync

CSCvu91063

6

dbconfig

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

CSCvv04451

3

template

Finesse gadget does not load in cceadmin Device Configuration

CSCvu25506

2

web.config.api

Agent create/update with default SkillGroup failing with 500 error

CSCvv07804

2

web.config.ui

CCE Administration Unable to Update IDS Subscriber Name

CSCvv43901

2

web.config.ui

SPOG does not allow resetting SIGDigits back to 0

CSCvv43532

2

web.setup

Evaluation of ICM for Apache Struts Aug20 vulnerabilities

CSCvu54806

2

dbconfig

Not able to update credentials of Remote Site CUCM PUB

CSCvu85367

2

dbconfig

Symmetric Key exception observed intermittently

CSCvv51017

1

dbconfig

Unable to Set the deploymentType to PCCE2k

CSCvw45522

3

dbconfig

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

CSCvv53307

2

ova

PCCE does not correctly validate CPU speed

CSCvu91011

2

web.config.ui

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

CSCvw82858

2

web.config.api

Outbound Import API throws 503 Service Unavailable leading Tomcat to crash

CSCvw53423

3

dbconfig

Issue in Fresh Install of PCCE Simplex Lab mode

CSCvx52770

2

tools

Certmon does not handle the JAVA_HOME change when in FIPS mode

CSCvv53842

3

dbconfig

Network Binding order corruption, result private and public IP got interchanged in t_machine_Address

CSCvx94616

3

web.config.api

B side CampaignManager stays stuck in standby when frequent API requests are being sent

CSCvx98655

3

web.config.api

Licensing Management page is blank in CCEadmin when Contact director is chosen as deployment type

CSCvx95438

3

web.config.api

While setting deployment to PCCE 2k, issue while providing CVP cred

CSCvw47719  

3

dbconfig

CUIC streaming datasource creation fails in PCCE lab deployment

CSCvz26111       

2

web.config.ui

Configuration in Call Settings->Miscellaneous cannot be saved in SPOG for PCCE

CSCvy91067

3

web.config.api

Tomcat OutOfMemoryError due to SQL Delay

CSCvz10953

3

web.config.ui

Cannot edit status or schedule on multiple Outbound campaigns in SPOG if some have AMD disabled

CSCvz21484

3

web.config.api

Import API requests at the same millisecond results in "Session was already closed" failure

 

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: